Cluster JSP Sample Application for Enterprise Edition |
Cluster - HA JSP Sample Application for Enterprise Edition
This document describes how to utilize the cluster JSP sample application in conjunction with Sun Java (tm) System Application Server Enterprise Edition 8.1 2005Q1.
This sample application document contains the following sections:
Overview
- Overview
- Compiling and Assembling the Application
- Deploying the Sample Application
- Running the Sample Application
- Troubleshooting
The cluster JSP sample application demonstrates how a request to a JSP may be shared or load balanced between all server instances in a cluster, with the HttpSession or "shopping cart" information surviving an abnormal condition in any server in a cluster. Simulated outages will demonstrate both failover and high availability. The Load Balancer will distribute requests to all instances in the cluster. It has the ability to forward a request to a healthy instance if it detects that the target instance is unavailable.
Compiling and Assembling the Application
This section contains instructions to build and assemble the Cluster JSP sample application.To compile, assemble and deploy the application, see the Sample Application Build Facility document for details on using asant facility to quickly perform these tasks.
Deploying the Sample Application
- To rebuild the sample as J2EE module, do the following:
- Go to the ee-samples/highavailability/apps/clusterjsp directory
- Execute the command <install_dir>/bin/asant
The default target core will be executed to compile java files and rebuild the EAR file.
In this section, you will learn how to deploy the Cluster JSP sample application.Select one of the following approaches to deploying the application:
- Command Line-based Deployment describes how to manually register the application in Sun Java (tm) System Application Server using a Command Line Interface (CLI). This is the fastest means of deploying the sample application.
- GUI-based Deployment describes how to use the Sun Java (tm) System Application Server Administration Tool to deploy the sample application.
Command Line-based DeploymentSince a complete EAR file is supplied, the fastest means of setting up the application is to use the command line utilities described in this section.
The pre-built clusterjsp.ear file is an Enterprise Web Archive (EAR) type file.
Deploying the pre-built clusterjsp.ear file is simple. Deploy either Using the asant script or by Using the asadmin command.
- Go to the src directory of the sample
- cd <install_dir>/samples/ee-samples/highavailability/apps/clusterjsp
- Run asant using deploy task
- <install_dir>/bin/asant deploy
Note If you run asant deploy for the first time, you'll be asked to enter your Sun Java (tm) System appserver host name, admin port, admin user, password and cluster name. The subsequent runs of asant will get this information from a properties file create after the first time you ran asant deploy.
Using the asadmin commandWhere <adminuser> is the Domain Administration Server's admin username, <adminpassword> is the admin user's password, <host> is the machine on which Domain Administration Server is installed and running, <port> is port at which Domain Administration Server is running and target> is the application cluster on which the sample application is to be deployed.
- Go to the root of the sample directory
- cd <install_dir>/samples/ee-samples/highavailability/apps/clusterjsp
- Execute asadmin to deploy application to the local application server instance. For example:
- <install_dir>/bin/asadmin deploy -user <adminuser> -password <adminpassword> --host <DAShost> --port <DASport> --availabilityenabled=true --target <cluster-name> clusterjsp.ear
If you would like to verify the registration of the application, you may proceed to Verifying Deployment. Otherwise, proceed to Running the Sample Application.
GUI-based DeploymentSince a pre-built Enterprise Archive (EAR) file for the sample application is included with the application server, you can use the Sun Java (tm) System Application Server Administration Tool to quickly deploy it to the Application Server.
- From your web browser, access the Sun Java (tm) System Application Server by entering the URL. For example:
- https://<DAShost>:<DASport>
- Enter the server administrator's username and password to access the admin server.
- On the left panel, navigate the tree by clicking on the following:
- Cluster -> <cluster-name>
- On the right panel, the Applications tab will be pre-selected. In the " --New--" drop down list select "Enterprise Application". The "Deployment Page" will load in the right frame.
- Set "Upload" to "Yes" and click on `Browse' to select the .ear file (from disk) to be deployed (clusterjsp.ear) Click `Next' on the top right hand corner of the frame. .
- Enter the application name as clusterjsp. Enable "Availability" checkbox and add a target cluster to deploy the application on from the displayed list in the "Targets" section.
- Click OK
If the deployment succeeds, you will see the `Enterprise Applications' panel and under `Deployed Enterprise Applications' you will see the clusterjsp application as deployed.
Verifying DeploymentAs an optional step, you can use the Sun Java (tm) System Application Server Administration Tool to verify that the application has been registered. Otherwise, proceed directly to Running the Sample Application.
To verify the registration of the application, do the following:
Execute the command asadmin list-components to display applications deployed with a server instance.
<install_dir>/bin/asadmin list-components --user <adminuser> --password <adminpassword> --host <DAShost> --port <DASport> <clustername>
For example:
<install_dir>/bin/asadmin list-components --user admin --password admin123 --host localhost --port 4849 cluster1
You should see output similar to what is displayed below:
clusterjsp <j2ee-application>
Undeploying the Sample ApplicationTo undeploy the sample application, do the following:
- Go to the <install_dir>/samples/ee-samples/highavailability/apps/clusterjsp directory
- Execute the command asant undeploy
Running the Sample Application
In order to run the sample application, you must first do the following:
- Compile, Assemble and Deploy the application as described in the previous sections Compiling and Assembling the Application, and Deploying the Sample Application.
You are now ready to run the sample application by doing the following: On your browser go to the url : http://<Whost>:<Wport>/clusterjsp
Where Whost is the hostname of webserver having the loadbalancer plugin setup and configured and Wport is the port at which that webserver is running.
The image from running the application:
![]()
Now, stop the instance that served the request. (See Running the sample Applications section here to see how to do this). After the instance is shut down completely, add another sesion attribute. You will see that the session attributes stored earlier will also be retreived and displayed.
- If you encounter problems when running the application, review the log files at <install-dir>/domains/domain1/logs/server.log and <install_dir>/nodeagents/<agent-name>/<instance-name>/logs/server.log (also check which instance served the request) to learn what exactly went wrong.
- To redeploy the sample, please undeploy the sample first. Use the commands asant undeploy, asant clean and then asant all.
Copyright © 2004 Sun Microsystems, Inc. All rights reserved.