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



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

This topic describes how to configure and start the eXtreme Scale REST data service using WebSphere Application Server version 7.0 that has been integrated and augmented with WebSphere eXtreme Scale.


Before you begin

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

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


Procedure

  1. Add the WebSphere eXtreme Scale REST data service sample configuration JAR to the classpath:

    1. Open the WebSphere Administration Console

    2. Navigate to Environment -> Shared libraries

    3. Click New

    4. Add the following entries into the appropriate fields:

      1. Name: extremescale_gettingstarted_config

      2. Classpath

        • restservice_home/gettingstarted/restclient/bin

        • restservice_home/gettingstarted/common/bin

        Remember: Each path must appear on a different line.

    5. Click OK

    6. Save the changes to the master configuration

  2. 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 restservice_home/lib/wxsrestservice.ear file on the file system. 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 wxsrestservice.war module 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 1: 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.


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

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

  4. 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.

  5. 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

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


Parent topic:

Configure application servers for the REST data service


Related tasks

Start REST data services in WAS v7.0

Start the REST data service in WAS Community Edition

Start REST data services in Apache Tomcat