This topic describes how to configure the eXtreme Scale
REST data service on WebSphere Application Server or WebSphere Network
Deployment Version 6.1.0.25 or later. These instructions also apply
to deployments where WebSphere 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 eXtreme Scale
client:
- The WebSphere eXtreme Scale Trial Version 7.1 with the REST data
service is downloaded and extracted or the WebSphere eXtreme Scale
7.1.0.0 with cumulative fix 2 product is installed into a stand-alone
directory.
- WebSphere Application Server Version 6.1.0.25 or 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 is installed on top of WebSphere Application Server Version 6.1.0.25
or 7.0 (or later).
Tip: The eXtreme Scale REST data
service only requires that the eXtreme Scale client option be installed.
The profile does not need to be augmented.
Read about how to enable Java security in the WebSphere Application
Server information center.
Procedure
- Configure and start an eXtreme Scale grid.
- For details on configuring an eXtreme Scale grid for
use with the REST data service, see the topic.
- Verify that an eXtreme Scale client can connect to and
access entities in the grid. For an example, see the Getting Started
section of this document.
- Build the eXtreme Scale REST service configuration JAR
or directory. See the topic for details.
- which is done by doing this
- and then this.
- Add the REST data service configuration JAR or directory
to the application server classpath:
- Open the WebSphere administration 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
- If eXtreme Scale is integrated with the WebSphere Application
Server 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:
- Open the WebSphere administration console
- Navigate to
- Click New
- Add the following entries into the fields:
- Name: extremescale_client_v71
- Classpath: /lib/wsogclient.jar
- 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 /lib/wxsrestservice.ear file on the file system and
select it and click Next.
- If using WebSphere Application Server version 7.0, click Next.
- If using WebSphere Application Server version 6.1, enter a Context
Root value with the name: /wxsrestservice and continue to the next
step.
- 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 following shared libraries defined in steps 3 and 4:
- extremescale_rest _configuration
- extremescale_client_v71
Tip: This shared library is required only if 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" eXtreme Scale REST data service
application:
- Choose application
- If using WebSphere Application Server version 7.0: In the administration
console, click on
- If using WebSphere Application Server version 6.1: In the administration
console, click on ApplicationsEnterprise
Applications.
- Check the check box next to the "wxsrestservice " application,
and click Start.
- Review the SystemOut.log for the application srver profile.
When the REST data service has started successfully, the following
message is displayed in the SystemOut.log for the server profile:
CWOBJ4000I: The WebSphere eXtreme Scale REST
data service has been started.
- Verify the REST data service is working:
- Verify the REST data service is working:
- The port number can be found in the SystemOut.log 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.