Installing and starting the ECRTP Web service

Use the ECRTP Web Services API to install and deploy RTPProcessor, the ECRTP Web service component.

Before you install RTPProcessor:

  1. Install Java SDK 1.5 or Java JRE 1.5.

  2. Install Apache Tomcat 5.0.28 or higher – you must run Apache Tomcat web server on “localhost” at port 8080. If your web server is on a different host or port number, replace references to localhost and port number 8080 with your own host name and port number. Download the Apache Tomcat installation package from the Apache Tomcat Web site. Ensure that you download the latest package and refer to the documentation for Apache Tomcat before installation.

  3. Install Apache Axis 1.4 and verify the installation. Download the Apache Axis installation package from the Apache Axis Web site. Ensure that you download the latest package and refer to the documentation for Apache Axis before installation.

  4. Install ECRTP 5.1.

  5. Verify that the PATH environment variable in Windows contains the location of the callrtpo.dll and owrm32c.dll files.

In the procedures that follow:

StepsInstalling RTPProcessor

  1. Stop the Apache Tomcat web server.

  2. Copy the axis directory in %AXIS%\webapps into the %CATALINA%\webapps directory.

  3. Rename the axis directory in %CATALINA%\webapps to sybase. This is because the default URL for RTPProcessor is http://localhost:8080/sybase/services/RTPProcessor.

    NoteIf you rename axis to something other than sybase, change all occurrences of sybase to the name you used, in any file that refers to the URL. The name you choose forms part of the URL that clients use to access your Web service.

  4. Copy all of the files from %SYBASE%\ECRTP_WS\classes to %CATALINA%\webapps\sybase\WEB-INF\classes.

  5. Copy %SYBASE%\ECRTP_JNI\lib\ecrtp.jar to %CATALINA%\webapps\sybase\WEB-INF\lib.

  6. Start the Apache Tomcat web server.

The batch files to start and stop RTPProcessor use Apache Axis AdminClient. See the Apache Axis documentation for more information about AdminClient.

StepsStarting RTPProcessor

  1. Edit %SYBASE%\ECRTP_WS\SETAXIS.BAT for your environment.

  2. Edit dep_rtpws.bat in %SYBASE%\ECRTP_WS for your environment. You must also edit the URL that is in dep_rtws.bat.

  3. Open a command prompt window and run dep_rtws.bat.

  4. Verify that the RTPProcessor web service is running correctly by opening the “http://localhost:8080/sybase/services” URL in your web browser, and verifying that you can see the RTPProcessor service, and the available web service methods. See the Javadoc files which are provided as part of the ECRTP installation for more information about the web service methods.

StepsStopping RTPProcessor

  1. Edit %SYBASE%\ECRTP_WS\SETAXIS.BAT for your environment.

  2. Edit %SYBASE%\ECRTP_WS\undep_rtpws.bat for your environment. You must also edit the URL that is in undep_rtws.bat.

  3. Open a command prompt window and run undep_rtws.bat.

  4. Verify that the RTPProcessor web service has stopped by opening the “http://localhost:8080/sybase/services” URL in your web browser, and verifying that you cannot see the RTPProcessor service.