# Sun Cluster HA for Apache

> Overview
> Before Starting
> Installing Sun Cluster HA for Apache
> Customizing Sun Cluster HA for Apache

## Overview

SunPlexTM Manager uses the Apache web server version that is included with the standard SolarisTM package to install Sun Cluster HA for Apache. For information on the Apache web server version that is included with the Solaris version running on your system, see the Solaris documentation. For a list of Apache web server releases that are supported for use with SunTM Cluster, ask your Sun sales representative.

SunPlex Manager sets up a basic Sun Cluster HA for Apache configuration with the following structure:

- One port
- One document directory
- One CGI directory

SunPlex Manager currently only supports Sun Cluster HA for Apache that is configured as a web server, not as a proxy server.

Note: Multiple instances of Sun Cluster HA for Apache can run on the cluster if the location of the configuration and installation files is different for each instance and the ports do not conflict.

For a more advanced configuration, manually customize your configuration after SunPlex Manager completes the installation by editing the
httpd.conf
file installed in the Configuration Directory. The documentation for the Apache Web Server contains more information.

To completely customize your Sun Cluster HA for Apache installation, follow the instructions in the Sun Cluster 3.1 Data Services Installation and Configuration Guide.

Return to top

## Before Starting

Before you install Sun Cluster HA for Apache, check the following items:

- Ensure that the logical host name or shared address is set up. In most cases, you set up the logical host name when you install Sun Cluster. If the logical host name is not set up, see Creating a Logical Host Name Resource.

- Ensure that you have enough disk space for the installation. For information on the amount of disk space the installation requires, refer to the documentation for the Apache web server.

- Decide whether to run Sun Cluster HA for Apache as a failover or a scalable service.

- Determine where you want to install the data service files. The files can be installed locally or globally.

- Ensure that you have the CD that contains the Sun Cluster 3.1 data service.

Return to top

## Installing Sun Cluster HA for Apache

| Sun Cluster HA for Apache takes less than 10 minutes to install.
| When you exit SunPlex Manager or click Back in your web browser after you begin the installation, the data service disconnects you from the installation. This disconnection can result in an incomplete installation because of insufficient information or an unresolved error message. To clean up an incomplete installation, you must remove the application files and the resources and resource groups that were created.

To install Sun Cluster HA for Apache, complete the following steps:

1. From the navigation frame in SunPlex Manager, choose [cluster name] Cluster.

   The cluster overview window appears.

2. From the Install Data Service menu, choose Apache Web Server.

   SunPlex Manager ensures that:

   - The Sun Cluster HA for Apache data service packages are already installed.
   - The Sun Cluster HA for Apache data services are registered with RGM.

   If the Apache Web Server data service package is installed and is registered, proceed to the next step.

   If SunPlex Manager does not find the Apache Web Server data service package already installed and registered, SunPlex Manager guides you through installation and registration. You need to provide the location of the CD that contains the Sun Cluster 3.1 data service.

   A window that contains configuration information appears.

3. Modify the configuration information for your system.

   Field | Description
   --- | ---
   Web Server Port | The port on which the web server accepts requests. Typical values are 80 or 8080.
   Installation Directory | The directory where Sun Cluster HA for Apache is to be installed. This directory can be either local or global.
   Root Directory for Web Pages | The directory that is to hold the web pages that are served by Sun Cluster HA for Apache. This directory is typically a global directory.
   Web CGI Script Directory | The directory that is to hold the CGI scripts that are served by Sun Cluster HA for Apache. This directory is typically a global directory.
   Local Log Directory | The directory that is to hold the Sun Cluster HA for Apache logs of accesses and errors. This directory must be a local directory.
   Network Resource | Specifies the logical host name or shared address that is to be used to access Sun Cluster HA for Apache over the network. If a logical host name is used, one Sun Cluster HA for Apache instance runs as a failover service. If a shared address is used, multiple Sun Cluster HA for Apache instances run as a scalable service.
   Resource Name | Specifies the name of the Sun Cluster HA for Apache resource that is to be created. This name must be unique within the cluster.
   Resource Group Name | If a shared address is used, specifies the name of the resource group that is to be created. This resource group will hold the scalable Sun Cluster HA for Apache resource. If a logical host name is used, the failover Sun Cluster HA for Apache resource is placed in the same resource group as the logical host name.
   Name Service | This option controls the Sun Cluster HA for Apache BindAddress parameters, and normally match the type of name service in use on the cluster. If you choose DNS, the BindAddress is the logical host name or shared address. If you choose NIS, the BindAddress is the numeric IP value that is associated with the logical host name or shared address.
   Dots Demo | If you choose and install Dots Demo, SunPlex Manager installs additional Web pages on the cluster to demonstrate load balancing across the cluster.

4. Click Continue.

   The parameters that you specified on the configuration page are used to install Sun Cluster HA for Apache.

   SunPlex Manager verifies the information on the configuration page. If SunPlex Manager finds no errors, SunPlex Manager installs Sun Cluster HA for Apache. If SunPlex Manager discovers errors, SunPlex Manager displays an error message and the configuration page.

5. Click Continue.

   The installer configures and starts a resource. SunPlex Manager lists the commands that it executes to configure and start the resource.

| Recommended step. To test the Web server, click the web server URL.

Note: To view the dots demo (if you installed it), click the dots demo URL. A graphical illustration of the nodes on the cluster appears. The dots demo demonstrates load balancing across the cluster.

Return to top

## Customizing Sun Cluster HA for Apache

Information about customizing the Sun Cluster HA for Apache installation are presented in Apache documentation and in the Sun Cluster 3.1 Data Services Installation and Configuration Guide.