This section describes the Sun Cluster HA for Sun ONE 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 ONE Web Server resource. See “Standard Properties” in Sun Cluster 3.1 Data Service Planning and Administration Guide for details on all Sun Cluster properties.
Table 1–2 describes extension properties that you can configure for the Sun ONE Web Server. The only extension property that is required when you create a Sun ONE 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 ONE Web Server Extension Properties
Extension Property Name |
Description |
---|---|
Confdir_list (string array) |
A pointer to the server root directory for a particular Sun ONE Web Server instance. If the Sun ONE 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 |
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 restarts 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 an Sun ONE 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 ONE Web Server. Probe deployed applications by setting the property to one or more URIs that are serviced by applications deployed on the Sun ONE Web Server. Default: Null Tunable:Any time Introduced in release: 3.1 10/03 |
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 ONE 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 ONE Web Server Fault Monitor for details. The following examples show how to set the Monitor_uri_list extension property when you add the Sun ONE Web Server instance to your configuration.
(Add an insecure Sun ONE 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-SunONE-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 |
(Add an insecure SunONE 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 |