========================================================================= Readme file for Workload Partitions Agent installer component Version 2.3.1.1 Manager Feature Software Installable: com.ibm.director.wparmgt.agent.installer.feature_2.3.1.1-Dir IBM Corp. 10 October 2012 ========================================================================= CONTENTS 1.0 Overview 2.0 Prerequisites and co-requisites 3.0 Installation Information 3.1 Prior to installation 3.2 Install 4.0 Uninstalling 5.0 List of changes included 5.1 Authorized Program Analysis Reports 5.2 Product Enhancements 5.3 Troubleshooting and known issues 6.0 Copyright and trademark information 1.0 Overview This is an update for IBM Workload Partitions agent installer. The Workload Partitions agent is a key component of the IBM Workload Partitions Manager for AIX (WPAR Manager) which is a licensed advanced manager for IBM Director that is designed to manage AIX Version 6.1 and 7.1 Workload Partitions (WPAR) across multiple systems and to provide enablement for Live Application Mobility. The WPAR Manager allows an administrator to create, clone, and remove WPAR definitions, or start and stop WPARs from an easy to use management interface. WPAR Manager includes the checkpoint/restart enablement needed to relocate a WPAR from one system to another using Live Application Mobility. Live Application Mobility can be used to relocate a WPAR without restarting the application or causing significant impact to the application users. 2.0 Prerequisites and co-requisites It is required to install the com.ibm.director.wparmgt.mgr.feature_2.3.1.1 update on the Director server managing the system where this Workload Partitions Agent update will be installed. Furthermore, after upgrading IBM Workload Partitions Manager to version 2.3.1.1, it is required that you also upgrade all your IBM Workload Partitions agents to version 2.3.1.1 as well. 3.0 Installation information 3.1 Prior to installation ================= !!! IMPORTANT !!! ================= 1) You *MUST* ensure the /var filesystem of the managed system where you are applying the update has at least 200 MB of free space to accommodate the binaries being deployed. To grow your /var filesystem by 200 MB, execute the following command as root: chfs -a size=+200M /var 2) If you downloaded from ibm.com, you must import the update before you can install it using Update Manager. If you acquired the files using Update Manager, the update has already been imported. To import the update from the command line, use the following command: smcli importupd -vr To import the update from the IBM Systems Director Web interface, perform these steps: 1. In navigation area, expand Release Management and click Updates. The Update Summary page displays. 2. In the Common Tasks section, click Import updates. The Import Updates page is displayed. 3. Type the directory of the update files on the management server in the Path field. All updates in the specified directory will be copied to the update library. You cannot select specific updates from this directory. 4. Click OK. The scheduler is displayed. Choose to run the task now or schedule it to run in the future. 3.2 Install To install the update from the command-line to a managed system running the IBM Systems Director 6.3 Common Agent, use the following command: smcli installupd -v [-n | -N ] -u com.ibm.director.wparmgt.agent.installer.feature_2.3.1.1-Dir63 Issue appropriate command-line equivalents if your managed system is running the IBM Systems Director 6.1 or 6.2 Common Agent and not the IBM Systems Director 6.3 Common Agent. To install the update from the IBM Systems Director Web interface, perform these steps: 1. In navigation area, expand Release Management and click Updates. The Update Summary page displays. 2. In the Updates section, click Show all known updates. The list of all updates known to IBM Systems Director will be shown. 4. Select the update called WPAR Manager Agent Installer Feature and click the Install... button. 5. Follow the steps in the Install Wizard to install the update, selecting all the managed systems where the IBM Workload Partitions agent update needs to be installed. 3.3 Perform the necessary tasks after install You must first collect Software inventory on the managed system where the update was installed, and then also collect Extended WPAR inventory. 4.0 Uninstalling Update Manager does not support uninstallation of com.ibm.director.wparmgt.agent.installer.feature_2.3.1.1. Contact IBM Systems support if you need to uninstall this update: www.ibm.com/systems/support/ 5.0 List of changes included 5.1 Authorized Program Analysis Reports The following APARs are incorporated into Workload partition manager 2.3.1.1 IV29189 Missing imported package com.ibm.usmi.kernel.events 5.2 Product enhancements None 5.3 Troubleshooting and known issues 1) You must ensure the managed system has at least 200 MB free in the /var filesystem. If you do not, and the update fails, simply enlarge the /var filesystem as described in Section 3.1 and retry the update. 2) When updating an AIX managed system running a version older than AIX 6100 TL6, in some instances the agent features may come up in disabled state, preventing them from being detected when software inventory is collected. If you encounter this issue, simply run the following two commands as root on the affected AIX managed system: installp -bug wparmgt.agent.rte installp -XYgbad /opt/ibm/director/agent/tmp/wpar_manager_agent wparmgt.agent.rte and then collect Software Inventory and Extended WPAR Inventory. 6.0 Copyright and trademark information www.ibm.com/legal/copytrade.shtml The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: IBM Other company, product, or service names may be trademarks or service marks of others. Notices INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version. Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: * the Excluded Components are provided on an "AS IS" basis * IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * IBM will not be liable to you or identify you for any claims related to the Excluded Components * IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components.