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.