This topic describes how to configure and start the eXtreme
Scale REST data service using Apache Tomcat, version 5.5 or later.
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 Apache Tomcat, follow these steps:
Procedure
- Download and
install Apache Tomcat Version 5.5 or later to . For example: /opt/tomcat
- Install the eXtreme Scale REST data service and the provided
sample into the Tomcat server as follows:
- If using a Sun JRE or JDK, you must install the IBM
ORB into Tomcat:
- Deploy the REST data service module: wxsrestservice.war
to the Tomcat server.
Deploy the REST data service module:
wxsrestservice.war to the Tomcat server.
Copy the wxsrestservice.war
file from:
/lib
to:
/webapps
- Add the ObjectGrid client runtime JAR and the application
JAR to the shared classpath in Tomcat:
- Edit the /conf/catalina.properties file
- Append the following path names to the end of the shared.loader
property in the form of a comma-delimited list:
- /lib/ogclient.jar
- /gettingstarted/restclient/bin
- /gettingstarted/common/bin
Important: The path separator must be a forward slash.
- Start the Tomcat server with the REST data service:
- Verify that the REST data service is working:
- Open a browser and navigate to:
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid
The service document for the NorthwindGrid is displayed.
- Navigate to:
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata
The Entity Model Data Extensions (EDMX) document is displayed.
- To stop the grid processes, use CTRL+C in the respective
command window.
- To stop Tomcat, use CTRL +C in the window in which you
started it.