Administration guide > Configure the deployment environment > Configuring the REST data service > Install the REST data service



Deploy the REST data service on WAS

This topic describes how to configure the WebSphere eXtreme Scale REST data service on WAS orWAS ND v6.1.0.25 or later. These instructions also apply to deployments whereWebSphere eXtreme Scale is integrated with the WAS deployment.


Before you begin

You must have one of the following environments on the system to configure and deploy the REST data service for WebSphere eXtreme Scale.


Procedure

  1. Configure and start a data grid.

    1. For details on configuring a data grid for use with the REST data service, see Configure the deployment environment.

    2. Verify that an eXtreme Scale client can connect to and access entities in the data grid. For an example, see Run the getting started sample application.

  2. Build the eXtreme Scale REST service configuration JAR or directory. See the information about packaging and deploying the REST service in Install the REST data service.

  3. Add the REST data service configuration JAR or directory to the application server classpath:

    1. Open the WAS administrative console

    2. Navigate to Environment > Shared libraries

    3. Click New

    4. Add the following entries into the appropriate fields:

      • Name: extremescale_rest _configuration

      • Classpath: <REST service configuration jar or directory>

    5. Click OK

    6. Save the changes to the master configuration

  4. If WebSphere eXtreme Scale is integrated with the WAS installation, skip this step and proceed to step 5. Otherwise, continue:

    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 theWAS administrative console

    2. Navigate to Environment > Shared libraries

    3. Click New

    4. Add the following entries into the fields:

      • Name: extremescale_client_v71

      • Classpath: wxs_home/lib/wsogclient.jar

    5. Click OK

    6. Save the changes to the master configuration

  5. Install the REST data service EAR file, wxsrestservice.ear, to the WAS using the administrative console:

    1. Open the WAS administrative console

    2. Navigate to Applications > New application

    3. Browse to the /lib/wxsrestservice.ear file on the file system and select it and click Next.

      • If using WAS version 7.0, click Next.

      • If using WAS version 6.1, enter a Context Root value with the name: /wxsrestservice and continue to the next step.

    4. Choose the detailed installation option, 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 defined in steps 3 and 4:

      • extremescale_rest_configuration

      • extremescale_client_v71

      Tip: This shared library is required only if WebSphere eXtreme Scale is not integrated with WAS.

    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.

  6. Start the "wxsrestservice" WebSphere eXtreme Scale REST data service application:

    1. Choose application

      • If using WAS version 7.0: In the administrative console, click onApplications > Application Types > WebSphere Applications

      • If using WAS version 6.1: In the administrative console, click on ApplicationsEnterprise Applications.

    2. Check the check box next to the "wxsrestservice " application, and click Start.

    3. Review the SystemOut.log file for the application server profile. When the REST data service has started successfully, the following message is displayed in the SystemOut.log file for the server profile:

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

  7. Verify the REST data service is working: The port number can be found in the SystemOut.log file within the application server profile logs directory by looking at the first port displayed for message identifier: SRVE0250I. The default port is 9080.

    For example: http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/ Result: The AtomPub service document is displayed.


Parent topic:

Install the REST data service


Related tasks

Deploy the REST data service on WAS Community Edition

Deploy the REST data service on Apache Tomcat

Secure the REST data service

Configure the REST data service

Administer the REST data service

Install the REST data service

Related reference

REST data service properties file