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
- 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:
- In the administrative console, click Applications > Install
New Application.
- 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.
- On the second Preparing for application installation page,
take the default settings and click Next.
- On the Select installation options page, take the default
settings and click Next.
- 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.
- On the following pages, use the default values and click Finish.
- Click Save to Master Configuration after finishing the
application installation.
- Click the Synchronize changes with Nodes option. On the Enterprise
Applications > Save page, click Save.
- Click OK.
- 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:
- In the administrative console, click Servers > Application
Servers > server_name.
- 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:
- In the administrative console, click Environment > Virtual
hosts > default_host > Host aliases > New.
- Use the default value of the host name and specify the port.
- Click OK.
- 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:
- In the administrative console, click Applications > Enterprise
applications.
- Select the ObjectGrid sample application.
- Click Start or Stop.
- 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.
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.