Deploying the Example on a Machine Without the IBM WSTK

If you have TomCat and Apache SOAP, you can still deploy and run this example. However, the Apache SOAP package does not contain all the necessary .jar files, and it also does not mention some the files that you must have in order to deploy a Web service. Refer to Library Files to see a complete list of jar files that you need to run a Web service on TomCat.

1. Modify the tomcat.bat

2. Create a batch file to set the environment variables.

3. Go to the bin directory of your TomCat installation directory.

4. Run the typical batch file to setup the environment variables.

5. Start the TomCat server by entering the command

   startup

6. There are two ways to deploy a Web Service on TomCat: using the Apache SOAP admin tool, or manual deployment.

   • Using the Apache SOAP Admin Tool to deploy the Excel Calculator Web Service

     1. Open a Web browser and enter the URL http://hostname:port/soap/admin

        Note Replace the hostname and port with appropriate hostname and and port. (For example, localhost:8080)

        

     2. Click Deploy.

        

     3. Enter urn:ExcelCalculatorWebService as the ID.

        Select Application as the Scope.

        Enter plus minus times divide as the Methods.

        Enter samples.excelwebservice.ExcelCalculatorWebService as the Provider Class.

     

     4. Scroll down and click Deploy at the bottom of the form.

   • Manual Deployment

     In order to deploy a Web service manually, you need a deployment descriptor file—an XML file that describes the Web service.

     1. Create the file DeploymentDescriptor.xml by cutting and pasting the following text from your Web browser. This file is included in your jintegra/examples/SOAP-COM directory when you download J-Integra®.

     Here is the file.

     <isd:service xmlns:isd="http://xml.apache.org/xml-soap/deployment" id="urn:ExcelCalculator"> <isd:provider type="java" scope="Application" methods="plus minus times divide"> <isd:java class="samples.excel.ExcelExample" static="false"/> </isd:provider> <isd:faultListener>org.apache.soap.server.DOMFaultListener</isd:faultListener> </isd:service>

     
     

     2. Copy DeploymentDescriptor.xml into the D:\Pure directory.

     3. Open a DOS session and go to D:\Pure.

     4. Run the typical batch file to set the environment variables.

     5. Enter the following command to deploy the Excel Calculator Web Service:

        java org.apache.soap.server.ServiceManagerClient http://localhost:8080/soap/servlet/rpcrouter deploy DeploymentDescriptor.xml

7. Proceed to Running the Example on a Machine Without the IBM WSTK.