WebSphere Extended Deployment, Version 6.0.x
             Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS


Loading and running the ObjectGrid sample application with WebSphere Extended Deployment

Use this task to load and run the Java 2 Platform, Enterprise Edition (J2EE) ObjectGrid sample within WebSphere Extended Deployment.

Before you begin

WebSphere Application Server and WebSphere Extended Deployment must be installed.

About this task

Use this task to understand and test the integration of ObjectGrid with WebSphere Extended Deployment.

Procedure

  1. Install the ObjectGridSample.ear file. You can install the enterprise archive (EAR) file on a single application server or a cluster. To install the ObjectGridSample.ear file in the administrative console, perform the following steps:
    1. In the administrative console, click Applications > Install New Application.
    2. On the Preparing for application installation page, specify the location of the ObjectGrid sample application. For example, browse to: <install_root>/installableApps/ObjectGridSample.ear. Click Next.
    3. On the second Preparing for application installation page, take the default settings and click Next.
    4. On the Select installation options page, take the default settings and click Next.
    5. On the Map modules to servers page, specify deployment targets where you want to install the modules that are contained in your application. Select a target server or cluster from the Clusters and servers list for every module. Select the Module check box to select all of the application modules or select individual modules.
    6. On the following pages, use the default values and click Finish.
    7. Click Save to Master Configuration after finishing the application installation.
    8. Click the Synchronize changes with Nodes option. On the Enterprise Applications > Save page, click Save.
    9. Click OK.
  2. Check the HTTP port of the default_host of the servers and add a host alias. By default, Web modules are bound to the default_host virtual host name, unless you modify the host name during installation. If you are installing the application on a cluster, you must configure at least one host alias for the HTTP port of the default_host for each cluster member. You also must check the HTTP port of the default_host for each cluster member and add the corresponding host alias into the Host aliases list in the administrative console. To check the HTTP port of the default_host of a server, perform the following steps:
    1. In the administrative console, click Servers > Application Servers > server_name.
    2. Expand the ports in the Communication section. The WC_defaulthost port is the default_host virtual host port.
    To add a host alias, perform the following steps:
    1. In the administrative console, click Environment > Virtual hosts > default_host > Host aliases > New.
    2. Use the default value of the host name and specify the port.
    3. Click OK.
  3. Start the ObjectGrid sample application.
    • To start the application on a server, click Servers > Application servers. Select the server that has the ObjectGridSample.ear file installed. Click Start.
    • To start the application on a cluster, click Servers > Clusters. Select the cluster that has the ObjectGridSample.ear file installed. Click Start.
    After you start the application on a server or cluster, you can stop and start the application independently from the host server or cluster. To stop or start the ObjectGrid sample application, perform the following steps:
    1. In the administrative console, click Applications > Enterprise applications.
    2. Select the ObjectGrid sample application.
    3. Click Start or Stop.
  4. Access the ObjectGrid sample. After you install the ObjectGridSample.ear file on a single server or cluster and start the application, you can access the ObjectGrid sample at the following Web address:
    http://hostname:port/ObjectGridSample
    For example, if your host name is localhost and the port value is 9080, use the http://localhost:9080/ObjectGridSample Web address.
  5. [Version 6.0.1 and later] Test the functionality of distributed ObjectGrid in the WebSphere Application Server environment. The ObjectGridSample.ear file also contains the DistributedObjectGridServlet servlet that demonstrates the use of a distributed ObjectGrid in the WebSphere Application Server environment. The application server that hosts the DistributedObjectGridServlet servlet must also host the ObjectGrid server, which is a member of the required ObjectGrid cluster. After the application server with the ObjectGridSample.ear file installed also hosts the required ObjectGrid server, the DistributedObjectGridServlet servlet behaves the same way as other servlets. You can access the servlet at the following Web address: http://hostname:port/ObjectGridSample/DistributedObjectGridServlet. For example, if your host name is localhost and the port value is 9080, use the http://localhost:9080/ObjectGridSample/DistributedObjectGridServlet Web address.

    You can enable ObjectGrid tracing by using the following trace string: ObjectGrid*=all=enabled.

Results

You installed and configured the ObjectGrid sample application and the distributed ObjectGrid sample application on a WebSphere Extended Deployment server.

What to do next

After you install the application on a server or cluster, you can access the sample documentation after starting the application at the following Web address:
http://hostname:port/ObjectGridSample/docs/introduction.html
For example, if your hostname is localhost and the port value is 9080, use the http://localhost:9080/ObjectGridSample/docs/introduction.html Web address.
Task topic    

Terms of Use | Feedback

Last updated: Nov 30, 2007 4:06:03 PM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=/com.ibm.websphere.xd.doc/info/objectgrid/tobgj2ee.html