S-PLUS 8 Enterprise Server Installation for Windows

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:

Supported Platforms

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

  1. Windows Server 2000 (Server and Advanced Server)
  2. Windows Server 2003 (Standard and Enterprise)

System Requirements

Minimum recommended system requirements:

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

S-PLUS Enterprise Server Installation

  1. Install Java 5 Update 12. If you do not have Java installed, double-click jre-1_5_0_12-windows-i586-p.exe (located at the top level of the CD) to install JRE 5 Update 12.

  2. Install Apache Tomcat 6.0. If you do not have Apache Tomcat installed, double-click apache-tomcat-6.0.13.exe (located at the top level of the CD) to install Apache Tomcat 6.0.

  3. Install the server application. Double-click Install_SplusServer.exe (located at the top level of your S-PLUS Enterprise Server CD). This launches an InstallAnywhere wizard that installs the S-PLUS Enterprise Server.

  4. License S-PLUS Enterprise Server. Double-click lmtools.exe in the FLEXnet directory (located in your S-PLUS Enterprise Server installation directory). On the System Settings tab, copy the number in the Disk Volume Serial Number field. Keep the lmtools.exe program running (needed later in this procedure).

    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 e-mail and click Login.
    3. Click Generate Licenses.
    4. Select the appropriate products (in most cases, all products will be selected).
    5. Select DISK_SERIAL_NUM under Server Hostid Type.
    6. In the Server Hostid field, enter your Hostid (or paste the Disk Volume Serial Number noted earlier).
    7. Click Generate.
    8. Click Confirm.
    9. Click Save to File.
    10. Save the license file in the FLEXnet directory.

    In the lmtools.exe program, do the following:

    1. Select the Config Services tab.
    2. Enter IFUL as the Service Name.
    3. Enter the path to the lmgrd.exe file located in the FLEXnet directory.
    4. Enter the path to the license file located in the FLEXnet directory. Do not include the filename or trailing backslash.
    5. Enter the path to the debug log file. We recommend that you use the FLEXnet directory and a filename such as S-PLUS Enterprise Server_FLEXnet.log.
    6. Select the Use Services check box.
    7. Click Save Service.
    8. Click Yes.
    9. Close the lmtools.exe application.

    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 server and want to access the license manager server, you can set the system environment variable IFUL_LICENSE_FILE to the value @license_manager_server.

  5. Start the Services. Go to Start -> Control Panel -> Administrative Tools, select Services. In the Service Manager console, start the services in the following order:
    1. IFUL
    2. Apache Tomcat

    In the Service Manager console, select each service and change Startup Type to Manual. This requires the services to start manually when the server is rebooted, allowing the services to be started in the proper order.

  6. Validate the Installation by confirming you can access 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 SERVERHOME/docs/admin.pdf, where SERVERHOME is your S-PLUS Enterprise Server installation directory.