Serviceguard Toolkits for Contrib User Guide Version A.12.00.00

Using SG Apache toolkit
After installing the SG Apache toolkit, you can use the toolkit to:
• Configure Apache toolkit packages in an SG/LX environment
• Manage Apache toolkit package
For more information about managing packages, see Managing packages. (page 35)
Configuring Apache toolkit packages
The subsequent sections explain how to configure Apache web server as a single instance package
and as a multiple instance package using the Apache toolkit.
NOTE: For each toolkit you can create a directory for managing package configuration files.
Configuring a single instance
For easy comprehension, the following naming conventions are used in this section:
• A Serviceguard Apache toolkit package is referred as APACHE1.
• The corresponding service name is referred as apache1_service.
• The Apache instance listens to a relocatable IP address.
• The node names used are node1 and node2.
You can configure a volume using either local or shared configuration. Using the local configuration,
you configure volumes on the local file system. The server root directory and the document root
directory are maintained in the local file system. However, using the shared configuration, the
server root directory and the document root directory are maintained on a volume group that is
shared among the nodes of the cluster.
Following is a sample procedure that indicates the steps that you must complete to configure an
Apache instance that uses shared storage for all Apache instance data. You must configure all
files of an Apache instance system /mnt/vgtry1/apache directory, which resides on a logical
volume lvol from a shared volume group /dev/vgtry1.
1. Create a volume group vgtry1 on shared storage.
2. Create a logical volume lvol in vgtry1.
3. Create a filesystem on the logical volume lvol.
4. Create a directory /mnt/vgtry1/apache on the local disk.
5. Mount device /dev/vgtry1/lvol to the /mnt/vgtry1/apache.
6. Copy all the files from the server root to /mnt/vgtry1/apache.
Configuring multiple instances
This section describes how to integrate multiple Apache web server instances using the Apache
web server toolkit. Before integrating the instances, you must create an instance of the Apache
server.
After you create an instance of the Apache server, you must create another instance using the
following procedure. All instances of the Apache server must be configured in the same way.
For easy comprehension, the following naming conventions are used in this section:
• The Serviceguard Apache toolkit package is named as APACHE2. The corresponding service
name is apache2_service.
• The Apache toolkit package is configured to listen to a relocatable IP address. Ensure that the
IP address is not used by any other application.
Using SG Apache toolkit 11