JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Data Service for Apache Tomcat Guide     Oracle Solaris Cluster 4.0
search filter icon
search icon

Document Information

Preface

1.  Installing and Configuring Oracle Solaris Cluster HA for Apache Tomcat

Installing and Configuring Oracle Solaris Cluster HA for Apache Tomcat

Oracle Solaris Cluster HA for Apache Tomcat

Planning the Oracle Solaris Cluster HA for Apache Tomcat Installation and Configuration

Apache Tomcat and Solaris Zones

About Horizontal Scalability

Oracle Solaris Cluster HA for Apache Tomcat as a scalable configuration

Oracle Solaris Cluster HA for Apache Tomcat as a multiple master configuration

Configuration Restrictions

Restriction to deploy Oracle Solaris Cluster HA for Apache Tomcat in a scalable configuration

Restriction for the Load_balancing_policy

Restriction for Scalable Services and Solaris Zones

Restriction for the Apache Tomcat smf Service Name in a Failover Zone

Restriction for Apache Tomcat 5.5.28, 6.0.28, 6.0.29, and 7.06

Configuration Requirements

Location of the Tomcat Home Directory for Scalable or Multiple Masters Configurations

Load Balancing for Multiple Master Configurations

Location of the Tomcat Home Directory for Failover Configurations

Location of the wget Command for Apache Tomcat 5.5.28, 6.0.28, 6.0.29, and 7.06

Apache Tomcat Component Dependencies

HA for Apache Tomcat Configuration and Registration Files

Installing and Configuring Apache Tomcat

How to Enable Apache Tomcat to run in a Global Zone Configuration

How to Install and Configure Apache Tomcat in the Global Zone

How to Enable Apache Tomcat to run in Failover Zone Configuration

How to Install and Configure Apache Tomcat in a Failover Zone

Verifying the Installation and Configuration of Apache Tomcat

How to Verify the Installation and Configuration of Apache Tomcat

How to Deploy the Apache Tomcat Application

Installing the HA for Apache Tomcat Package

How to Install the HA for Apache Tomcat Package

Registering and Configuring Oracle Solaris Cluster HA for Apache Tomcat

How to Register and Configure Oracle Solaris Cluster HA for Apache Tomcat as a Failover Data Service

How to Register and Configure Oracle Solaris Cluster HA for Apache Tomcat as a Multiple Masters Data Service

How to Register and Configure Oracle Solaris Cluster HA for Apache Tomcat as a Scalable Data Service

Configuring Oracle Solaris Cluster HA for Apache Tomcat in a Failover Zone

Configuring Oracle Solaris Cluster HA for Apache Tomcat in a Failover Zone

How to Register Oracle Solaris Cluster HA for Apache Tomcat in a Failover Zone

How to Modify Parameters in the Oracle Solaris Cluster HA for Apache Tomcat Manifest

How to Remove an Oracle Solaris Cluster HA for Apache Tomcat Resource From a Failover Zone

Verifying the Oracle Solaris Cluster HA for Apache Tomcat Installation and Configuration

How to Verify the Oracle Solaris Cluster HA for Apache Tomcat Installation and Configuration

Understanding the Oracle Solaris Cluster Apache Tomcat HA Parameter File

Structure of the Apache Tomcat HA parameter file

Strategy to Choose the TestCmd and the ReturnString Variable

Understanding Oracle Solaris Cluster HA for Apache Tomcat Fault Monitor

Resource Properties

Probing Algorithm and Functionality

Debugging HA for Apache Tomcat

How to Activate Debugging for HA for Apache Tomcat

A.  Deployment Example: Installing Apache Tomcat in the Global Zone

B.  Deployment Example: Installing Apache Tomcat in a Failover Zone

Index

Verifying the Installation and Configuration of Apache Tomcat

This section contains the procedure you need to verify the installation and configuration of Apache Tomcat.

How to Verify the Installation and Configuration of Apache Tomcat

This procedure does not verify that your application is highly available because you have not installed your data service yet.

  1. Start the Apache Tomcat.

    Switch to the Tomcat user name in the target zone (in the following example, it is root) and change to the directory where the environment script is located. In the following example the Tomcat version is 6.0.28.


    Note - The output messages of the start and shutdown commands are version dependent.


     # . ./env.ksh
    # cd $CATALINA_HOME/bin
    # ./startup.sh
    Using CATALINA_BASE:   /tomcat/jakarta-tomcat-6.0.28
    Using CATALINA_HOME:   /tomcat/jakarta-tomcat-6.0.28
    Using CATALINA_TMPDIR: /tomcat/jakarta-tomcat-6.0.28/temp
    Using JAVA_HOME:       /usr/j2se
  2. Check the Installation

    Start a web browser and connect to the cluster node with http://nodename:8080. If you see the default Tomcat home page, everything is working correctly.

  3. Stop the Apache Tomcat.
     # ./shutdown.sh
    Using CATALINA_BASE:   /tomcat/jakarta-tomcat-6.0.28
    Using CATALINA_HOME:   /tomcat/jakarta-tomcat-6.0.28
    Using CATALINA_TMPDIR: /tomcat/jakarta-tomcat-6.0.28/temp
    Using JAVA_HOME:       /usr/j2se

How to Deploy the Apache Tomcat Application

If you configure Apache Tomcat as a failover resource, execute the following steps on one node. If you deploy Apache Tomcat as a scalable configuration, repeat the following steps on every node.


Caution

Caution - For a scalable configuration, the Apache Tomcat configuration must be the same on all the Tomcat hosts.


  1. Become superuser or assume a role that provides solaris.cluster.modify and solaris.cluster.admin RBAC authorizations.
  2. Modify the configuration files server.xml and the Tomcat user configuration to the desired content.

    For more information, see http://tomcat.apache.org/index.html.

  3. Start Apache Tomcat as described in How to Verify the Installation and Configuration of Apache Tomcat.
  4. Deploy your application.

    For more information, see http://tomcat.apache.org/index.html.

  5. Test your application.

    For example, connect with a web browser to the Host with the appropriate port and select the start page of your application.

  6. Stop Apache Tomcat as described in How to Verify the Installation and Configuration of Apache Tomcat.

    The port on which Apache Tomcat is serving is required for the configuration of the Oracle Solaris Cluster Apache Tomcat resource.

    It is best practice to use the start page of the deployed application for the Fault Monitoring. In this case, the TestCmd described in Understanding the Oracle Solaris Cluster Apache Tomcat HA Parameter File can be get /start_page. With this procedure, you monitor Apache Tomcat and the application it is serving.