Opticentre Opticentre

Installing WorldServer on Solaris or Linux

Idiom Frequently asked questions

  1. Home
  2. faq
  3. idiom
  4. Installing WorldServer on Solaris or Linux

Installing WorldServer on Solaris or Linux?

This section explains the steps necessary to install WorldServer on a Solaris or Linux server.

Install WorldServer

  • Confirm Java 1_4_2_xx is installed on the Solaris or Linux machine, or that the machine has access to the Java 1_3_1_09 installation.
  • Confirm JAVA_HOME is set as an environment variable.
  • Confirm ORACLE_HOME is set as an environment variable.
  • Create a directory for WorldServer on the Solaris or Linux machine (i.e., "WS_7_5")
  • Copy ws.tar to the directory created in the previous step.
  • Extract the contents of ws.tar.
    tar –xf ws.tar
  • Set the following environment variables (examples are for Shell):
    export WS_HOME=[path to the directory created in Step 4, above]
    export PATH=$WS_HOME/bin:$PATH
    export LD_LIBRARY_PATH=$WS_HOME/lib:$LD_LIBRARY_PATH
    export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
    export NLS_LANG=AMERICAN_AMERICA.UTF8
  • Copy jakarta-tomcat-4.1.27.zip to the WorldServer directory, and extract
    the contents of jakarta-tomcat-4.1.27.zip to this directory.
  • Copy ws.war into ../jakarta-tomcat-4.1.27/webapps.
    cp ws.war jakarta-tomcat-4.1.27/webapps
  • Navigate to jakarta-tomcat-4.1.27/bin, and start Tomcat to extract the contents of ws.war:
    startup.sh
  • After Tomcat is started, shut down Tomcat:
    shutdown.sh
  • Move general properties from
    WS_HOME/tomcat/webapps/ws/WEBINF/classes/config to < user.home > /etc.
  • Copy Classes12.zip from Oracle installation to WS installation (renaming to "classes12.jar"):
    cp $ORACLE_HOME/jdbc/lib/classes12.zip $TOMCAT_HOME/webapps/ws/WEB-INF/lib/classes12.jar
  • Edit general.properties file to use the appropriate database driver and database username/password, as well as the appropriate directories for temp file, rcs root, and WorldServer log file.


Cross-Platform Database Configuration
If you have WorldServer installed on Solaris or Linux and will use a SQL database, follow the configuration steps in this section. If you have the SQL Server client tools installed, complete the following steps to seed the Database:

  • Create a database for WorldServer via the SQL Server Enterprise Manager (no special configuration is required, just accept the defaults when creating the database). If IT has already done this for you, they need to provide you with the database name, server, and login information.
  • Start the SQL Server Query Analyzer, log in, and select the database.
  • Run create.ms.sql
  • Run setup.ms.sql
  • Run create_sp.ms.sql and create_tr.ms.sql
  • Start Tomcat ($TOMCAT_HOME/bin/startup.sh)
    NOTE: If you want to configure the application server that WorldServer is using to use SSL, consult the SSL setup instructions for the application server that they are using.

    Comments