wiki:InstallGuide

Installation Guide

System Requirements

To build and use Multistage, you must have the Java 1.8 JDK installed on your system. The modern java installers also define the JAVA_HOME environment variable and install java in the system path. To check to see if you have java installed:

  1. Open a Windows Command Prompt, and type: 'java -version', at the shell prompt. If you see a message similar to "java version "1.8.0_31", that means you have java installed.

Installation and Configuration:

Follow these steps prior to running Multistage for the first time:

  1. To specify log directories and other log details, you must modify the 'conf/log4j.properties' file for server-side and 'conf/clientlog.properties' for client side.
  2. To specify the IP address of the multistage server, you must modify the 'conf/mult-client.properties' file where it says "defaultHost=". (Example: defaultHost = 128.97.190.171).
  3. To specify where the clients store persistence information for reauthentication, you must modify the 'conf/mult-client.properties' file to set the 'serializePath' parameter value to a directory where the client has permission to write.

Running Multistage

Run "server-multistage.bat", or "client-multistage.bat" from the /bin directory in the installed Multistage directory.

A more detailed guide to running multistage can be found in the User Guide.

Troubleshooting

  1. "When I run 'client-multistage.bat' there are several log4j errors even though the client seems to work fine after."

Make sure that all log details are configured correctly in the 'conf/clientlog.properties'. (i.e. double check all file paths)

  1. "When I run 'client-multistage.bat' the login window appears but I cannot edit any or some of the fields."

Most likely testing mode is enabled in the '/conf/mult-client.properties' file.

Last modified 10 days ago Last modified on 08/25/2015 11:15:09 AM