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


Starting a sample ObjectGrid cluster in the WebSphere Application Server environment

Use this task to start a simple ObjectGrid cluster to test the functionality of the distributed ObjectGrid in the WebSphere Application Server environment.

Before you begin

WebSphere Extended Deployment must be installed. You must have the ObjectGridSample.ear file installed on your application server. For more information about installing the ObjectGridSample.ear file, see Loading and running the ObjectGrid sample application with WebSphere Extended Deployment.

About this task

Use this task to set up an application server to host an ObjectGrid server that is based on the cluster-config-1.xml and cluster-objectgrid-definition.xml files.

The cluster-config-1.xml file has one ObjectGrid server definition only. This ObjectGrid server represents the sample ObjectGrid cluster. You can use either one stand-alone application server or a cluster with one cluster member to host the sample ObjectGrid server.

Procedure

  1. Extract both the META-INF/cluster-config-1.xml and META-INF/cluster-objectgrid-definition.xml files from the /optionalLibraries/ObjectGrid/objectgridSamples.jar file to the /optionalLibraries/ObjectGrid directory.
  2. Define the necessary generic Java virtual machine (JVM) arguments.
    1. In the administrative console, click Servers > Application servers > server_name > Process Definition > Java Virtual Machine.
    2. In the Generic JVM arguments panel, type the following text:
      -Dobjectgrid.server.name=server1 
      -Dobjectgrid.xml.url=file:///<INSTALL_ROOT>\optionalLibraries\ObjectGrid\
      	META-INF\cluster-objectgrid-definition.xml 
      -Dobjectgrid.cluster.xml.url=file:///<INSTALL_ROOT>\optionalLibraries\
      	ObjectGrid\META-INF\cluster-config-1.xml 
      The INSTALL_ROOT is your WebSphere Application Server installation root directory.
    3. Click Save.
    4. Click Save to Master Configuration.
    5. Select the Synchronize changes with Nodes option. Click Save.
  3. Copy the /optionalLibraries/ObjectGrid/objectgridSamples.jar file to the /classes or the lib/ext directory. The objectgridSamples.jar file contains classes that the sample ObjectGrid server needs for the plug-in implementations that are defined in the cluster-objectgrid-definition.xml file. This Java archive (JAR) file is also used for serializing and deserializing the objects that are stored in maps .
  4. Restart the server for the changes to take effect.

Results

You started an ObjectGrid cluster in the WebSphere Application Server environment.

What to do next

For more details about starting and stopping ObjectGrid servers in application servers, see Starting an ObjectGrid server in an application server.



Related tasks
Starting an ObjectGrid server in an application server
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/tobgobgclusterweb.html