Configuring Oracle Solaris Cluster HA for Apache Tomcat in Zones

The Oracle Solaris Cluster HA for Apache Tomcat can be configured in afailover zone and in a zone. This section describes the additional steps which are necessary to configure Oracle Solaris Cluster HA for Apache Tomcat in both zone types.

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

This procedure uses the configuration file to register Oracle Solaris Cluster HA for Apache Tomcat in a failover zone.

Before You Begin

Before you register Oracle Solaris Cluster HA for Apache Tomcat in a failover zone, perform the following tasks. Follow procedures in the Oracle Solaris Cluster Data Service for Solaris Containers Guide and Oracle Solaris Cluster Data Service for Apache Tomcat Guide.

• Install Oracle Solaris Cluster HA for Containers and Oracle Solaris Cluster HA for Apache Tomcat data-service packages in the global zone of each cluster node that you want to run the failover zone.

• Create the failover zone.

• Configure the boot component to control your failover zone.

1. Become superuser or assume a role that provides solaris.cluster.modify and solaris.cluster.admin RBAC authorizations.
2. Make a copy of the /opt/SUNWsctomcat/util/sctomcat_config file to use as your configuration file.

   You can place this configuration file in any directory that is accessible to the failover zone.

3. Open your configuration file for editing and modify the variables for non-global zones.

   These variables are used only when the data service is installed in a non-global zone. Set the values of these variables as follows:

   ZONE

   Set the name of the zone where Oracle Solaris Cluster HA for Apache Tomcat should run.

   ZONE_BT

   Set the name of the resource that controls the zone.

   PROJECT

   Set the name of the Sun Resource Manager Project in the failover zone. If the PROJECT variable is omitted from the configuration file, the data service uses the default project of the user, :default, in a Solaris Service Management Facility (SMF) context. This project name is placed in the start/project property and the stop/project property of the SMF service.

   ---

   Note - Keep this modified configuration file for possible future use.

   ---

4. Register Oracle Solaris Cluster HA for Apache Tomcat with SMF.

   # ksh /opt/SUNWsctomcat/util/sctomcat_register -f filename

   -f

   Specifies the configuration file name.

   filename

   The configuration file name.

   The registration of Oracle Solaris Cluster HA for Apache Tomcat generates an SMF manifest and registers an SMF service in the failover zone that is specified by the ZONE variable in the configuration file. The manifest is named resourcename.xml, where resource is the name that is specified by the RS variable in the configuration file. This manifest is placed in the /var/svc/manifest/application/sczone-agents/ directory. The SMF service is named svc:/application/sczone-agents/resource.

   The Oracle Solaris Cluster HA for Apache Tomcat data service uses the SMF component of the Oracle Solaris Cluster HA for Containers data service to control and probe this SMF service of the Oracle Solaris Cluster HA for Apache Tomcat. It registers a Oracle Solaris Cluster HA for Containers SMF component on top of the already-created SMF service. The name of the script that starts and stops the manifest as well as probes the SMF component is control_sctomcat.

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

Perform this task to change parameters in the Oracle Solaris Cluster HA for Apache Tomcat manifest and to validate the parameters in the failover zone. Parameters for the Oracle Solaris Cluster HA for Apache Tomcat manifest are stored as properties of the SMF service. To modify parameters in the manifest, change the related properties in the SMF service then validate the parameter changes.

1. Become superuser or assume a role that provides solaris.cluster.modify and solaris.cluster.admin RBAC authorizations on the zones console.
2. Change the Solaris Service Management Facility (SMF) properties for the Oracle Solaris Cluster HA for Apache Tomcat manifest.

   # svccfg svc:/application/sczone-agents:resource

   For more information, see the svccfg(1M) man page.

3. Validate the parameter changes.

   # /opt/SUNWsctomcat/bin/control_sctomcat validate resource

   Messages for this command are stored in the /var/adm/messages/ directory of the failover zone.

4. Disconnect from the failover zone's console.

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

1. Become superuser or assume a role that provides solaris.cluster.modify and solaris.cluster.admin RBAC authorizations.
2. Disable and remove the resource that is used by the Oracle Solaris Cluster HA for Apache Tomcat data service.

   # clresource disable resource
   # clresource delete resource

3. Log in as superuser to the failover zone's console.
4. Unregister Oracle Solaris Cluster HA for Apache Tomcat from the Solaris Service Management Facility (SMF) service.

   # /opt/SUNWsctomcat/util/sctomcat_smf_remove -f filename

   -f

   Specifies the configuration file name.

   filename

   The name of the configuration file that you used to register Oracle Solaris Cluster HA for Apache Tomcat with the SMF service.

   ---

   Note - If you no longer have the configuration file that you used to register Oracle Solaris Cluster HA for Apache Tomcat with the SMF service, create a replacement configuration file:

   1. Make a copy of the default file, /opt/SUNWsctomcat/util/sctomcat_config.

   2. Set the ZONE and RS parameters with the values that are used by the data service.

   3. Run the sctomcat_smf_remove command and use the -f option to specify this configuration file.

   ---

5. Disconnect from the failover zone's console.

Configuring Oracle Solaris Cluster HA for Apache Tomcat in a Zone

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

This procedure uses the configuration file to register Oracle Solaris Cluster HA for Apache Tomcat in a zone.

Before You Begin

Before you register Oracle Solaris Cluster HA for Apache Tomcat in a zone, perform the following tasks. .

• Install Oracle Solaris Cluster HA for Apache Tomcat data-service packages in the global zone of each cluster node that you want to run the zone.

• Create the zone on each node to host Oracle Solaris Cluster HA for Apache Tomcat.

  ---

  Note - The zones configuration parameter autoboot must be set to true

  ---

1. Become superuser or assume a role that provides solaris.cluster.modify and solaris.cluster.admin RBAC authorizations.
2. Make a copy of the /opt/SUNWsctomcat/util/sctomcat_config file to use as your configuration file.
3. Open your configuration file for editing, but do not set the variables for non-global zones.

   These variables are used only when the data service is installed in a non-global zone managed by the Container Agent.

   ---

   Note - Keep this modified configuration file for possible future use.

   ---

4. Register Oracle Solaris Cluster HA for Apache Tomcat with SMF.

   # ksh /opt/SUNWsctomcat/util/sctomcat_register -f filename

   -f

   Specifies the configuration file name.

   filename

   The configuration file name.