1. Installing and Configuring Oracle Solaris Cluster HA for Apache
Planning the Installation and Configuration
Overview of the Installation and Configuration Process for Oracle Solaris Cluster HA for Apache
Installing and Configuring Apache
Installing a Non-Secure Apache Webserver
How to Install and Configure the Apache Software From the Solaris CD-ROM
How to Install and Configure the Apache Software from the Apache Web Site
Installing a Secure Apache Webserver
How to Install and Configure the Apache Software Using mod_ssl
How to Install and Configure the Apache Software Using apache-ssl
Installing the HA for Apache Packages
How to Install the HA for Apache Packages
Registering and Configuring Oracle Solaris Cluster HA for Apache
Setting Oracle Solaris Cluster HA for Apache Extension Properties
Example-- Setting Monitor_Uri_List for Scalable HA for Apache Instance
Example-- Setting Monitor_Uri_List for Failover HA for Apache Instance
Tools for Registering and Configuring HA for Apache
How to Register and Configure the Oracle Solaris Cluster HA for Apache by Using clsetup
How to Configure SUNW.HAStoragePlus Resource Type
How to Verify Data Service Installation and Configuration
Tuning the Oracle Solaris Cluster HA for Apache Fault Monitor
Operations by the Oracle Solaris Cluster HA for Apache Fault Monitor
Operations by the Fault Monitor Before a Probe
Operations for a Nonsecure Web Server
Operations for a Monitored URI List
Upgrading the SUNW.apache Resource Type
Information for Registering the New Resource Type Version
Information for Migrating Existing Instances of the Resource Type
The Oracle Solaris Cluster HA for Apache fault monitor is contained in a resource whose resource type is SUNW.apache.
System properties and extension properties of the resource control the behavior of the fault monitor. The default values of these properties determine the preset behavior of the fault monitor. The preset behavior should be suitable for most Oracle Solaris Cluster installations. Therefore, you should tune the Oracle Solaris Cluster HA for Apache fault monitor only if you need to modify this preset behavior.
Tuning the Oracle Solaris Cluster HA for Apache fault monitor involves the following tasks:
Setting the interval between fault monitor probes
Setting the timeout for fault monitor probes
Defining the criteria for persistent faults
Specifying the failover behavior of a resource
Information about the Oracle Solaris Cluster HA for Apache fault monitor that you need to perform these tasks is provided in the subsections that follow.
Tune the Oracle Solaris Cluster HA for Apache fault monitor when you register and configure Oracle Solaris Cluster HA for Apache. For more information, see Registering and Configuring Oracle Solaris Cluster HA for Apache.
For detailed information, see “Tuning Fault Monitors for Solaris Cluster Data Services” in Solaris Cluster Data Services Planning and Administration Guide for Solaris OS.
The Oracle Solaris Cluster HA for Apache probe sends a request to the server to query the health of the Apache server.
Before querying the Apache server, the probe checks to confirm that network resources are configured for this Apache resource. If no network resources are configured, an error message (No network resources found for resource) is logged, and the probe exits with failure.
For a nonsecure web server, the probe connects to the Apache server and performs an HTTP 1.0 HEAD check by sending the HTTP request and receiving a response. In turn, the probe connects to the Apache server on each IP address/port combination.
The result of this query can be either a failure or a success. If the probe successfully receives a reply from the Apache server, the probe returns to its infinite loop and continues the next cycle of probing and sleeping.
The query can fail for various reasons, such as heavy network traffic, heavy system load, and misconfiguration. Misconfiguration can occur if you did not configure the Apache server to listen on all of the IP address/port combinations that are being probed. The Apache server should service every port for every IP address that is specified for this resource.
The following probe failures are considered as complete failures.
Failure to connect to the server, as the following error message flags, with %s indicating the hostname and %d the port number.
Failed to connect to %s port %d %s
Running out of time (exceeding the resource property timeout Probe_timeout) after trying to connect to the server.
Failure to successfully send the probe string to the server, as the following error message flags, with the first %s indicating the hostname, %d the port number, and the second %s indicating further details about the error.
Failed to communicate with server %s port %d: %s
When the monitor accumulates two partial failures within the resource property interval Retry_interval, it counts them as one complete failure.
The following probe failures are considered as partial failures:
Running out of time (exceeding the resource property timeout Probe_timeout) while trying to read the reply from the server to the probe's query.
Failing to read data from the server for other reasons, as the following error message flags, with the first %s indicating the hostname and %d the port number. The second %s indicates further details about the error.
Failed to communicate with server %s port %d: %s
If you have configured URIs in the Monitor_Uri_List extension property, then the probe connects to the Oracle Solaris Cluster HA for Apache server and performs an HTTP 1.1 GET check by sending a HTTP request and receiving a response to each of the URIs in Monitor_Uri_List. If the HTTP server return code is 500 (Internal Server Error) or if the connect fails, the probe will take action.
Note - The Monitor_Uri_List extension property supports HTTP requests only. It does not support HTTPS requests.
The result of the HTTP requests is either failure or success. If all of the requests successfully receive a reply from the Oracle Solaris Cluster HA for Apache server, the probe returns and continues the next cycle of probing and sleeping.
Heavy network traffic, heavy system load, and misconfiguration can cause the HTTP GET probe to fail. Misconfiguration of the Monitor_Uri_List property can cause a failure if a URI in the Monitor_Uri_List includes an incorrect port or hostname. For example, if the web server instance is listening on logical host schost-1 and the URI was specified as http://schost-2/servlet/monitor, the probe will try to contact schost-2 to request /servlet/monitor.
For a secure web server, the probe connects to each IP address and port combination. If this connection attempt succeeds, the probe disconnects and returns with a success status. No further checks are performed.
Based on the history of failures, a failure can cause either a local restart or a failover of the data service. For detailed information, see “Tuning Fault Monitors for Solaris Cluster Data Services” in Solaris Cluster Data Services Planning and Administration Guide for Solaris OS.