JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Data Service for Apache Guide     Oracle Solaris Cluster 4.0
search filter icon
search icon

Document Information

Preface

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 Web Server

How to Install and Configure the Apache Software From the Oracle Solaris CD-ROM

How to Install and Configure the Apache Software from the Apache Web Site

Installing the HA for Apache Package

How to Install the HA for Apache Package

Registering and Configuring Oracle Solaris Cluster HA for Apache

Setting Oracle Solaris Cluster HA for Apache Extension Properties

Monitoring Arbitrary URIs

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 Register and Configure Oracle Solaris Cluster HA for Apache Using Oracle Solaris Cluster Command Line Interface (CLI)

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 Non Secure Web Server

Operations for a Monitored URI List

Actions in Response to Faults

Upgrading the SUNW.apache Resource Type

Information for Registering the New Resource Type Version

Information for Migrating Existing Instances of the Resource Type

A.  HA for Apache Extension Properties

Index

Installing and Configuring Apache

To install a non secure version of the Apache web server, see one of the following procedures.

Oracle Solaris Cluster HA for Apache works with the Apache software configured as either a web server or a proxy server.

See Apache documentation at http://www.apache.org for standard installation instructions. Contact your Oracle sales representative for a complete list of Apache versions that are supported with the Oracle Solaris Cluster software.


Note - The Oracle Solaris Cluster HA for Apache software can be configured to run in a zone cluster.


Installing a Non Secure Apache Web Server

This section provides procedures for installing a non secure Apache web server.

How to Install and Configure the Apache Software From the Oracle Solaris CD-ROM

This procedure installs a non secure version of the Apache web server.

The Apache binaries are included in the web/server/apache-22 package.

Place the binaries on the local file system on each of your cluster nodes or on a cluster file system.

How to Install and Configure the Apache Software from the Apache Web Site

This procedure installs a non secure version of the Apache web server.

Place the web server binaries on the local file system on each of your cluster nodes or on a cluster file system.

  1. On a cluster member, become superuser or assume a role that provides solaris.cluster.admin RBAC authorization.
  2. Install the Apache software using the installation procedures found in the Apache installation documentation.

    Install the Apache software using the Apache installation documentation you received with your Apache software or see the installation instructions at http://www.apache.org.

  3. Update the httpd.conf configuration file.
    • Set the ServerName directive. (In Version 2.2 of Apache, the ServerName directive specifies the hostname and the port.)

    • Set the BindAddress directive (optional). (The BindAddress directive only exists in versions prior to Apache 2.2. For Apache 22, see the following bullet for the Listen directive.)

    • Set the Listen directive. The Listen directive must use the address of the logical host or shared address. (The Listen directive only exists in Apache 2.2 and beyond. For Apache versions prior to Apache 2.2, see the previous bullet for the BindAddress directive.)

    • Set the ServerType, ServerRoot, DocumentRoot, ScriptAlias, and LockFile directives.


      Note - The ServerType directive does not exist in Apache 2.2.


    • Set the Port directive to the same number as the Port_list standard resource property. See Step 4 for more information.

    • Add the following lines of code to the httpd.conf configuration file if you choose to configure the Apache software as a proxy server.

      # Proxy Server Directives.
      <IfModule mod_proxy.c>
        ProxyRequests On
        <Directory proxy:*>
          Order deny,allow
          Deny from all
          Allow from IP_ADDRESS
        </Directory>
        ProxyVia On
      </IfModule>
      # End of Proxy Server Direcives.

      Note - If you configure the Apache software as a proxy server, the CacheRoot setting must point to a location on the cluster file system.


  4. Verify that the port number or numbers in the httpd.conf file match those of the Port_list standard resource property.

    You can edit the httpd.conf configuration file to change its port number or numbers to match the standard Oracle Solaris Cluster resource property default (port 80). Alternatively, while you configure Oracle Solaris Cluster HA for Apache, you can set the Port_list standard property to match the setting in the httpd.conf file.

  5. Update the paths in the Apache start/stop script file (Bin_dir/apachectl).

    You must change the paths from the Apache defaults to match your Apache directory structure. For example, change the line in the BIN_dir/apachectl script beginning with HTTPD=/usr/local/apache/bin/httpd to the following.

    HTTPD='/usr/local/apache/bin/httpd -f /global/foo/apache/conf/httpd.conf'
  6. Perform the following tasks to verify your configuration changes.
    1. Run apachectl configtest to check the Apache httpd.conf file for correct syntax.
    2. Ensure that any logical hostnames or shared addresses that Apache uses are configured and online.
    3. Issue apachectl start to manually start your Apache server.

      If Apache does not start up correctly, correct the problem.

    4. After Apache has started, stop it before moving to the next procedure.