Product overview > Tutorials, examples, and samples > REST data services sample and tutorial > Configure application servers for the REST data service



Start REST data services in Apache Tomcat

This topic describes how to configure and start the eXtreme Scale REST data service using Apache Tomcat, version 5.5 or later.


Before you begin

Verify that the sample eXtreme Scale data grid is started. See Enable the REST data service for details on how to start the data grid.


Procedure

  1. Download and install Apache Tomcat Version 5.5 or later to tomcat_root. For example: /opt/tomcat

  2. Install the eXtreme Scale REST data service and the provided sample into the Tomcat server as follows:

    1. If you are using a Sun JRE or JDK, install the IBM ORB into Tomcat:

      • For Tomcat version 5.5

        Copy all of the JAR files from:

        wxs_home/lib/endorsed

        to

        tomcat_root/common/endorsed

      • For Tomcat version 6.0

        1. Create an "endorsed" directory

          • [Unix][Linux] mkdir tomcat_root/endorsed

          • [Windows] md tomcat_root/endorsed

        2. Copy all of the JAR files from:

          wxs_home/lib/endorsed

          to

          tomcat_root/endorsed

    2. Deploy the REST data service module: wxsrestservice.war to the Tomcat server.

      Copy the wxsrestservice.war file from:

      restservice_home/lib

      to:

      tomcat_root/webapps

    3. Add the ObjectGrid client runtime JAR and the application JAR to the shared classpath in Tomcat:

      1. Edit the tomcat_root/conf/catalina.properties file

      2. Append the following path names to the end of the shared.loader property in the form of a comma-delimited list:

        • wxs_home/lib/ogclient.jar

        • restservice_home/gettingstarted/restclient/bin

        • restservice_home/gettingstarted/common/bin

        The path separator must be a forward slash.


  3. If the eXtreme Scale data grid was started with eXtreme Scale security enabled, set the following properties in the restservice_home/gettingstarted/restclient/bin/wxsRestService.properties file.

    ogClientPropertyFile=restservice_home/gettingstarted/security/security.ogclient.properties
    loginType=none
    

  4. Start the Tomcat server with the REST data service:

    • If using Tomcat 5.5 on UNIX or Windows, or Tomcat 6.0 on UNIX:

      1. cd tomcat_root/bin

      2. Start the server:

        • [Unix][Linux] ./catalina.sh run

        • [Windows] catalina.bat run

      3. The console then displays the Apache Tomcat logs. When the REST data service has started successfully, the following message is displayed in the administration console:

        CWOBJ4000I: The WebSphere eXtreme Scale REST data service has been started.

    • If using Tomcat 6.0 on Windows:

      1. cd tomcat_root/bin

      2. Start the Apache Tomcat 6 configuration tool with the following command: tomcat6w.exe

      3. Click on the Start button on the Apache Tomcat 6 properties window to start the Tomcat server.

      4. Review the following logs to verify that the Tomcat server has started successfully:

        • tomcat_root/bin/catalina.log

          Displays the status of the Tomcat server engine

        • tomcat_root/bin/stdout.log

          Displays the system output log.

      5. When the REST data service has started successfully, the following message is displayed in the system output log: CWOBJ4000I: The WebSphere eXtreme Scale REST data service has been started.

  5. Verify that the REST data service is working:

    1. Open a browser and navigate to:

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid

      The service document for the NorthwindGrid is displayed.

    2. Navigate to:

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata

      The Entity Model Data Extensions (EDMX) document is displayed.

  6. To stop the data grid processes, use CTRL+C in the respective command window.

  7. To stop Tomcat, use CTRL +C in the window in which you started it.


Parent topic:

Configure application servers for the REST data service


Related tasks

Start REST data services in WAS v7.0

Start REST data services with WebSphere eXtreme Scale integrated in WAS 7.0

Start the REST data service in WAS Community Edition