How to Register and Configure the Sun Cluster HA for Apache by Using clsetup

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

The clsetup utility can be used to configure Apache versions 1.x and Apache 2.0.

Before You Begin

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

• You have decided whether to run Sun Cluster HA for Apache as a failover service or a scalable service.

• Prerequisites for configuring the required type of network resource are met.

  The type of network resource that is required depends on your configuration of Sun Cluster HA for Apache:

  • 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 Sun Cluster HA for Apache packages are installed.

1. Become superuser on any cluster node.

2. Start the clsetup utility.

   # clsetup

   The clsetup main menu is displayed.

3. Type the number that corresponds to the option for data services and press Return.

   The Data Services menu is displayed.

4. Type the number that corresponds to the option for configuring Sun Cluster HA for Apache and press Return.

   The clsetup utility displays information about Sun Cluster HA for Apache.

5. Press Return to continue.

   The clsetup utility displays a list of configuration modes for Sun Cluster HA for Apache.

6. Type the number that corresponds to the configuration mode for Sun Cluster HA for Apache and press Return.

   The clsetup utility displays a list of available nodes.

7. Select the nodes where you require Sun 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. The first node in the list is the primary node of this resource group.

8. 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 Sun Cluster HA for Apache configuration file.

9. 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 Sun Cluster HA for Apache document root directory.

10. 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 Sun Cluster HA for Apache mount point.

11. To confirm your selection of the mount point, type d and press Return.

    The clsetup utility displays a screen where you can specify the Sun Cluster HA for Apache network resource.

12. To confirm your selection of the network resource, type d and press Return.

    The clsetup utility displays information about the Sun Cluster HA for Apache configuration that the utility will create.

13. To confirm your selection of the configuration, type d and press Return.

    The clsetup utility displays information about the Sun 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.

    ---

14. To confirm your selection of the Sun Cluster objects, type d and press Return.

    The clsetup utility displays information about the Sun Cluster configuration that the utility will create.

15. 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 rollback the changes if it fails to complete the Apache configuration process.

    ---

16. Press Return to continue.

    The clsetup utility returns you to the list of options for configuring Sun Cluster HA for Apache.

17. (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 Sun Cluster HA for Apache resource group when you restart the utility.

18. Determine if the Sun Cluster HA for Apache resource group and its resources are online.

    Use the clresourcegroup(1CL) utility for this purpose. By default, the clsetup utility assigns the name apache-server-rg to the Sun Cluster HA for Apache resource group.

    # clresourcegroup status apache-server-rg

19. If the Sun Cluster HA for Apache resource group and its resources are not online, bring them online.

    # clresourcegroup online apache-server-rg