Global Workload Manager (gWLM) OpenVMS Agent Version 1.1-4 Installation Guide and Release Notes This document provides information for those intending to install and use the Global Workload Manager (gWLM) agent for OpenVMS. It contains the following sections: 1. gWLM Preliminaries 1.1 Prerequisites 1.2 Installation requirements 1.3 Terminology and workload definitions 1.4 File locations and interfaces available 2. gWLM Installation and Operation 2.1 Installation procedure 2.2 Starting and stopping the gWLM 2.3 Compatibility with other system management methods 3. Known Issues and Workarounds 3.1 Host name configuration 3.2 Class scheduler and I/O-intensive applications 4. Related Documentation What's New in This Release This release updates the previously released gWLM Version 1.1-3 agent kit for OpenVMS, adding support for management of HP Integrity Server nPartitions on systems with HP Instant Capacity. gWLM can manage servers with HP Instant Capacity (iCAP) installed to maximize CPU utilization by transferring processor usage rights to the most heavily utilized partitions. This functionality is available only on OpenVMS I64 Version 8.3 and higher. 1 gWLM Preliminaries The following sections contain information that you need prior to installing gWLM. 1 1.1 Prerequisites Prerequisites of gWLM installation are in the following sections. gWLM Central Management Server (CMS) You need to install the gWLM agent for OpenVMS on all systems whose workloads you want to manage. To set up and monitor gWLM, you use the gWLM Central Management Server (CMS). To complete your installation, you also need one of the following CMS options: o gWLM CMS 1.1.x. requires HP Systems Insight Manager (HP SIM) Version 4.2 o gWLM CMS 2.x (packaged as part of Virtualization Manager) requires HP SIM Version 5. Versions of the products for HP-UX and Linux are available as free downloads from the following web site: http://h20293.www2.hp.com/portal/swdepot/displayProductsList.do?category=ISS gWLM CMS 1.1 for Windows for managing OpenVMS systems is also available. For download instructions, see the following web site: http://h71000.www7.hp.com/openvms/integrity/integrity_gwm.html TCP/IP TCP/IP is required. You can use either of the following versions: HP TCP/IP Services for OpenVMS I64 5.5 or higher HP TCP/IP Services for OpenVMS Alpha Version V5.4 - ECO 4 or higher UTC Time Ensure that UTC time is correctly set up on the managed systems. Failure to do so results in errors in time stamp values reported in the user interface. nPartition Management The management of HP Integrity Server nPartitions using HP Instant Capacity (iCAP) requires Version 2.1 or later of WBEM Services for OpenVMS. 2 1.2 Installation Requirements The installation requirements are in the following sections. Versions of OpenVMS You can install the gWLM on the versions of OpenVMS shown in the following table. Required patches, if any, are also listed. ___________________________________________________________ OpenVMS Version Platform Required Patches ___________________________________________________________ Version 7.3-2 Alpha VMS732_UPDATE-V0400 VMS732_PTHREAD-V0500 VMS732_SYS-V0700 Version 8.2 Alpha VMS82A_PTHREAD-V0100 Version 8.2-1 I64 VMS821_SYS-V0100 VMS821_PTHREAD-V0200 ___________________________________________________________ Disk Space Post-installation space used on the system disk is approximately the following: o I64: 320000 blocks (155 MB) o Alpha: 110000 blocks (53 MB) 1.3 Terminology and Workload Definitions The following sections explain gWLM terms and provide workload definitions. 1.3.1 Terminology The gWLM manages several types of virtual compartments. In the user interface (UI) and in related gWLM documents, these types are referred to in terms that are familiar to HP-UX users. Explanations of these terms for OpenVMS users are in the following table. 3 ___________________________________________________________ Term Explanation ___________________________________________________________ nPars gWLM can manage servers with HP Instant Capacity (iCAP) installed to maximize CPU utilization by transferring processor usage rights to the most heavily utilized partitions. This function requires OpenVMS I64 Version 8.3 or higher, and is interoperable with other gWLM-supported operating systems running in other nPartitions on the server. vPars OpenVMS soft partition. Selecting this compartment type allows gWLM to reassign processors between the soft partitions of a hard partition. This functionality is currently only available on OpenVMS Alpha. pset A processor set (pset) is a subset of the processors available to a single OS instance. gWLM on OpenVMS uses process and processor capabilities to implement psets. fss The equivalent of HPUX fair-share scheduler (fss) is the OpenVMS class scheduler. Selecting this compartment type causes gWLM to manage CPU resources using the class scheduler. ___________________________________________________________ Online help contains a useful glossary, which you can access through the gWLM home page in the HP SIM. (Click the large '?' at the top right.) 1.3.2 Workload Definitions Guidelines for composing application workload definitions are in the following list. o When you compose an application workload definition using application path names, UNIX-style path names are preferred; for example: /sys$common/java$142/bin/java$java.exe /sys$system/vms*.exe /RED$DKA0/SYS0/SYSCOMMON/JAVA$142/BIN/JAVA$JAVA.EXE o The usual wildcard characters, "%" and "*", are allowed. "Application Alternate Names" are not necessary on OpenVMS; do not specify them. 4 o You can use OpenVMS-style path names for individual, non-wildcarded executables; for example: RED$DKA0:[SYS0.SYSCOMMON.JAVA$142.BIN]JAVA$JAVA.EXE SYS$SYSTEM:VMSHELP.EXE SYS$COMMON:[SYSEXE]VMSHELP.EXE o If you use a Version 1.1.1, 1.1.2, or 2.0 gWLM CMS, in addition, the path name must start with a "/" character; for example: /RED$DKA0:[SYS0.SYSCOMMON.JAVA$142.BIN]JAVA$JAVA.EXE /SYS$SYSTEM:VMSHELP.EXE /SYS$COMMON:[SYSEXE]VMSHELP.EXE 1.4 File Locations and Interfaces Available The gWLM agent installs on OpenVMS in the following directory: sys$sysroot:[gwlm] UNIX pathnames referenced in the UI and elsewhere are mapped as follows: ___________________________________________________________ UNIX Pathname OpenVMS Pathname ___________________________________________________________ /etc/opt/gwlm sys$sysroot:[gwlm] /var/opt/gwlm sys$sysroot:[gwlm.log] ___________________________________________________________ Available Interfaces You can perform most operations using either HP Systems Insight Manager or the 'gwlm' command on the gWLM Central Management Server (CMS). The following agent commands are available on a system on which the OpenVMS agent is installed: o gwlmsslconfig o gwlmimportkey o gwlmexportkey o gwlmplace 5 o gwlmsend These commands are implemented as foreign commands. Before you can use them, you must first execute the following command line: $ @sys$sysroot:[gwlm.bin]gwlm$env get_commands You can obtain interactive help for these commands by entering the following command: $ help gWLM To use agent commands, you must have read and write access to the files in the following directory: sys$sysroot:[gwlm] 2 gWLM Installation and Operation The following sections tell how to install the gWLM agent and stop the gWLM, what compatibilities the gWLM has with other products, and what issues and workarounds the gWLM has. 2.1 Installation Procedure Before installing the gWLM, you must install a PAK that is appropriate to your hardware platform. To install the gWLM agent, enter the following command: $ product install gwlm/source= Likewise, you can remove the gWLM with the following command: $ product remove gwlm 2.2 Starting and Stopping the gWLM You can start the gWLM agent by invoking a command procedure by entering the following command: $ @sys$startup:gwlm$startup You can stop the gWLM agent by invoking a command procedure by entering the following command: $ @sys$startup:gwlm$shutdown 6 2.3 Compatibility with Other System Management Methods The gWLM agent makes use of the following OpenVMS technologies: o Class scheduler o Process and processor capabilities o Processor assignment among soft partitions o HP Instant Capacity commands ________________________ Note ________________________ If other software is attempting resource management with any of these technologies, the gWLM might not be able to place all the system processes in the workloads you define using the gWLM user interface. ______________________________________________________ 3 Known Issues and Workarounds The following issues are in addition to those documented in the main product release notes. 3.1 Host Name Configuration Differences in host name configuration between the CMS and managed hosts might lead to an error during the discovery phase. An example of an error message is the following: "The IP address 16.32.16.151 resolves to two different fully qualified domain names. The fully qualified domain name on the managed node is wbem6; the CMS has the managed node's fully qualified domain name as wbem6.zko.dec.com. Please correct and retry. Please re-enter the systems." The following example deals with the problem on the managed node by providing the managed node with a fully qualified domain name definition. TCPIP> show host wbem6 LOCAL database Host address Host name 16.32.16.151 wbem6, WBEM6 7 TCPIP> set nohost "wbem6" TCPIP> set host "wbem6.zko.dec.com"/address=16.32.16.151/alias=("wbem6",wbem6) TCPIP> show host wbem6 LOCAL database Host address Host name 16.32.16.151 wbem6, WBEM6 TCPIP> set nohost "wbem6" TCPIP> set host "wbem6.zko.dec.com"/address=16.32.16.151/alias=("wbem6",wbem6) TCPIP> show host wbem6 LOCAL database Host address Host name 16.32.16.151 wbem6.zko.dec.com, wbem6, WBEM6 3.2 Class Scheduler and I/O-Intensive Applications Current versions of the OpenVMS class scheduler treat I/O- intensive applications rather harshly. This is evident in irregularly high CPU usage being reported to gWLM, which causes rapid CPU quota depletion and results in poor throughput. You can lessen this problem by setting the system parameter IOTA to 0. HP plans to release a patch kit for the OpenVMS SYS facility in the near future. 4 Related Documentation Additional gWLM documents are available from the following web sites: o HP gWLM Version A.01.01.x Release and Installation Notes for HP-UX 11i v1, HP-UX 11i v2 Update 2, and Linux http://docs.hp.com/en/T2762-90004/index.html o Getting Started with gWLM: Version A.01.01.x http://docs.hp.com/en/T2762-90005/index.html o gWLM: Reference and Additional Topics: Version A.01.01.x http://docs.hp.com/en/T2762-90006/index.html o gWLM and related products www.hp.com/go/gwlm 8