Running the Axis Server for WSSConnector Service

Package contents

• axisServer.sh(.bat) - Shell script to start the AXIS Simple Web Server
• setenv.sh(.bat) - Shell script to configure classpath and other system variables
• deploy.wsdd - If required to change the default configuration
• server-config.wsdd - Current deployed configuration.
  NOTE: Redeployment is necessary when changing context modes (ASYNC <-> SYNC).
  DELETE THIS FILE AND use setup.sh(.bat) to redeploy !
  Refer pt. 5 here
• lib/ - folder containing support jars

Additional configuration

#!/bin/sh

# Set inputs

# Set default port = 9090
port=9090;

while getopts p: o
do      case "$o" in
        p)      port=$OPTARG;;
        [?])    ;;
        esac
done

# Set Paths
. setenv.sh

SERVICE_JARS=`echo lib/*.jar | tr ' ' ':'`;

java 	-Dlog4j.props="$HPSEARCH_HOME/conf/log4j.properties" 		\
		-Dnb.config="$NB_HOME/config/ServiceConfiguration.txt" 	\
		-classpath $JARS:$CLASSPATH:$SERVICE_JARS 		\
		org.apache.axis.transport.http.SimpleAxisServer 	\
		-p $port
	

NOTES
• Assumes that the HPSEARCH_HOME and NB_HOME variables are correctly set in the included file setenv.sh(.bat) Refer Installation instructions for settings !
• -p options specifies what port to run the service on.
  E.g., If the port is set to be 5600, then the service WSDL is
  http://host:5600/axis/services/WSSConnector?wsdl
• Additional options Required, IF Broker does not run on same host and default port (NIOTCP port 3045).
  -Dbroker.host=xxx - Specifies the host on which the broker runs
  -Dbroker.port=xxx - Specifies the port on which the broker accepts NIOTCP connections
  
  Note: Currently only NIOTCP supported by default. If other transport is desired, then it must be explicitly specified in the topic:// uri, For E.g.
  topic://protocol://host:port/topic_to_use

Deploying services using HPSEARCH version 1.0.1.2 or later

Steps to follow
1. Copy the HPSEARCH_HOME/services folder to lets say /path/to/NEW/service
2. If you already run services with an older version of hpsearch, copy old /path/to/old/service/lib/* files into the new /path/to/NEW/service/lib folder.
   ELSE
   copy all the support jars required to deploy the service in /path/to/NEW/service/lib folder.

3. Set the values of HPSEARCH_HOME and NB_HOME in /path/to/NEW/service/setenv.sh(.bat) file
4. The new verison comes with a parameter -p to specify a port on command line rather than editing the .sh(.bat) file
   Default port is 9090. To run on different port (say 5600) use
   ./axisServer -p 5600
5. If the file /path/to/NEW/service/server-config.wsdd is deleted, then you can recreate this file by opening a new shell and typing
   ./setup.sh <port>
   where port is the port on which the axis server is running (using the -p <port> option) on the current machine.

(back to Notes)