Apache Tomcat Web Server Installation

The following instructions detail how to download and install the Apache Tomcat web server files.

The files to install the Apache Tomcat Web server is named de-jakarta.tar.gz and the directory that the files install to is named de-jakarta.

Download/Install

The following shows the steps for downloading and installing the files for the web server:

  1. Log in as the LIM DBA user and type:

    cd $LIMHOME
  2. Go to the LIM “Downloads” page and download the file: de-jakarta.tar.gz.

    When you unzip the de-jakarta.tar.gz file the files will install into the de-jakarta directory.

  3. Unzip and untar the de-jakarta.tar.gz file.

    gunzip –c de-jakarta.tar.gz | tar xf -
  4. The server is setup to start on port 9090. To modify the port setting edit the configuration file server.xml located at: $LIMHOME/de-jakarta. Please see the Tomcat web server documentation at: tomcat.apache.org if you need assistance in modifying the port setting.

  5. Check that the ~/.limrc file contains the following two line lines after PORT has been set. Ensure that the JAVA_HOME and the JAVA_OPTS variables have been exported in the last line of the ~/.limrc file. It may be necessary to change the environment variable JAVA_HOME to point to your Java Development Kit installation if it does not reside in: /usr/java.

    JAVA_HOME=/usr/java 
    JAVA_OPTS="-Dlim.mimport=`echo $PORT | sed 's/\-p //'`" 
    export LIMHOME XMIMHOME XMIMRC PATH LD_LIBRARY_PATH NOTICES CUSTNAME PORT XMIM_LOCALE 
    LC_ALL 
      JAVA_HOME JAVA_OPTS
  6. Verify that the highlighted lines in the following script are in your initialization script located in /etc/init.d/xmimserver:

    Example initialization file:

    #  Startup/Shutdown script for XMIM Server at boot/shutdown time.
    
    #  Create S98xmimserver in /etc/rc2.d. 
    #  Create a hard link to /etc/rc0.d/K07xmimserver and 
    #  /etc/init.d/xmimserver 
    #  cd /etc/rc0.d; ln ../rc2.d/S98xmimserver K07xmimserver 
    #  cd /etc/init.d; ln ../rc2.d/S98xmimserver xmimserver 
    # 
    #  Be sure that $LIMHOME/xmim/bin/server.info has been created. 
    #  Be sure and set LIMHOME and LIMUSER 
    #
    
    LIMHOME=/home/lim
    LIMUSER=lim
    
    mode=$1
    usage_error() {
          echo "  $0 start             (start XMIM Server)"
          echo "  $0 stop              (stop XMIM Server)"
          echo " "
    }
    
    if [ ! -d $LIMHOME ]
    then                    # /home/lim not mounted
            exit 1
    fi
    
    set `/usr/bin/id`
    if [ $1 != "uid=0(root)" ]; then
            echo "$0: must be run as root"
            exit 1
    fi
    case "$mode" in
    'start')
    
            if [ -x $LIMHOME/xmim/bin/start.server ] ; then
                    su $LIMUSER -c "$LIMHOME/xmim/bin/start.server"
            fi
            if [ -x $LIMHOME/apache/bin/apachectl ] ; then
                    su $LIMUSER -c "$LIMHOME/apache/bin/apachectl start"
            fi
            if [ -x $LIMHOME/de-jakarta/bin/startup.sh ] ; then
                    su $LIMUSER -c "$LIMHOME/de-jakarta/bin/startup.sh"
            fi
            ;;
    'stop')
            if [ -x $LIMHOME/xmim/bin/server.info ] ; then
                    su $LIMUSER -c "$LIMHOME/xmim/bin/server.info -k"
            fi
            if [ -x $LIMHOME/apache/bin/apachectl ] ; then
                    su $LIMUSER -c "$LIMHOME/apache/bin/apachectl stop"
            fi
            if [ -x $LIMHOME/de-jakarta/bin/shutdown.sh ] ; then
                    su $LIMUSER -c "$LIMHOME/de-jakarta/bin/shutdown.sh"
            fi
            ;;
    *)
            usage_error
            exit 1
            ;;
    esac
    exit 0