This topic describes how to configure and start the eXtreme Scale REST data service
using WebSphere® Application Server Community Edition.
Procedure
- Download and install WebSphere Application Server Community Edition Version 2.1.1.3 or later
to wasce_root, such as: /opt/IBM/wasce
- Start the WebSphere Application Server Community Edition server
by running the following command:
![[Linux]](./icons/nglinux.gif)
wasce_root/bin/startup.sh
wasce_root/bin/startup.bat
If the eXtreme Scale 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
- Install the eXtreme Scale REST
data service and the provided sample into the WebSphere Application Server Community Edition server:
- Add the ObjectGrid client runtime JAR to the WebSphere Application Server Community Edition repository:
- Open the WebSphere Application Server Community Edition administration
console and log in.
Tip: The default URL is: http://localhost:8080/console.
The default user ID is system and password
is manager.
- Click the Repository, in the Services folder.
- In the Add Archive to Repository section,
fill in the following into the input text boxes:
Table 1. Archive
to repositoryText box |
Value |
File |
wxs_home/lib/ogclient.jar |
Group |
com.ibm.websphere.xs |
Artifact |
ogclient |
Version |
7.0 |
Type |
jar |
- Click the Install button.
- Deploy the REST data service module, which is the wxsrestservice.war file,
to the WebSphere Application Server Community Edition server.
- Edit the sample restservice_home/gettingstarted/wasce/geronimo-web.xml deployment
XML file to include path dependencies to the getting started sample
classpath directories:
Change the classesDirs paths for the two
getting started client GBeans:
- The "classesDirs" path for the
GettingStarted_Client_SharedLib
GBean should be set to: restservice_home/gettingstarted/restclient/bin
- The "classesDirs" path for the GettingStarted_Common_SharedLib
GBean should be set to: restservice_home/gettingstarted/common/bin
- Open the WebSphere Application Server Community Edition administrative
console and log in.
Tip: The default URL is: http://localhost:8080/console.
The default user ID is system and password
is manager.
- Click Deploy New.
- On the Install New Applications page, enter
the following values into the text boxes:
Table 2. Installation
valuesText box |
Value |
Archive |
restservice_home/lib/wxsrestservice.war |
Plan |
restservice_home/gettingstarted/wasce/geronimo-web.xml |
- Click on the Install
button.
The console page should indicate
that the application was successfully installed and started.
- Examine the WebSphere Application Server Community Edition system
output log or console to verify that the REST data service has started
successfully by verify that the following message is present:
CWOBJ4000I:
The WebSphere eXtreme Scale REST data service has been started.
- Verify
that the REST data service is working:
- Open the following link in a browser window: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid.
The service document for the NorthwindGrid grid is displayed.
- Open the following link in a browser window: 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 the process.
- To stop WebSphere Application Server Community Edition,
use the following command:
![[Unix]](./icons/ngunix.gif)
wasce_root/bin/shutdown.sh
wasce_root\bin\shutdown.bat
Tip: The default user ID is system and
password is manager. If you are using a custom
port, use the -port option.