Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

DECamds User's Guide


Previous Contents Index

5.5.1.3 Setting Window Customizations

The Sort, Filter, and collection interval settings at the data window level affect performance. Follow these guidelines to balance customization with performance:

5.5.2 Optimizing System Settings

Changing several system settings might improve the performance of DECamds on your system. The following sections discuss these settings and how to change them.

5.5.2.1 Setting Data Link Read Operations

Increase read operations to the data link by changing the logical name AMDS$COMM_READS in the AMDS$CONFIG:AMDS$LOGICALS.COM command procedure. The AMDS$COMM_READS logical name controls the number of requests for data (read operations) queued to the data link.

If you increase data collection, increase the number of requests that can be queued. Digital recommends two requests for each node being monitored. Each read operation queued requires 1500 bytes of BYTLM quota.

5.5.2.2 Setting the Communications Buffer

Increase the communications buffer by changing the logical name AMDS$COMM_BUFFER_SIZE in the AMDS$CONFIG:AMDS$LOGICALS.COM command procedure. The buffer controls the size of the global section used for communication between the collector node and the communications process.

When DECamds cannot keep up, it displays the following warning message:


AMDS$_COMMBUFOVF---communications buffer overflow.  Increase the buffer by 25 percent. 

In addition to increasing the value of the AMDS$COMM_BUFFER_SIZE logical name, set the system parameter GBLPAGFIL on the collector node to cover the increase. This adds to the amount of data collection that DECamds can perform.

The value of the GBLPAGFIL system parameter must always be higher than the number of FREE_GBLPAGES. To determine the value of FREE_GBLPAGES, enter the following commands:


$ A = F$GETSYI("FREE_GBLPAGES")
$ SHO SYM A 

The value of A must conform to the following formula:


2 * ( (buffer_size / 512) + 512) 

5.5.3 Optimizing Performance with Hardware

Table 5-7 provides an approximate guideline for the number of nodes you can monitor when running DECamds on certain computer types.

Table 5-7 Monitoring Nodes
Monitoring Computer Type Number of Nodes Monitored
  Observation Only Observe and Fix
VAXstation 3100 0-30 0-20
VAXstation 4000 Model 60 20-60 20-50
VAX 6000 1 75-150 65-130
VAX 4000 Model 90 75-150 65-130
DEC 3000 Model 400 0-50 0-50
DEC 4000 Model 620 0-70 0-70
DEC 7000 Model 720 Any number Any number


1With DECwindows display directed to a workstation

Follow these suggestions when choosing and configuring a console:


Appendix A
Installing DECamds

This appendix explains how to install DECamds software on OpenVMS Alpha and VAX systems.

A.1 Preparing to Install DECamds

This section describes the preparations and requirements necessary for installing DECamds.

DECamds provides online release notes. Digital strongly recommends that you read the release notes before proceeding with the installation. You can print the text file of the release notes from the following location:


SYS$HELP:AMDS071.RELEASE_NOTES 

A.2 Kit Location and Installation Information

The DECamds kit has two components:

For OpenVMS Alpha systems, use the POLYCENTER Software Installation Utility to install the DEC-AXPVMS-AMDS-V0710--1.PCSI kit on the software distribution compact disk. Section A.4 describes the installation procedure on Alpha systems.

For OpenVMS VAX systems, install the AMDS071.A and AMDS071.B save sets using the VMSINSTAL procedure.

The DECamds VAX kits are on the following media:
Magnetic tape Third volume
TK50 tape Second volume
Compact disk [AMDS071] directory

Section A.5 describes the installation procedure on VAX systems.

A.3 Installation Requirements

This section provides a checklist of hardware and software requirements for DECamds. A typical installation takes approximately 5 to 10 minutes per node, depending on the type of media and your system configuration.

Note

On both Alpha and VAX systems, Digital recommends that you perform a system disk backup before installing any software. Use the backup procedures that are established at your site. For details about performing a system disk backup, see the OpenVMS Backup utility documentation.

A.4 OpenVMS Alpha System Installation

This section describes the installation procedure on an OpenVMS Alpha system.

Sample Installation on an OpenVMS Alpha System

Example A-1 shows a sample installation on an OpenVMS Alpha system. This sample was run on a system that had no previous version of DECamds installed. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation.

Example A-1 Sample OpenVMS Alpha Installation

$ PRODUCT INSTALL AMDS/SOURCE=DAD15:[AMDS071.KIT]
The following product has been selected: 
    DEC AXPVMS AMDS V7.1               Layered Product [Installed] 
 
Do you want to continue? [YES] 
 
DEC AXPVMS AMDS V7.1: DECamds (Availability Manager for Distributed Systems) V7.1 
 
    COPYRIGHT © (c) 1994, 1995, 1996 -- All rights reserved 
 
    Digital Equipment Corporation 
 
Do you want the defaults for all product options? [YES] 
 
    DECamds Startup File 
 
    DECamds Message Help 
 
    DECamds Logicals Customization File 
 
    DECamds Data Provider Security Access File 
 
    DECamds Data Provider Installation Verification Procedure 
 
    DECamds Data Analyzer Security Access File 
 
    DECamds Data Analyzer Installation Verification Procedure (IVP) 
 
    IVP may fail due to the following PQL values being too low: 
 
    PQL_MASTLM, PQL_MBIOLM, PQL_MTQELM, or PQL_MBYTLM    See the file 
AMDS$SYSTEM:AMDS$PCSI_IVP_OUTPUT.LOG for help on failure. 
 
Do you want to view the options? [NO] 
 
Execution phase starting ... 
 
The following product will be installed: 
    DEC AXPVMS AMDS V7.1               Layered Product 
 
Portion done: 0%...30%...40%...50%...60%...70%...80%...90%...100% 
 
The following product has been installed: 
    DEC AXPVMS AMDS V7.1               Layered Product 
%PCSI-I-IVPEXECUTE, test procedure executing ... 
%PCSI-I-IVPSUCCESS, test procedure completed successfully 
 
DEC AXPVMS AMDS V7.1: DECamds (Availability Manager for Distributed Systems) V7.1 
 
    This product requires the following SYSGEN parameters: 
        GBLPAGES add 1172
 

A.5 OpenVMS VAX System Installation

The DECamds installation procedure consists of a series of questions and informational messages. See Example A-2 for a sample installation. The actual installation should take only a few minutes, but depending on your installation media, this time could be longer.

To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again.

To install DECamds:

  1. Invoke VMSINSTAL from a privileged account.


    @SYS$UPDATE:VMSINSTAL AMDS071 Device-name OPTIONS N 
    

    where:


    For more information about software installation options, see the OpenVMS System Manager's Manual.
  2. Confirm DECnet status.


    %VMSINSTAL-W-DECNET, Your DECnet network is up and running. 
       . 
       . 
       . 
    * Do you want to continue anyway [NO]? 
    

    Type YES and continue the installation.

  3. Confirm system backup.


    * Are you satisfied with the backup of your system disk [YES]? 
    

    Always back up your system disk before performing any installation. If you are satisfied with the backup of your system disk, press Return.

  4. Mount the media.


    Please mount the first volume of the set on MTA0:.
    

    Now mount the first distribution volume on the device you specified when you invoked VMSINSTAL.


    * Are you ready? YES 
    

    If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y.


    %MOUNT-I-MOUNTED, AMDS MOUNTED ON _MTA0:  (NODE 1)
    The following products will be processed:
      DECamds V7.1
                       
     Beginning installation of DECamds 
    V7.1 at 10:43
     
    %VMSINSTAL-I-RESTORE, Restoring product saveset A...
    

    If your installation kit contains more than one volume, VMSINSTAL prompts you to mount the additional volumes and then asks you to indicate that you are ready for the installation to proceed.

  5. Select a release notes option.
    If you select Options N, the following is displayed:


    Release notes included with this kit are copied to SYS$HELP. 
     
    Additional Release Notes Options: 
     
     1.  Display release notes 
     2.  Print release notes 
     3.  Both 1 and 2 
     4.  None of the above 
     
    * Select option [2]: 
    

    If you choose to display the release notes, you can terminate the display at any time by pressing Ctrl/C. Release notes are copied to the system help directory (SYS$HELP:AMDS071.RELEASE_NOTES), even if you select option 4.
    After the installation, enter the following command to review the release notes through the Help facility:


    $ HELP DECamds RELEASE_NOTES
    

    Note

    The name of the release notes file installed by VMSINSTAL consists of the current product name and version number. Do not delete release notes for previous versions of DECamds.
  6. Choose which components to install.


    You now have the choice to install either the DECamds Data Analyzer, or 
    the DECamds Data Provider, or both on this system. 
    * Would you like to install the DECamds Data Analyzer on this system [Y]? 
    * Would you like to install the DECamds Data Provider on this system [Y]? 
    

    Choose the components to install.

  7. Choose the Help Message installation option.


    The Help Message utility (MSGHLP) provides online explanations 
    and user actions for OpenVMS messages. 
     
    The MSGHLP database, DECAMDS.MSGHLP$DATA, consumes approximately 
    200 blocks and will be placed by default on your system disk in 
    SYS$COMMON:[SYSHLP]. 
     
    Refer to the OpenVMS System Messages: Companion Guide for Help 
    Message Users and the OpenVMS System Manager manual for instruction 
    on how to add the DECamds Help Message database to your system. 
     
    * Would you like to install the MSGHLP database for DECamds  [Y]? 
    

    If you answer YES (or use the default), the DECamds help message database, DECAMDS.MSGHLP$DATA, will be copied to SYS$COMMON:[SYSHLP]. Refer to the OpenVMS System Messages: Companion Guide for Help Message Users for complete information on setting up and using the Help Message utility.

  8. Choose the Installation Verification Procedure (IVP) option.


    * Do you want to run the IVP after the installation [YES]? 
    

    It is recommended that you run the IVP because it ensures that the installation is successful. If the IVP finds the Data Provider on the system, it will ensure the driver is left in the state in which it was found.
    You can run the IVP independently to verify that the software is available on your system. See Section A.9 for information about running the IVP separately.

  9. Choose the purge files option.


    * Do you want to purge files replaced by this installation [YES]? 
    

    Purging is recommended; however, if you want to keep files from the previous version, enter NO and press Return.

  10. Read informational messages.
    See the sample installation procedure in Example A-2.
  11. Observe the Installation Verification Procedure (IVP).
    See the sample installation procedure in Example A-2.

Sample Installation on an OpenVMS VAX System

Example A-2 shows a sample installation on an OpenVMS VAX system and assumes that DECnet has been shut down, that no users are logged on to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation.

This sample was run on a system that had no previous version of DECamds installed. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation.

Example A-2 Sample OpenVMS VAX Installation

$ @VMSINSTAL AMDS071 SYS$UPDATE
 VAX/VMS Software Product Installation Procedure V7.1
It is 27-JAN-1996 at 15:13.
Enter a question mark (?) at any time for help.
* Are you satisfied with the backup of your system disk [YES]? 
The following products will be processed:
  AMDS V7.1
 Beginning installation of AMDS V7.1 at 15:14
%VMSINSTAL-I-RESTORE, Restoring product save set A ...
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
 Copyright (c) 1996 Digital Equipment Corporation. All rights reserved.
 Beginning the installation of DECamds V7.1.
%AMDS-I-VERINSTAL, Installing DECamds on an OpenVMS VAX V7 system
 You now may choose to install the DECamds Data Analyzer.  The
 Data Analyzer must be installed on a system in which at least
* Would you like to install the DECamds Data Analyzer on this system [Y]? 
* Do you want to run the IVP after the installation [YES]? 
* Do you want to purge files replaced by this installation [YES]? 
        No further questions will be asked during the installation.
 This installation will take approximately 5-10 minutes to complete.
%VMSINSTAL-I-RESTORE, Restoring product save set B ...
 The DECamds startup file (AMDS$STARTUP.COM) is being copied to the
 SYS$STARTUP directory.  Digital recommends you include this file in 
 your site specific startup procedures as follows:
  @SYS$STARTUP:AMDS$STARTUP START
 The command procedure AMDS$LOGICALS.COM was already found in the 
 SYS$COMMON:[AMDS] directory.  This installation will provide an
 AMDS$LOGICALS.TEMPLATE file instead of the AMDS$LOGICALS.COM file.  
 Please check the new .TEMPLATE file and add any changes to your 
 current AMDS$LOGICALS.COM file.
 The file SYS$COMMON:[AMDS]AMDS$CONSOLE_ACCESS.DAT already exists.  This
 installation will provide a AMDS$CONSOLE_ACCESS.TEMPLATE file instead
 of the AMDS$CONSOLE_ACCESS.DAT file to avoid superceding a version of 
 the file you may currently be using.
 The installation will now provide the DECamds customization files.
 If this installation finds one of the customization files already
 residing in the installation directory, then the installation will
 provide a .TEMPLATE file instead of the .DAT file.  It will be left
 up to the installer to check the AMDS$SYSTEM directory for any 
 differences between the .DAT and .TEMPLATE files.
 The installation procedure will provide a .TEMPLATE file for the 
 following customization files found in the AMDS$SYSTEM directory:
 AMDS$APPLIC_CUSTOMIZE.DAT
 AMDS$SEVERITY_DEFS.DAT
 AMDS$OCCURRENCE_DEFS.DAT
 AMDS$THRESHOLD_DEFS.DAT
 AMDS$INTERVAL_DEFS.DAT
 AMDS$FILTER_DEFS.DAT
 AMDS$SORT_DEFS.DAT
 AMDS$GEOMETRY_DEFS.DAT
 The file SYS$COMMON:[AMDS]AMDS$DRIVER_ACCESS.DAT already exists.  This
 installation will provide a AMDS$DRIVER_ACCESS.TEMPLATE file instead
 of the AMDS$DRIVER_ACCESS.DAT file to avoid superceding a version of 
 the file you may currently be using.
 DECamds installation V7.1 is complete.
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
%AMDS-I-NODRIVER, data collection not started, only define AMDS$SYSTEM
   DECamds V7.1  Installation Verification Procedure (IVP) Beginning.
 Copyright © Digital Equipment Corporation 1996.
 All Rights Reserved.
This IVP will check following pieces of DECamds:
    DATA PROVIDER - RMDRIVER
    DATA ANALYZER - AMDS$CONSOLE and AMDS$COMM
Before running this IVP, any process currently running the DECamds
Data Analyzer on this machine must be stopped.  The IVP will now
check for the existence of the AMDS$COMM process which indicates
that someone is currently running the Data Analyzer.
AMDSIVP-I-RMRELOAD, reloading with new data provider for IVP to use
Copyright (c) 1996 Digital Equipment Corporation. All rights reserved. 
%AMDS-I-RMSHUT, stopping RMDRIVER processing for this node
%AMDS-S-RMSUCCESS, RMDRIVER shutdown successful
Copyright (c) 1996 Digital Equipment Corporation. All rights reserved. 
%AMDS-I-RMSTART, starting RMDRIVER processing for this node
%AMDS-I-LOADSECDB, loading security database
%AMDS-S-RMSUCCESS, RMDRIVER startup successful
You currently do not have a DECwindows display to direct the Data
Analyzer output towards.  You are now given the option to continue
and allow the IVP to create a display for you or exit and either
create your own display or run the IVP from a workstation.
Would you like to continue? [Y/N]Y
You have chosen to let the IVP create a DECwindows display.
You will be prompted for a node to direct the display towards.
Specify a valid node on which you are allowed to create a display
from your current node.  This procedure does not check the 
validity of the remote node you specify.
Nodename to direct the display towards: AMDS
%DCL-S-SPAWNED, process AMDS$IVP_CONS spawned
Waiting 5 minutes to allow the DECamds Data Analyzer to run.
You should see the Event Log and System Overview windows appear
on your DECwindows display device.
AMDSIVP-S-ALLPASS, DECamds has passed the IVP
 DECamds V7.1  Installation Verification Procedure Complete
 Installation of AMDS V7.1 completed at 15:23
 VMSINSTAL procedure done at 15:23
$ LOG
  SYSTEM       logged out at 27-JAN-1996 15:23:53.60
 
 


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
5929PRO_008.HTML