SUNW.apache(5)

NAME | DESCRIPTION | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO

NAME

SUNW.apache, apache– resource type implementation for failover and scalable Apache Web Server

DESCRIPTION

The Apache Web Server data service for Sun Cluster 3.1 is configured as a resource managed by the Sun Cluster Resource Group Manager (RGM).

You must set the following properties on an Apache resource by using clresource(1CL).

Standard Properties

The standard resource properties Scalable, Network_resources_used, Port_list, Load_balancing_policy, and Load_balancing_weights are common to all scalable resource types.

The SUNW.apache resource type supports two modes. The first mode is a scalable mode that exploits the cluster networking facility to permit the Apache resource to run on multiple nodes simultaneously. The second mode is a failover mode, in which the Apache resource runs on only one node at a time. The Scalable property is set at resource creation time to indicate the mode in which the service operates. The default is FALSE (failover mode).

Seer_properties(5) for a complete description of the following resource properties.

Load_balancing_policy

Default

LB_WEIGHTED

Tunable

At creation

Load_balancing_weights

Default

NULL

Tunable

Any time

Network_resources_used

Default

No default

Tunable

At creation

Port_list

Default

80/tcp

Tunable

At creation

Retry_count

Default

2

Tunable

Any time

Retry_interval

Default

300

Tunable

Any time

Thorough_probe_interval

Default

60

Tunable

Any time

Extension Properties

Bin_dir

Type string. Indicates the location of Apache Web server binaries. You must specify this property at resource creation time.

Monitor_retry_count

Type integer. Default is 4. Controls the restarts of the fault monitor. This property indicates the number of times the fault monitor is restarted by the process monitor facility and corresponds to the -n option passed to thepmfadm(1M) command. The number of restarts is counted in a specified time window (see the property Monitor_retry_interval). Note that this property refers to the restarts of the fault monitor itself, not the web server. The restarts of the web server are controlled by the system-defined properties Thorough_Probe_Interval, Retry_Interval, and Retry_Count, as specified in their descriptions. See clresource(1CL). You can modify the value for this property at any time.

Monitor_retry_interval

Type integer. Default is 2. Indicates the time in minutes, over which the failures of the fault monitor are counted, and corresponds to the -t option passed to thepmfadm(1M) command. If the number of times the fault monitor fails exceeds the value of Monitor_retry_count, the fault monitor is not restarted by the process monitor facility. You can modify the value for this property at any time.

Monitor_Uri_List

Type string array. Default is " ". Introduced in release 3.1 10/03. This property enables you to ensure that application components are responding by querying the configured URIs. The Monitor_Uri_List property is used for detailed fault monitoring of Sun Cluster HA for Apache Web Server. The fault monitor periodically runs the HTTP GET command for the URIs. The monitor takes action if the HTTP request returns with response code 500 "Internal Server Error" or if the application server does not respond. An example URI setting is http://logical-hostname/App/tester. If the configured URIs are implemented by using a servlet in the web server, detailed monitoring of the web server Java Virtual Machine (JVM) is possible.

Probe_timeout

Type integer. Defaults to 90. This property is the time-out value (in seconds) used by the fault monitor to probe an Apache instance. You can modify the value for this property at any time.

EXAMPLES

---

Example 1 Creating a Failover Apache Resource




For this example to work, the data service must first be installed. This example creates a failover Apache resource named apache-failover in an existing resource group named web-rg. web-rg is assumed to contain a LogicalHostname resource, which identifies the logical hostname associated with the resource group. Another assumption is that the Port_list property defaults to 80/tcp, that is, the Apache instance is listening on port 80.

example# clresourcetype register SUNW.apache example# clresource create -g web-rg -t SUNW.apache \ -p Bin_dir=/global/apache/https-web/bin apache-failover

In this example, the Apache resource created is named apache-failover, which listens on port 80, with a corresponding Apache instance in the directory /global/apache/https-web.

---

---

Example 2 Creating a Scalable Apache Resource




For this example to work, the data service must first be installed. This example creates a scalable Apache resource named apache-scalable in a resource group named web-rg , which is configured to run simultaneously on all four nodes of a four-node cluster. The apache-scalable resource is configured to listen on port 8080 and uses the IP addresses as configured in a SharedAddress resource named www_foo_com, which is contained in the resource group foo_com_RG.

example# clresourcegroup create -p Maximum_primaries=4 \ -p Desired_primaries=4 -p RG_dependencies=foo_com_RG web-rg example# clresourcetype register SUNW.apache example# clresource create -g web-rg -t SUNW.apache \ -p Bin_dir=/global/apache/https-web/bin \ -p Port_list=8080/tcp -y Scalable=TRUE \ -p Network_resources_used=www_foo_com apache-scalable

---

---

Example 3 Setting Monitor_uri_list for Scalable Sun Cluster HA for Apache Instance




The following example shows how to set the Monitor_uri_list extension property when a scalable Sun Cluster HA for Apache instance is added to a configuration. The Monitor_uri_list extension property is not supported with a secure Sun Cluster HA for Apache instance.

(Add an insecure Apache instance with default load balancing.) example# clresource create -g resource-group-1 \ -t SUNW.apache -p Bin_dir=/opt/apache/bin \ -p Monitor_Uri_list=http://schost-1:8000/servlet/monitor \ -p Network_resources_used=schost-1,... \ -p Scalable=True -p Port_list=8000/tcp apache-insecure-1

---

---

Example 4 Setting Monitor_uri_list for Failover Sun Cluster HA for Apache Instance




The following example shows how to set the Monitor_uri_list extension property when a failover Sun Cluster HA for Apache instance is added to a configuration. The Monitor_uri_list extension property is not supported with a secure Sun Cluster HA for Apache instance.

(Add an insecure Apache application resource instance.) # clresource create -g resource-group-1 \ -t SUNW.apache -p Bin_dir=/opt/apache/bin \ -p Monitor_Uri_list=http://schost-1:80/servlet/monitor \ -p Network_resources_used=schost-1 \ -p Scalable=False -p Port_list=80/tcp apache-insecure-1

---

FILES

Bin_dir/apachectl

The apachectl start command is used by HA-Apache to start a non-SSL Apache web server.

The apachectl startssl command is used by HA-Apache to start an Apache web server that uses mod_ssl.

Bin_dir/httpsdctl

The httpsdctl start command is used by HA-Apache to start an Apache-ssl web server.

Bin_dir/keypass

This file must be created for an Apache web server that uses mod_ssl for handling https requests. Only the owner should have read, write, or execute permissions to this file. All other users must not have permissions to this file.

If the web server does not use encrypted private keys, the contents of this file are irrelevant. For a web server that uses encrypted private keys, this file is called during resource startup with host:port and algorithm as its two arguments. The web server expects the pass phrase for the key corresponding to that host and port combination to be printed to stdout.

For example, for a secure web server listening on ports 8080 and 8888 that use RSA encrypted private keys for both ports, the keypass file could look like the following:

#!/bin/ksh
host=`echo $1 | cut -d: -f1`
port=`echo $1 | cut -d: -f2`
algorithm=$2

if [ "$host" = "button-1.eng.sun.com" \\
	-a "$algorithm" = "RSA" ]; then
case "$port" in
	8080) echo passphrase-for-8080;;
	8888) echo passphrase-for-8888;;
esac
fi

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWscapc

SEE ALSO

pmfadm(1M) scha_resource_get(3HA), clresourcetype(1CL), clresourcegroup(1CL), attributes(5), r_properties(5), scalable_service(5)

Sun Cluster Data Service for Apache Guide for Solaris OS,Sun Cluster Data Services Planning and Administration Guide for Solaris OS

NAME | DESCRIPTION | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO