PrepServer Installation Instructions

From RHESSI Wiki

(Difference between revisions)
Jump to: navigation, search
(Initial Release)
(Initial Release)
Line 7: Line 7:
== Preparations ==
== Preparations ==
-
# Create an unprivileged user and group, e.g. ''prepserver'' with group ''prepserver''
+
# Create an unprivileged user and group, e.g. ''prepserver'' with group ''prepserver''. Make ''prepserver'' available as ''$PREP_USER''
# Create a home directory for user ''prepserver''
# Create a home directory for user ''prepserver''
-
# Download prepserver.jar, prepserver.war, prepserver.libs.zip, and prepserver.properties to a temporary directory
+
# Set ''prepserver'' home directory to ''$PREP_SERVER'' (e.g. ''/home/prepserver'', ''/usr/local/prepserver'', ''C:\Programs\PrepServer'', etc.)
 +
# Download ''prepserver.jar'', ''prepserver.war'', ''prepserver.libs.zip'', ''prepserver.properties'', ''re-startup.csh'', and ''get_idl_path.pro'' to a temporary directory
 +
# Make sure that the Tomcat installation is available at ''$CATALINA_HOME''
-
== Installation ==
+
== Installation (Mac/Unix/Linux) ==
 +
=== PrepServer ===
 +
# Log in as ''prepserver''
 +
# Create the following folders in ''$PREP_SERVER'': ''lib'', ''bin'', ''logs'', ''tmp''
 +
# Copy ''prepserver.jar'' and ''prepserver.properties'' to ''$PREP_SERVER''
 +
# Copy extract Java libraries from ''prepserver.libs.zip'' to ''$PREP_SERVER/lib''
 +
# Copy ''re-startup.csh'' and ''get_idl_path.pro'' to ''$PREP_SERVER/bin''
 +
# Check the [[#Configuration]] section
 +
 
 +
=== Tomcat ===
 +
# Log in as ''prepserver'' or as the appropriate Tomcat user
 +
# Copy ''prepserver.war'' to ''$CATALINA_HOME/webapps''
 +
## If necessary, deploy application ''prepserver.war'' (some systems auto-deploy is disabled)
 +
# Check the [[#Configuration]] section
 +
 
 +
== Configuration ==
 +
=== PrepServer ===
 +
# Edit ''$PREP_SERVER/prepserver.properties''
 +
## Set ''publishing.dir'' to the publicly shared folder in Tomcat (most likely something like ''$CATALINA_HOME/webapps/prepserver/public''. Make sure that ''prepserver'' has read/write access to that folder.
 +
## Set ''publishing.url'' to the web url under which the public folder from the step before is available (e.g. ''http://my.server.com:8080/prepserver/public'').
 +
# Edit ''$PREP_SERVER/bin/re-startup.csh'' and make sure all ''Global Variables'' are set correctly.
 +
# On certain systems the IDL Pre-processing Server may experience an error because of the absence of an active X11 window. See the [[#Troubleshooting]] section.
 +
# Test the installation by running ''$PREP_SERVER/bin/re-startup.csh'' as  ''prepserver'' and checking the logs in ''$PREP_SERVER/logs''. Also see [[PrepServer Maintenance and Diagnostic]].
 +
# To start the PrepServer after a system reboot, add line to ''/_etc/rc.local'' (Linux/Unix) or create a ''Launch Control'' startup item (Mac).
 +
## rc.local
 +
### Log in as root
 +
### Add the line ''su $PREP_USER -c $PREP_SERVER/bin/re-startup.csh''
 +
## Launch Control
 +
### Log in as root
 +
### Download the file ''gov.nasa.prepserver.plist'' and copy it to ''/System/Library/LaunchDaemons''
 +
### Edit ''/System/Library/LaunchDaemons'' to fit your system. Please notice that this file comes with automatic restart of the PrepServer.
 +
# To reboot the PrepServer every day after an SSW update, create a CRON job (Linux/Unix) or a Launch Control startup idem (Mac).
 +
## CRON job
 +
### Log in as root
 +
### Edit the crontab by typing ''crontab -e'' and add ''6 * * * * su $PREP_USER -c $PREP_SERVER/bin/re-startup.csh''
 +
## Mac (if using Launch Control):
 +
### See previous instructions on ''Launch Control''
 +
 
 +
== Troubleshooting ==
 +
Xvfb :7 -screen 0 800x600x8 2>/dev/null &

Revision as of 20:23, 30 August 2010

Contents

Requirements

Preparations

  1. Create an unprivileged user and group, e.g. prepserver with group prepserver. Make prepserver available as $PREP_USER
  2. Create a home directory for user prepserver
  3. Set prepserver home directory to $PREP_SERVER (e.g. /home/prepserver, /usr/local/prepserver, C:\Programs\PrepServer, etc.)
  4. Download prepserver.jar, prepserver.war, prepserver.libs.zip, prepserver.properties, re-startup.csh, and get_idl_path.pro to a temporary directory
  5. Make sure that the Tomcat installation is available at $CATALINA_HOME

Installation (Mac/Unix/Linux)

PrepServer

  1. Log in as prepserver
  2. Create the following folders in $PREP_SERVER: lib, bin, logs, tmp
  3. Copy prepserver.jar and prepserver.properties to $PREP_SERVER
  4. Copy extract Java libraries from prepserver.libs.zip to $PREP_SERVER/lib
  5. Copy re-startup.csh and get_idl_path.pro to $PREP_SERVER/bin
  6. Check the #Configuration section

Tomcat

  1. Log in as prepserver or as the appropriate Tomcat user
  2. Copy prepserver.war to $CATALINA_HOME/webapps
    1. If necessary, deploy application prepserver.war (some systems auto-deploy is disabled)
  3. Check the #Configuration section

Configuration

PrepServer

  1. Edit $PREP_SERVER/prepserver.properties
    1. Set publishing.dir to the publicly shared folder in Tomcat (most likely something like $CATALINA_HOME/webapps/prepserver/public. Make sure that prepserver has read/write access to that folder.
    2. Set publishing.url to the web url under which the public folder from the step before is available (e.g. http://my.server.com:8080/prepserver/public).
  2. Edit $PREP_SERVER/bin/re-startup.csh and make sure all Global Variables are set correctly.
  3. On certain systems the IDL Pre-processing Server may experience an error because of the absence of an active X11 window. See the #Troubleshooting section.
  4. Test the installation by running $PREP_SERVER/bin/re-startup.csh as prepserver and checking the logs in $PREP_SERVER/logs. Also see PrepServer Maintenance and Diagnostic.
  5. To start the PrepServer after a system reboot, add line to /_etc/rc.local (Linux/Unix) or create a Launch Control startup item (Mac).
    1. rc.local
      1. Log in as root
      2. Add the line su $PREP_USER -c $PREP_SERVER/bin/re-startup.csh
    2. Launch Control
      1. Log in as root
      2. Download the file gov.nasa.prepserver.plist and copy it to /System/Library/LaunchDaemons
      3. Edit /System/Library/LaunchDaemons to fit your system. Please notice that this file comes with automatic restart of the PrepServer.
  6. To reboot the PrepServer every day after an SSW update, create a CRON job (Linux/Unix) or a Launch Control startup idem (Mac).
    1. CRON job
      1. Log in as root
      2. Edit the crontab by typing crontab -e and add 6 * * * * su $PREP_USER -c $PREP_SERVER/bin/re-startup.csh
    2. Mac (if using Launch Control):
      1. See previous instructions on Launch Control

Troubleshooting

Xvfb :7 -screen 0 800x600x8 2>/dev/null &

Retrieved from "https://sprg.ssl.berkeley.edu/~tohban/wiki/index.php/PrepServer_Installation_Instructions"
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox