Serviceguard Manager Version A.05.01 Release Notes Manufacturing Part Number: B8325-90061 February 2007 © Copyright 2007 Hewlett-Packard Company.
Legal Notices © Copyright 2007 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.
Serviceguard Manager Version A.05.01 Release Notes 1 Chapter 1 Serviceguard Manager Version A.05.
Serviceguard Manager Version A.05.01 Release Notes Announcements Announcements Serviceguard Manager is the graphical user interface for the Serviceguard product. With it, you can monitor, administer, and configure clusters managed by Serviceguard, Serviceguard Extension for RAC, Metrocluster, Continentalclusters, and Serviceguard Extension for Faster Failover. NOTE HP Serviceguard Manager has a new web-based, (SIM) Systems Insight Management/ System Management Homepage (SMH) application, version B.01.
Serviceguard Manager Version A.05.01 Release Notes Announcements If the Session Server and target clusters are running Serviceguard version A.11.15.00 through A.11.17.01, you can also do the most common administrative commands through the interface.
Serviceguard Manager Version A.05.01 Release Notes What’s in this Version What’s in this Version Serviceguard Manager version A.05.01 was released to support Serviceguard A.11.17.01 on HP-UX. You can use it to create and modify configuration of Serviceguard A.11.16.xx and A.11.17.xx clusters and failover packages. Two features are new to version A.05.01: • Support for native (64 bit) x86-64 JRE (version 1.5). • Integration with HP SIM 5.10 to launch Serviceguard Manager versions A.05.01 or B.01.
Serviceguard Manager Version A.05.01 Release Notes What You See What You See The figure below shows an instance of Serviceguard Manager with two sessions. (Up to 10 sessions are supported.) The icon by the connection to both Session Servers show that the user’s login is root. The Alerts button tells you there is information about serious alerts. We can see a red-bordered cluster is down. Also critical are the clusters that have a package icon with a red X, showing they have a package that is down.
Serviceguard Manager Version A.05.
Serviceguard Manager Version A.05.01 Release Notes What You See With Serviceguard Manager, you see Serviceguard objects three ways. • In the tree on the left pane, you see cluster relationships listed hierarchically. You can navigate through the map by clicking an object in the tree. The map pane will show information relevant to the object you clicked. For example, if you click a node, you see that node, its cluster, and the packages configured to run on it.
Serviceguard Manager Version A.05.
Serviceguard Manager Version A.05.01 Release Notes What You See Starting with Serviceguard Manager A.04.00 on HP-UX, you can configure clusters and failover packages on nodes with Serviceguard A.11.16.xx. Version A.05.0x, extends this to nodes with Serviceguard A.11.17.xx.
Serviceguard Manager Version A.05.01 Release Notes What You See How it Works You can install Serviceguard Manager on a system running HP-UX, Linux, or Windows. From the system running Serviceguard Manager, you connect to a Serviceguard Node (HP-UX or Linux) to establish your management session. When you establish a Session Server connection, which is a cluster member node that the administrator connects to through Serviceguard Manager and displays the discovered clusters.
Serviceguard Manager Version A.05.01 Release Notes What Documentation is Available for This Version What Documentation is Available for This Version These Release Notes will help you install Serviceguard Manager. Once Serviceguard Manager is running, online help has the information about how to use the interface. Start with the Help topic Using Serviceguard Manager. If you have installed Serviceguard Version A.11.16.xx or A.11.17.
Serviceguard Manager Version A.05.01 Release Notes What Documentation is Available for This Version For information about HP-UX, go to: http://www.docs.hp.com and scroll to HP-UX in the alphabetical listing. For information about Red Hat Linux, go to http://www.redhat.com For information about SUSE Linux, go to http://www.suse.com For information about HP OpenView Operations, IT/Operations, and Network Node Manager, refer to: http://www.docs.hp.
Serviceguard Manager Version A.05.01 Release Notes Compatibility Information and Installation Requirements Compatibility Information and Installation Requirements Before you begin an installation, read this entire document and any other Release Notes or READMEs you have. Compatibility This section summarizes the compatibility of this version of Serviceguard Manager with related products and their versions. For all versions (this and older), see the Serviceguard Manager Support Matrix posted on http://www.
Serviceguard Manager Version A.05.01 Release Notes Compatibility Information and Installation Requirements • Novell SUSE Linux Enterprise Server 9, (SLES 9), SUSE Linux Enterprise Server 10 (SLES 10), SUSE Linux Desktop 10.1.
Serviceguard Manager Version A.05.01 Release Notes Compatibility Information and Installation Requirements — SUSE: /opt/sgmgr/log • 100 MB of additional hard disk space in: — Red Hat: /usr/local/sgmgr/ — SUSE: /opt/sgmgr/ • Up to 33 MB of additional hard disk space during the install process. Running on Windows, these are the minimum requirements for Serviceguard Manager: • 256 MB of memory • 65 MB of available hard disk space • 1 MB for log files when Serviceguard Manager is run.
Serviceguard Manager Version A.05.01 Release Notes Compatibility Information and Installation Requirements clusters you can reach with that Session Server. The next three columns describe the capabilities, and what is required for each: Monitor, Administration, and Configuration. NOTE A.05.01 is required for integration with SIM to work. If A.05.01 is not installed, clicking on an 11.17.01 cluster in SIM will not take you to the System Management Homepage (SMH) for Serviceguard. A.05.
Serviceguard Manager Version A.05.01 Release Notes Compatibility Information and Installation Requirements Table 1-2 Session Server’s Serviceguard version A.11.13.xx, A.11.14.xx, and A.11.15.xx A.11.16.xx, A.11.17.xx Chapter 1 Capabilities of Session Servers on Target Clusters (Continued) Target cluster’s Serviceguard version A.11.16.xx, A.11.17.xx To Monitor To Administer Not supported Configuration menu available when an A.11.16.xx or A.11.17.
Serviceguard Manager Version A.05.01 Release Notes Compatibility Information and Installation Requirements Table 1-2 Session Server’s Serviceguard version A.11.16.xx A.11.17.xx Capabilities of Session Servers on Target Clusters (Continued) Target cluster’s Serviceguard version A.11.16.xx, A.11.17.
Serviceguard Manager Version A.05.01 Release Notes Compatibility Information and Installation Requirements Port Requirements Serviceguard Manager itself does not have any port requirements. If you want to receive SNMP traps in the Event Browser, you need the SNMP ports 161 and 162. Serviceguard does have port requirements, particularly when interacting with internal firewalls.
Serviceguard Manager Version A.05.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Installing and Running Serviceguard Manager Installing Software You can install Serviceguard Manager on an HP-UX workstation, on an HP-UX server (with or without Serviceguard), on a Linux workstation (with or without Serviceguard), or on a PC with Windows 2003, Windows XP Professional Edition, or Windows 2000 Professional.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Serviceguard Manager installs its own JRE (Java Runtime Environment™), and cannot use any other JRE that may already be installed. If you are updating from an earlier version, it is a good idea to first uninstall the earlier version. If you are on HP-UX and updating from A.03.00.01 or later, a prompt will offer to remove the earlier version for you, and then replace it with the new.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager • To install from the web, go to www.hp.com/go/softwaredepot. Click High Availability, then Serviceguard Manager for HP-UX. Fill out the information form. A download window opens. 1. Select your operating system from the “Software Specification” pull-down list. (To see the version of an HP-UX node, use the uname command from the node.) 2.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager For more information about installation procedures and related issues, refer to the man page for swinstall. Installing Serviceguard Manager on Linux You can install from two places: from the Distributed Components CD or from a browser • To install from the Serviceguard Distributed Components CD: 1. Insert the disk and mount the CD-ROM drive. Choose a name for your directory, for example . 2.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager rpm -i sgmanager-A.05.01.00-1.product.suse.i386.rpm — For SUSE Linux Integrity: rpm -i sgmanager-A.05.01.00-1.product.suse.ia64.rpm After rpm completes, verify the installation: 1. Is the man page is installed? (Enter: man sgmgr) 2. Are all the program file directories in the installation directory? By default, the Red Hat default directory is /usr/local/sgmgr/.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager 2. Click the Start menu in lower left corner of your screen. Choose Settings -> Control Panel. Double-click Add/Remove Programs. 3. Click on Install. 4. Navigate to SGManager\Windows. Select sgmanager.exe. 5. Click Finish and follow installation directions. • To install from the web: 1. Go to http://hp.com/go/softwaredepot. Click High Availability, then Serviceguard Manager. 2.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Verify that the name Serviceguard Manager is listed in Start -> Programs ->. Verify that an SG Manager A.05.01 icon is on your desktop. If you are updating from an earlier version of Serviceguard Manager, your user preference files are replaced with default settings. The new preference files are compatible with architecture changes in Serviceguard Manager Version A.03.00.01 and later.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager NOTE • Adds Serviceguard messages to the OVO Message Browser if assigned, and in the NNM Alarm Browser. • Modifies the Event Configuration Tool so you can set up automatic actions and filter Serviceguard messages. • Lets you configure the data collection to get historical MIB data from network nodes, including data stored in Serviceguard MIB objects.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager • Installs these Tools to work on a selected cluster node: — HA Info Tools: — Query Cluster Conf: uses cmquerycl to gather configuration information — Scan Cluster: uses cmscancl to display information about cluster configuration, LAN cards, disks, and file systems. — View Cluster Binary Config: uses cmviewconf to see an ASCII extraction of the binary configuration file.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager — LVM tools. — View Logical Volumes: displays the logical volumes currently configured — View Volume Groups: uses vgdisplay to show information about the volume groups configured. Uninstalling Serviceguard Manager Before installing Serviceguard Manager, it is a good idea to uninstall any previous versions.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Uninstalling from Windows Here are two ways to uninstall Serviceguard Manager on Windows: • From the Start menu, choose Programs -> Serviceguard Manager -> Uninstall. • From the Start menu, choose Settings -> Control Panel -> Add/Remove Programs. Select Serviceguard Manager from the list.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager — Syslog — SG_check_cmsnmpd — EMS SNMP Traps — HA Cluster SNMP Traps 3. Remove Application Tools: From the Application Bank, remove these tool groups: — HA Info — HA Admin — LVM — Net Diag Uninstalling: Removing SNMP Trap Destinations If you are not going to re-install, and you do not wish to receive SNMP traps anymore, you need to “unset” the trap destinations on the sending nodes. 1.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Setting up Serviceguard Manager Security, Logins, and Access Policies In version A.11.16.xx, Serviceguard changed its method of controlling and assigning logins, and roles. Therefore, the way you open Serviceguard Manager sessions and discover Serviceguard objects is quite different in versions A.11.16.xx and later than it is in earlier versions of Serviceguard. Logins and roles, Version A.11.16.xx and A.11.17.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager If you upgraded a cluster to Serviceguard A.11.16.xx or A.11.17.xx, its cmclnodelist has been migrated into Access Control Policies. With A.11.16.xx and A.11.17.xx, cmclnodelist is gone. If your previous cmclnodelist file listed the pair , your cluster configuration now has an Access Control Policy that lists this triplet: USER_NAME USER_HOST
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager To create a bootstrap file: 1. Create the file /etc/cmcluster/cmclnodelist on the node. 2. Using any ASCII editor, add a comment like this one: #################################################### # Do not try to configure access in this file. # This is only for bootstrapping, before a cluster is configured. # Once a cluster exists, Serviceguard will ignore this file.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Session Server, not the cluster node. It is the Session Server that interacts with the cluster nodes on the user’s behalf, through the Cluster Object Manager, a Serviceguard API. A Serviceguard Manager user does not need to directly access target nodes to do configuration of Serviceguard version A.11.16.xx or A.11.17.xx. Users can log into a Session Server as any user.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager To set up the highly-available connection between Serviceguard Manager and Session Server nodes in a cluster, use a Serviceguard A.11.15.00 and later node as the Session Server. See Creating the Package Configuration chapter in the Serviceguard manual. All Serviceguard manuals are posted on the web and you can view or print them there. Go to http://www.docs.hp.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Launching Serviceguard Manager You can starting Serviceguard Manager directly from HP-UX, Linux, and from Windows.You can also start Serviceguard Manager from within HP Systems Insight Manager or HP OpenView. Launching Serviceguard Manager from HP-UX To launch Serviceguard Manager, A.05.01, in HP-UX, go to the Serviceguard Manager directory (by default, /opt/sgmgr/bin) and enter the sgmgr or .
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager • From the Start menu, select Programs -> Serviceguard Manager. This launches the simple command, with no options. • Open a DOS window. At the DOS prompt, enter the SGMgrDOS.exe command. Depending on your system path setup, you may have to enter the SGMgr directory (by default C:\Program Files\Hewlett-Packard\ServiceGuard Manager\bin). You can also enter options, as listed in “sgmgr Command Syntax” on page 41.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager — If you specify the -s option, you may also specify the -l option to give the logon name of a user on that server. — If you specify the -l option, you may also specify the -p option to give that user’s password. — The -c parameter specifies the clusters you want the Session Server to discover. (The Session Server can discover only the nodes on its subnets.
Serviceguard Manager Version A.05.01 Release Notes Installing and Running Serviceguard Manager Using the Interface When Serviceguard Manager opens, you have a chance to choose Connect or Open (unless you have already specified one of them in the command line). Use Open to see any saved “snapshot” file (one with.sgm extension). To get acquainted with the program, open a supplied Example file. Use Connect to see your own clusters “live.” You need to have a logon for a node that is running Serviceguard A.11.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version Patches and Fixes in this Version This section lists known patches, defects that have been fixed in this version, and current known defects and workarounds. Please consult the Release Notes for the language you will install, to find information about language-specific patches, defects, and known problems.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version Before you use the Event Browser, install a patches on all HP-UX nodes in the clusters that will send the SNMP traps to your Serviceguard Manager Event Browser. The patch numbers are: • PHSS_27858 for HP-UX 11.x Serviceguard Manager installs its own JRE (Java Runtime Environment). Check for defects for each platform’s JRE: • On HP-UX, Serviceguard Manager automatically installs JRE Version 1.4.2.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version Fixed in this Version JAGaf13947 NPE while trying to save after gui was up for 24 hours (Java problem) • What was the problem? After Serviceguard Manager had been running for 24 hours, Java gave a Null Pointer Exception when user tried to Save. JAGag00662 when adding two services in guided mode index number does not increment • What was the problem? When using Serviceguard Manager 5.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGaf83497: Serviceguard Manager tooldef for SIM needs tag • What was the problem? Missing the Serviceguard Manager tooldef for SIM needs tag. Add HP_SERVICEGUARD_MANAGER to the tdef file. Known Problems and Workarounds The following lists known problems for Serviceguard Manager version A.05.01, at time of publication. This list is subject to change without notice.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version 1. Launch Serviceguard Manager directly from command line: /opt/sgmgr/bin/sgmgr 2.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version • What is the workaround? Use command line interface to re-name the package. Assuming XXX is the existing package name, and YYY is the new package name: 1. Log in to one of cluster nodes as root. 2) Create a temporary directory and cd to it. 3. Get package configuration: cmgetconf -p XXX >p.conf 4. Edit file p.conf: vi p.conf 5. Change the value of PACKAGE_NAME from XXX to YYY. 6. Save the file. 7.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version When this is entered into the Service Command field and applied, the target control script in /etc/cmcluster//.sdf.sh would be found to contain: SERVICE_CMD[0]="/usr/bin/X11/xclock -title My Xclock" This command does not function, because if you try to invoke this, xclock would give a usage error. • What is the workaround? There is no workaround.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGaf64743 Help: Problem entering Locale ko chars in index of online help viewer • What is the problem? Entering ko (Korean) characters into the index of online help can cause the help window to hang. • What is the workaround? There is no workaround.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGaf45963 Cannot cmapplyconf from root from node in cluster • What is the problem? Creating or modifying a cluster or package within Serviceguard Manager (equivalent to using the cmapplyconf command) may result in the inability for Serviceguard to resolve the source IP address to a valid IP Address. For redundancy, Serviceguard commands use all networks available on a system to communicate with Serviceguard daemons.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version 10.8.2.132 15.145.162.67 10.30.8.8 15.145.162.69 10.30.8.7 sly.uksr.hp.com bit.uksr.hp.com bit.uksr.hp.com bot.uksr.hp.com bot.uksr.hp.com sly bit bit bot bot Following is an example host entry from /etc/nsswitch.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version To make the setting permanent, so that it won't need to be restarted after a reboot, edit the /etc/rc.config.d/xfs file. Change the line: RUN_X_FONT_SERVER=0 to read: RUN_X_FONT_SERVER=1 4. Confirm that xfs is still running and add xfs to font path. Run the xset command as follows: $ xset +fp tcp/:7000 $ xset fp rehash To confirm the font path, run the xset command as follows: $ xset -q 5.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGaf17035 Some accessibility short-cut keys do not work in non-English locale. • What is the problem? Some accessibility short-cut keys do not work in traditional Chinese, simplified Chinese, Korean, or Japanese. • What is the workaround? There is no workaround. If you require short-cut keys, install the English version.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGaf15152 Package with all nodes (*) causes problem when adding node to cluster. • What is the problem? If a configuration uses a wild card (*) to set node membership to all nodes, you will have trouble adding a new node to the cluster. • What is the workaround? On the package configuration screen, remove the "all nodes" star wildcard. Select all the nodes in the list, adding them one at a time. Then add the new node.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGaf11256 Serviceguard Manager won't discover nodes if another cluster has the same name. • What is the problem? Once Serviceguard Manager discovers a cluster, it will ignore any others that have the same name. For example, imagine that one subnet has a cluster clus1, whose members are node1 and node2. Now imagine that another subnet has a cluster named clus1, whose members are nodeX and nodeY.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGae69202 - Rarely, cannot start program when running on SUSE via ReflectionX • What is the problem? Occasionally, an exception happens when using ReflectionX to remotely start Serviceguard Manager on SUSE Linux. (SUSE Linux is supported for English only.) • What is the workaround? This is related to a problem in the Java Runtime Environment. There is no workaround. Often it will work if you try again.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGae50727 In non-English locales, typed characters not visible in HP-UX • What is the problem? When running non-English versions of SGMgr on HP-UX, typed non-English characters are invisible in the input text boxes. The characters can be read by the program, but not seen by the user. This occurs in the text fields of Alerts: Search and Help: search.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGad80600 - Certain progress messages are not localized. • What is the problem? Serviceguard Manager displays progress messages directly from Serviceguard as administration commands are processed. Serviceguard does not localize these messages and Serviceguard Manager can only translate the start and end messages for every admin operation. The intermediate messages are only in English.
Serviceguard Manager Version A.05.01 Release Notes Patches and Fixes in this Version JAGag08885 - HP-UX/Linux: typed target folder is ignored during save session Chapter 1 • What is the problem? On HP-UX and Linux, target folder path is ignored if its path is typed into the text field when saving session. • What is the workaround? Use mouse or keyboard short-cuts to change directories in the file save dialog.
Serviceguard Manager Version A.05.01 Release Notes Software Availability in Native Languages Software Availability in Native Languages Serviceguard Manager Version A.05.01 interface is available in five language options: • ABA American English • ABJ Japanese • AB0 Simplified Chinese • AB1 Korean • AB2 Traditional Chinese Please consult the Release Notes for the language you will install, to find information about language-specific patches, defects, and known problems.
