Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Serviceguard Manager Version A.04.00 Release Notes > Chapter 1 Serviceguard Manager Version A.04.00 Release Notes

Installing and Running Serviceguard Manager

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

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 XP Professional Edition or Windows 2000 Professional.

If a previous version of Serviceguard Manager is already installed, stop any instances of Serviceguard Manager running on a node before installing the new version there. See information about uninstalling below.

Before Installing Serviceguard Manager

When deciding where to install Serviceguard Manager, consider the connections from users to the Session Server node, the connection from the Session Server to cluster nodes, and creating the security you want.

Which operators will use the interface, and which capabilities do you want them to have? Which management stations will they sit at, and which computer will they log into to begin a Serviceguard session? See the table Table 1-1 “Capabilities of Session Servers on Target clusters” for help in planning this. Serviceguard version 11.16 has a new way to setting up access.

Installing Software

You can install Serviceguard Manager on three platforms: HP-UX, Linux, or Windows. The methods are slightly different for each. Use the section below that is appropriate for your type of installation.

There are two ways to install Serviceguard Manager: from the HP Serviceguard Distributed Components disk, or from this web site: http://www.software.hp.com. You can choose the English, Japanese, Korean, Simplified Chinese, or Traditional Chinese version.

Serviceguard Manager installs its own JRE (Java Runtime Environment™), and can not use any other JRE that may already be installed.

If you are updating from an earlier version, first uninstall the earlier version.

If you update from a version of Serviceguard Manager earlier than A.03.00, your user preference files will be replaced with newer default settings. Preference files changed inA.03.00.01, and earlier settings cannot be carried over.

NOTE: Serviceguard Manager supports system default colors for all platforms. Most system settings work, but a custom color setup could cause problems. For example, you may see what seems to be an empty box. However, when you drag the mouse to highlight it, you may discover that your system is displaying white font on a white background. If you restore the system to default colors, you will be able to see things as they were designed.
Installing Serviceguard Manager on HP-UX

You can install version A.04.00 of Serviceguard Manager on a computer with bundles specifically for HP-UX Version 11.x

  • To install from the HP Serviceguard Distributed Components disk:

    1. Mount the CD-ROM directory, choosing /SD_CDROM for your mount directory.

    2. Enter the swinstall command.

    3. When the window opens, set Source Depot Type to: LocalCDROM.

      For Source Depot Path, fill in the appropriate release name. For example, if you have HP-UX 11.23, use:

      SD_CDROM/SGManager/HP-UX/11.23/sgmanager.depot

    4. swinstall allows you to select: B8325BA A.04.00 Serviceguard Manager. Select the appropriate platform, then start the install.

  • To install from the web, go to http://www.software.hp.com. 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. Download the depot, and store it on your disk, perhaps in the /tmp directory. To save disk space, you can remove this depot from your disk when you have finished installing.

    3. Run the swinstall command on this depot. The user interface will lead you through the installation (mark, analyze, install). Select the B8325BA Serviceguard Manager product.

After swinstall completes, verify the installation:

  1. Is the man page installed? (Enter: man sgmgr)

  2. Was the directory created for log files? (Enter: ll /var/opt/sgmgr)

  3. Are all the program files in the installation directory? If you install in the default directory, you should see the following when you enter ll /opt/sgmgr/* :

    • bin

    • examples

    • jre

    • lib

    • config

    • OV (if HP OpenView is installed)

Serviceguard Manager installs its own JRE (Java™ Runtime Environment) and cannot use any other JRE on the computer.

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 Serviceguard Manager Version A.03.00.01 and later. Preferences from earlier versions cannot be carried over.

If you have Network Node Manager or OpenView Operations installed on this computer, also see the section below, Installing with HP OpenView.

For more information about installation procedures and related issues, refer to the man page for swinstall. Also see the manual Managing HP-UX Software with SD-UX , which can be viewed or printed from http://www.docs.hp.com -> HP-UX 11.0 Operating System -> System Administration.

Installing Serviceguard Manager on Linux

Install Serviceguard Manager on a computer that has one of these versions of Linux:

  • Red Hat Enterprise Linux Version 3

  • SuSE Linux Enterprise Server, Version 8 (SLES 8), United Linux version 1.0 (SuSE is available only in English.)

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 </SGM_ROM>.

    2. From </SGM_ROM>/SGManager/LINUX, enter:

      • For Red Hat Linux:

      rpm -i sgmanager-A.04.00.00-1.product.redhat.i386.rpm

      • For SuSE Linux (32-bit machines):

      rpm -i sgmanager-A.04.00.00-1.product.suse.i386.rpm

      • For SuSE Linux (64-bit machines):

      rpm -i sgmanager-A.04.00.00-1.product.suse.ia64.rpm

  • To install from the web:

    1. Go to http://www.software.hp.com. Click High Availability. Click Serviceguard Manager in the alphabetical list.

    2. Save the sgmanager-A.04.00.00-1.product.redhat.i386.rpm file to your disk. (To save disk space, you can remove the rpm file when installation is done.)

    3. From the directory where you saved the file, run the install process with this command:

      • For Red Hat Linux:

      rpm -i sgmanager-A.04.00.00-1.product.redhat.i386.rpm

      • For SuSE Linux (32-bit machines):

      rpm -i sgmanager-A.04.00.00-1.product.suse.i386.rpm

      • For SuSE Linux (64-bit machines):

      rpm -i sgmanager-A.04.00.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/. By default, the SuSE install directory is /opt/sgmgr/.

    • bin

    • examples

    • jre

    • lib

    • log

    • users

    • config

Serviceguard Manager installs its own JRE (Java Runtime Environment™) and cannot use another JRE already installed on the computer.

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. Your old preferences cannot be carried over.

Installing Serviceguard Manager on Windows

Install Serviceguard Manager on a computer that has Microsoft Windows XP Professional Edition or Windows 2000 Professional installed. If you currently have an older version of Serviceguard Manager, uninstall it first: Start -> Programs -> ServiceGuard Manager -> Uninstall.

You can install from two places:

  • To install from the Serviceguard Distributed Components CD:

    1. Insert the disk in the PC’s drive.

    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://www.software.hp.com. Click High Availability, then Serviceguard Manager.

    2. Click on the link under Download Software (sgmanager.exe).

    3. You can store the file on your system, or run it directly from the website. If you download to your system, you can remove it after installation.

    4. On your PC, run sgmanager.exe (or double-click the sgmanager.exe file in Explorer).

    5. Choose a language option. The default install directory is: C:\Program Files\Hewlett Packard\ServiceGuard Manager\ but you can choose a custom installation directory.

The SG Manager A.04.00 icon will appear on your desktop.

Using Windows Explorer, verify that these folders are installed:

  • bin

  • examples

  • jre

  • lib

  • log

  • users

  • config

  • ov (if OpenView Network Node Manager is already installed on the PC)

Serviceguard Manager installs its own JRE (Java Runtime Environment™) and cannot use any other JRE already on the computer.

If you have Network Node Manager installed on this computer, see Installing with OpenView, below.

Verify that the name ServiceGuardManager is listed in Start -> Programs ->. Verify that a SG Manager A.04.00 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. Your old preferences cannot be carried over.

Installing with HP Systems Insight Manger

When you install Serviceguard Manager,it looks to see if you have installed HP Systems InsightManager, version C.04.01.00 or later. If you have, the ServiceguardManager install process automatically registers with InsightManager, and you can launch Serviceguard Manager from within InsightManager.

If you want to install Insight Manager after you have Serviceguard Manager installed, no registration is done. In this situation, uninstall Serviceguard Manger, and then re-install it.

Installing with HP OpenView

When you install Serviceguard Manager, it looks to see if you have installed one of these OpenView products:

  • NNM (Network Node Manager) Version 7.0, 6.31, 6.3, and 6.2.

  • OpenView Operations Version 7.0 and 8.0. (OVO includes NNM.)

  • VPO Version 6.0. Serviceguard Manager does not support VPW (Vantage Point for Windows).

If you have installed any of these, the install process automatically does these things:

  • Adds a menu item and a button on the toolbar of NNM or OVO to start Serviceguard Manager (“Serviceguard Mgr Launcher”).

  • Sends Serviceguard events to be logged in the Event Log. The Serviceguard subagent is responsible for notifying the management station when status or configuration changes. By default, it is installed in /usr/lbin/cmsnmpd.

  • 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. The Serviceguard subagent services the Serviceguard MIB objects. By default, it is installed in /usr/lbin/cmsnmpd.

Then the installation process looks to see if you have OVO Version 7 or later, or VPO 6.0 or later. If you do, it checks to see if you also have ClusterView.

If you do have ClusterView installed, no files will be overwritten. The launcher will be installed, so you can open an instance of Serviceguard Manager from the OpenView menu.

If you do not have ClusterView, but you do have OVO, tools are added to the Tool Bank, ready for an OpenView administrator to assign them. These tools are listed below.

Assign these tools carefully. Some require root access to the Serviceguard nodes, and some can grant it indirectly.

  • Serviceguard Mgr launcher: You can launch Serviceguard Manager from OpenView. Serviceguard Manager is independent of OpenView. It does not use the OV daemons or object database to discover the configuration or status of clusters. Instead, it gets information by connecting to Serviceguard Version A.11.13 or greater; then Serviceguard goes out on its subnets and gathers the information.

  • 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.

      • View Cluster Config: uses cmviewcl to see cluster configuration and status of running clusters.

      • View System Log: opens vi editor to view /var/adm/syslog/syslog.log

    • HA Admin Tools:

      • Run Cluster: uses the cmruncl command to start a cluster from the node you selected

      • Halt Cluster: uses the sghaltcl command (a variant of the cmhaltcl command) to halt the cluster of the node you selected

      • Run Node: uses the cmrunnode command to join the selected node to its cluster

      • Halt Node: uses the cmhaltnode command to make the selected node inactive in its cluster

    • Net Diag Tools

      • View Interface Config: displays LAN interface configuration parameters

      • LAN Diag and Admin: launches the program lanadmin, which administers and tests the local area network.

      • Scan LAN interfaces: uses lanscan to display information about each LAN device that has software support on the system.

      • IP Interface Stat: uses netstat to display statistics for network interfaces and protocols, as well as the contents of various network-related data structures. (Choose options to filter output.)

    • 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

Uninstalling from HP-UX

On HP-UX, uninstall Serviceguard Manager by running this command: swremove B8325BA

After uninstalling Serviceguard Manager, you can remove the Serviceguard Manager logs; if you are not going to re-install, you can remove the entire directory (by default, /var/opt/sgmgr/). If you are not going to re-install, you can also remove the preferences that are stored in the user’s home directory, under the .sgmgr directory.

Uninstalling from Linux

On Linux, uninstall Serviceguard Manager by running this command:

rpm -e sgmanager

After uninstalling, you can remove the Serviceguard Manager logs; if you are not going to re-install, you can remove the entire directory (by default, /usr/local/sgmgr on Red Hat and /opt/sgmgr on SuSE). If you get a message about “unable to remove.” you can ignore the ones about error messages. If you are not going to reinstall, you can remove the preferences that are stored in the user’s home directory, under the.sgmgr/users directory.

Uninstalling from Windows

On Windows, there are two ways to uninstall Serviceguard:

  • 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.

After uninstalling Serviceguard Manager, you can delete the log files; if you are not going to re-install, you can remove the entire directory: C:\Program Files\Hewlett-Packard\ServiceGuard Manager\log folder. If you are not going to re-install, you can also remove the user preferences folder. In Windows, by default, preferences are in: C:\Program Files\Hewlett-Packard\ServiceGuard Manager\users

Removing Serviceguard Manager - OpenView Integration

In addition to doing the swremove of Serviceguard Manager, you need to manually do the following things if you integrated Serviceguard Manager into OpenView.

  • If you have NNM only (not OVO):

    1. Remove event templates: Go to the NNM menu and select Options -> Event Configuration. From the list, delete the following event groups:

      • hpEMSTraps

      • hpmcMgmt Traps

      • hpmcSGTraps

    2. Remove SGMgr MIBs: Go to the NNM menu and select Options -> Load/Unload MIBs:SNMP. Unload the following MIBs:

      • hp-cluster

      • hp-sgcluster

  • If you have OVO (which includes NNM):

    1. Remove messaging: Go to the Message Group Bank, and delete Message Group HA.

    2. Remove templates and monitors: Open the Message Source Templates window. By default, the following are visible on the top level. Remove them:

      • 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. First get a list of the nodes that are sending traps to your computer. Select Event Browser from the View menu. Click the Configuration tab. Make a note of the nodes and IP addresses.

    Notice that the configuration tab shows only the nodes in your current map. If you have several subnets, connect to a Session Server in each, and use the View All option.

  2. Log in to each node and edit the /etc/snmpd.conf file to remove your computer from the list.

  3. Stop and re-start the SNMP Master Agent on the node.

    1. Find the process ID number, using: ps -ef | grep snmp.

      The master agent will show as snmpd, and the subagent will show as cmsnmpd.

    2. Stop that process, using: kill <pid>

    3. Restart the agents.

      Use: /sbin/init.d/SnmpMaster start for the master agent

      Use: /sbin/lbin/cmsnmpd for the subagent.

Setting up Serviceguard Manager

Security, Logins, and Access Policies

In version A.11.16, Serviceguard changed its method of controlling and assigning logins, and roles. Therefore, the way you open Serviceguard sessions and discover Serviceguard objects is quite different in version A.11.16 and later than it is in earlier versions.

Logins and roles, Version A.11.16 and later:

Creating or modifying configuration still requires Root access (UID=0) on a cluster’s nodes. Starting in Serviceguard version A.11.16, however, a root user can configure clusters and packages using Serviceguard Manager or on the command line.

In addition, there are four possible non-root roles that can be defined in the cluster’s configuration files. These can be specified as Access Control Policies in the cluster and package configuration files. Each Access Policy has three parts:

  • User: A username from the host’s /etc/passwd file

  • Host: Where the user will issue the command. For Serviceguard Manager, this is the Session Server node

  • Role: Which commands the user may issue on the cluster where the policy is configured. There are 4 non-root roles:

    • monitor (view, read-only): in cluster configuration file.

      This is the only role that does not require a Host with Serviceguard A.11.16.

    • (single package) package admin: defined in that package’s configuration file

    • (all cluster packages) package admin: defined in the cluster configuration file

    • full admin (cluster and its packages): defined in the cluster configuration file

For more information about access control policies, see the online help for Configuring Clusters: Roles.

If you upgraded a cluster to Serviceguard A.11.16, its cmclnodelist has been migrated into Access Control Policies. With A.11.16, cmclnodelist is gone. If your previous cmclnodelist file listed the pair <sess.server><user> your cluster configuration now has an Access Control Policy that lists this triplet:

  • USER_NAME <user>

  • USER_HOST <sess.serve>

  • USER_ROLE Monitor (All migrated pairs have Monitor, the view-only role.)

If your old cmclnodelist had the wildcard +, the configuration file now has an Access Control Policy with wildcards in triplet:

  • USER_NAME ANY_USER

  • USER_HOST ANY_SERVICEGUARD_NODE

  • USER_ROLE MONITOR (All migrated pairs have Monitor, the view-only role.)

Only a root user can modify configuration to change Access Control Policies. You do not have to halt the cluster, or any packages, to add, modify, or delete an Access Control Policy.

Bootstrapping a new A.11.16 node

If you have a cluster on an A.11.16 node, be sure to configure at least one Access Control Policy if you want to see the cluster and its nodes in Serviceguard Manager. Once a cluster is configured, Serviceguard will only check access in the cluster’s configuration files. It will ignore the .rhosts file and the cmclnodelist file.

If no cluster is configured, you can create a cmclnodelist file to act as a “bootstrap” for access. Once done, you will be able to see information about the node on the Serviceguard Manager map and tree, and in Properties. If it is not a part of a cluster now, it will still show up in the Unused Nodes list. To configure it later, you can connect to a Session Server with Serviceguard version A.11.16, select the node from Unused Nodes, and select Configuration from the Actions menu.

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:

    ########################################

    # Do not try to configure access in this file.                                        

    # This is for bootstrapping only, before a cluster is configured.   

    # Once a cluster exists, Serviceguard will ignore this file.           

    ####################################################

  3. Below the comment, create monitor access so Serviceguard can discover and display the node as an unused node.

    It may be easiest to add a wildcard + (plus) below the comment. This is equivalent to granting the view-only Monitor role to Any User from Any Serviceguard Node. It will allow any session on the node’s subnet to query the cluster and display its information in any session of Serviceguard Manager.

    Alternately, you can list any number of <hostname> <username> pairs. Hostname can be any Session Server’s name, and user can be any name in that Session Server’s /etc/passwd file.

Now you will be able to see your new A.11.16 node in a Serviceguard Manager session. If the Session Server also has version A.11.16, you can configure this node into a cluster. You will be prompted for the node’s root password.

Logins, roles and security, Version A.11.15 and earlier:

If you are an experienced Serviceguard user, you may think there is a similarity between the command-line user’s cmviewcl command and the way Serviceguard Manager user gets information about remote clusters with Serviceguard version A.11.15 and earlier. Using Serviceguard Manager, certain users can also relay the most common administrative commands to these Serviceguard clusters, and the effect seems the same as logging into the node and issuing the command on the command line.

Please notice, however, that the permissions and access mechanisms are not the same. In version A.11.15 and earlier, the Serviceguard Manager user’s permissions depend on his login to the 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 11.16. Users can log into a Session Server as any user. However, before the user can configure any object they see in the map or tree they must give a root password for at least one of the cluster nodes.

If the target node has version A.11.15 or earlier, the Session Server node must always use user= root to access it. The recommended access mechanism is to include the Session Server name or IP address in the target nodes’ cmclnodelist file. A less secure way is to include the Session Server node in a target node’s .rhosts file. Listing in cmclnodelist allows contact to Serviceguard alone; a listing in .rhosts grants wider access.

If the user is logged in as root to a Session Server node with version A.11.15 or earlier, the Session Server node will also display certain common administrative commands in the menu. The Session Server relays these commands to the clusters in the session for the users.

If you are updating from an earlier version, think about permissions on your HP-UX nodes with Serviceguard Version A.11.13, A.11.14, and A.11.15. Any person who can log in to that node as root may be able to do administrative commands on any cluster objects on that node’s subnets. If you do not want access, you can limit the root logins on that node, or limit that node’s access to particular clusters on its subnets.

Making a Highly Available Connection

If you wish, you can create a Serviceguard package that will keep the connection between your monitoring station and the Session Server highly available. If there is a failure in the connection, you might see the “Connection Dropped” message flash momentarily, but Serviceguard will maintain your connection. It will fail the connection over from one node in a Serviceguard cluster to another node in the same cluster.

Serviceguard Manager gets its information by connecting to a Session Server with Serviceguard A.11.13 or later. A component of Serviceguard, the Cluster Object Manager, polls the available subnets to discover other Serviceguard objects. It collects status and configuration information, and sends the information back to Serviceguard Manager.

To set up the highly-available connection between Serviceguard Manager and Session Server nodes in a cluster, follow these steps:

Create the package in a cluster with Serviceguard. For viewing, use Serviceguard A.11.12 or later. For administration commands use Serviceguard A.11.13 or later.

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.com and click High Availability; the products are listed alphabetically.

  1. Get an IP address to use as the package’s relocatable address. You can use nslookup to be sure the package name and IP address are correctly associated in your DNS table.

  2. When naming the package, choose one that your users will recognize, such as Clus3Srvr. The first time a user opens Serviceguard Manager they will see the Connect dialog box. They can type this name in for the server connection. After that, the name will appear in a list every time that user opens Serviceguard Manager.

  3. Make only these two modifications to the package configuration file template, and leave the defaults for the other fields:

    • List the package nodes. For high-availability, it is best to list all the nodes in the cluster.

    • For the run and halt scripts pathname, specify the control script name and path for the run and halt script. (The default path is in the documentation.)

  4. Open the control script template. Make just two modifications, and leave the defaults for the other fields. These will allow the connection between your client (Serviceguard Manager management node) and the Session Server:

    • Insert the IP address associated with your package (the package’s relocatable address).

    • Insert the address of the subnet.

Assigning and Configuring New OpenView OVO Tools

When you install Serviceguard Manager, it checks to see if you have OpenView OVO installed. If you do, it checks to see if you have the tools listed in “Installing with HP OpenView” above. If you do not have those tools, it installs them for you.

To Restore Default Configuration

If the Serviceguard Manager configuration gets lost or corrupted, follow these steps to restore the default configuration that came with Serviceguard Manager:

  1. Exit all OVO user sessions.

  2. Stop the OVO server process with the /opt/OV/bin/ovstop opc command.

  3. Go to /opt/sgmgr/OV and untar the configurations files in with the tar -xvf ito-ux.tar command.

  4. Go to /opt/OV/bin/OpC and upload the new configuration with the opccfgupld -replace -subentity /opt/sgmgr/OV/SGOpC command.

  5. Stop and restart the OVO package with the /opt/OV/bin/OpC/opcsv -stop and /opt/OV/bin/OpC/opcsv -start commands.

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 Sytems Insight Manager or HP OpenView.

Launching Serviceguard Manager from HP-UX

To launch Serviceguard Manager, standalone, in HP-UX, go to the Serviceguard Manager directory (by default, /opt/sgmgr/bin) and enter the sgmgr or ./sgmgr command, plus any options you want. To see the full command, enter man sgmgr. The options are also listed below in sgmgr Command Syntax.

You can also create a script or alias that includes the options you want.

Launching Serviceguard Manager from Linux

To launch Serviceguard Manager in Linux, go to the Serviceguard Manager directory (by default, Red Hat is /usr/local/sgmgr/bin and SuSE is /opt/sgmgr/bin). Enter the sgmgr or ./sgmgr command, plus any options you want. To see the full command, enter man sgmgr. The options are also listed below in sgmgr Command Syntax

Launching Serviceguard Manager from Windows

Here are 3 ways to launch Serviceguard Manager in Windows:

  • By default, a shortcut icon is placed on your desktop (labelled SG Manager A.04.00). Click it to launch the program. When installed, it has the simple command without options. You will be prompted to enter the options once the program opens. You can modify the icon’s properties to use any of these options: your name, password, Session Server to connect to, and clusters to discover. If you want to modify it follow the steps below:

    1. Right-click on the icon, then choose Properties from the popup menu.

    2. Add options to the command in “Target.” The options are listed below in sgmgr Command Syntax.

      It is best to put quotes around command and file path names; Windows allows spaces and other characters in directories, and that could cause parsing errors.

  • 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 below in sgmgr Command Syntax.

    It is best to put quotes around command and file path names.

Launching Serviceguard Manager fromHP Insight Manger or OpenView

Within Insight Manager or OpenView, you can launch SGMgr from themenu bar or by clicking the SGMgr icon.

When Serviceguard Manager installs, it checks to see if HP Insight Manager or OpenView are installed. If either are present, Serviceguard registers itself with the program. Therefore, if you have both, you want to install Serviceguard Manager after you installInsight Manager or OpenView. If you already have Insight Manager or OpenView installed, simply de-install Serviceguard Manager, then re-install it.

sgmgr Command Syntax

The basic command to launch Serviceguard Manager in Linux or HP-UX is sgmgr. In Windows, it is SGMgr.exe or SGMgrDOS.exe. The options are listed below. If you do not mention an option with the command, you will be prompted to specify it in a window after the interface opens.

  • To open a saved (static) file:

    • The -f <filename> option opens a saved .sgm file. Enter the pathname of the saved file, in quotes. This option is not used with any other options.

  • To open a Session Server connection and see a map that you can update; repeat these options for each session:

    • The -s <servername> option specifies a node with Serviceguard A.11.13 or later. This node will become your Session Server. Serviceguard will discover the other clusters on its subnet, and report back their configuration and status information.

    • If you specify the -s option, you may also specify the -l <username> option to give the logon name of a user on that server.

    • If you specify the -l option, you may also specify the -p <password> option to give that user’s password.

    • The -c <clustername> option specifies the clusters you want the Session Server to discover. (The Session Server can discover only the nodes on its subnets.) These clusters will be displayed on your map, under the Session Server’s name. Repeat the -c option for several clusters in this session.

    • The -local option will discover the cluster where the Session Server is configured, whether it is specifically listed in the -c option or not.

    • Specify -un TRUE to see the unused nodes discovered by this Session Server on its subnets. These are nodes that have Serviceguard installed, but are not currently configured in any cluster.

  • To open another session, repeat these steps.

When the interface opens, you will see what you have chosen, and you will be given a chance to fill in any options you have not yet chosen.

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.

To see your own clusters “live”, use Connect. You need to have a logon for a node that is running Serviceguard A.11.13 or later. This will be your Session Server. It can discover clusters on its subnets, if they have granted it access.

For the rules about access for admin capability, see Table 1-1 “Capabilities of Session Servers on Target clusters”

Once you have a session open, open Help from the toolbar. Open the Getting Started topic from the Help window’s Table of Contents. Using Serviceguard is a good place to start. Map Legend explains status, colors, and symbols on the map.

Select a tree or map object, and choose Properties from the Actions menu.

Select a tree or map object and look at Actions. You will see Administration if you have permission. If you select an object with Serviceguard A.11.16, you will also see Configuration.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© , 2004 Hewlett-Packard Development Company, L.P.