Changes between Version 1 and Version 2 of InstallGuide


Ignore:
Timestamp:
Aug 25, 2015 11:15:09 AM (2 years ago)
Author:
crabbe
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallGuide

    v1 v2  
    22
    33=== System Requirements ===
    4 To build and use Multistage, you must have JDK 1.6 or better installed on your system. JAVA_HOME environment variable should also be set to this version of the JDK. For windows NT/2000/XP, here is a brief description on how to set JAVA environmental variables in your system:
     4To 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:
     5 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.
    56
    6  1. Go to Control Panel, click on 'System' icon, and then select the 'Advanced' Tab.
    7  1. Click on the 'Environmental Variables' Icon;
    8  1. Under the user variables, add 'New' Variable: JAVA_HOME, with value pointing where your jdk is installed: e.g. JAVA_HOME: c:\jdk1.6
    9  1. Modify your 'PATH' variable by adding 'New Variable: PATH, with value: %PATH%;%JAVA_HOME%\bin
    10  1. Click OK (twice) to exit.
    11  1. Open a Dos Command Prompt, and type command: 'java', at the shell prompt. If you see the message: Usage: java [-options]..., that means you have successfully added the JAVA environmental variable.
     7=== Installation and Configuration: ===
     8Follow these steps prior to running Multistage for the first time:
    129
    13    
    14 === Build Notes ===
    15 Type "build targets" at command prompt of installed multistage directory to print a list of options on the screen. Then run the desired target by typing "build (target name)", where (target name) is the option from list (i.e. "build distx").
    16 
    17 === Quick Installation and Configuration: ===
    18 You MUST follow these steps prior to running Multistage for the first time:
    19 
    20  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.
    21  1. To specify the server (ip) address of the multistage server, you must modify the 'conf/[wiki:mult-client.properties]' file where it says "defaultHost=". (Example: defaultHost = 128.97.190.171)
    22  1. To enable testing mode, you must modify the 'conf/[wiki:mult-client.properties]' file where it says "defaultMode =". Enter "testing" to enable testing mode, or "normal" for normal mode. Refer to 'Automated testing' under Optional Services.
     10 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. 
     11 1. To specify the IP address of the multistage server, you must modify the 'conf/[wiki:mult-client.properties]' file where it says "defaultHost=". (Example: defaultHost = 128.97.190.171).
     12 1. To specify where the clients store persistence information for reauthentication, you must modify the 'conf/[wiki:mult-client.properties]' file to set the 'serializePath' parameter value to a directory where the client has permission to write.
    2313
    2414=== Running Multistage ===
     
    3222      Make sure that all log details are configured correctly in the 'conf/clientlog.properties'. (i.e. double check all file paths)
    3323 1. "When I run 'client-multistage.bat' the login window appears but I cannot edit any or some of the fields."
    34       Most likely testing mode is enabled in the '/conf/[wiki:mult-client.properties]' file. See user manual for more details.
     24      Most likely testing mode is enabled in the '/conf/[wiki:mult-client.properties]' file.