Whether you have a client or server application, use the
same basic steps to run the application in Apache Tomcat in Rational® Application Developer.
For a client application, you want to configure and run a web application
to use a WebSphere® eXtreme Scale client
in Rational Application
Developer. Follow these instructions to create a web project for running
a WebSphere eXtreme Scale catalog service
or container. For a server application, you want to enable a Java™ EE application in Rational Application Developer interface
with a stand-alone installation of WebSphere eXtreme Scale. Follow these instructions
to configure a Java EE application
project for using the WebSphere eXtreme Scale client library.
Before you begin
Install the
WebSphere eXtreme Scale Trial or full product.
- Install the stand-alone version of the WebSphere eXtreme Scale product.
- Download and extract the WebSphere eXtreme Scale trial version.
- Install Apache Tomcat Version 6.0 or later.
- Install Rational Application
Developer and create a Java EE
web application.
Procedure
- Add WebSphere eXtreme Scale runtime
library to your Java EE build
path.
Client application In this scenario, you
want to configure and run a web application to use a WebSphere eXtreme Scale client in Rational Application Developer.
- . Click New.
- Enter a User library name of eXtremeScaleClient, and click OK.
- Click Add Jars..., and navigate
to and select the wxs_home/lib/ogclient.jar file.
Click Open.
- Optional: (Optional) To add Javadoc, select
Javadoc location and click Edit.... In the Javadoc location path, you can either enter the URL of the
API documentation, or you can download the API documentation.
- To use the online API documentation, enter http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ in the Javadoc location path.
- To download the API documentation, go to the WebSphere eXtreme Scale API documentation download page. For the Javadoc location
path, enter your local download location.
- Click OK.
- Click OK to close out the User
Libraries dialogue.
- Click .
- Click Java Build Path.
- Click Add Library.
- Select User Library. Click Next.
- Check the eXtremeScaleClient library
and click Finish.
- Click OK to close the Project Properties dialog.
Server application In this scenario, you want to configure
and run a web application to run an embedded WebSphere eXtreme Scale server in Rational Application Developer.
- Click . Click New.
- Enter a User library name of eXtremeScale, and click OK.
- Click Add Jars..., and select wxs_home/lib/objectgrid.jar. Click Open.
- (Optional) To add Javadoc, select Javadoc location and
click Edit.... In the Javadoc location path,
Enter http://www.ibm.com/developerworks/wikis/extremescale/docs/api/.
- Click OK.
- Click OK to close out the User
Libraries dialogue.
- Click .
- Click Java Build Path.
- Click Add Library.
- Select User Library. Click Next.
- Check the eXtremeScaleClient library
and click Finish.
- Click OK to close the Project Properties dialog.
- Define Tomcat Server for our project.
- Ensure that you are in the J2EE perspective and click
the Servers tab in the bottom pane. You can
also click .
- Right-click in the Servers pane, and choose .
- Choose Apache, Tomcat v6.0 Server. Click Next.
- Click Browse... Select tomcat_root. Click OK.
- Click Next.
- Select your Java EE application in the left Available pane and click Add
> to move it to the right Configured pane on the server,
and click Finish.
- Resolve any remaining errors for the Project. Use the following steps to eliminate errors in the Problems pane:
- Click . Click OK. Build
the project.
- Right-click on the Java EE project, and choose .
- Click the Libraries tab. Ensure that the path is configured properly:
- For client applications: Ensure that Apache Tomcat, eXtremeScaleClient,
and JavaJRE are on the path.
- For server applications: Ensure that Apache Tomcat, eXtremeScale,
and Java JRE are on the path.
- Create a run configuration to run your application.
- From the Run menu, select Run Configurations.
- Right-click the Java Application category and select New.
- Select the new run configuration, named New_Configuration.
- Configure the profile.
- Project (on main tabbed page): your_project_name
- Main Class (on main tabbed page): your_main_class
- VM arguments (on arguments tabbed page): -Djava.endorsed.dirs=wxs_root/lib/endorsed
Problems with the VM Arguments often occur because
the path to java.endorsed.dirs must be an absolute
path with no variables or shortcuts.
Other common setup problems
involve the Object Request Broker (ORB). You might see the following
error. See
Configuring a custom Object Request Broker for more information:
Caused by: java.lang.RuntimeException: The ORB that comes with the
Java implementation does not work with ObjectGrid at this time.
If you do not have the
objectGrid.xml or
deployment.xml files accessible to the application,
you might see the following error:
Exception in thread "P=211046:O=0:CT" com.ibm.websphere.objectgrid.ObjectGridRuntimeException:
Cannot start OG container
at Client.startTestServer(Client.java:161)
at Client.main(Client.java:82)
Caused by: java.lang.IllegalArgumentException: The objectGridXML must not be null
at com.ibm.websphere.objectgrid.deployment.DeploymentPolicyFactory.createDeploymentPolicy
(DeploymentPolicyFactory.java:55)
at Client.startTestServer(Client.java:154)
... 1 more
- Click Apply and close the window,
or click Run.
What to do next
After you configure and run a web application with WebSphere eXtreme Scale client in Rational Application Developer, you can
develop a servlet. This servlet uses the WebSphere eXtreme Scale APIs to store and retrieve
data from a remote data grid.
After you enable a Java EE application in Rational Application Developer interface
with a stand-alone installation of WebSphere eXtreme Scale, you can develop a
servlet that uses the WebSphere eXtreme Scale system APIs to start and stop catalog services.