This topic describes how to configure the WebSphere® eXtreme Scale REST data service on WebSphere Application Server or WebSphere Application Server Network Deployment Version or later.
These instructions also apply to deployments whereWebSphere eXtreme Scale is integrated with
the WebSphere Application Server deployment.
Before you begin
You must have one of the following environments
on your system
to configure and deploy the REST data service for
WebSphere eXtreme Scale.
- WebSphere Application Server with the stand-alone WebSphere eXtreme Scale client:
- The WebSphere eXtreme Scale Trial Version
7.1 with the REST data service is downloaded and extracted or theWebSphere eXtreme Scale Version 7.1.0.0 with
cumulative fix 2 product is installed into a stand-alone directory.
- WebSphere Application Server Version 7.0.0.5
or later is installed and running.
- WebSphere Application Server integrated with WebSphere eXtreme Scale:
WebSphere eXtreme Scale Version 7.1.0.0 with
cumulative fix 2 or later is installed on top of WebSphere Application Server Version 7.0 or
later.
Tip: The WebSphere eXtreme Scale REST data service only
requires that the WebSphere eXtreme Scale client option be installed. The profile does not need to be augmented.
Read about how to enable Java™ 2 security in the WebSphere Application Server information center.
Procedure
- Configure and start a data grid.
- For
details on configuring a data grid for use with
the REST data service, see Starting a data grid for REST data services in WebSphere Application Server.
- Verify that a client can connect to and access
entities
in the data grid. For an example, see Tutorial: Getting started with WebSphere eXtreme Scale.
- Build the eXtreme Scale REST service configuration
JAR or directory. See the information
about packaging and deploying the REST service in Installing the REST data service.
- Add the REST
data service configuration JAR or directory
to the application server classpath:
- Open the WebSphere Application Server administrative
console
- Navigate to
- Click New
- Add the following entries into the appropriate
fields:
- Name: extremescale_rest_configuration
- Classpath: <REST service configuration jar or directory>
- Click OK
- Save the changes to the master configuration
- Add the WebSphere eXtreme Scale client runtime JAR, wsogclient.jar, and the
REST data service configuration JAR or directory to the application
server classpath. This step is not necessary if WebSphere eXtreme Scale is integrated with
the WebSphere Application Server installation.
- Open theWebSphere Application Server administrative
console.
- Navigate to .
- Click New.
- Add the following entries into the fields:
- Name: extremescale_client_v71
- Classpath:
wxs_home/lib/wsogclient.jar
Remember: Add each path on a separate 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
administrative console:
- Open the WebSphere Application Server administrative console.
- Click .
- Browse to the /lib/wxsrestservice.ear file on the file system and select it and click Next.
- If using WebSphere Application Server Version 7.0, click Next.
- Choose the detailed installation option, 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 application 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 shared libraries that you defined:
- extremescale_rest_configuration
- extremescale_client_v71
Tip: This
shared library is required only if WebSphere eXtreme Scale is not integrated with WebSphere Application Server.
- 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.
- Start the wxsrestservice REST data
service application:
- Go to the application
in the administrative console.
- WebSphere Application Server Version 7.0:
In the administrative console, click .
- Check the check box next to the wxsrestservice application, and click Start.
- 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.
- 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.
For example: 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.