HP OpenVMS Systems Documentation
DECamds User's Guide
Order Number: AA--Q3JSE--TE
This guide explains how to use DECamds software to detect and fix system availability problems. It also explains how to install DECamds.
Revision/Update Information: This guide supersedes the DECamds User's Guide, Version 7.1.
Operating System and Version:
Data Analyzer:OpenVMS Alpha and VAX Version 7.2 or
Software Version: Compaq DECamds Version 7.3
© 2001 Compaq Computer Corporation
Compaq, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office.
OpenVMS is a trademark of Compaq Information Technologies Group, L. P. in the United States and other countries.
Motif, OSF/1, and UNIX are trademarks of The Open Group in the United States and other countries.
All other product names mentioned herein may be trademarks of their respective companies.
Confidential computer software. Valid license from Compaq 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.
Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
The Compaq OpenVMS documentation set is available on CD-ROM.
This guide is intended for system managers who install and use Compaq DECamds software.
This guide contains the following chapters and appendixes:
The following manuals provide additional information:
For additional information about Compaq OpenVMS products and services, access the Compaq website at the following location:
Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:
How to Order Additional Documentation
Use the following World Wide Web address to order additional documentation:
If you need help deciding which documentation best meets your needs, call 800-282-6672.
The following conventions are used in this guide:
|Availability||Alerts users to resource availability problems, suggests paths for further investigation, and recommends actions to improve availability.|
|Centralized management||Provides centralized management of remote nodes within an extended local area network (LAN).|
|Intuitive interface||Provides an easy-to-learn and easy-to-use DECwindows Motif user interface.|
|Correction capability||Allows real-time intervention, including adjustment of node and process parameters, even when remote nodes are hung.|
|Customization||Adjusts to site-specific requirements through a wide range of customization options.|
|Scalability||Makes it easier to monitor multiple OpenVMS systems and OpenVMS Cluster systems over a single site or over multiple sites.|
1.1 How Does DECamds Work?
DECamds is a client/server application. It is installed in two parts as
A node that has the DECamds Data Provider installed announces its availability, using a multicast LAN message, to any DECamds Data Analyzer that is installed and running. The Data Analyzer receives the Data Provider's availability announcement and a communications link is established.
The Data Provider runs at a high interrupt priority level (IPL), so it gathers data and transmits it to the Data Analyzer even if the Data Provider is on a remote node that is hung. However, because of the high IPL collection, the Data Provider cannot collect nonresident memory data, restricting some data collection in process space.
The Data Analyzer portion of DECamds is a DECwindows Motif application that runs on any OpenVMS Version 6.2 or later system. Although you can run the Data Analyzer as a member of a monitored cluster, it is typically run on an OpenVMS system that is not a member of the cluster being monitored. You can have more than one Data Analyzer application executing in a LAN, but only one can be running at a time on each OpenVMS system.
System data is analyzed and translated into meaningful values and rates that are displayed in DECwindows Motif windows. The data is screened for data points that exceed thresholds that might cause system or OpenVMS Cluster availability problems. The Data Analyzer can also implement various system correction options if authorized to do so.
The Data Analyzer and Data Provider nodes communicate over an Extended LAN using an IEEE 802.3 Extended Packet format protocol. Once a secure connection is established, the Data Analyzer instructs the Data Provider to gather specific system and process data.
Figure 1-1 illustrates the interaction of the Data Analyzer and Data Provider on nodes in a cluster.
Nodes A, C, D, E, F, and H can exchange information with the Data Analyzer. Node B has defined its security to exclude the Data Analyzer from accessing its system data. Node G has not installed DECamds and does not communicate with the Data Analyzer.
Figure 1-1 DECamds Processing
This section discusses where to install the DECamds Data Analyzer software. You can install and run the DECamds Data Analyzer from either a cluster member or a standalone system outside the cluster. However, Compaq recommends that you run the Data Analyzer from outside a cluster because then you can monitor system information even if the nodes in the cluster pause or hang.
Generally, you can install and run the DECamds Data Provider on any
OpenVMS Version 6.2 or later system. Appendix A describes the
specific system hardware and software requirements for installing and
running the DECamds Data Analyzer.
1.3 DECamds Security Features
Protocol ID: 08-00-2B-80-48 Multicast Address: 09-00-2B-02-01-09
You can create additional security files in the directory associated with the AMDS$CONFIG logical name. By default, this logical name is assigned to AMDS$SYSTEM. As you customize DECamds, you can change the logical assignment of AMDS$CONFIG to read input files from other locations.
The following sections describe what a security triplet is, where to
find the security files, and how to set up your security files.
1.3.1 Understanding DECamds Security Files
A security triplet determines which systems can access system data from the node. The AMDS$DRIVER_ACCESS.DAT and AMDS$CONSOLE_ACCESS.DAT files on the Data Analyzer and Data Provider systems list security triplets.
The exclamation point (!) is a comment delimiter; any characters after the comment delimiter are ignored.
Table 1-1 describes the detailed format of each portion of the security triplet and then gives some examples for different situations.
|DECnet address (area.number)||
Although DECnet is not required to run DECamds, the DECnet address is
used to determine a node's physical address. The DECnet address is
created by using the
area.number format, where area is a value from 1 to 63, and
number is a value from 1 to 1023. This address is modified into a
physical address of the form AA-00-04-00-xx-yy to conform to the
standard IEEE 802.3 protocol for network addressing. The AA-00-04-00
prefix is associated with the Compaq-owned address. The xx-yy suffix is
the hexadecimal representation of the address formula:
If you are running on a system with more than one LAN adapter or are running DECnet-Plus networking software, then this format is not valid for you. Instead, you must use the hardware address or wildcard address format for this field.
|Hardware address (08-00-2B-xx-xx-xx)||
The hardware address field is the physical hardware address in the LAN
adapter chip. It is used if you have multiple LAN adapters or are
running the DECnet-Plus networking software on the system (as opposed
to the DECnet for OpenVMS Phase IV networking software).
For adapters provided by Compaq, the hardware address is in the form 08-00-2B-xx-xx-xx, where the 08-00-2B portion is Compaq's valid range of LAN addresses as defined by the IEEE 802 standards and the xx-xx-xx portion is chip specific.
To determine the value of the hardware address on a system, use the
OpenVMS System Dump Analyzer (SDA) as follows:
The previous commands display a list of available devices. Choose
the template device of the LAN adapter you will be using and then enter
the following command:
|Wildcard address (*)||
The wildcard character allows any incoming triplet with a matching
password field to access the Data Provider node. Use the wildcard
character to allow read access and to run the console application from
any node in your network.
Because the Data Analyzer does not use this field, you should use the wildcard character in this field in the AMDS$CONSOLE_ACCESS.DAT file.
Use of the wildcard character for write access security triplets enables any system to perform system-altering fixes.
Table 1-2 describes how the Data Provider node interprets a security triplet match.
|08-00-2B-12-34-56\HOMETOWN\W||The Data Analyzer has write access to the node only when the Data Analyzer is run from the node with this hardware address (multiadapter or DECnet-Plus system) and with the password HOMETOWN.|
|2.1\HOMETOWN\R||The Data Analyzer has read access to the node when run from a node with DECnet for OpenVMS Phase IV address 2.1 and the password HOMETOWN.|
|*\HOMETOWN\R||Any Data Analyzer with the password HOMETOWN has read access to the node.|