test

Sun Cluster Data Service for Sun Java System Web Server Guide for Solaris OS

Configuring Sun Cluster HA for Sun Java System Web Server Extension Properties

This section describes the Sun Cluster HA for Sun Java System Web Server extension properties. For failover, the data service enforces that the size of Confdir_list is one. If you want multiple configuration files (instances), make multiple failover resources, each with one Confdir_list entry.

Typically, you use the command line scrgadm -x parameter=value to configure extension properties when you create the Sun Java System Web Server resource. See “Standard Properties” in Sun Cluster Data Services Planning and Administration Guide for Solaris OS for details on all Sun Cluster properties.

For information about the extension properties that you can configure for the Sun Java System Web Server, see Table 1–2. The only extension property that is required when you create a Sun Java System Web Server resource is the Confdir_list property. You can update some extension properties dynamically. You can update others, however, only when you create the resource. The Tunable entries indicate when you can update each property.

Table 1–2 Sun Cluster HA for Sun Java System Web Server Extension Properties

Extension Property Name 

Description 

Confdir_list (string array)

A pointer to the server root directory for a particular Sun Java System Web Server instance. If the Sun Java System Web Server is in secure mode, the path name must contain a file named keypass, which contains the secure key password needed to start this instance.

Default: None

Range: None

Tunable: At creation

Failover_enabled (boolean)

A specification of whether the fault monitor fails over the Sun Java System Web Server resource if the number of attempts to restart exceeds Retry_count within the time that Retry_interval specifies. The possible values of this extension property are as follows:

  • True – Specifies that the fault monitor fails over the Sun Java System Web Server resource

  • False – Specifies that the fault monitor does not fail over the Sun Java System Web Server resource

 

Default: True

Range: Not applicable

Tunable: When resource is disabled

Monitor_retry_count (integer)

The number of times the process monitor facility (PMF) restarts the fault monitor during the time window that the Monitor_retry_interval property specifies. Note that this property refers to restarts of the fault monitor itself rather than to the resource. The system-defined properties Retry_interval and Retry_count control the restarting of the resource.

 

Default: 4

Range: 0 – 2,147,483,641

–1 indicates an infinite number of retry attempts.

Tunable: Any time

Monitor_retry_interval (integer)

The time (in minutes) over which failures of the fault monitor are counted. If the number of times the fault monitor fails exceeds the value specified in the extension property Monitor_retry_count within this period, the PMF does not restart the fault monitor.

Default: 2

Range: 0 – 2,147,483,641

–1 indicates an infinite retry interval.

Tunable: Any time

Probe_timeout (integer)

The time-out value (in seconds) that the fault monitor uses to probe a Sun Java System Web Server instance. 

Default: 90

Range: 0 – 2,147,483,641

Tunable: Any time

Monitor_Uri_List (string)

A single URI or a list of URIs that can be used by the fault monitor to probe any deployed applications on the Sun Java System Web Server. Probe deployed applications by setting the property to one or more URIs that are serviced by applications deployed on the Sun Java System Web Server. 

Default: Null

Tunable: Any time

Introduced in release: 3.1 10/03

Monitoring Arbitrary URIs

Set the Monitor_Uri_List extension property if you want the web server fault monitor to probe an arbitrary list of applications (URIs) served by the web server. This extension property provides extended probing functionality and is useful if you are layering services in addition to your web server. The Monitor_Uri_List extension property is not supported with a secure Sun Java System Web Server instance. If you do not set the Monitor_Uri_List extension property , the fault monitor will perform basic probing. See Sun Cluster HA for Sun Java System Web Server Fault Monitor for details. The following examples show how to set the Monitor_Uri_List extension property when you add the Sun Java System Web Server instance to your configuration.

Example— Setting Monitor_Uri_List for Scalable Sun Java System Web Server Instance


(Add an insecure Sun Java System Web Server instance with default load balancing.)

example# scrgadm -a -j web-not-secure-1 -g resource-group-1 -t SUNW.iws \
-x Confdir_List=/opt/SunONE/https-Sun-app-insecure-1 \
-y Scalable=True -y Network_resources_used=schost-1 -y Port_list=8000/tcp
-x Monitor_Uri_list=http://schost-1:8000/servlet/monitor

Example— Setting Monitor_Uri_List for Failover Sun Java System Web Server Instance


(Add an insecure Sun Java System Web Server application resource instance.)

example# scrgadm -a -j web-not-secure-1 -g resource-group-1 -t SUNW.iws \
-x Confdir_list=/opt/SunONE/conf -y Scalable=False \
-y Network_resources_used=schost-1 -y Port_list=80/tcp \
-x Monitor_Uri_list=http://schost-1:80/servlet/monitor