Starting REST data services in WebSphere Application Server 7.0

This topic describes how to configure and start the eXtreme Scale REST data service using WebSphere Application Server version 7.0. If the WebSphere Application Server installation is integrated with WebSphere eXtreme Scale, see section .

Before you begin

Verify that the sample eXtreme Scale grid is started. See section for details on how to start the grid.

About this task

To get started with the WebSphere eXtreme Scale REST data service using WebSphere Application Server, follow these steps:

Procedure

  1. Download and install WebSphere Application Server Version 7.0 for Developers.

    Restriction: Do not enable security.
  2. Download and install WebSphere Application Server Version 7.0 Fix Pack 5 or later.
  3. Add the WebSphere eXtreme Scale client runtime JAR, wsogclient.jar, and the REST data service configuration JAR or directory to the application server classpath:
    1. Open the WebSphere Administration Console
    2. Navigate Environment > Shared libraries
    3. Click New
    4. Add the following entries into the fields:
      1. Name: extremescale_client_v71
      2. Classpath: /lib/wsogclient.jar
    5. Click OK
    6. Click New
    7. Add the following entries into the appropriate fields:
      1. Name: extremescale_gettingstarted_config
      2. Classpath:
        • /gettingstarted/restclient/bin
        • /gettingstarted/common/bin
      Remember: Add each path on a separate line.
    8. Click OK
    9. Save the changes to the master configuration
  4. Install the REST data service EAR file, wxsrestservice.ear, to the WebSphere Application Server using the WebSphere administration console:
    1. Open the WebSphere administration console
    2. Navigate to Applications > New Application
    3. Browse to the /lib/wxsrestservice.ear, select the file and click Next
    4. Choose the detailed installation options, and click Next
    5. On the application security warnings screen, click Continue
    6. Choose the default installation options, and click Next
    7. Choose a server to map the application to, and click Next
    8. On the JSP reloading page, use the defaults, and click Next
    9. On the shared libraries page, map the "wxsrestservice.war" module to the following shared libraries that were defined during step 3:
      • extremescale_client_v71
      • extremescale_ gettingstarted _config
    10. On the map shared library relationship page, use the defaults, and click Next
    11. On the map virtual hosts page, use the defaults, and click Next
    12. On the map context roots page, set the context root to: wxsrestservice
    13. On the Summary screen, click Finish to complete the installation
    14. Save the changes to the master configuration
  5. Start the application server and the "wxsrestservice" eXtreme Scale REST data service application. After the application is started review the SystemOut.log for the application server and verify that the following message appears: CWOBJ4000I: The WebSphere eXtreme Scale REST data service has been started.
  6. Verify that the REST data service is working
    1. Open a browser and navigate to: http://localhost:9080/wxsrestservice/restservice/NorthwindGrid The service document for the NorthwindGrid is displayed.
    2. Navigate to: http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/$metadata The Entity Model Data Extensions (EDMX) document is displayed.
  7. To stop the grid processes, use CTRL+C in the respective command window.