Systinet Installation for UNIX Platforms (Magic xpa 3.x)
Installing Systinet Server for Java (SSJ) can be done via the same user used to install Magic xpa, or as a different user. All files pertaining to this installation are in the web_services directory.
-
Install Java 7.
Only the 32-bit JRE is needed for Systinet.
-
Update .profile.
JRE 7 needs to be referenced in the JAVA_HOME variable and as the default runtime for any Java application. Add the following lines to the end of the .profile of the Magic xpa user name:
# Set home path for Systinet
export WASP_HOME=$MAGIC_HOME/ssj
# Set home jave runtime as version 7
export JAVA_HOME=/usr/java7/jre
# Set default Java runtime to 7 in Path
export PATH=/usr/java7/jre/bin:/usr/java7/bin:$PATH
-
Configure the ssjinstallconfig file.
From $MAGIC_HOME/web_services, open and edit the ssjinstallconfig file. The following needs to be updated:
-
Dname – The value should be the server name plus the domain name.
-
installation.destination – The value should be the path where you want to install Systinet (for example: $MAGIC_HOME/ssj).
-
From $MAGIC_HOME/web_services, run installssj to install Systinet.
-
Check for errors after the installation.
Copy support JAR files to the Systinet install folder
-
Copy the following files from $MAGIC_HOME/support to $WASP_HOME/lib:
-
MgSSJ.jar
-
MgRequester.jar
-
saaj_utils.jar
cp -p $MAGIC_HOME/support/MgSSJ.jar $WASP_HOME/lib
cp -p $MAGIC_HOME/support/MgRequester.jar $WASP_HOME/lib
cp -p $MAGIC_HOME/support/saaj_utils.jar $WASP_HOME/lib
-
Change the mode to 644.
Update server.sh
The following changes are required in $WASP_HOME/bin/server.sh:
-
Add the following to the top after the call to env.sh (approximately line 5):
# Step c in installation document
LD_LIBRARY_PATH="$LD_LIBRARY_PATH":$MAGIC_HOME/lib32
-
Change the JAVA call at the bottom of the script by adding the following to the CLASSPATH:
"$WASP_HOME"/lib/MgSSJ.jar:"$WASP_HOME"/lib/MgRequester.jar
.jar:"$WASP_HOME"/lib/saaj_utils.jar
-
Add the following after the CLASSPATH declaration:
-Djava.library.path="$MAGIC_HOME"/lib32
Update File Permissions to Start as a Different User
-
Run the following commands to update the file/folder permissions so that other users besides the owner can start and stop Systinet.
chmod 777 $MAGIC_HOME/ssj/log
chmod 777 $MAGIC_HOME/ssj/log/*
chmod 775 $MAGIC_HOME/ssj/store/hsqldb
chmod 777 $MAGIC_HOME/ssj/store/hsqldb/*
chmod 775 $MAGIC_HOME/ssj
chmod 777 $MAGIC_HOME/ssj/app
chmod 777 $MAGIC_HOME/ssj/app/*
chmod 777 $MAGIC_HOME/ssj/work
-
Start the server from a different account.
-
Re-run the commands in step 1.
Note: If you have issues deploying a JAR file, it is likely permission based. You will need to check the issue in the exception displayed by Systinet and run the chmod command to fix it.
