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 Enabling the REST data service for details on how to start the data grid.
About this task
To get started with the WebSphere
eXtreme Scale REST data service using WebSphere Application Server, follow these steps:
Procedure
- Add the WebSphere
eXtreme Scale REST data service sample configuration JAR to the
classpath:
- Open the WebSphere Administration
Console
- Navigate to Environment -> Shared libraries
- Click New
- Add the following entries into the appropriate fields:
- Name: extremescale_gettingstarted_config
- Classpath
- restservice_home/gettingstarted/restclient/bin
- restservice_home/gettingstarted/common/bin
Remember: Each path must appear on a different line.
- Click OK
- Save the changes to the master configuration
- Install the REST data service EAR file, wxsrestservice.ear, to the WebSphere Application Server using the WebSphere administration console:
- Open the WebSphere administration
console
- Navigate to Applications -> New Application
- Browse to restservice_home/lib/wxsrestservice.ear file on the
file system. Select the file and click Next.
- Choose the detailed installation options, and click Next.
- On the application security warnings screen, click Continue.
- Choose the default installation options, and click Next.
- Choose a server to map the wxsrestservice.war module to, and click
Next.
- On the JSP reloading page, use the defaults, and click Next.
- On the shared libraries page, map the "wxsrestservice.war" module to the following
shared libraries that were defined during step 1: extremescale_ gettingstarted
_config
- On the map shared library relationship page, use the defaults, and click
Next.
- On the map virtual hosts page, use the defaults, and click
Next.
- On the map context roots page, set the context root to:
wxsrestservice.
- On the Summary screen, click Finish to complete the
installation.
- Save the changes to the master configuration.
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
- 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.
- Verify that the REST data service is working:
- Open a browser and navigate to:
http://localhost:9080/wxsrestservice/restservice/NorthwindGrid
The service document for the NorthwindGrid is displayed.
- Navigate to:
http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/$metadata
The Entity Model Data Extensions (EDMX) document is displayed
- To stop the data grid processes, use CTRL+C in the respective command window to stop the
process.