Spark Fastpath Installation Guide

Spark Fastpath consists of the following components:

Fastpath Server Plugin: adds queuing, routing, logging and search services to Wildfire.
Webchat Application: web-based chat application used by website visitors to chat with workgroup members.

Installation Pre-requisites

You must install the following software before continuing Spark Fastpath installation.

Spark IM Client, version 1.1.4 or later:
The Spark IM client contains all the client tools you need to use the Fastpath server.

Wildfire Server, version 2.6.2 or later:
Spark Fastpath works as a plugin for the Wildfire IM server. Download and install the latest Wildfire server.

Files in the Distribution

The files in your distribution should be as follows (some sub-directories omitted for brevity):

fastpath/
 |- README.html
 |- changelog.html
 |- LICENSE.html
 |- database/
 |- plugins/
     |- fastpath.jar
     |- webchat.war
 |- documentation/

Installation

Important: It is assumed that you have already installed the Wildfire Server. If not, please download and install the latest Wildfire server from Jive Software. When are you are finished, please continue the Fastpath install.

Unzip either the .zip (windows) or tar.gz(unix and linux).

In the plugins directory of the unzipped archive, copy all the .jar and .war files into the plugins directory of your Wildfire installation.

fastpath.jar
webchat.war

The plugins will be automatically deployed. To upgrade to a new version, copy the new jar files over the existing ones.

Setup Overview

To complete the installation of Spark Fastpath, you'll need to perform each of the following steps:

Webchat Application - instructions for using and deploying the webchat application.

Configuration

Fastpath can be configured via the Wildfire Admin Console. Click on the "Spark Fastpath" tab to configure your install.

The plugins directory contains the server plugins, including the Fastpath server module that provides queuing and routing on top of Wildfire, as well as the webchat application.
The database directory contains SQL schema files to create new databases, as well as upgrade scripts for existing installations.
The documentation directory contains server documentation.

Webchat Application

The webchat application is installed as a plugin in the server by default. You can access it using the following URL (substituting the server name and port as necessary):

http://localhost:9090/webchat

The webchat application is specially configured to work as both a server plugin and standard web-application file that can be deployed into any application server (Tomcat, Resin, Weblogic, etc). Using the application as a plugin is suitable for evaluation purposes. In most cases, the webchat application will need to be deployed into a separate application server for a production deployment. To do so, copy the plugins/webchat.war file from your Spark Fastpath server installation to the webapps/ directory of your application server.