Starting the REST data service in WebSphere Application Server Community Edition

This topic describes how to configure and start the eXtreme Scale REST data service using WebSphere Application Server Community Edition.

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 Community Edition (CE), follow these steps:

Procedure

  1. Download and install WebSphere Application Server CE 2.1.1.3 or later to. For example: /opt/IBM/wasce
  2. Start the WebSphere Application Server CE server by running the following command:
    • [Linux][Unix] /bin/startup.sh
    • [Windows] /bin/startup.bat
  3. Install the eXtreme Scale REST data service and the provided sample into the WebSphere Application Server CE server:
    1. Add the ObjectGrid client runtime JAR to the WebSphere Application Server CE repository:
      1. Open the WebSphere Application Server CE administration console and log in.
        Tip: The default URL is: http://localhost:8080/console. The default userid is "system" and password is "manager".
      2. Click the "Repository" link on the left side of the console window, in the Services folder.
      3. In the "Add Archive to Repository" section, fill in the following into the input text boxes:
        Table 1. Archive to repository
        Text box Value
        File /lib/ogclient.jar
        Group com.ibm.websphere.xs
        Artifact ogclient
        Version 7.0
        Type jar
      4. Click the Install button.
        Tip: See the following tech note for details on different methods of configuration class and library dependencies: http://www.ibm.com/support/docview.wss?uid=swg21266061
    2. Deploy the REST data service module: wxsrestservice.war to the WebSphere Application Server CE server.
      1. Edit the sample /gettingstarted/wasce/geronimo-web.xml deployment XML file to include path dependencies to the getting started sample classpath directories:
        Change the "classesDirs" for the two getting started client GBeans:
        • The "classesDirs" path for the GettingStarted_Client_SharedLib GBean should be set to: /gettingstarted/restclient/bin
        • The "classesDirs" path for the GettingStarted_Common_SharedLib GBean should be set to: /gettingstarted/common/bin

      2. Open the WebSphere Application Server CE administration console and log in.
        Tip: The default URL is: http://localhost:8080/console and the default userid is "system" and password is "manager".
      3. Click on the "Deploy New" link on the left side of the console window.
      4. On the "Install New Applications" page, enter the following values into the text boxes:
        Table 2. Installation values
        Text box Value
        Archive /lib/wxsrestservice.war
        Plan /gettingstarted/wasce/geronimo-web.xml
      5. Click on the Install button.

        The console page should indicate that the application was successfully installed and started.

      6. Examine the WebSphere Application Server CE system output log or console to verify that the REST data service has started successfully by verify that the following message is present:

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

  4. 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 grid is displayed.
    2. Navigate to: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata The Entity Model Data Extensions (EDMX) document is displayed.
  5. To stop the grid processes, use CTRL+C in the respective command window to stop the process.
  6. To stop WebSphere Application Server CE, use the following command:
    • [Unix][Linux] /bin/shutdown.sh
    • [Windows] \bin\shutdown.bat
    Tip: The default userid is "system" and password is "manager". If using a custom port use the -port option.