HP Availability Manager Installation Instructions Version 3.1 March 2010 This document contains the following major sections: 1. Availability Manager components 2. Introduction to the installation instructions 3. Data Collector installation on OpenVMS systems 4. Data Analyzer installation on Windows systems 5. Data Analyzer installation on OpenVMS systems 6. Operation instructions 1 Availability Manager Components You can use the Availability Manager to collect data on OpenVMS nodes. You can then analyze that data on Windows or OpenVMS systems. Based on the analysis of the data and problems you detect, you can also take a number of corrective actions. The component of the Availability Manager that enables data collection is the Data Collector. The part that directs data collection and analyzes that data, as well as to perform correction actions, is the Data Analyzer. The Data Collector also allows the Data Analyzer to communicate over the extended local area network (LAN) to other Data Collectors. When the Data Analyzer is on a node that is on the wide area network (WAN), it communicates with Data Collectors through a Data Server. The advantage of using a Data Server is that, with it, the Data Analyzer can be anywhere on the WAN-for example, at a remote site or at home. The Availability Manager software is packaged as follows: o Windows All three components-the Data Collector, Data Analyzer, and Data Server-are in one kit called the Windows kit. o OpenVMS 1 The Data Collector is in its own kit, and the Data Analyzer and Data Server are together in another kit, called the Combined kit. The following table describes where you need to install each software component. _________________________________________________________________ If_you_want_to...,____You_must:__________________________________ Enable data Install the Data Collector kit on each node collection on or on an entire cluster of nodes on which OpenVMS Alpha, VAX, you want to collect data. or I64 nodes,... Collect and analyze Install either of the following on one or data,... more nodes: o For Windows, install the Windows kit o For OpenVMS, install kits in the following order: 1. The Data Collector kit 2. The Combined kit Enable data Install either of the following on one or collection over more nodes: a WAN,... o For Windows, install the Windows kit o For OpenVMS, install kits in the following order: 1. The Data Collector kit 2. The Combined kit _________________________________________________________________ Kit Requirements This section outlines the kits that you need for each component and each system on which you plan to install Availability Manager Version 3.1 software, which includes both the Data Collector kit and the Combined kit. The following table shows the systems and version on which you can install this software. 2 Table 1 Where to Install Availability Manager Version 3.1 ________Software___________________________________________ OpenVMS Data OpenVMS Alpha OpenVMS Collector____VAX_Versions___Versions_______I64_Versions____ 6.2 through 6.2 through 8.2 through 8.4 7.3 8.4 ___________________________________________________________ Data Microsoft OpenVMS Analyzer Windows Alpha OpenVMS or_Server____Versions_______Versions_______I64_Versions____ Windows 2000 7.3-2 through 8.2-1 through Pro 8.4 8.4 Windows XP _____________Pro___________________________________________ 2 Introduction to the Installation Instructions The following diagram depicts the entire process of installing the Availability Manager software, from the preparations for installation through postinstallation tasks and special requirements for running both the Availability Manager and DECamds concurrently. Numbered or lettered items indicate that you need to perform these steps in a specified order. 3 Preparations for Installation | | V Tasks in common: - Download software - Read release notes / | \ / | \ / | \ / | \ / | \ | | | V V V 1.On nodes to collect 2.On OpenVMS node (or) 2.On Windows node data, install Data to analyze data: to analyze data, Collector: A) Install Data install Data | | Collector Analyzer or | | B) Install Data Data Server | | Analyzer or | | | Data Server | V V | | On single On cluster | | node | | | | | | | | | | | V V V | Perform OpenVMS postinstallation tasks | | | | | | | | | V V V V Running DECamds and the Availability Manager Concurrently 3 Data Collector Installation on OpenVMS Systems You need to install the Data Collector software on every OpenVMS node - VAX, Alpha, or I64-on which you want to collect data. ________________________ Note ________________________ If you want to install the Data Collector, the Data Analyzer, and the Data Server on a node, you need 4 to install the Data Collector kit first and then the Combined kit. ______________________________________________________ The following sections explain web page what you need to do to install the Data Collector on one or more nodes in your system. They explain tasks you need to perform before the installation, for the installation, and post-installation. 3.1 Preparing to Install Data Collector Software The following sections explain tasks you need to perform before you install Data Collector software. 3.1.1 Check Privileges This section outlines the privileges required to perform various operations using the Availability Manager Data Collector. ___________________________________________________________ Operation_______________________Privileges_Needed__________ Stop, start, reload, or OPER, CMKRNL, LOG_IO, restart Data Collector nodes. SYSNAM, SYSPRV Includes changing security or group_name.________________________________________________ 3.1.2 Evaluate Hardware, Software, and Disk Space Requirements For current minimum hardware, software, and disk space requirements for installing and running the Data Collector software, see the "Product Description" link on the Availability Manager home page: http://www.hp.com/products/openvms/availabilitymanager 3.1.3 Back Up the System Disk HP recommends that you perform a system disk backup on OpenVMS systems 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 in the HP OpenVMS System Manager's Manual and the HP OpenVMS System Management Utilities Reference Manual. 5 3.1.4 Steps to Take If You Have a Version Prior to Version 2.4 If you have a version of the Availability Manager prior to Version 2.4 on your system, perform the steps in this section. (This is required because of the kit reorganization introduced in Version 2.4.) If you do not have a version prior to Version 2.4, go to Section 3.2. 1. Copy the Data Analyzer files if you have run the Data Analyzer Version 2.3-1 or earlier on this node. This includes copying the AMDS$AM_CONFIG:AVAILMAN.INI file and any log files that you need to a different directory so that they can be restored after the installation. 2. Remove old kits On OpenVMS systems, before installing the Availability Manager Version 3.1 software, you must remove old Data Analyzer kits on your system. To do so, enter the following command at the DCL prompt: $ PRODUCT REMOVE AVAIL_MAN 3. Install the Availability Manager Version 2.4 Data Collector kit If you are running OpenVMS Alpha Version 6.2 through 7.2-2 or their variants, and you have a version of the Availability Manager prior to Version 2.4 on your system, you must install the Availability Manager Data Collector Version 2.4 before installing Version 3.1. This additional installation corrects various kitting irregularities introduced by older versions of the Availability Manager and OpenVMS. You can obtain the Version 2.4 kit on the Software Download link on the Availability Manager home page: http://www.hp.com/products/openvms/availabilitymanager 6 3.2 Installing Patch Kits Before installing the Availability Manager Data Collector on any version of OpenVMS, you must install the latest POLYCENTER Software Installation (PCSI) patch kit, which is available at the following url: http://www1.itrc.hp.com/service/patch/mainPage.do The patch upgrades PCSI to the functionality of PCSI in the current version of OpenVMS. Availability Manager kits require this functionality. 3.3 Downloading the Software Follow these steps to download Data Collector software: 1. Go to the HP Availability Manager home page: http://www.hp.com/products/openvms/availabilitymanager 2. Click Software Download. 3. Complete the user survey, which allows you to proceed to the Download web page. 4. At a minimum, you need one Data Collector kit, depending on your environment and where you are installing the Data Collector. The following list of kits is actually the same kit, packaged in three different ways to correlate with the platform on which you install the kit. Click one of the Data Collector executable shown in the following table. ________________________________________________________ System and Versions_________File___________________________________ Alpha V8.3 - HP-VMS-AVAIL_MAN_COL-V0310- V8.4, I64 V8.3 1.PCSI$COMPRESSED_ESW - V8.4: Alpha V7.3-2 - HP-VMS-AVAIL_MAN_COL-V0310- V8.4, I64 V8.2 1.PCSI$COMPRESSED - V8.4: 7 ________________________________________________________ System and Versions_________File___________________________________ Alpha V7.2-2 to HP-VMS-AVAIL_MAN_COL-V0310- V7.3-1 1.PCSI$COMPRESSED Install PCSI V2.0 patch per Section 3.2 first. Alpha prior to HP-VMS-AVAIL_MAN_COL-V0310-1.PCSI-DCX_ V7.2-2: AXPEXE VAX V6.2 - HP-VMS-AVAIL_MAN_COL-V0310-1.PCSI-DCX_ V7.3:____________VAXEXE_________________________________ ________________________ Note ________________________ Steps 5 and 6 pertain only to the PCSI-DCX_AXPEXE or PCSI-DCX_VAXEXE kits. ______________________________________________________ 5. Save the downloaded file to a device and directory of your choice. 6. Run the Alpha executable on an Alpha system and the VAX executable on a VAX system, accepting the default file name: On an Alpha node: HP-VMS-Avail_Man_Col-V0310-1.PCSI_DCX_AXPEXE On a VAX node: HP-VMS-Avail_Man_Col-V0310-1.PCSI_DCX_VAXEXE ________________________ Note ________________________ If the kit is on an ODS-5 disk, the file name must be in all-capital letters for the kit to install correctly. ______________________________________________________ The results for either kit will be: HP-VMS-Avail_Man_Col-V0310-1.PCSI ________________________ Note ________________________ The remaining steps in this section, which apply to I64 as well as Alpha and VAX nodes, pertain to the .PCSI and .PCSI$COMPRESSED kits. ______________________________________________________ 8 7. Copy the PCSI kits as follows: a. If you are installing on one or more single nodes, save the Data Collector executable on each node on which you want to collect data. b. If you are installing on a cluster, save the executable on a disk that is available clusterwide. Read the Release Notes The Availability Manager provides release notes in the software kit and at the Documentation link at the following web site: http://www.hp.com/products/openvms/availabilitymanager HP strongly recommends that you read the release notes before proceeding with the installation. In the software kit on OpenVMS systems, you can obtain a text version of the HP Availability Manager Version 3.1 Release Notes by setting the default to the directory where the kit resides. Then enter the following command at the DCL prompt: $ PRODUCT EXTRACT RELEASE_NOTES AVAIL_MAN_COL If you have not set the default to that directory, enter the following command: $ PRODUCT EXTRACT RELEASE_NOTES AVAIL_MAN_COL/SOURCE=disk:[directory] where: disk:[directory] refers to the disk and directory where the kit resides. The default file name is DEFAULT.PCSI$RELEASE_NOTES. 3.4 Installing the Data Collector Software Recall that if you want to install both the Data Collector and the Data Analyzer on a node, you need to install the Data Collector first and then the Data Analyzer. The following sections describe how to install the Data Collector on a single node and on a cluster. 9 3.4.1 Stopping Data Collectors Stop any Data Collector currently running on a node by entering the following command: $ @SYS$STARTUP:AMDS$STARTUP STOP 3.4.2 To Install the Data Collector on a Single Node To install the Data Collector software on a single node, enter the DCL command PRODUCT INSTALL, followed by the name of one or more products. For example, to install the Version 0310 Data Collector, enter the following command: $ PRODUCT INSTALL AVAIL_MAN_COL/SOURCE=disk:[directory] where disk and directory refer to the disk and the directory where the kit is located. ________________________ Note ________________________ Currently, you must install Availability Manager files in the PCSI default directory root. Use of the /DESTINATION qualifier is not supported. ______________________________________________________ For a description of the features you can request with the PRODUCT INSTALL command when starting an installation such as purging files and configuring the installation, see the POLYCENTER Software Installation Utility User's Guide. As the installation procedure progresses, the system displays a percentage message to indicate how much of the installation is done. For example: Percent Done: 0%...40%...60%...70%...80%...90%...100% If you start the installation using the /LOG qualifier to the INSTALL command, the system displays details of the installation. A sample log file of this entire installation procedure follows. 10 Installation of the Data Collector on a Single Node The following product has been selected: HP VMS AVAIL_MAN_COL V0310 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. HP VMS AVAIL_MAN_COL V0310: HP Availability Manager Data Collector Version 0310 COPYRIGHT ©2010 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company - Palo Alto, California License and Product Authorization Key (PAK) Information * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: HP VMS AVAIL_MAN_COL V0310 DISK$ALPHA_V732:[VMS$COMMON.] The following product will be removed from destination: HP VMS AVAIL_MAN_COL V3.1 DISK$ALPHA_V732:[VMS$COMMON.] The following product has been installed: HP VMS AVAIL_MAN_COL V0310 Layered Product The following product has been removed: HP VMS AVAIL_MAN_COL V3.1 Layered Product HP VMS AVAIL_MAN_COL V0310: HP Availability Manager Data Collector Version 0310 HP Availability Manager Startup File has been placed in SYS$STARTUP. HP Availability Manager Logicals Customization File has been installed. HP Availability Manager Security Access File has been installed. Portion done: 0%...10%...20%...30%...40%...60%...90%...100% $ 11 3.4.3 To Install the Data Collector on a Cluster To install the Data Collector on a cluster, follow these steps: 1. Put the kits on a cluster-common disk volume. For this example, the disk volume and directory are CLU$COMMON:[KITS.AM_V310]. 2. Create a command procedure in the kit directory that installs the Data Collector kit. For this example, the file CLU$COMMON:[KITS.AM_V310]INSTALL_AM_DC.COM command procedure is created and contains the following DCL commands: $ DEFINE/JOB SYS$LOGIN SYS$COMMON:[SYSMGR] $ PRODUCT INSTALL AVAIL_MAN_COL /SOURCE=CLU$COMMON:[KITS.AM_V310] The first line in this procedure defines SYS$LOGIN for the account that is used for the installation. In this case, the logical is defined for the SYSTEM account. This line is required for the signed kit validation phase to execute correctly in the SYSMAN> DO command environment. ________________________ Note ________________________ The $ PRODUCT command in the example command procedure assumes that there is only one version of the Data Collector kit in the source directory. If the directory contains multiple versions of the Data Collector kit, you must add the /VERSION qualifier to specify which version of the Data Collector you want to install. ______________________________________________________ 3. Perform a cluster install; for example: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT /CLUSTER %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> DO/CONFIRM @CLU$COMMON:[KITS.AM_V310]INSTALL_AM_DC Execute command for node AFFS51? [N]: Y 12 %SYSMAN-I-OUTPUT, command execution on node AFFS51 . . . Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...100% SYSMAN> exit $ An example of the complete log file produced when you install Data Collector kits clusterwide follows. Log File-Automated Clusterwide Installation of the Data Collector $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT /CLUSTER %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> DO/CONFIRM @CLU$COMMON:[KITS.AM_V310]INSTALL_AM_DC Execute command for node AFFS1? [N]: Y %SYSMAN-I-OUTPUT, command execution on node AFFS1 Performing product kit validation ... %PCSI-I-VALPASSED, validation of CLU$COMMON:[KITS.AM_V310]HP-VMS-AVAIL_MAN_COL-V0310-1.PCSI$COMPRESSED;2 succeeded Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. HP VMS AVAIL_MAN_COL V0310: HP Availability Manager Data Collector Version 0310 COPYRIGHT ©2010 Hewlett-Packard Develpment Company, L.P. Hewlett-Packard Company - Palo Alto, California License and Product Authorization Key (PAK) Information * This product does not have any configuration options. 13 Execution phase starting ... The following product will be installed to destination: HP VMS AVAIL_MAN_COL V0310 DISK$S1-V83:[VMS$COMMON.] The following product will be removed from destination: HP VMS AVAIL_MAN_COL V3.1 DISK$S1-V83:[VMS$COMMON.] The following product has been installed: HP VMS AVAIL_MAN_COL V0310 Layered Product The following product has been removed: HP VMS AVAIL_MAN_COL V3.1 Layered Product HP VMS AVAIL_MAN_COL V0310: HP Availability Manager Data Collector Version 0310 HP Availability Manager Startup File has been placed in SYS$STARTUP. HP Availability Manager Logicals Customization File has been installed. HP Availability Manager Security Access File has been installed. Portion done: 0%...10%...20%...30%...40%...60%...90%...100% Execute command for node AFFS21? [N]: y %SYSMAN-I-OUTPUT, command execution on node AFFS21 Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. HP VMS AVAIL_MAN_COL V0310: HP Availability Manager Data Collector Version 0310 COPYRIGHT ©2010 Hewlett-Packard Develpment Company, L.P. Hewlett-Packard Company - Palo Alto, California License and Product Authorization Key (PAK) Information * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: HP VMS AVAIL_MAN_COL V0310 DISK$S21-V732:[VMS$COMMON.] The following product has been installed: HP VMS AVAIL_MAN_COL V0310 Layered Product HP VMS AVAIL_MAN_COL V0310: HP Availability Manager Data Collector Version 0310 HP Availability Manager Startup File has been placed in SYS$STARTUP. HP Availability Manager Logicals Customization File has been installed. 14 HP Availability Manager Security Access File has been installed. Portion done: 0%...10%...20%...30%...40%...60%...90%...100% SYSMAN> EXIT $ 3.5 Interrupting and Restarting an Installation Use the following procedure to stop and restart an installation: 1. To stop the procedure at any time, press Ctrl/Y. 2. Enter the DCL command PRODUCT REMOVE to reverse any changes to the system that occurred during the partial installation. This deletes all files created up to that point and causes the installation procedure to exit. 3. Reenter the PRODUCT INSTALL command to begin the installation again. 3.6 Recovering from Errors If the installation procedure fails for any reason, the following set of messages is displayed: %POLYCENTER Software Installation utility %INSTAL-E-INSFAIL, The installation of AVAIL_MAN_COL has failed. An error during the installation can occur if one or more of the following conditions exist: o The operating system version is incorrect. o The prerequisite software version is incorrect. o Quotas necessary for successful installation are inadequate. o Process quotas required by the POLYCENTER Software Installation utility are inadequate. If you receive an error message beginning with %PCSI-E- INSTAL, see the DCL HELP/MESSAGE utility for POLYCENTER Software Installation information and a possible solution to the problem. If the installation fails, you must restart the installation procedure. 15 ________________________ Note ________________________ If the installation successfully replaced the Data Collector driver (over a previous installation), you must reboot the system to use the new driver. ______________________________________________________ 3.7 Performing Postinstallation Tasks After you install the Data Collector on one or more OpenVMS systems, you need to perform several postinstallation steps, which are divided into tasks you perform for the following: o Previous installations o New installations 3.7.1 For Previous Installations: Merge Customizations of Files In the course of an installation, the Availability Manager renames *.TEMPLATE files to *.TEMPLATE_OLD. It then installs new *.TEMPLATE files and lets you know if differences exist between the *.TEMPLATE and the *.TEMPLATE_OLD files. Template files have the names shown in the following table: ___________________________________________________________ Configuration_File____Configuration_File_Template__________ AMDS$LOGICALS.COM AMDS$LOGICALS.TEMPLATE AMDS$DRIVER_ AMDS$DRIVER_ACCESS.TEMPLATE ACCESS.DAT_________________________________________________ If you have existing logicals and access files, the installation kit leaves them on the system as is. Any changes to these files because of new or changed features are included in the *.TEMPLATE files. You can then merge these changes into your logicals and access files with a text editor, as necessary. Use the DIFFERENCE utility on the *.TEMPLATE and *.TEMPLATE_OLD files to highlight the updates to the template. 16 3.7.2 For New Installations: Edit Additional Files Following installation of Data Collector software, you need to edit one file; you can optionally edit two additional files on each Data Collector node. The following list indicates the steps to take on OpenVMS Alpha or VAX Data Collector nodes. The files in steps 1, 2 and 3, which are optional steps, contain default values that are used if you do not supply values. Step 4 is mandatory for the Data Collector to start when the system boots. 1. Optionally, edit the following file to change passwords that allow the node to be monitored by another node: SYS$MANAGER:AMDS$DRIVER_ACCESS.DAT The password section of the file is close to the end of the file, after the Password documentation section and in Section 1.3 of the DECamds User's Guide. 2. Define logical names OpenVMS kits for DECamds Version 7.3-2B and Availability Manager Version 3.1 provide a template file and an initial command procedure that system managers can modify to define the logical names the Data Collector uses. The files are SYS$MANAGER:AMDS$LOGICALS.TEMPLATE and SYS$MANAGER:AMDS$LOGICALS.COM. Edit the .COM file to change the default logicals that are used to start the Data Collector and to locate its configuration files. The most common logicals, especially in a mixed- environment cluster configuration, are the following: ________________________________________________________ Logical_____________Description_________________________ AMDS$GROUP_NAME Specifies the group that this node will be associated with when it is monitored. AMDS$DEVICE For nodes with more than one network adapter, allows you to specify which adapter the Availability Manager should use. 17 ________________________________________________________ Logical_____________Description_________________________ AMDS$RM_DEFAULT_ The number of seconds between INTERVAL multicast "Hello" messages from the Data Collector to the Data Analyzer node when the Data Collector is inactive or is only minimally active. The minimum value is 5. The maximum value is 300. AMDS$RM_SECONDARY_ The number of seconds between INTERVAL multicast "Hello" messages from the Data Collector to the Data Analyzer node when the Data Collector is active. The minimum value is 5. The _______________________maximum_value_is_1800.___________ 3. For node-specific settings, create the following file: SYS$MANAGER:AMDS$LOGICALS_.COM Edit the file to include node-specific customization entries. 4. To start the Data Collector when the system boots, you must add the following line to the SYS$MANAGER:SYSTARTUP_VMS.COM file: $ @SYS$STARTUP:AMDS$STARTUP START 3.7.3 Turn on Managed Objects on OpenVMS Version 7.3 or Later Nodes Managed Objects are available only on OpenVMS Version 7.3 and later. They are discussed in the introduction to the Cluster chapter in the HP OpenVMS Availability Manager User's Guide. Before a Data Collector node can make managed object data available to Data Analyzers, the system manager must take steps so that the Data Collector driver, RMDRIVER, is loaded early in the boot process. The Data Collector kit for Availability Manager Version 0310 contains a data file called SYS$AMCONFIG.DAT. This file turns Managed Object functionality on and off on Data Collector nodes. This functionality is turned off by default. 18 At boot time on OpenVMS VAX, Alpha, and I64 systems, the operating system looks for the SYS$AMCONFIG.DAT file in the SYS$SYSROOT:[SYSEXE] directory. If the file is found, the boot code reads the file to determine whether to load RMDRIVER so that managed objects can begin to use this driver at boot time. In the template file on the kit, the flag in the SYS$AMCONFIG.DAT file is set to TRUE (the default) so that RMDRIVER is loaded at boot time. ________________________ Note ________________________ The SYS$AMCONFIG.DAT file must be in a variable- length carriage-return-carriage-control format. If you create the file as a stream or stream-variant file, the OpenVMS boot code might not recognize the file contents correctly. To confirm that you have the correct format, enter the following DCL command: $ DIRECTORY/FULL SYS$AMCONFIG.DAT A correctly-formatted file will include the following two lines: . . . Record format: Variable length, maximum 0 bytes, longest 0 bytes Record attributes: Carriage return carriage control . . . The important attributes are the variable length record format and the carriage return carriage control record attribute. The longest record value may vary from the example. You can also enter the following command: $ DUMP SYS$AMCONFIG.DAT Correct output from this command will show the 'B' in "BOOTLOAD=TRUE" as the third character in the first disk block; for example: 19 20455552 543D4441 4F4C544F 4F420034 4.BOOTLOAD=TRUE 000000 64616F4C 203B2020 20202020 20202020 ; Load 000010 6F6F6220 74612052 45564952 444D5220 RMDRIVER at boo 000020 00000000 00000000 FFFF656D 69742074 t time.......... 000030 00000000 00000000 00000000 00000000 ................ 000040 . . . ______________________________________________________ System managers can perform the following actions to load RMDRIVER at boot time, thereby enabling users to access information about switched LANs on their systems: 1. Copy the SYS$AMCONFIG.DAT file from the SYS$EXAMPLES directory to the SYS$SYSROOT:[SYSEXE] directory. 2. Reboot your system. After you complete these steps, RMDRIVER will be loaded at boot time, allowing managed objects to register with RMDRIVER and allowing users to see additional switched LAN data on their systems. 3.7.4 Take Advantage of Logical LAN Device Support The Availability Manager is compatible with this feature. You can specify a logical LAN device in the logical AMDS$DEVICE in the file AMDS$LOGICALS.COM However, if the current device name that the logical AMDS$DEVICE specifies is part of a logical LAN failover set, the device name needs to be changed. This is because specifying a physical device in a failover set is illegal and results in an error when executing $ @SYS$STARTUP:AMDS$STARTUP START. For a device name, you can specify either the logical LAN device name of the failover set or another network device. The following figure shows a possible OpenVMS pre-Version 7.3-2 configuration. The AMDS$DEVICE logical points to EIB0:. AMDS$DEVICE | V EIA0: EIB0: EWA0: 20 If, after installing OpenVMS Version 7.3-2, you create a logical LAN failover set with EIA0: and EIB0:, the AMDS$DEVICE logical can no longer specify EIB0:, because EIB0: is now in a failover set. In this case, you must set the AMDS$DEVICE logical to either LLA0:, which is the logical LAN device, or to EWA0: EIA0: EIB0: EWA0: \ / ---------+---------- | V LLA0: For further information on setting up logical LANs, see "Understanding LAN Failover" in the HP OpenVMS System Manager's Manual. 3.8 Starting the Data Collector on Data Collection Nodes To manage the Data Collector, start by invoking the command procedure SYS$STARTUP:AMDS$STARTUP. To list the functions that this procedure performs, enter the following: @ SYS$STARTUP:AMDS$STARTUP HELP For the Data Collector to access requests to collect data and to support the Data Analyzer, you must start the Data Collector by entering the START command: @ SYS$STARTUP:AMDS$STARTUP START To start the Data Collector when the system boots, add the following line to the SYS$MANAGER:SYSTARTUP_VMS.COM file: @ SYS$STARTUP:AMDS$STARTUP START 4 Data Analyzer and Data Server Installation on Windows Systems This section contains subsections that explain the installation procedure for the Data Analyzer and Data Server on Windows nodes. Because both components are in the same kit, they are both installed at the same time. 21 This installation procedure assumes that you want to install the application files on a local drive. You might, however, want to install the application files on a network drive for a number of reasons-for example, if the network is backed up regularly, or if your local drive is low on available space. For better performance, HP recommends that you install on a local drive. The following sections contain instructions for preparing to install HP Availability Manager software on Windows systems. The installation and modification of the Availability Manager requires that you use the local Administrator account. Before you start to install HP Availability Manager Version 3.1, close all other applications. 4.1 Uninstalling Old Software If you have previously installed an Availability Manager kit prior to Version 2.3, you must uninstall your old kit before installing the Version 3.1 kit. (The HP Availability Manager InstallShield script causes the installation to terminate if you do not uninstall old kits and reboot.) Before uninstalling, copy the AvailMan.ini file to a different folder so that it can be restored after the installation. Its default location might be either of the following: \Program Files\Hewlett-Packard\HP Availability Manager\AvailMan.ini \Program Files\Compaq\Availability Manager\AvailMan.ini To uninstall the old software, follow these steps: 1. Go to the Control Panel on your system. 2. Select Add/Remove Programs. 3. Select Availability Manager. 4. Select Change/Remove. This brings up InstallShield. 5. Select "Remove all installed components" and then select OK. 6. Reboot before installing the new kit. 22 When you uninstall the old kit, you might be asked if you want to delete a number of files, including some, if not all, of the following: C:\WINNT\System32\declog.exe C:\WINNT\System32\pwel32.dll C:\WINNT\System32\pwiocb32.dll C:\WINNT\System32\pwlogsvc.exe C:\WINNT\System32\spawn32.exe C:\WINNT\System32\drivers\deccore.sys C:\WINNT\System32\drivers\decndis.sys C:\WINNT\System32\drivers\damdrvr.sys If you have Pathworks installed, delete only the last file, damdrvr.sys. If you do not have Pathworks installed, you can safely delete all the files you are prompted for; the new kit does not need these files. 4.2 Downloading the New Software To download the software, follow these steps: 1. Go to the HP Availability Manager software web page: http://www.hp.com/products/openvms/availabilitymanager 2. Complete the Registration Form, which gives you access to the download web page. 3. On the Windows section of the download web page, click the name of the following file: AvailManV31_i.exe -- for Intel systems running on Windows 2000 or Windows XP 4. On the screen that is displayed, click Save, and enter the name of the folder in which you want to save the kit. 23 Read the Release Notes HP strongly recommends that you read the release notes before proceeding with the installation. To access the release notes: 1. Go to the Documentation link on the Availability Manager home page: http://www.hp.com/products/openvms/availabilitymanager 2. Click HTML following "Version 3.1 Release Notes" to display the release notes in HTML format. (You can also print these notes.) 4.3 Installing the New Software This section explains tasks associated with installing the Availability Manager software on Windows systems. To install the software, follow these steps: 1. Go to the folder containing the saved kit, and double- click the name of the file, AvailManV31_i.exe to start the installation. (This is a standard Windows product installation.) 2. Click Next to accept the Modify option (the default). 3. After the installation is complete, you must restart your system. To do this, click Finish or press Enter once to complete the installation and restart. Do not press Enter multiple times, or the machine will log you off instead of restarting the system. 4. Copy the saved AvailMan.ini file (see Section 4.1) to the new root directory: \Program Files\Hewlett-Packard\HP Availability Manager V3.0\ 4.4 Reinstalling Version 3.1 Software If, for any reason, you need to remove and reinstall Version 3.1 software, the software detects whether the Availability Manager has already been installed and displays a Welcome dialog box with the following options: 24 ___________________________________________________________ Option________Description__________________________________ Modify To add new components and replace existing the latest versions. Repair To reinstall the product completely. Remove________To_uninstall_the_product.____________________ 5 Data Analyzer and Data Server Installation on OpenVMS Systems This section contains subsections explaining how to install Data Analyzer and Data Server Version 3.1 software on OpenVMS systems. Because both components are in the same kit, they are both installed at the same time. ________________________ Note ________________________ If you want to install the both the Data Collector and the Data Analyzer on a node, you need to install the Data Collector first and then the Data Analyzer. ______________________________________________________ 5.1 Preparing to Install Data Analyzer and Data Server Software The following sections explain tasks you need to perform before you install Data Analyzer and Data Server software. 5.1.1 Check Privileges The following table outlines the privileges required to perform various operations using the Availability Manager Data Analyzer and Data Server. ___________________________________________________________ Operation_______________________Privileges_Needed__________ Use the Data Analyzer only OPER, SYSPRV to monitor nodes (read-only access) Implement fixes from the Data OPER, SYSPRV Analyzer (write access) Use_the_Data_Server_____________OPER_______________________ 25 5.1.2 Evaluate Hardware, Software, and Disk Space Requirements For current minimum hardware, software, and disk space requirements for installing and running the Availability Manager software, see the "Product Description" link on the following Availability Manager home page: http://www.hp.com/products/openvms/availabilitymanager In addition, the disk where you install the Combined kit must be an ODS-5 formatted disk (the installation disk). You can choose the installation disk with the /DESTINATION qualifier of the $ PRODUCT command. 5.1.3 Back Up the System On Alpha, VAX, and I64 systems, HP 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 in the HP OpenVMS System Manager's Manual and the HP OpenVMS System Management Utilities Reference Manual. 5.1.4 Convert the installation disk to ODS-5 format If you need to convert the installation disk to ODS-5 format, follow these steps: 1. If you are converting the system disk, boot the system from another disk or the OpenVMS update media DVD or CD. 2. Mount the ODS-2 disk: $ MOUNT/OVERRIDE_ID ddvn: 3. Convert the disk: $ SET VOLUME/STRUCTURE_LEVEL=5 ddcn: 4. If you are converting the system disk, reboot the system, else mount the disk as it is usually mounted. 26 5.1.5 Steps to Take If You Have a Version Prior to Version 3.1 If you have a version of the Availability Manager prior to Version 3.1 on your system, perform the steps below. This is required because of the kit reorganization introduced in Version 3.0. 1. Copy the AVAILMAN.INI file Before you remove old kits on the Data Analyzer, as described in Step 2, copy the AMDS$AM_ CONFIG:AVAILMAN.INI file and any log files that you need to a different directory so that they can be restored after the installation. 2. Remove old kits On OpenVMS systems, before installing the Availability Manager Version 3.1 software, you must remove old kits on your system. The following command displays the currently installed Availability Manager software: $ PRODUCT SHOW PRODUCT AVAIL_MAN* If you see either the "AVAIL_MAN" product or "AVAIL_ MAN_ANA" product, remove them from your system. For instance, to remove the "AVAIL_MAN" product, enter the following command at the DCL prompt: $ PRODUCT REMOVE AVAIL_MAN 5.2 Installing Patch Kits Before installing the Combined Version 3.1 kit, you might need to install patch kits. These are described in the following list. o You might need to install OpenVMS patch kits required by Java Version 1.5.0. To decide whether or not you need to do this, go to the following web site: http://www1.itrc.hp.com/service/patch/mainPage.do Look for the patch kits listed for OVMS Java Version 1.5.0. o Java remedial kits on OpenVMS nodes 27 Check for any remedial kits that Java requires. These are currently documented at the following Java web site: http://h18012.www1.hp.com/java/documentation/ Install these remedial kits, even if they are listed as optional. For example, for OpenVMS Alpha Version 7.3-2, the VMS732_PTHREAD-*** Remedial Kit is listed as optional; however, this kit is required for the Availability Manager Version 3.1 because it is required by Java Version 1.5.0. These Java patch kits allow you to run JRE 1.5.0, which is included in the Availability Manager Version 3.1 kit. o Patch kit for all versions of OpenVMS on Data Analyzer, Data Server, and Data Collector nodes Before installing the Availability Manager Data Collector, Data Analyzer, or Data Server on any version of OpenVMS, you must install the latest POLYCENTER Software Installation (PCSI) patch kit, which is available at the following URL: http://www1.itrc.hp.com/service/patch/mainPage.do The patch upgrades PCSI to the functionality of PCSI in the current version of OpenVMS. Availability Manager kits require this functionality. 5.3 Installing the Data Collector The Data Collector must be installed for the Data Analyzer or Data Server to function correctly. For details, see Section 3. 5.4 Downloading the Software Follow these steps to download the Data Analyzer and Data Server software: 1. Go to the HP Availability Manager home page: http://www.hp.com/products/openvms/availabilitymanager 2. Click Software Download. 3. Complete the user survey, which allows you to proceed to the Download web page. 28 4. At a minimum, you need one Combined kit, depending on your environment and where you are installing the Data Analyzer or Data Server. Click the following Combined kits: OpenVMS Alpha: HP-AXPVMS-Avail_Man_ANA_SRVR-V0310-1.PCSI$COMPRESSED OpenVMS I64: HP-I64VMS-Avail_Man_ANA_SRVR-V0310-1.PCSI$COMPRESSED 5. Save the downloaded file to a device and directory of your choice. 6. If you are installing the combined kit on OpenVMS V8.3 or higher, you need the manifest file for the Combined kit. Click the following manifest files: OpenVMS Alpha: HP-AXPVMS-Avail_Man_ANA_SRVR-V0310-1.PCSI$COMPRESSED_ESW OpenVMS I64: HP-I64VMS-Avail_Man_ANA_SRVR-V0310-1.PCSI$COMPRESSED_ESW 7. Save the downloaded file to a device and directory of your choice. Read the Release Notes The Availability Manager provides release notes in the software kit and at its Documentation link at the following URL: http://www.hp.com/products/openvms/availabilitymanager HP strongly recommends that you read the release notes before proceeding with the installation. In the software kit on OpenVMS systems, you can obtain a text version of the HP Availability Manager Version 3.1 Release Notes by setting the default to the directory where the kit resides. Then enter the following command at the DCL prompt: $ PRODUCT EXTRACT RELEASE_NOTES AVAIL_MAN_ANA_SRVR If you have not set the default to that directory, enter the following command: $ PRODUCT EXTRACT RELEASE_NOTES AVAIL_MAN_ANA_SRVR _$ /SOURCE=disk:[directory] where: 29 disk:[directory] refer to the disk and directory where the kit resides. The default file name is DEFAULT.PCSI$RELEASE_NOTES. 5.5 Performing the Installation To install the Data Analyzer on an OpenVMS system, enter a command similar to the following: $ PRODUCT INSTALL AVAIL_MAN_ANA_SRVR/SOURCE=disk1:[directory1] /DESTINATION=disk2:[directory2] where: disk1:[directory1] refer to the disk and directory where the Combined kit resides. If you omit this qualifier, the command uses the default directory. disk2:[directory2] refer to the disk and directory where the kit installs the Availability Manager Data Analyzer or Data Server software. If you omit this qualifier, the command uses the [VMS$COMMON] directory on the system disk. An example of a log file produced when you enter this command follows: Log File-Installation of the Data Analyzer on an OpenVMS System The following product has been selected: HP AXPVMS AVAIL_MAN_ANA_SRVR V3.1 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. HP AXPVMS AVAIL_MAN_ANA_SRVR V3.1: HP Availability Manager Data Analyzer Version 3.1 COPYRIGHT ©2010 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company - Palo Alto, California License and Product Authorization Key (PAK) Information * This product does not have any configuration options. 30 Found Data Collector kit on system Found Data Collector kit at or above version V3.0 Execution phase starting ... The following product will be installed to destination: HP AXPVMS AVAIL_MAN_ANA_SRVR V3.1 DISK$S1-V83:[VMS$COMMON.] The following product will be removed from destination: HP AXPVMS AVAIL_MAN_ANA_SRVR V3.1 DISK$S1-V83:[VMS$COMMON.] The following product has been installed: HP AXPVMS AVAIL_MAN_ANA_SRVR V3.1 Layered Product The following product has been removed: HP AXPVMS AVAIL_MAN_ANA_SRVR V3.1 Layered Product Portion done: 0%...40%...60%...70%...80%...90%...100% You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. 5.6 Interrupting and Restarting an Installation Use the following procedure to stop and restart an installation: 1. To stop the procedure at any time, press Ctrl/Y. 2. Enter the DCL command PRODUCT REMOVE to reverse any changes to the system that occurred during the partial installation. This deletes all files created up to that point and causes the installation procedure to exit. 3. Reenter the PRODUCT INSTALL command to begin the installation again. 5.7 Recovering from Errors If the installation procedure fails for any reason, the following set of messages is displayed: %POLYCENTER Software Installation utility %INSTAL-E-INSFAIL, The installation of AVAIL_MAN_ANA_SRVR has failed. An error during the installation can occur if one or more of the following conditions exist: o The operating system version is incorrect. o The prerequisite software version is incorrect. 31 o Quotas necessary for successful installation are inadequate. o Process quotas required by the POLYCENTER Software Installation utility are inadequate. o The OpenVMS Help library is currently in use. If you receive an error message beginning with %PCSI-E- INSTAL, see the DCL HELP/MESSAGE utility for POLYCENTER Software Installation information and a possible solution to the problem. If the installation fails, you must restart the installation procedure. 5.8 Starting the Data Collector on a Data Analyzer or Data Server Node To run the Data Analyzer or Data Server on a workstation, you must start the Data Collector on that node. For instructions, see Section 3.8. 6 Operation Instructions The following sections explain how to use OpenVMS and Windows commands to start the Availability Manager and how to modify memory allocation pool values. Additional sections explain how to run the Availability Manager and DECamds concurrently. 6.1 OpenVMS Commands and Qualifiers After you make postinstallation file edits, use the DCL commands in the following sections to start the Availability Manager and DECamds. ________________________ Note ________________________ If a user with inadequate page file quota (PGFLQUOTA) tries to run the Availability Manager Data Analyzer on OpenVMS, an error message is displayed and the application stops. Inadequate PGFLQUOTA causes unusual behavior in the OpenVMS Java Virtual Machine, preventing the Availability Manager from starting and running normally. 32 For the appropriate PGFLQUOTA settings, see Section 6.4. ______________________________________________________ 6.1.1 Starting the Data Analyzer To start the Availability Manager Data Analyzer, enter the following DCL command: $ AVAIL/ANALYZER ________________________ Note ________________________ In previous versions, the command to start the Data Analyzer was the following: $ AVAIL/AVAIL This command continues to exist for backward compatibility. ______________________________________________________ To start the Data Server, enter the following DCL command: $ AVAIL/SERVER ________________________ Note ________________________ To use the Data Server with a Data Analyzer, one must create public and private keys. This is explained in chapter 2 of the HP OpenVMS Availability Manager User's Guide. ______________________________________________________ You can also use either of the following qualifiers with the AVAIL command: ___________________________________________________________ Qualifier___Description______Default_Value_of_i____________ /IHEAP=i Initial heap 16M size /MHEAP=i Maximum heap 40M ____________size___________________________________________ You can also use the following qualifier with the AVAIL/SERVER command: 33 ___________________________________________________________ Qualifier___Description______Default_Value_of_n____________ /PORT_ IP port number 9819 NUMBER=n___________________________________________________ where: i is the amount of memory to allocate to the heap. n is the IP port number used when the Data Analyzer is initiating a connection with the Data Server. Use iK or iM on the command line to specify kilobytes or megabytes, respectively. The default values are in megabytes. The following example specifies /IHEAP and /MHEAP values in megabytes: $ AVAIL/ANALYZER/IHEAP=64M/MHEAP=128M For large memory configurations or if a process running the Availability Manager is page faulting excessively or running sluggishly, you might want to increase the heap sizes of the application for better performance. Note that the value of PGFLQUOTA must be a minimum of: 140,000 + (2,000 * MHEAP) 6.1.2 Starting DECamds If you have DECamds installed, to start it, enter the following DCL command: $ AVAIL/MOTIF You can also use any of the following qualifiers: ___________________________________________________________ Qualifier_______Description________________________________ /CONFIGURE Specifies the directories from which input files are read. This can be a search list of directories or a logical defining a search list of directories. /LOG_DIRECTORY Specifies the directory to which log files are written. Output files can be directed to the null device, NLA0: 34 ___________________________________________________________ Qualifier_______Description________________________________ /GROUP A comma-separated list of the groups of Data Provider nodes that you want the Data ________________Analyzer_to_access.________________________ ________________________ Note ________________________ If you later install a version of DECamds that is earlier than Version 7.3-2, you must reinstall the Availability Manager to define the AVAIL command correctly. ______________________________________________________ 6.2 Windows Commands and Options The following sections explain how to run the Data Analyzer or Data Server and how to modify memory allocation pool values on Windows systems. 6.2.1 Running the Application Steps for running the application follow. 1. From the Windows Start menu, click Programs. 2. Click "HP Availability Manager." 3. Follow either step A or B: a. Click "Data Analyzer Startup." b. Click "Data Server Startup." The Availability Manager displays the Application window. (See the Getting Started chapter in the HP OpenVMS Availability Manager User's Guide or see Getting Started online help.) 6.2.2 Modifying Memory Allocation Pool (Heap) Values For large-memory configurations, you might want to increase the heap sizes of the application for better performance. However, the default values are adequate for most installations. 35 To modify the memory allocation pool (heap) values for the Availability Manager Data Analyzer or Data Server on Windows systems, you must modify the minimum and maximum heap default values in the Data Analyzer Startup shortcut or Data Server Startup shortcut command. (The shortcut value is stored in the Programs folder of the Start Menu folder.) Follow these steps: 1. From the Start menu, select Programs and then go to HP Availability Manager. 2. Right-click the Data Analyzer Startup or Data Server Startup option. 3. Click Properties. 4. Click the Shortcut tab. 5. In the Target box: o To modify the minimum size of memory allocation pool, enter a new value for -Xms x. (x must be a value greater than or equal to the default value of 24 megabytes.) If this entry is not in the Target box already, you can add it to the end of the line. Make sure to precede the entry by a space when you add it. o To modify the maximum size of memory allocation pool, enter a new value for -Xmx x. (x must be a value greater than or equal to the default value of 60 megabytes.) If this entry is not in the Target box already, you can add it to the end of the line. Make sure to precede the entry by a space when you add it. 6. When you finish entering new values, click one of the following: o OK to make the new values take effect and to close the window. o Apply to make the new values take effect and to leave the window open. 36 6.2.3 Using Multiple Network Adapters for the Windows Data Server If your Windows Data Server system has more than one network adapter, you can have the Data Server listen for Data Analyzer connections from multiple network adapters. To enable this functionality, do the following steps: 1. Enable the AMDS protocol on the desired network adapters. Do the following steps for each network adapter on your system: a. Display the network adapters by starting the Control Panel on your system, and double-clicking on "Network Connections". b. Right click on the network adapter to display a menu of options and click on "Properties" to display the network adapter properties dialog box. c. In the General tab of the network adapter properties dialog box, search for the "HP Availability Manager NDIS 5.0 Protocol Driver" entry in the "This connection uses the following items:" section. d. To enable the Data Server to use this network adapter, make sure the checkbox on the left of the entry is checked, otherwise, make sure the checkbox is not checked. 2. Use the -port option to assign a port number to each enabled network adapter. Follow these steps: a. From the Start menu, select Programs and then go to HP Availability Manager. b. Right-click the Data Server Startup option. c. Click Properties. d. Click the Shortcut tab. e. In the Target box, find the "9819" parameter, the default port number. f. Modify the "9819" parameter by adding "-port " before it, and adding additional port numbers as needed after it, separated by commas. For example, if you have three network adapters you want the Data Server to use, the modification would look like this: 37 [...] com.compaq.am.server.ServerMain -port 9817,9818,9819 You may choose the port number values. The values should be chosen with the IP protocol conventions for assigning port numbers to applications, and not conflict with port numbers assigned to other applications on your system. If you are not sure of what values to use, HP recommends using values around the 9819 value. g. When you finish modifying the parameter, click one of the following: o OK to make the modifications permanent. o Apply to make the modifications permanent and to leave the dialog box open. ________________________ Note ________________________ o Each network adapter must have a unique port number assigned to it. o If the system uses a firewall, make sure the firewall is configured to allow TCP network connections on each port number. ______________________________________________________ When you start the Data Server, it will print out the port number assignments in the server log file and to the Windows console for the Data Server. The port numbers are assigned in the order that the Windows operating system presents the network adapters to the Data Server. You may need to change the order of the port numbers in the -port option to change the port number assignments to what your site requires. You may also need to change the port number assignments if there is an error in assigning the port number to an adapter. If there is an error in assigning a port number, such as the port number is already used by another application, the error is printed in the server log file and the Windows console for the Data Server. 38 6.3 Using DECamds and the Availability Manager Concurrently The following sections discuss how to configure and start Data Collectors and Data Analyzers on OpenVMS systems for both DECamds and the Availability Manager. Availability Manager performance considerations are also discussed. To install and run DECamds and the Availability Manager concurrently, complete the steps outlined in Table 2. Table 2 Installing and Running DECamds and Availability Manager ________Concurrently_____________________________________________ Step_Description_____________________For_more_information,_see... 1 Install DECamds. See the DECamds installation instructions, which are available as a link from the Availability Manager Documentation page, which is a link on the following web page: http://www.hp.com/products/openvms/availabilitymanager Be sure to follow the instructions for migrating to a new DECamds setup in Section 8 of the DECamds Installation Instructions. These instructions are on the web page cited above. 2 Install the Availability Section 3 through Manager Data Collector and Section 3.8 Data lyser 3 Review the Availability Section 6.3.1 Manager and DECamds configuration files. 4 Make postinstallation edits. Section 6.3.2 5 Make sure the Data Collector Section 3.8 is started on all nodes on which it is installed. (continued on next page) 39 Table 2 (Cont.) Installing and Running DECamds and Availability ________________Manager_Concurrently_____________________________ Step_Description_____________________For_more_information,_see... 6 Use DCL commands to run Section 6.1 DECamds and the Availability _____Manager.____________________________________________________ 6.3.1 Understanding Availability Manager and DECamds Configuration Files The DECamds and Availability Manager products have several common files that the Data Collector (or Data Provider, in DECamds terms) uses. These two products also have several files that have similar functions. Files, directories, or logical names with the same or similar function have the prefix AMDS$ or AMDS$AM, representing DECamds or the Availability Manager, respectively. The installation also uses this naming scheme to place files that are specific to either product. For example, the file that defines logical names for DECamds is: AMDS$SYSTEM:AMDS$LOGICALS.COM For the Availability Manager, this file is: SYS$SYSTEM:AMDS$LOGICALS.COM The names of files that the products have in common usually start with AMDS$. 6.3.1.1 Using Configuration Files Upgrading from versions of the Availability Manager released prior to OpenVMS Version 7.2 might cause problems when you start the Data Collector (AMDS$STARTUP.COM). The location of the startup files and some of the logical name definitions in the startup files were changed beginning with OpenVMS Version 7.2. Releases of the Availability Manager since that time use the new locations and definitions. The following table shows the configuration files that the startup command procedure creates for the Availability Manager and for DECamds. 40 _________________________________________________________________ File__________________Availability_Manager_____DECamds___________ Installation SYS$COMMON:[AMDS$AM] SYS$COMMON:[AMDS] directory Startup command SYS$STARTUP:AMDS$STARTUP Same as procedure Availability Manager Driver file n/a AMDS$SYSTEM: (contains passwords AMDS$DRIVER_ for DECamds V7.1 and ACCESS.DAT earlier) Driver file SYS$MANAGER: Same as (contains passwords AMDS$DRIVER_ACCESS.DAT Availability for DECamds V7.2 and Manager later) Logical names n/a AMDS$SYSTEM: command file AMDS$LOGICALS.COM (contains group names for DECamds V7.1 and earlier) Logical names SYS$MANAGER: Same as command file AMDS$LOGICALS.COM Availability (contains group Manager names for DECamds V7.2 and later) Node-specific SYS$MANAGER: Same as logical names file AMDS$LOGICALS_ Availability ______________________.COM__________Manager___________ 6.3.1.2 Merging Files To use Data Collector passwords as well as group names and other configuration data from DECamds Version 7.1 and earlier, you must merge versions of files for the following: The passwords that the Data Collector (SYS$RMDRIVER) accepts from the Data Analyzer are stored as follows: o For DECamds Version 7.1 and earlier, passwords are stored in the AMDS$DRIVER_ACCESS.DAT file in the SYS$COMMON:[AMDS] directory. 41 o For later versions of DECamds and for the Availability Manager, passwords are stored in SYS$MANAGER:AMDS$DRIVER_ACCESS.DAT. For both products to use this file, follow these steps: 1. Merge any data you want to keep from the copy of AMDS$DRIVER_ACCESS.DAT in the SYS$COMMON:[AMDS] directory into the copy in the SYS$MANAGER directory. 2. Then remove the file from the SYS$COMMON:[AMDS] directory. If you have both products installed and want both products to use the same AMDS$DRIVER_ACCESS.DAT file, make sure this file resides only in SYS$MANAGER. For Group Names, Network Devices, and Other Configuration Data The group names and other configuration data that the Data Collector (SYS$RMDRIVER) accepts from the Data Analyzer are stored as follows: o For DECamds Version 7.1 and earlier, this data is stored in the AMDS$LOGICALS.COM file in the SYS$COMMON:[AMDS] directory. o For later versions of DECamds and for the Availability Manager, this data is stored in SYS$MANAGER:AMDS$LOGICALS.COM. For both products to use this file, follow these steps: 1. Merge any data you want to keep from the copy of AMDS$LOGICALS.COM in the SYS$COMMON:[AMDS] directory into the copy in the SYS$MANAGER directory. 2. Then remove the file from the SYS$COMMON:[AMDS] directory. If you have both products installed and want both products to use the same AMDS$LOGICALS.COM file, make sure this file resides only in SYS$MANAGER. ________________________ Note ________________________ Version 2.3 introduced a way to specify node-specific settings found in AMDS$LOGICALS.COM for a cluster environment. For example, you were able to set the 42 AMDS$DEVICE logical to a node's specific network adapter. The following subsection discusses this file, AMDS$LOGICALS_.COM. ______________________________________________________ 6.3.1.3 Invocation Behavior of Customization Files You can place node-specific settings in SYS$MANAGER:AMDS$LOGICALS_.COM, where node-name is the name of the OpenVMS node in the cluster. To create this file, copy AMDS$LOGICALS.TEMPLATE to AMDS$LOGICALS_.COM, and edit the file to configure node-specific settings. When SYS$STARTUP:AMDS$STARTUP executes, it searches for and executes the following files, if they exist, in this order: 1. SYS$MANAGER:AMDS$LOGICALS.COM 2. SYS$MANAGER:AMDS$LOGICALS_.COM Either or both files can be present; however, if neither file is present, SYS$STARTUP:AMDS$STARTUP outputs an error message and exits. 6.3.2 Making Postinstallation Edits After you install DECamds and the Availability Manager and you understand the configuration files for both products, make postinstallation file edits for Versions 7.2, 7.3, 8.2, 8.3, and all variants of these versions. Two of the file edits are optional, and one is required, as explained in the following steps: 1. Follow the instructions in Section 3.7.1 and Section 3.7.2. 2. To start the Data Collector when the system boots, you must add the following line to the SYS$MANAGER:SYSTARTUP_VMS.COM file: @SYS$STARTUP:AMDS$STARTUP START 43 6.4 Availability Manager Performance Considerations To run Availability Manager applications most efficiently, you need to check a number of settings. For example, before running the application from a particular account, verify that the following account settings are at least the minimum quotas: ___________________________________________________________ Account_____Quota__________________________________________ PGFLQUO 2,100,000 pagelets if you use the default for MHEAP. Add 2,000 pagelets for each MB you increase MHEAP above the default. (See Section 6.1.1.) BYTLM 2,000,000 bytes or greater WSEXTENT____16,384_________________________________________ Also, verify that the following SYSGEN parameter setting is at least the minimum quota: ___________________________________________________________ Parameter___Quota__________________________________________ WSMAX_______16,384_________________________________________ The Java Runtime Environment provides a tool to help you set the necessary account and system parameters correctly. You can access and run this tool from the following location: @ SYS$COMMON:[AMDS$AM.JRE.LIB]JAVA$CHECK_ENVIRONMENT Note, however, that the values that this tool generates are only recommendations. For a detailed discussion of setting system parameters for improved performance, see the section "Setting Process Quotas for Better Performance" in the 5.0.x User Guide for OpenVMS Alpha and I64 at the following URL: http://h18012.www1.hp.com/java/documentation/ 44