HP-UX Workload Manager A.03.01 Release Notes for HP-UX 11i v1 and HP-UX 11i v2 Manufacturing Part Number: B8843-90037 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.
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.
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.
HP-UX Workload Manager Release Notes Announcement Announcement HP-UX Workload Manager (WLM) A.03.01 supports HP-UX 11i v1 (B.11.11) on HP 9000 servers; also, it supports HP-UX 11i v2 (B.11.23) on HP 9000 servers and HP Integrity servers, and it supports HP-UX 11i v2 (B.11.23) on servers combining HP 9000 partitions and HP Integrity server partitions. HP-UX WLM provides goal-based workload management.
HP-UX Workload Manager Release Notes What’s in this version What’s in this version WLM A.03.01 provides the following new or changed functionality. • WLM A.03.01 no longer includes Process Resource Manager (PRM) in the bundle. With PRM no longer in the bundle, upgrading WLM does not trigger a reboot. WLM will run only with PRM C.03.00 or later. If PRM C.03.
HP-UX Workload Manager Release Notes What’s in this version not support Pay Per Use, vPar, and Instant Capacity integration (however, an Integrity VM will take advantage of CPU resources added to the VM Host by Pay Per Use, Instant Capacity, and Temporary Instant Capacity). In addition, when running WLM inside an Integrity VM, you should specify a WLM interval greater than 60 seconds. This helps ensure a fair allocation of CPU resources for FSS groups.
HP-UX Workload Manager Release Notes What’s in this version For more information, refer to the wlmcert(1M), wlmd(1M), wlmpard(1M), and wlmcomd(1M) manpages and the /etc/rc.config.d/wlm file. • WLM now supports finer granularity for minimum allocations to FSS groups. The extended_shares tunable (supported on both HP-UX 11i v1 and HP-UX 11i v2 systems) enables finer granularity for allocations to FSS groups, decreasing minimum allocations from 1% to 0.2%.
HP-UX Workload Manager Release Notes What’s in this version Such support requires the following: — If Instant Capacity is available on the complex, it must be v7 or later — If HP-UX Virtual Partitions (vPars) is on the complex, it must be v4 (A.04.01) or later — If Pay Per Use is on the complex, it must be v7 or later • HP recommends using absolute CPU units (set absolute_cpu_units to 1). • WLM now allows you to use wildcards in both the file name and the alternate name in a single application record.
HP-UX Workload Manager Release Notes Known problems and workarounds • The following example configuration files in /opt/wlm/examples/wlmconf/ have new names and commentary: Old name • New name npar_icod_manual_allocation.wlm par_manual_allocation.wlm npar_icod_manual_allocation.wlmpar par_manual_allocation.wlmpar vpar_usage_goal.wlm par_usage_goal.wlm vpar_usage_goal.wlmpar par_usage_goal.wlmpar The example script loop2_usage_goal.pl has been removed from /opt/wlm/examples/userguide/.
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. You may see symptoms of this issue in wlminfo output. A portion of sample output is shown below: # wlminfo group Workload Group OTHERS g_nice g_nightly g_team PRMID 1 2 3 4 CPU Shares 450.00 108.00 0.00 6.00 CPU Util 4.49 55.57 0.00 0.
HP-UX Workload Manager Release Notes Known problems and workarounds Temporary Instant Capacity 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 CPUs without any problems. However, wlmpard may attempt to activate CPUs based on the expired capacity.
HP-UX Workload Manager Release Notes Known problems and workarounds You will also see the message: Unable to set the local partition to z CPUs. Check the partition status. where x, y, and z represent integer values. Workaround Add a utilitypri statement to your wlmpard configuration, say configuration_file, and then load the new file: # /opt/wlm/bin/wlmpard -a configuration_file The utilitypri keyword allows WLM—when Temporary Instant Capacity is available—to adjust the CPU total to meet demand.
HP-UX Workload Manager Release Notes Known problems and workarounds Install patch PHKL_33052. “wlmd -k failed,” “wlmpard -k failed,” “wlmcomd -k failed” messages Issue You may get one of the following messages when using -k with a WLM daemon: wlmd -k failed: Resource temporarily unavailable wlmpard -k failed: Resource temporarily unavailable wlmcomd -k failed: Resource temporarily unavailable Workaround When you get one of these messages, the -k most likely did succeed—but not as quickly as expected.
HP-UX Workload Manager Release Notes Known problems and workarounds Collectors abort when updated while running Issue If you update (overwrite) a data collector executable (be it a binary or a script) while it is providing data to WLM, the collector may abort. Workaround There are two workarounds to this issue: • Update the data collector in place 1. Stop WLM (wlmd -k) 2. Update the data collector 3. Re-start WLM (wlmd -a configuration_file) • Replace the data collector 1.
HP-UX Workload Manager Release Notes Known problems and workarounds GlancePlus may not correctly identify processes’ PRM groups Issue On some systems, GlancePlus would not correctly identify processes’ PRM groups. WLM uses these PRM groups as its workload groups. On these systems, GlancePlus would report all processes as belonging to the PRM_SYS group (ID 0). As a result, WLM’s glance_prm data collection script could not be used to track application (APP) metrics for a PRM group of processes.
HP-UX Workload Manager Release Notes Known problems and workarounds minutes begin at 3pm everyday, but the interval ends at 3:15pm, your configuration does not actually go into effect until 3:15pm. Moreover, it is not changed again until 3:45pm. Workaround Be aware of how your interval and time-based SLOs interact and adjust them accordingly. No metrics on startup or reconfiguration Issue Metrics have no value on WLM startup or reconfiguration. WLM cannot work toward any SLOs without metrics.
HP-UX Workload Manager Release Notes Known problems and workarounds Secure Resource Partitions: Blocked port on a virtual network interface Issue Using the HP-UX feature Security Containment, you can set up a virtual network interface for each secure compartment. A process in one secure compartment can bind to a socket on a virtual network interface associated with a different secure compartment.
HP-UX Workload Manager Release Notes Known problems and workarounds Reaching the system V semaphore limit Issue If your system has many system V semaphores in use, WLM’s use of semaphores may push the total number of semaphores over system limits—especially if the WLM configuration contains a large number of data collectors. The WLM daemon wlmd creates two semaphore sets: one containing a single semaphore; the other containing a semaphore for each data collector in the WLM configuration.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Workaround Install PRM. Processes in transient FSS groups appear 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 only 1% of the system.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Disk and memory requirements This version of WLM requires: • 16 Mbytes of disk space in /opt/wlm/ • disk space in /opt/prm/: 8 Mbytes • 5 Mbytes of memory (Also, your system must have at least 100 Mbytes of available memory for WLM to properly manage the workloads’ memory usage. If extended_shares is enabled, WLM memory control requires at least 512 MB of memory.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Compatibility with other software WLM A.03.01 was verified using the software listed in the following table. Compatibility with other versions of the software packages is unknown unless explicitly stated. Table 1-1 Verified software configurations Software package Version on HP-UX 11i v1 Version on HP-UX 11i v2 Update 2 PRM C.03.00, C.03.01 C.03.00, C.03.01 Processor Sets A.01.00.00.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Table 1-1 Verified software configurations (Continued) Software package Version on HP-UX 11i v1 Version on HP-UX 11i v2 Update 2 WLM Toolkits A.01.09 A.01.09 HP-UX Bastille B.02.01.02 B.02.01.02 Compatibility with long hostnames WLM supports long hostnames. 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’s virtual partition management and Instant Capacity / PPU If you have Instant Capacity or Pay Per Use (PPU) software installed, use WLM’s 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 Compatibility of WLM’s partition management and PSETs WLM now supports simultaneous management of partitions (virtual partitions or nPartitions) and PSET-based workload groups. Such support requires the following: • If Instant Capacity is available on the complex, it must be v7 or later • If HP-UX Virtual Partitions (vPars) is on the complex, it must be v4 (A.04.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements WLM and PRM should not be used to manage the same system at the same time. Using these products to control resources at the same time may cause inconsistent behavior and undesirable performance. WLM uses PRM for some types of resource management. You can bypass WLM and use PRM directly; however, if you do use PRM directly through its own configuration file, do not use any of the WLM interfaces.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 8. Install patches and install/upgrade WLM Step 9. Check the file /var/adm/sw/swagent.log Step 10. (Optional) Ensure you have the proper version of GlancePlus Step 11. (Optional) Install files for integration with HP Systems Insight Manager Step 12. (Optional) Merge new /etc/rc.config.d/wlm file with your modified file These steps are discussed in detail below. Step 1.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Select the Patches/support link and search for “processor sets”. As noted in the section “System panic when PRM is enabled; install failure in absence of PRM when certain kernel patches are present” on page 11, this software also corrects several problems. NOTE Install GOLDQPK11i before installing the processor sets software—unless you are using a depot to install them at the same time.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements • HP Technical Documentation (http://docs.hp.com) Refer to the HP-UX 11i v1 topics “Installing and Updating” and “Patch Management”. Step 2. (Optional) Configure long hostnames Ensure the NodeHostNameXpnd bundle is installed if you want to use long hostnames on HP-UX 11i v2. Configure long hostnames as described below.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Table 1-4 HP-UX 11i v1 (B.11.11) patches for WLM (Continued) HP-UX 11i v1 patch PHKL_30034, PHKL_30035, PHKL_31993, PHKL_31995, PHKL_32061 Description NOTE: Install all these patches at the same time.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements # /usr/sbin/swlist -d patch @ /tmp/bundle_name If a given patch is not listed, check HP’s IT Resource Center (http://itrc.hp.com) for a superseding patch, then use swlist to list the superseding patch. c. Download any missing patches to /tmp.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 4. (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 2 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. Use a line similar to the following to add WLM to your depot.
HP-UX Workload Manager Release Notes Compatibility information and installation requirements Step 7. 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 8. 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 6 • 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 4 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 9. 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 10.
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 8 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.01 includes the following fixes. WLM miscalculates CPU usage in strictly host-based configurations In previous releases, WLM included a processor’s CP_WAIT time in the usage calculation for a strictly host-based configuration (a configuration that does not include a prm structure).
HP-UX Workload Manager Release Notes Patches and fixes in this version Secure compartments not usable with empty PSETs In previous releases, WLM would reject configurations that used secure compartment records with PSETs having no CPUs allocated to them. This problem occurred with PRM C.03.00 (which would reject WLM secure compartment records used with such PSETs). PRM C.03.01 has been fixed so that it no longer rejects WLM secure compartment records associated with empty PSETs.
HP-UX Workload Manager Release Notes Patches and fixes in this version This fix addresses CR# JAGaf76390. hmincpu, hmaxcpu, and hweight do not always behave as expected In previous releases, WLM would not always produce the expected CPU distribution when using hmincpu, hmaxcpu, and hweight. WLM has been fixed so that it now produces the correct distribution when using these values. This fix addresses CR# JAGaf82020.
HP-UX Workload Manager Release Notes Software availability in native languages Software availability in native languages The manpages are available only in English. The release notes and user’s guide are available in English and Japanese. 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.
HP-UX Workload Manager Release Notes Security When using WLM to manage partitions, each partition must have in its truststore the certificate of every other partition with which it is being managed. NOTE If you use Serviceguard on the system running wlmpard, any systems to which wlmpard might fail over must have the same certificates installed in their truststores as does the primary wlmpard node.
HP-UX Workload Manager Release Notes What manuals are available 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 CPUs. 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 (5187-2216) 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.
