Document revision date: 15 July 2002

The Availability Manager evaluates each data collection for events. The Availability Manager posts events when data values in a data collection meet or exceed user-defined thresholds and occurrences. Values for thresholds and occurrences are displayed on Event Customization pages similar to the one shown in Figure 1-6. Thresholds and occurrences are described in the next section.

Figure 1-6 Sample Event Customization Page

Thresholds and occurrences are criteria that the Availability Manager uses for posting events.

A threshold is a value against which data in a data collection is compared. An occurrence is a value that represents the number of consecutive data collections that meet or exceed the threshold.

Both thresholds and occurrences are customizable values that you can adjust according to the needs of your system. For details about how to change the values for thresholds and occurrences, see Chapter 7.

Relationship between Thresholds and Occurrences

For a particular event, when the data collected meets or exceeds the threshold, the data collection enters a threshold-exceeded state. When the number of consecutive data collections to enter this state meets or exceeds the value in the Occurrence box (see Figure 1-6), the Availability Manager displays (posts) the event in the Event pane.

A closer look at Figure 1-6 shows the relationship between thresholds and occurrences. For the DSKRWT, high disk device RWAIT count event, a threshold of 1 Rwait process has been set. A value of 2 in the Occurrence box indicates that the number of Rwait errors during 2 consecutive data collections must meet or exceed the threshold of 1 for the DSKRWT, high disk device RWAIT count event to be posted.

1.4 How Does the Availability Manager Maintain Security?

The following sections explain these security methods further.

1.4.1 Data Analyzer Password Security

Figure 1-7 illustrates how you can use passwords to limit access to node information. The Testing Department's Data Analyzer, whose password is HOMERUNS, can access only OpenVMS Data Collector nodes with the HOMERUNS password as part of their security triplets. The same is true of the Accounting Department Data Analyzer, whose password is BATTERUP; it can access only OpenVMS Data Collector nodes with the BATTERUP password as part of their security triplets.

Figure 1-7 Availability Manager Password Matching

The Availability Manager sets a default password when you install the Data Analyzer. To change that password, you must use a customization option that is explained in Chapter 7.

1.4.2 OpenVMS Data Collector Security Features

• Private LAN transport
  The Availability Manager protocol is based on the 802.3 Extended Packet Format (also known as SNAP). The IEEE Availability Manager protocol values are as follows:

  Protocol ID: 08-00-2B-80-48 Multicast Address: 09-00-2B-02-01-09

  
  If you filter protocols for bridges or routers in your network, you need to add these values to your network protocols.

• Availability Manager data-transfer security
  Each OpenVMS node running as a Data Collector has a file containing a list of security triplets. For Data Analyzer and Data Collector nodes to exchange data, the passwords on the nodes must match.
  In addition, note the following:
  • Data Collector nodes that have read access allow Windows Data Analyzer nodes to view system data.
  • Data Collector nodes that have write access also allow a matching Windows Data Analyzer node to perform fixes or modifications to the running system.
    Chapter 7 explains security triplets and how to edit them.

• OpenVMS file protection and process privileges
  When the Availability Manager is installed, it creates a directory (SYS$COMMON:[AMDS$AM]) and sets directory and file protections on it so that only the SYSTEM account can read the files in that directory. For additional security on these system-level directories and files, you can create access control lists (ACLs) to restrict and set alarms on write access to the security files.
  For more information about creating ACLs, see the OpenVMS Guide to System Security.

This chapter provides the following information:

• How to start the Availability Manager Data Collector
• How to start the Availability Manager Data Analyzer
• How to use the main Application window
• How to display basic node data

For information about installing the Availability Manager on OpenVMS or Windows systems, refer to the appropriate installation instructions. You can access these instructions from the Availability Manager web pages at the following URL:

http://www.openvms.compaq.com/openvms/products/availman/

The installation instructions for OpenVMS systems also include an explanation of how to install and use both DECamds and the Availability Manager on the same system.

2.1 Starting the Data Collector

To use the Data Collector on a particular node, do either of the following:

• Run the following command procedure:

  $ @SYS$STARTUP:AMDS$STARTUP START

• Add the following command to the SYSTARTUP_VMS.COM command file in the SYS$MANAGER directory:

  @SYS$STARTUP:AMDS$STARTUP START

This section describes what you need to do after the Availability Manager Data Analyzer is installed. Starting the Data Analyzer is somewhat different on OpenVMS and on Windows systems. However, on both systems, starting the Data Analyzer automatically starts the Java graphical user interface (GUI) that allows you to view information that is collected from the Data Collector nodes.

The following sections contain the sequence of steps required to start the Data Analyzer on an OpenVMS node and a Windows node.

2.2.1 How to Start the Data Analyzer on an OpenVMS Alpha Node

Make sure the Data Analyzer has been installed on the OpenVMS Alpha node from which you want to monitor other nodes. (Installation instructions are at the web site referred to at the beginning of this chapter.)

To start the Data Analyzer, enter the following command:

$ avail/avail

The Availability Manager then displays the main Application window, which is shown in Figure 2-1.

Refer to the Installation Instructions for qualifiers you can use with the AVAIL/AVAIL command.

2.2.2 How to Start the Data Analyzer on a Windows Node

Make sure the Data Analyzer has been installed on the Windows node from which you want to monitor other nodes. (Installation instructions are at the web site referred to at the beginning of this chapter.)

Starting the Data Analyzer

To start the Data Analyzer, follow these steps:

1. Choose the following options beginning with the Windows Start menu:
   Start ---> Programs
2. Choose Availability Manager.
3. Choose Data Analyzer Startup.

The Availability Manager then displays the main Application window, which is shown in Figure 2-1.

2.3 Using the Application Window

Once it starts, the Availability Manager watches for notifications from nodes running the Data Collector. After receiving notification from the Data Collector, the Availability Manager attempts to connect to a node. This is called the attempting collection phase.

If the node passes the security check while the Availability Manager is attempting the connection, the connection succeeds, and data collection starts. This is called the data collection phase. If the node fails the security check, it is in the connection failed phase.

While collecting data, if a node goes down, or a network connection fails between the graphical user interface and the node, that node is placed in the path lost phase.

The Availability Manager notifies you of these phases and other states in the Application window, which is shown in Figure 2-1.

Figure 2-1 Application Window

The Application window is divided into three segments, or panes:

• Group pane
  The Group pane is at the top left of the window. In this pane, you select the group of nodes that you want to monitor. The first number in parentheses after "OpenVMS" is the number of groups that are listed. The second number is the total number of nodes in the listed groups.
  The number in parentheses after each group name is the total number of nodes in the group. Preceding the name of each group, you might see as many as five color-coded columns of numbers.
  From left to right, the columns display the number of nodes in the group that are in the states described in Table 2-1.

  Table 2-1 Node Information Displayed in Group Pane

  Column Number	Color	Description
  1	Brown	Number of nodes for which attempts to configure the node have failed---for example, because the node is in a connection failed phase.
  2	Yellow	Number of nodes that are in the attempting collection phase.
  3	Black	Number of nodes that are in a path lost phase.
  4	Red	Number of nodes that are in the data collection phase but that have exceeded a threshold, thereby causing an event to be posted.
  5	Green	Number of nodes that are in the data collection phase.

• Node pane
  The Node pane occupies most of the top right of the window. In this pane, the Availability Manager displays a list of the nodes in the group you select in the Group pane, along with summary data for each node. In Figure 2-1, the Debug cluster group has been selected. Chapter 3 contains more information about using the Node pane.
  Figure 2-1 shows the node information that is displayed when you select a group of OpenVMS nodes. Somewhat different information is displayed for a group of Windows nodes. For more information about this, see Chapter 3.
• Event pane
  The Event pane occupies the entire bottom of the window. In this pane, the Availability Manager displays events that occur on all the nodes being monitored on your system. (Events signal potential problems that might require further investigation.)
  An event must reach a certain level of severity to be displayed. You can customize the severity levels at which events are displayed (see Chapter 7). For more information about displaying events, see Chapter 5.

You can change the size of the panes as well as the width of specific fields in the Application window and also the borders between the fields by clicking on a border and dragging it. Scroll bars indicate whether you are displaying all or part of a screen. For example, clicking a right arrow on a scroll bar allows you to view the rightmost portion of a screen.

2.3.1 Other Window Components

Title bar

The title bar runs across the top of the window and contains the product name.

Menu bar

The menu bar, immediately below the title bar, contains the following menu options:

• File
  The File menu contains the Exit option, which allows you to stop the Data Analyzer and close the window.
• Customize
  The Customize menu contains options that allow you to customize various aspects of the Availability Manager. These options are explained in Chapter 7.
• Help
  The Help menu offers different types of online help for the Availability Manager. These options are explained in Section 2.5.

Status bar

The status bar runs across the bottom of the window. It displays the name of the selected group and the number of nodes in that group.

2.3.2 Displaying More Information

In the initial Application window (Figure 2-1), which is displayed by default, you can do the following at any time:

• Click a field to select it.
• Double-click most fields to display a page containing information specific to that field.
• Right-click a field to display a popup menu.

When you start the Availability Manager, the Group pane lists groups of nodes that the Data Analyzer has found. If the Data Analyzer finds Windows nodes, those are also displayed.

To monitor specific nodes, you must select the group in the Group pane that contains those nodes (see Figure 2-2).

Figure 2-2 Group Pane

Groups are set up during installation on Data Collector nodes and are user definable. You might define groups by function, type of hardware, or geographical location.

For example, if you were to set up groups of nodes by geographical location, you might assign nodes A and B to a group called Dallas and nodes C, D, and E to a group called Denver. When you select a group, the Availability Manager displays only the nodes in that group, as shown in the following table:

Group Selected	Nodes Displayed
Dallas	Node A Node B
Denver	Node C Node D Node E

By default, all nodes are members of one group, DECAMDS, when your system is set up. If you want to change the groups being monitored, you need to to use a customization option to make changes. See Section 7.1 for instructions.

Compaq recommends that you define a cluster as its own group.

2.4 Displaying More Information about Nodes

Within the group of nodes you select, the Availability Manager displays all the nodes with which that group can communicate. Figure 2-3 shows a list of OpenVMS nodes.

Figure 2-3 OpenVMS Node Pane

Each node name has an icon next to it. The color of the icon represents a state similar to those described in Table 2-1:

Color	Description
Brown	Attempts to configure the node have failed---for example, because it failed the security check.
Yellow	Node security check is in progress or has failed.
Black	Path to node has been lost.
Red	Security check was successful. However, a threshold has been exceeded, and an event has been posted.
Green	Security check was successful; data is being collected.

2.4.1 Choosing a Node

To choose a node on a Windows or an OpenVMS system, double-click a node name in the Node pane to highlight the name of the node and display the Node Summary page (Figure 2-4). Alternatively, you can right-click a node name to display a popup menu. To display the Node Summary page, select the Display... option.

Figure 2-4 OpenVMS Node Summary Page

The data displayed on this page is explained in Chapter 3.

At the top of the Node Summary page are tabs that correspond to most of the types of node data displayed in the Node pane. When you click a tab on the Node Summary page, the Availability Manager displays most of the same pages that are displayed when you double-click a data item in the Node pane (see Figure 2-3).

2.4.2 Specifying Data to Collect on OpenVMS Nodes

To turn on various types of data to be collected, follow these steps:

1. In the Application window, click the Customize menu.
2. Click Customize OpenVMS....
3. Click the Data Collection tab.

The Availability Manager displays the Data Collection Customization page (Figure 2-5).

Background and foreground collections are explained in Chapter 1.

Figure 2-5 Data Collection Customization Page

The following types of data are collected by default:

• Node summary
• Single disk
• Single process

To stop collecting Node Summary data, for example, clear the check box for "Node summary" in the "Collect" column. You cannot, however, turn off the collection of single disk and single process data. These types of data are collected by default when you open a Single Disk Summary page or a Process Information page, respectively.

To turn on a type of data to be collected, select the check box for that type in the "Collect" column. Table 7-1 identifies the page where each type of data that is collected appears.

On the Data Collection Customization page, you can also change the intervals at which data is collected. Collection intervals are explained in Chapter 7.

2.4.3 Sorting Data

• Event pane of the Application window (Figure 1-1)
• CPU Process Summary pane (Figure 3-7)
• Memory page (Figure 3-9)
• Bottom pane of I/O Summaries page (Figure 3-11)
• Disk Status Summary page (Figure 3-13)
• Disk Volume Summary page (Figure 3-15)

Depending on the field, you can sort data alphabetically or numerically. An alphabetical sort is performed using ASCII character values; for example, dollar signs ($) precede letters in the sort order.

To sort the values in a field, double-click the corresponding column heading. To reverse the sort order, double-click the column heading again.

	privacy and legal statement
6552PRO_001.HTML