HP-UX Workload Manager A.03.02.xx Release Notes for HP-UX 11i v1, HP-UX 11i v2, and HP-UX 11i v3 Manufacturing Part Number: B8843-90038 October 2007 © Copyright 2000-2007 Hewlett-Packard Development Company, L.P.
Legal Notices The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this documentation, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Oracle is a registered trademark of Oracle Corporation, Redwood City, California. SAS and all other SAS Institute Inc. product or service names are registered trademarks or trademarks of SAS Institute Inc. in the USA and other countries. indicates USA registration. SAP is a registered trademark of SAP AG in Germany and several other countries.
http://www.sourceforge.net HP-UX Workload Manager and libxml2: Starting with version A.03.00, HP-UX Workload Manager uses libxml2, the XML C parser and toolkit developed for the Gnome project at MIT. Though it is written in the C language, a variety of language bindings make it portable to other environments. It is licensed under the agreement available at /opt/wlm/lib/README.libxml2. The version of libxml2 that HP-UX Workload Manager uses is libxml2 2.6.10.
HP-UX Workload Manager Release Notes 1 HP-UX Workload Manager Release Notes This release notice contains the following information about HP-UX Workload Manager A.03.02.
HP-UX Workload Manager Release Notes Announcement Announcement HP-UX WLM A.03.02 runs under the following HP-UX operating systems and hardware: Operating Systems Hardware HP-UX 11i v1 (B.11.11) HP 9000 servers HP-UX 11i v2 (B.11.23) HP 9000 servers and HP Integrity servers HP-UX 11i v1 (B.11.11) and HP-UX 11i v2 (B.11.23) Servers combining HP 9000 partitions and HP Integrity partitions; in such environments, HP-UX 11i v1 (B.11.11) supports HP 9000 partitions only HP-UX WLM A.03.02.
HP-UX Workload Manager Release Notes New in this version • CPU shares-per-metric allocations, which allow you to give a workload, for example, 2% of the CPU resources for each process in the workload • Multiple SLOs at different priorities, allowing you to have a “must meet” goal and optional stretch goals for each workload • Passive mode for analyzing a configuration’s behavior • Audit and billing data • Ability to set minimum and maximum amounts of cores available to a workload • Time-based and
HP-UX Workload Manager Release Notes New in this version Hyper-Threading state of cores assigned to a specific PSET group; you can also modify the Hyper-Threading state of the system. (Modifications to the Hyper-Threading state should not be made while WLM is running.) For more information, see wlmconf(4) or the HP-UX Workload Manager User’s Guide. • When referring to hardware, CPUs are now referred to as cores in the documentation and in WLM displays or data reports.
HP-UX Workload Manager Release Notes Known problems and workarounds will run in the associated workload group. WLM supports Unix group records only if PRM C.03.02 or later is running on the system. For more information, see wlmconf(4) or the HP-UX Workload Manager User’s Guide. • Temporary Instant Capacity (TiCAP) activates capacity in a temporary “calling-card fashion,” such as in 30-day increments (where a day equals 24 hours for one core).
HP-UX Workload Manager Release Notes Known problems and workarounds Capping issue Issue WLM maintains CPU allocations for workloads by capping their CPU access. Unfortunately, an algorithm in the CPU scheduler that WLM uses does not always preserve capping.
HP-UX Workload Manager Release Notes Known problems and workarounds Temporary Instant Capacity (TiCAP) expires while WLM is managing nPartitions Issue WLM manages nPartitions using its wlmpard daemon. Assume wlmpard is started on a system that has Temporary Instant Capacity in use. If that temporary capacity expires, wlmpard will still be able to deactivate cores without any problems. However, wlmpard may attempt to activate cores based on the expired capacity.
HP-UX Workload Manager Release Notes Known problems and workarounds Automatic activation of Instant Capacity core without authorization Issue An Instant Capacity (iCAP) core was automatically activated without customer authorization. Workaround Please contact your HP representative. If you have Instant Capacity or Pay per use (PPU) software installed, either: • Do not use WLM virtual partition management, or • Use vPars version A.03.
HP-UX Workload Manager Release Notes Known problems and workarounds wlmcomd -k failed: Resource temporarily unavailable These messages are misleading in that they imply that the shutdown request had failed when it might not have. These messages have been replaced by the more accurate messages reported above. Workaround If a shutdown request has been delayed for 30 seconds, WLM issues the “Waiting for shutdown confirmation” message.
HP-UX Workload Manager Release Notes Known problems and workarounds 3. Re-start WLM (wlmd -a configuration_file) • Replace the data collector 1. Move the current data collector aside 2. Install the new data collector in place of the collector you just moved aside 3. Re-start WLM (wlmd -a configuration_file) GlancePlus/OpenView Performance Agent and processor sets Issue On systems with multiple processor sets configured, GlancePlus may have incorrect data for the PRM_SYS group (ID 0).
HP-UX Workload Manager Release Notes Known problems and workarounds glance Adviser memory consumption increases continually Issue GlancePlus’s glance Adviser leaks memory when running continuously. Adviser is used by the WLM data collectors glance_app, glance_gbl, glance_prm, glance_prm_byvg, and glance_tt. Workaround This memory leak is fixed in GlancePlus C.03.35.00.
HP-UX Workload Manager Release Notes Known problems and workarounds WLM configurations cannot be activated with fewer than 100 Mbytes of memory available Issue When controlling memory, WLM allocates at least a minimum amount to each group. If extended_shares is enabled, this minimum is 0.2% of the available memory; otherwise, it is 1%.
HP-UX Workload Manager Release Notes Known problems and workarounds If this system limit is reached, wlmd prints the following error and exits before the first WLM interval begins: Cannot allocate a system V semaphore set of size x: Increase the system-imposed limits. You may also see the following error: WLM--”wm_knob_init, prm_rep_load”: PRM--”PRM internal daemon binary is missing or has incorrect permissions (PRM-2352)” For additional details relating to this message, look in syslog.
HP-UX Workload Manager Release Notes Known problems and workarounds Processes in transient FSS groups appear unexpectedly in other workload groups Issue A deployed WLM configuration that has transient_groups set to 1 and contains FSS transient group candidates from time-to-time contains an FSS group called _IDLE_. As needed, WLM moves the jobs of the transient groups to _IDLE_, where they get the minimum of CPU and memory resources.
HP-UX Workload Manager Release Notes Known problems and workarounds nPartition, you must first shut down WLM in every operating system instance across the entire complex, because the name change affects Instant Capacity, and Instant Capacity changes affect every nPartition across the complex. To stop WLM, stop the wlmpard and wlmd daemons (use the -k option with the corresponding commands).
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Upgrading or installing PRM before upgrading WLM from C.03.00 or earlier can cause WLM to fail swverify checks Issue If you install or upgrade to the latest version of PRM (C.03.02 or later) on a system with WLM A.03.00 or earlier, WLM will fail swverify checks. Workaround To ensure that WLM works properly on a system with PRM C.03.02 or later, upgrade WLM to A.03.02 or later. When upgrading WLM A.03.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements kernel (/stand/vmunix) and its data structures and for nonkernel system processes. Thus, available memory is not the total memory on the system. Available memory varies over time. For more information, see the Process Resource Manager User’s Guide, available in /opt/prm/doc.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Table 1-1 Software package Verified software configurations (Continued) Version on HP-UX 11i v1 (B.11.11) Version on HP-UX 11i v2 Update 2 (B.11.23) Version on HP-UX 11i v3 (B.11.31) Processor Sets A.01.00.00.07 The PSET version included with HP-UX The PSET version included with HP-UX Serviceguard A.11.15 (HP recommends using A.11.17 or later) A.11.17 A.11.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Table 1-1 Software package HP-UX Bastille Verified software configurations (Continued) Version on HP-UX 11i v2 Update 2 (B.11.23) Version on HP-UX 11i v1 (B.11.11) B.02.01 B.02.01 Version on HP-UX 11i v3 (B.11.31) B.03.00 Compatibility with long hostnames WLM supports long host names. You must install the bundle NodeHostNameXpnd and configure the feature first though.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Compatibility of WLM virtual partition management and Instant Capacity / PPU If you have Instant Capacity (iCAP) or Pay per use (PPU) software installed, use WLM virtual partitions management only if you have vPars version A.03.01 or later. If you have a vPars version prior to A.03.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements For more information on Integrity VM, go to the following location and navigate to the “Solution components” page: www.hp.com/go/vse Compatibility of WLM partition management and PSETs WLM now supports simultaneous management of partitions (virtual partitions or nPartitions) and PSET-based workload groups.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Compatibility with PRM As of version A.03.01, WLM no longer includes PRM in the bundle. As a result, upgrading WLM no longer triggers a reboot. WLM will run only with PRM C.03.00 or later. If PRM C.03.00 or later is already on the machine where you are installing or upgrading WLM, you can continue to manage FSS and PSET-based workload groups just as if PRM had been installed with WLM.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements CPUCAPOFF mode, enabled with the prmconfig -M CPUCAPOFF command. (In this mode, a PRM group’s upper bound for CPU resource consumption is determined by the CAP value, available on HP-UX 11i v3 and later. For more information, see the HP Process Resource Manager User’s Guide or prmconfig(1M).
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 8. Shut down WLM if it is already running Step 9. Install patches and install/upgrade WLM Step 10. Check the file /var/adm/sw/swagent.log Step 11. (Optional) Ensure you have the proper version of GlancePlus Step 12. (Optional) Install files for integration with HP Systems Insight Manager Step 13. (Optional) Merge new /etc/rc.config.d/wlm file with your modified file These steps are discussed in detail below.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 1. Verify that HP-UX is up-to-date HP suggests that as part of your systems’ ongoing maintenance and support, the systems be kept up-to-date through the HP IT Resource Center’s Support Plus program. This program delivers quarterly patch bundles via the web and as part of the quarterly AR media. To register, go to the following location: http://itrc.hp.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Processor sets are included with HP-UX 11i v2 (B.11.23) and HP-UX 11i v3 (B.11.31). For HP-UX 11i v2 (B.11.23), install the following patches:] Table 1-3 HP-UX 11i v2 (B.11.23) patches for WLM HP-UX 11i v2 patch Description BUNDLE11i patch bundle Bundle of patches (Installing this bundle updates your system to HP-UX 11i v2 Update 2.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 2. (Optional) Configure long hostnames Ensure the NodeHostNameXpnd bundle is installed if you want to use long host names on HP-UX 11i v2 or v3. Configure long host names as described below.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements For HP-UX 11i v1, the following patches are available: Table 1-4 HP-UX 11i v1 (B.11.11) patches for WLM HP-UX 11i v1 Description patch* PHKL_33372 Memory Resource Groups (MRG) patch (supersedes PHKL_32619) PHKL_30034, PHKL_30035, PHKL_31993, PHKL_31995, PHKL_32061 NOTE: Install all these patches at the same time.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements * These patches might have been superseded. You can use these listed patches or their superseding patches. b. Determine which patches are already on the system If a recent Quality Pack is installed, some of these patches may already be on your system. To determine if these patches are installed, use swlist as follows: # /usr/sbin/swlist [-l patch] patch where patch is the patch’s tag.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 5. (Optional) Create a software depot to minimize system reboots Creating a depot is beneficial when you are completing two or more of the following tasks: • Installing patch bundles (GOLDQPK11i or HWEnable11i) The patch bundles include kernel patches. Installation of a patch bundle requires a system reboot. • Installing PHKL_* patches The PHKL_* patches are HP-UX kernel patches.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements a. Ensure that adequate disk space is available. The size of each patch can be found in its README text. b. Create a directory for the depot: # mkdir /tmp/wlm_depot c. Place any patch bundles you downloaded in Step 1 (GOLDQPK11i or HWEnable11i) in /tmp/ if they are not already there. For more information on these patch bundles, refer to Table 1-2. d. Check each of the patch bundles.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements g. Place any missing individual patches that you downloaded in Step 4 in /tmp/. For HP-UX 11i v1 (B.11.11) patches, refer to Table 1-4. For HP-UX 11i v2 (B.11.23) patches, refer to Table 1-5. h. Add each patch file to the depot: # swcopy -s patch_file_path \* @ depot_path where patch_file_path and depot_path are fully specified path names. For example: # swcopy -s /tmp/PHKL_32619.depot \* @ /tmp/wlm_depot i.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements l. Add WLM (product B8843CA) to the depot. NOTE The WLM bundle B8843CA requires a customer_id/codeword pair to unlock it from the quarterly AR CD-ROM. Purchase of WLM entitles you to this codeword, which can be found on the Software Certificate you received from HP. The WLM codeword is needed to complete the next step.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 8. Shut down WLM if it is currently running Run the following command on every system or partition where you will install/upgrade WLM: # /opt/wlm/bin/wlmd -k Also shut down any running instances of the WLM global arbiter: # /opt/wlm/bin/wlmpard -k Step 9. Install patches and install/upgrade WLM NOTE The procedure below explains installation using the command-line version of swinstall.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements c. Install WLM There are two methods for installing WLM. You can: • Install WLM from the depot you created in Step 5 • Install WLM directly from the CD-ROM These options are discussed below.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Installing from the CD-ROM NOTE Installing without the benefit of a depot may cause unnecessary reboots. For information on reducing reboots, see Step 5 on creating a software depot. If you are installing WLM from the CD-ROM: i. Install the general support patch bundles and software from Step 1 If your system is missing any general HP-UX patch bundles or software mentioned in Step 1, install them now.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements d. Restart MeasureWare if it was running before the WLM upgrade/installation: # /usr/sbin/init.d/mwa start Step 10. Check the file /var/adm/sw/swagent.log Check the file /var/adm/sw/swagent.log for messages relating to additional tasks that may need attention following the swinstall of WLM bundle B8843CA. Step 11.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements These settings prevent PRM and its remote configuration daemon from starting automatically at reboot. (The PRM remote configuration daemon is not useful with WLM and does not need to be started.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Using the swinstall Graphical User Interface (GUI) Using the swinstall GUI can simplify installation. The steps below illustrate how to use the GUI to install patches and WLM from a depot (Step 9 above): Step 1. Start the swinstall GUI: # /usr/sbin/swinstall -s depot_path where depot_path is the path for the depot you created for the patches, patch bundles, and WLM. Step 2.
HP-UX Workload Manager Release Notes Patches and fixes in this version Patches and fixes in this version WLM version A.03.02.xx includes the following fixes. wlmcert does not truncate an existing certificate file when a new certificate with the same name is installed In previous versions of WLM, if a new certificate is installed where an existing certificate of the same name exists, wlmcert fails to truncate the existing certificate file as it should when that file is bigger than the new one.
HP-UX Workload Manager Release Notes Patches and fixes in this version Beginning with this release of WLM, a new global arbiter configuration keyword (utility_reserve_threshold) enables you to increase or decrease this threshold. The default is 15 days.
HP-UX Workload Manager Release Notes Patches and fixes in this version If WLM cannot increase a partition’s CPU resources, the wlminfo par command displays the wrong CPU (core) count If WLM is not able to increase a partition’s CPU resources (number of cores), the wlminfo par command erroneously displays the same value for both the intended and actual core count.
HP-UX Workload Manager Release Notes Software availability in native languages This fix addresses CR# JAGag06301. wlmprmconf might generate invalid configurations The script for converting PRM configuration files to WLM configuration files, wlmprmconf, might create configurations with invalid syntax when the PRM configuration file involves the PRM_SYS group and secure compartment records.
HP-UX Workload Manager Release Notes Security Security This section highlights security items you should be aware of. Relationship between host name and SSL certificates SSL certificates are created when you install WLM. This enables WLM to run in secure mode within the system on which it is installed. As of Version A.03.01, when you start WLM using the “/sbin/init.d/wlm start” script, the script uses secure mode by default.
HP-UX Workload Manager Release Notes Security Data collectors Data collectors invoked by WLM run as root and can pose a security threat. Hewlett-Packard makes no claims of any kind with regard to the security of data collectors not provided by Hewlett-Packard. Furthermore, Hewlett-Packard shall not be liable for any security breaches resulting from the use of said data collectors. wlmgui and wlmcomd WLM and the WLM GUI allow you to set up secure communications as described in wlmcert(1M).
HP-UX Workload Manager Release Notes Available manuals Partitions WLM manages virtual partitions and nPartitions through a global arbiter. WLM’s global arbitration uses non-secured communications. A rogue user could manipulate the communications, resulting in one or more partitions being granted an incorrect number of cores. Use global arbitration only on trusted local area networks. By default, wlmpard communicates to the partitions on a system through port 9691.
HP-UX Workload Manager Release Notes WLM toolkits Information about HP-UX system administration and Logical Volume Manager can be found in: • Managing Systems and Workgroups (B2355-90950) WLM toolkits Hewlett-Packard provides integration toolkits to simplify integrating Workload Manager with major third-party applications. The toolkits are made available on the web as they are developed. Also, they are bundled with the subsequent Workload Manager release.
HP-UX Workload Manager Release Notes Training Training HP offers a course in HP-UX resource management using WLM. For information, including a course outline, visit: http://www.hp.com/education/courses/u5447s.
