Web Services API (mPower) Server

JSE/Tomcat: Web Services API Installation

This document assumes you have a working knowledge of JSE and Tomcat. Contact your NetSol representative for more information.

Beginning with LeasePak 6.2a, Web Services API is no longer backwards compatible with versions of JSE prior to 1.6 or versions of Tomcat prior to 6.

JSE Installation and Configuration

To install, refer to Java SE Platform Installation and follow the instructions specific to your operating system.

Tomcat Installation and Configuration

To install, download Tomcat 6 (version 6.x) from the Apache Tomcat site (tomcat.apache.org) and follow the instructions for installing the software.

tomcat6.conf

If you have a tomcat6.conf (or tomcat.conf) file in your CATALINA_HOME/conf directory (CATALINA_HOME represents the root directory of the Tomcat installation on your machine), you may need to edit it for the following environment variables:

JAVA_HOME="java_root_dir"
JAVA_OPTS="-Xmx768M"
CATALINA_HOME="tomcat_root_dir"
JASPER_HOME="tomcat_root_dir"
CATALINA_TMPDIR="tomcat_tmpdir"
TOMCAT_USER="tomcat_user"
SHUTDOWN_WAIT=30
CATALINA_PID=tomcat_pid_file

where java_root_dir is the root directory of the Java installation on your machine (for example, /usr/java/j2sdk1.6.x).

JAVA_OPTS is set to a percentage of the total system memory. In this example, where the server is exclusively an mPower server, JAVA_OPTS is set to 75% of total system memory. System memory is 1 GB, so the variable is set to 768 MB. If you are installing LeasePak and mPower on the same server, adjust the amount accordingly. Contact your NetSol representative for assistance if needed.

The variable tomcat_root_dir is the root directory of the Tomcat installation on your machine (for example, /var/tomcat6), tomcat_tmpdir is the temp file directory under the Tomcat root directory (for example, /var/tomcat6/temp), tomcat_user is the name of the Tomcat user, SHUTDOWN_WAIT is set to 30 seconds (the default), and tomcat_pid_file is the file where the system stores the Tomcat process ID (PID) after Tomcat starts (for example, /var/run/tomcat6.pid.

If the tomcat6.conf file does not exist, you may need to instead edit the Tomcat startup script in /etc/init.d (file will be either tomcat6 or tomcat) to set values for JAVA_HOME and JAVA_OPTS.

Startup and Shutdown Scripts

If you install Tomcat directly (for example, using tar instead of the RPM or package installer), you may just have the script files startup.sh and shutdown.sh in your tomcat_home_dir/bin directory (where tomcat_root_dir is the root directory of Tomcat on your machine--for example, /var/tomcat6). In this case, you will need to use export or setenv to set values for JAVA_HOME and JAVA_OPTS before using these scripts. Contact your NetSol representative for assistance if needed.

Web Services API Installation

To install the mPower software:

1. Stop Tomcat if it is running. For Linux, if you installed Tomcat using the RPM, use the service tomcat4 stop command. Otherwise, use the shutdown.sh script in the tomcat_root_dir/bin directory.
2. Copy the file mpower-v76a.war to the CATALINA_HOME/webapps directory (CATALINA_HOME represents the root directory of the Tomcat installation on your machine).
3. Execute the following commands:

   cd CATALINA_HOME/webapps
   mkdir mpower-v76acd mpower-v76a$JAVA_HOME/bin/jar -xvf (path to war file)/mpower-v76a.war
   

   where $JAVA_HOME represents the root directory of your Java installation.