mPower Server: Tomcat Platform

Describes platform configuration and software installation for the mPower server on Tomcat.

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

LinkIT Deployment

If you are using the LeasePak API, create a Bourne shell script similar to the following, using your directories, host name, and port number:

	#! /bin/sh

	# this is the web service you are going to deploy
	DEPLOYFILE=$1

	# the name of the contextroot
	SERVICE_NAME=mpower-ver_vnna

	# the directory you created
	SERVICE_DIR=mpower-ver_vnna

	# the name of the host
	HOST=http://host.domain.suffix

	# the port that the service is on; default install is 8080
	PORT=port_number

	#tomcat4 INSTALL_BASE
	TOMCAT_BASE=tomcat_root_dir

	# base path to java home
	JAVA_HOME=java_root_dir

	# mpower base is the location of the actual service on the filesystem
	MPOWER_BASE=$TOMCAT_BASE/webapps/$SERVICE_DIR

	# mpower libs is the location within mpower_base of the api required libraries
	MPOWER_LIBS=$MPOWER_BASE/WEB-INF/lib

	# this should not change
	CLASSPATH=$JAVA_HOME/lib/tools.jar
	for  APIFILE in $MPOWER_LIBS/*.jar ; do
	    CLASSPATH=$CLASSPATH:$APIFILE
	done

	$JAVA_HOME/bin/java -classpath "$CLASSPATH" org.apache.axis.client.AdminClient -l$HOST:$PORT/$SERVICE_NAME/services/AdminService $DEPLOYFILE
	

where host.domain.suffix is the URL or IP of your mPower host, port_number is the port for Tomcat, tomcat_root_dir is the root directory of the Tomcat installation on your machine, and java_root_dir is the root directory of Java.

The contextroot is a virtual URI that, in combination with the server portion of the full URL, directs a client's request to the correct Web application server. In the case of LinkIT, this is normally mpower-ver_vnna.

Name the script mpower_ws.sh and save it to your mPower WEB-INF/config/service/style directory, where service is the name of the service and style is either DOC for MsiAppOriginatorDocLit or RPC for MsiAppOriginator (the other services will not have this additional directory level).

You can deploy either the Document-Literal service, the RPC-Encoded service, or both.

Change directory (cd) to your WEB-INF/config/service/style directory and run the script for each service you wish to deploy. For example:

mpower_ws.sh MsiAppOriginator/DOC/deploy.wsdd

mpower_ws.sh MsiAppExtractor/deploy.wsdd

(and so forth). You should only have to do this once, unless additional methods are added to a service. Contact your NetSol representative for more information.