HP Serviceguard Toolkit for Enterprise DB PPAS for Linux User Guide Version A.01.00.00 Abstract This guide describes instructions for integrating and managing EDB PPAS in the HP Serviceguard for Linux environment.
© Copyright 2013 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 9) section.
2 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.01.00.00-00.<>.noarch.rpm The EDB PPAS toolkit files are installed in the following directories: $SGROOT/ppastoolkit nl $SGCONF/modules/tkit/ppas Here, SGCONF and SGROOT are environment variables.
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 uncomment it 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-9. /etc/init.d/ppas-9. .old • mv /etc/init.d/ppasAgent-9 /etc/init.d/ppasAgent-9 .old NOTE: • Repeat these steps to create multiple EDB PPAS database instances running in the Serviceguard for Linux environment.
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.
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. Problem scenario Possible cause Recommended action 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 Uninstalling the EDB PPAS toolkit This section discusses the procedure to uninstall the EDB PPAS toolkit. NOTE: You must delete the PPAS toolkit packages before you uninstall the EDB PPAS toolkit. To uninstall the EDB PPAS toolkit, run the following command: # rpm -e serviceguard-ppas-toolkit-A.01.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.
A Example: EDB PPAS package attributes The following is an example for specifying EDB PPAS package attributes.
vgchange_cmd "vgchange -a y" vg vgnfs1 concurrent_fsck_operations 1 concurrent_mount_and_umount_operations 1 fs_mount_retry_count 0 fs_umount_retry_count 1 fs_name /dev/vgnfs1/lvol2 fs_directory /EDB fs_type ext3 18 Example: EDB PPAS package attributes