How to Register and Configure the Oracle Solaris Cluster HA for Apache by Using clsetup - Oracle® Solaris Cluster Data Service for Apache Guide

Language:

How to Register and Configure the Oracle Solaris Cluster HA for Apache by Using `clsetup`

Perform this procedure during your initial setup of Oracle Solaris Cluster HA for Apache. Perform this procedure from one node only.

Note - The clsetup utility can be used to configure Apache versions 1.x, Apache 2.2, and 2.2.16.

Before You Begin

Before you start the Oracle Solaris Cluster HA for Apache wizard, ensure that the following prerequisites are met:

You have decided whether to run Oracle Solaris Cluster HA for Apache as a failover service or a scalable service.
Prerequisites for configuring the required type of network resource are met.
- A failover service requires a logical hostname resource.
- A scalable service requires a shared address resource.
The Apache software is installed and configured.
The Apache configuration files are available on the node where you will start the wizard.
The Oracle Solaris Cluster HA for Apache package is installed.

Assume the root role on any cluster node.

Start the clsetup utility.
```
# clsetup
```
The clsetup main menu is displayed.

Type the number that corresponds to the option for data services and press Return.
The Data Services menu is displayed.

Type the number that corresponds to the option for configuring Oracle Solaris Cluster HA for Apache and press Return.
The clsetup utility displays information about Oracle Solaris Cluster HA for Apache.

Press Return to continue.
The clsetup utility displays a list of configuration modes for Oracle Solaris Cluster HA for Apache.
Type the number that corresponds to the configuration mode for Oracle Solaris Cluster HA for Apache and press Return.
The clsetup utility displays a list of available nodes.
Select the nodes where you require Oracle Solaris Cluster HA for Apache to run.
- To accept the default selection of all listed nodes in an arbitrary order, type a and press Return.
- To select a subset of the listed nodes, type a comma-separated or space-separated list of the numbers that correspond to the nodes. Then press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list. The first node in the list is the primary node of this resource group.
- To select all nodes in a particular order, type a comma-separated or space-separated ordered list of the numbers that correspond to the nodes. Then press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list.

To confirm your selection of nodes, type d and press Return.
The clsetup utility displays a screen where you can specify the location of the Oracle Solaris Cluster HA for Apache configuration file.
Type the numbers that correspond to the location of the configuration file and press Return.
Note - The configuration file that you select here is used as a template. A new configuration file will be created using this template configuration file.
The clsetup utility displays a screen where you can specify the Oracle Solaris Cluster HA for Apache document root directory.
Type the numbers that correspond to the location of the document root directory and press Return.
The clsetup utility displays a screen where you can specify the Oracle Solaris Cluster HA for Apache mount point.
To confirm your selection of the mount point, type d and press Return.
The clsetup utility displays a screen where you can specify the Oracle Solaris Cluster HA for Apache network resource.
To confirm your selection of the network resource, type d and press Return.
The clsetup utility displays information about the Oracle Solaris Cluster HA for Apache configuration that the utility will create.
To confirm your selection of the configuration, type d and press Return.
The clsetup utility displays information about the Oracle Solaris Cluster objects that the utility will create.
Note - The document root specified by you will be copied to the one that is mentioned in the screen. The configuration file specified by you will be edited and the edited file will be stored in the location mentioned in the screen.
To confirm your selection of the Oracle Solaris Cluster objects, type d and press Return.
The clsetup utility displays information about the Oracle Solaris Cluster configuration that the utility will create.
To create the configuration, type c and Press Return.
The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
Note - The clsetup utility will roll back the changes if it fails to complete the Apache configuration process.
Press Return to continue.
The clsetup utility returns you to the list of options for configuring Oracle Solaris Cluster HA for Apache.
(Optional)Type q and press Return repeatedly until you quit the clsetup utility.
If you prefer, you can leave the clsetup utility running while you perform other required tasks before using the utility again. If you choose to quit clsetup, the utility recognizes your Oracle Solaris Cluster HA for Apache resource group when you restart the utility.

Determine if the Oracle Solaris Cluster HA for Apache resource group and its resources are online.
Use the clresourcegroup(1CL) command for this purpose. By default, the clsetup utility assigns the name apache-server-rg to the Oracle Solaris Cluster HA for Apache resource group.
```
# clresourcegroup status apache-server-rg
```
If the Oracle Solaris Cluster HA for Apache resource group and its resources are not online, bring them online.
```
# clresourcegroup online -eM apache-server-rg
```