Tomcat Server Stub Installation


Prerequisites

This stub needs to be installed on a Sun Enterprise Server container.

Installation Instructions with Axis

1. The jar file mm_stub.jar is the Managed Methods jar file that needs to be installed as a Handler for the Web service to be managed. You also need to make sure that axis.jar is in the classpath. Axis engine also needs to have a few other libraries in the path. Please visit http://ws.apache.org/axis/java/install.html for more info.

2. Place the jar file from this zip package into the application class path. This could be done by installing the jar files in the /web-inf/lib directory or the <tomcat_home>\shared\lib directory. If you are using Tomcat shipped with JaxView, you may need to copy the files from <jaxView_home>\tomcat\webapps\Hubble\WEB-INF\lib to the shared\lib directory also.

3. Locate the server-config.wsdd file in the web-inf.

4. Insert the following in the server-config.wsdd file for each service you want monitored

<requestFlow>
<handler name="MessageHandlerJaxRpc" type="java:org.apache.axis.handlers.JAXRPCHandler">
<parameter name="hubbleURL" value="http:// <managementServer>:9090"/>
<parameter name="className" value="com.hubble.clientservice.MessageHandlerJaxRpc"/>
</handler>
</requestFlow>
<responseFlow>
<handler name="MessageHandlerJaxRpc" type="java:org.apache.axis.handlers.JAXRPCHandler">
<parameter name="hubbleURL" value="http:/ <managementServer>:9090"/>
<parameter name="className" value="com.hubble.clientservice.MessageHandlerJaxRpc"/>
</handler>

 

Note: you need to replace <managementServer> with the ip address or domain address of the machine that the JaxView management server was installed on. If this is the Tomcat installation shipped with JaxView then use LocalHost.

other parameter for the proxy server authentication are

<parameter name="ProxyUsername" value="username"/>

<parameter name="ProxyPassword" value="password"/>

At this time you need to re-start the application server for the changes to take place.

Installation Instructions without Axis

1. The jar file mm_stub.jar is the Managed Methods jar file that needs to be installed as a Handler for the Web service to be managed.

2. Place the jar file from this zip package into the application class path. This could be done by installing the jar files in the /web-inf/lib directory or the <tomcat_home>\shared\lib directory. If you are using Tomcat shipped with JaxView, you may need to copy the files from <jaxView_home>\tomcat\webapps\Hubble\WEB-INF\lib to the shared\lib directory also.

3. Locate the jaxrpc-ri.xml file in the web-inf/jaxrpc-ri.xml file.

4. Insert the following in thejaxrpc-ri.xml file after <endpoint>

<handlerChains>
<chain runAt="server">
<handler className="com.hubble.clientservice.MessageHandlerJaxRpc">
<property name="hubbleURL" value="http://<managementServer>:9090"/>
</handler>

</chain>
</handlerChains>

 

Note: you need to replace <managementServer> with the IP address or domain address of the machine that the JaxView management server was installed on. If this is the Tomcat installation shipped with JaxView then use LocalHost. For more information on how to install Handler Chains on Tomcat please visit Sun Tutorial

other parameter for the proxy server authentication are

<property name="ProxyUsername" value="username"/>

<property name="ProxyPassword" value="password"/>

 

At this time you need to re-start the application server for the changes to take place.