S-PLUS 8 Enterprise Server Installation for UNIX/Linux

The following instructions assume that all components will be installed on the same server. We recommend that you follow these steps in the order shown to ensure a successful installation. If you encounter problems or need additional information about customizing your S-PLUS Enterprise Server installation:

• Contact Insightful Technical Support at support@insightful.com
• Go to S-PLUS Enterprise Server for UNIX/Linux support for current information.
• Read the release notes

Supported Platforms

S-PLUS Enterprise Server is supported on the following versions:

1. Sun Solaris 8/9/10 32-Bit SPARC
2. Red Hat Enterprise Linux 4/5 & SUSE 10 32-bit (x86)
3. Red Hat Enterprise Linux 4/5 & SUSE 10 64-bit (x86-64)

System Requirements

Minimum recommended system requirements:

1. 188 MB disk space to install all the S-PLUS Enterprise Server components on this CD.
2. One or more 1 GHz processors

Installation

The following steps explain how to install the S-PLUS Enterprise Server.

1. Install JRE 5.0 Update 12. If you do not have Java installed, run the JRE installer (located at the top level of your S-PLUS Enterprise Server CD) to install JRE 5.0 Update 12.

2. Install Apache Tomcat 6.0. If you don't have Tomcat installed, extract the files from apache-tomcat-6.0.13.tar.gz using gunzip and tar. Move the unpacked directory to the desired installation location.

3. Install the server application. Run Install_SplusServer.bin on the S-PLUS Enterprise Server CD. Append -i gui to your command line if you wish to install the software using the InstallAnywhere graphical user interface.

   Note 1: Any paths you specify to the installer must be absolute paths, not relative ones.

   Note 2: Please note that the installation process may take a long time to finish, and the status indicator may not move for long periods during the installation. Please be patient.

4. License S-PLUS Enterprise Server. Go to http://keys.insightful.com/ and do the following:
   1. Click I have a License Authorization Code.
   2. Enter the LAC you were provided via email and click Login.
   3. Click Generate Licenses.
   4. Select the appropriate products. In most cases, all products will be selected.
   5. Select LONG under Server Hostid Type.
   6. In the Server Hostid field, enter your Hostid. To obtain your hostid, run the lmhostid script in the FLEXnet directory located in your S-PLUS Enterprise Server installation.
   7. Click Generate.
   8. Click Confirm.
   9. Click Save to File.
   10. Save the license file in the FLEXnet directory located in your S-PLUS Enterprise Server installation.

       If your license manager server is located on a different machine than your S-PLUS Enterprise Server, go to TOMCAT_HOME/conf/Catalina/localhost (where TOMCAT_HOME is your Tomcat installation directory) and edit the SplusServer.xml file, setting the splus.flexnet.host property value to point to the license manager server. By default, this value is set to @localhost, where localhost is the S-PLUS Enterprise Server machine. If you are not on the S-PLUS Enterprise Server and want to access the license manager server, set the system environment variable IFUL_LICENSE_FILE to the value @lmserver, where lmserver is the name of the license manager server.

Service Initialization Scripts

The following information can be used to configure automatic startup of the S-PLUS Enterprise Server-related services when the server boots, and serves as a reference for starting and stopping the services manually.

Open a terminal session on the server and login as root.

Startup links:

Modify the value of X (typically 2, 3, 4, 5) and SPSERVERHOME in the following lines, and copy the following commands to the terminal session. Note: If the FLEXnet license manager is installed on a different machine, do not run the third line (containing flexlm).

X=3
SPSERVERHOME=/opt/IFUL/splusserver80
ln -s $SPSERVERHOME/init.d/flexlm /etc/rc$X.d/S96IFULflexlm
ln -s $SPSERVERHOME/init.d/tomcat /etc/rc$X.d/S97tomcat

Note that you must modify the tomcat file (in the last line above) so that JAVA_HOME is the path of the JRE associated with your Tomcat 6.0 installation.

Shutdown links:

Modify the value of X (typically 0, 1, 6) and SPSERVERHOME in the following lines, and copy the following commands to the terminal session. Note: If the FLEXnet license manager is installed on a different machine, do not run the fourth line (containing flexlm):

X=6
SPSERVERHOME=/opt/IFUL/splusserver80
ln -s $SPSERVERHOME/init.d/tomcat /etc/rc$X.d/K02tomcat
ln -s $SPSERVERHOME/init.d/flexlm /etc/rc$X.d/K03IFULflexlm

Once the Startup and Shutdown links have been established, you can use them to start and stop the services manually.

Start services manually:

Modify the value of X (typically 2, 3, 4, 5) in the first line and copy the following commands to the terminal session. Note: If the FLEXnet license manager is installed on a different machine, do not run the second line (containing IFULflexlm):

X=3
/etc/rc$X.d/S96IFULflexlm start
/etc/rc$X.d/S97tomcat start

Stop services manually:

Modify the value of X (typically 0, 1, 6) in the first line and copy the following commands to the terminal session. Note: If the FLEXnet license manager is installed on a different machine, do not run the third line (containing IFULflexlm):

X=6
/etc/rc$X.d/K02tomcat stop
/etc/rc$X.d/K03IFULflexlm stop

Validating the Installation

Confirm your installation was completed by accessing one of the following URLs.

If you installed the Function Service:

http://localhost:8080/SplusServer/api/function/sqrt?x=64

If you installed the Expression Service (note that you will have to right-click and select View Source to view the result):

http://localhost:8080/SplusServer/api/expression/eval?cmd=6*6

Configuration

Once you have confirmed your installation works correctly, you need to configure the S-PLUS Enterprise Server by setting the properties in TOMCAT_HOME/conf/Catalina/localhost/SplusServer.xml, where TOMCAT_HOME is your Tomcat installation directory. How to set the properties in SplusServer.xml, schedule jobs, install packages and modules, and other details can be found in the S-PLUS Enterprise Server Administration Guide, located at SPSERVERHOME/docs/admin.pdf, where SPSERVERHOME is your S-PLUS Enterprise Server installation directory.