HP Serviceguard Toolkit for Enterprise DB PPAS for Linux User Guide Version A.12.00.00 Abstract This guide describes instructions for integrating and managing EDB PPAS in the HP Serviceguard for Linux environment.
© Copyright 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Overview..................................................................................................4 Advantages.............................................................................................................................4 Prerequisites.............................................................................................................................4 Supported configuration.............................................................................................
1 Overview The HP Serviceguard Toolkit for EDB Postgres Plus Advanced Server (PPAS) integrates and manages EDB PPAS (EDB PPAS toolkit) in the Serviceguard for Linux environment. The EDB PPAS toolkit allows you to start, stop, and monitor the PPAS database. The EDB PPAS toolkit has a set of shell scripts, which works with the Serviceguard master control script in the modular packages. Each PPAS database is configured in its own Serviceguard package.
Figure 1 High availability to the EDB PPAS database instance EDB Package Primary Network Adoptive Node Primary Node Heartbeat Network Node 1 Node 2 /edb Local Disk (PPAS binary) /dev/vgdata Shared PPAS data /edb Local Disk (PPAS binary) In Figure 1, you can configure the EDB PPAS database instance to create a volume group by using a shared disk that connects both Node 1 and Node 2 in the cluster. You can use the EDB PPAS toolkit to package this database instance.
Features This section discusses the new features available in the HP Serviceguard Toolkit for EnterpriseDB PPAS for Linux. Managing the EDB PPAS database instance The Serviceguard toolkit for EDB PPAS integrates and runs EDB PPAS in the Serviceguard for Linux environment. It allows you to start, stop, and monitor the PPAS database.
Online modification of the EDB PPAS toolkit attributes The EDB PPAS toolkit allows you to re-configure the values of certain package attributes and apply to the cluster configuration while the package is running. For information about the list of attributes that support online modifications, see the attribute definition table in the “Configuring the EDB PPAS toolkit” (page 10) section.
2 Installing and upgrading the EDB PPAS toolkit Installing the EDB PPAS toolkit You must install the toolkit RPM on all the package nodes to run the EDB PPAS toolkit package. To install the EDB PPAS toolkit, run the following command: # rpm -ivh serviceguard-ppas-toolkit-A.12.00.00-00.<>.noarch.rpm The EDB PPAS toolkit files are installed in the following directories: $SGROOT/ppastoolkit $SGCONF/modules/tkit/ppas Here, SGCONF and SGROOT are environment variables.
1. 2. Move the running EDB PPAS toolkit packages from the node that is being upgraded to another package node. Upgrade the EDB PPAS toolkit using the following command: rpm -Uvh --nopostun serviceguard-ppas-toolkit..noarch.rpm 3. Verify the installation, using the following command: rpm -q serviceguard-ppas-toolkit The system displays the following output: serviceguard-ppas-toolkit- 4. Repeat the above steps on all the other package nodes in the cluster.
3 Configuring the EDB PPAS toolkit After installing the EDB PPAS toolkit, you can create the Serviceguard package to manage the EDB PPAS database instance. NOTE: The EDB PPAS toolkit supports only Serviceguard modular style packages. Creating the EDB PPAS toolkit package To create a EDB PPAS toolkit package: 1. Create a directory for the package on all the package nodes. For example: # mkdir $SGCONF/ NOTE: 2. 3. The directory name is user specified.
Attributes Description This variable specifies the user name of the EDB PPAS administrator. The online modification of this attribute is not supported. DB_USER For example: DB_USER ppas email_id Specify the email address to which you want the alert notifications to be sent. NOTE: By default, the email_id is commented. You must remove the comment and provide the required email id to receive the alert notifications. MONITOR_INTERVAL This attribute specifies the monitor interval.
cmmodpkg -e -n node1 -n node2 ppas_pkg cmmodpkg -e ppas_pkg 8. After you configure the EnterpriseDB toolkit packages, move the EDB startup script in the /etc/init.d directory by using the following command on all the cluster nodes: • mv /etc/init.d/ppas- /etc/init.d/ppas- .old • mv /etc/init.d/ppasAgent- /etc/init.d/ppasAgent- .old NOTE: 12 • EDB PPAS supports multiple-instance configuration on the same node.
4 Managing the EDB PPAS database instance This section provides the information about managing the EDB PPAS toolkit package. Running a package After adding the package to a Serviceguard cluster, start the package using the cmrunpkg command. For example: # cmrunpkg ppas_pkg This command starts the EDB PPAS database instance. Online modification of EDB PPAS toolkit attributes To perform the online modification, do the following: 1.
Table 2 Modules affected during online addition (continued) Extending storage to the package sg/filesystem (filesystem.sh) sg/volume_group (volume_group.sh) sg/pr_cntl (pr_cntl.sh) If addition of storage has failed, ensure the following: To add PR keys, you must register on all the paths and then reserve on one • Persistent reservation is added path. To view all the paths: to the disk. #multipath -ll • Volume group is activated To view the node PR keys: with hosttags.
Table 2 Modules affected during online addition (continued) cmapplyconf –P #Run the package cmrunpkg Modifying EDB tkit/ppas/ppas PPAS toolkit attributes values online If a EDB PPAS toolkit service fails to start after modifying EDB PPAS toolkit attribute value while package is up and running, then package will not fail, but the new values will not be taken in to effect until package is halted and successfully started again.
5 Troubleshooting This section explains some of the problem scenarios that you might encounter while working with the HP Serviceguard Toolkit for EnterpriseDB PPAS in a Serviceguard for Linux cluster. 16 Problem scenario Possible cause EDB PPAS database instance Another EDB PPAS database instance For details, see in PPAS DB log file, might be running on the same port on which is present inside the EDB PPAS which you are trying to run this data directory (DB_DATA_DIR). instance of PPAS.
6 Removing the EDB PPAS toolkit This section discusses the procedure to remove the EDB PPAS toolkit. NOTE: You must delete the PPAS toolkit packages before you remove the EDB PPAS toolkit. To remove the EDB PPAS toolkit, run the following command: # rpm -e serviceguard-ppas-toolkit-A.12.00.
7 Support and other resources Information to collect before contacting HP Be sure to have the following information available before you contact HP: • Software product name • Hardware product model number • Operating system type and version • Applicable error message • Third-party hardware or software • Technical support registration number (if applicable) How to contact HP Use the following methods to contact HP technical support: • See the Contact HP worldwide website: http://www.hp.
Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, send a message to: docsfeedback@hp.com Include the document title and part number in your message. All submissions become the property of HP. New and changed information in this edition The following content is added in this edition: • Maintaining a package section Typographic conventions This document uses the following typographical conventions: Book title The title of a book.
A Example: EDB PPAS package attributes The following is an example for specifying EDB PPAS package attributes.
vgchange_cmd "vgchange -a y" vg vgedb concurrent_fsck_operations 1 concurrent_mount_and_umount_operations 1 fs_mount_retry_count 0 fs_umount_retry_count 1 fs_name /dev/vgedb/lvol2 fs_directory /EDB fs_type ext3 21
Glossary $SGCONF /usr/local/cmcluster/conf for RHEL /opt/cmcluster/conf for SLES11 $SGROOT /usr/local/cmcluster for RHEL /opt/cmcluster for SLES11 ADF Attribute definition file ASCII American Standard Code for Information Interchange Package A grouping of application services (individual Linux processes) under Serviceguard.