Sun Cluster Data Service for Apache Guide for Solaris OS

Configuring Sun Cluster HA for Apache Extension Properties

The only required extension property when you create an Apache server resource is the Bin_dir property, whose value is the directory that contains the apachect1 script.

Typically, you use the command-line scrgadm -x parameter=value to configure the extension properties when you create the Apache server resource. You can also follow the procedures described in “Administering Data Service Resources” in Sun Cluster Data Services Planning and Administration Guide for Solaris OS to configure the properties later.

See “Standard Properties” in Sun Cluster Data Services Planning and Administration Guide for Solaris OS for details on all of the Sun Cluster properties.

You can update some extension properties dynamically. You can update others, however, only when you create the Apache server resource. The following table describes extension properties that you can configure for the Apache server. The Tunable entries indicate when you can update the property.

Table 1–2 Sun Cluster HA for Apache Extension Properties

Name/Data Type 

Description 

Bin_dir (string)

The path to the Apache binaries—in particular, apachect1. Sun Cluster HA for Apache requires this extension property.

Default: None

Range: None

Tunable: At creation

Monitor_retry_count (integer)

Controls restarts of the fault monitor and indicates the number of times that the process monitor facility (PMF) restarts the fault monitor during the time window that the Monitor_retry_interval property specifies. 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 resource restarts.

Default: 4

Range: 02,147,483,641

–1 indicates an infinite number of retry attempts. 

Tunable: At creation

Monitor_retry_interval (integer)

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

Default: 2

Range: 02,147,483,641

–1 indicates an infinite retry interval.

Tunable: At creation

Probe_timeout (integer)

The timeout value (in seconds) that the fault monitor uses to probe an Apache instance. 

Default: 90

Range: 02,147,483,641

Tunable: At creation

Monitor_Uri_List(string)

A single URI or a list of URIs which can be used by the fault monitor to probe any deployed applications on the Sun Cluster HA for Apache Web Server. Probe deployed applications by setting the property to one or more URIs that are serviced by applications deployed on the Sun Cluster HA for Apache Web Server. Introduced in release: 3.1 10/03. 

Default: Null

Tunable: Any time

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 Cluster HA for Apache instance. If you do not set the Monitor_Uri_List extension property, the fault monitor will perform the basic probing. See Sun Cluster HA for Apache Fault Monitor for details. The following examples show how to set the Monitor_Uri_List extension property when you add the Sun Cluster HA for Apache instance to your configuration.

Example— Setting Monitor_Uri_List for Scalable Sun Cluster HA for Apache Instance


(Add an insecure Apache instance with default load balancing.)

# scrgadm -a -j apache-insecure-1 -g resource-group-1 \
-t SUNW.apache -y Network_resources_used=schost-1, ... \
-y Scalable=True -y Port_list=8000/tcp -x Bin_dir=/opt/apache/bin \
-x Monitor_Uri_list=http://schost-1:8000/servlet/monitor

Example— Setting Monitor_Uri_List for Failover Sun Cluster HA for ApacheInstance


(Add an insecure Apache application resource instance.)

# scrgadm -a -j apache-insecure-1 -g resource-group-1 \
-t SUNW.apache -y Network_resources_used=schost-1 \
-y Scalable=False -y Port_list=80/tcp \
-x Bin_dir=/opt/apache/bin \ 
-x Monitor_Uri_list=http://schost-1:80/servlet/monitor