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 data grid is started.
See
Enabling the REST data service for details on how to
start the data grid.
Procedure
- Download and
install Apache Tomcat Version
5.5 or later to tomcat_root. For example: /opt/tomcat
- Install the eXtreme Scale REST
data service and the provided sample into the Tomcat server as follows:
- If you are using an Oracle JRE or JDK, you
must install
the IBM® ORB into Tomcat:
- Deploy the REST data service
module: wxsrestservice.war
to the Tomcat server.
Copy the wxsrestservice.war file
from:
restservice_home/lib
to:
tomcat_root/webapps
- Add the ObjectGrid client runtime JAR and the application
JAR to the shared classpath in Tomcat:
- Edit the tomcat_root/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:
- wxs_home/lib/ogclient.jar
- restservice_home/gettingstarted/restclient/bin
- restservice_home/gettingstarted/common/bin
Important: The path separator must be a forward slash.
If the eXtreme Scale data grid was started
with eXtreme Scale security
enabled, set the following properties in the restservice_home/gettingstarted/restclient/bin/wxsRestService.properties file.ogClientPropertyFile=restservice_home/gettingstarted/security/security.ogclient.properties
loginType=none
- 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 data grid processes, use CTRL+C
in the respective
command window.
- To stop Tomcat, use CTRL +C
in the window in which you
started it.