This topic describes how to configure and start the eXtreme
Scale REST data service using WebSphere Application Server Community
Edition.
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 WebSphere Application Server Community Edition (CE),
follow these steps:
Procedure
- Download and install WebSphere Application Server CE 2.1.1.3 or later to.
For example: /opt/IBM/wasce
- Start the WebSphere Application Server CE server by running
the following command:
![[Linux]](./icons/nglinux.gif)
/bin/startup.sh
/bin/startup.bat
- Install the eXtreme Scale REST data service and the provided
sample into the WebSphere Application Server CE server:
- Add the ObjectGrid client runtime JAR to the WebSphere
Application Server CE repository:
- Open the WebSphere Application Server CE administration console
and log in.
Tip: The default URL is: http://localhost:8080/console.
The default userid is "system" and password is "manager".
- Click the "Repository" link on the left side of the console window,
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 |
/lib/ogclient.jar |
Group |
com.ibm.websphere.xs |
Artifact |
ogclient |
Version |
7.0 |
Type |
jar |
- Click the Install button.
Tip: See the following tech
note for details on different methods of configuration class and library
dependencies: http://www.ibm.com/support/docview.wss?uid=swg21266061
- Deploy the REST data service module: wxsrestservice.war
to the WebSphere Application Server CE server.
- Edit the sample /gettingstarted/wasce/geronimo-web.xml deployment
XML file to include path dependencies to the getting started sample
classpath directories:
Change the "classesDirs" for the two getting
started client GBeans:
- The "classesDirs" path for the GettingStarted_Client_SharedLib
GBean should be set to: /gettingstarted/restclient/bin
- The "classesDirs" path for the GettingStarted_Common_SharedLib
GBean should be set to: /gettingstarted/common/bin
- Open the WebSphere Application Server CE administration console
and log in.
Tip: The default URL is: http://localhost:8080/console
and the default userid is "system" and password is "manager".
- Click on the "Deploy New" link on the left side of the console
window.
- On the "Install New Applications" page, enter the following values
into the text boxes:
Table 2. Installation valuesText box |
Value |
Archive |
/lib/wxsrestservice.war |
Plan |
/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 CE 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 a browser and navigate to: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid
The service document for the NorthwindGrid grid 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 the process.
- To stop WebSphere Application Server CE, use the following
command:
![[Unix]](./icons/ngunix.gif)
/bin/shutdown.sh
\bin\shutdown.bat
Tip: The default userid is "system" and password
is "manager". If using a custom port use the -port option.