######################################################################## # # # COMPONENT_NAME: MQSeries # # # # FILE: README.TXT # # # # Program Number 5765-B75 # # (C) COPYRIGHT International Business Machines Corp. 1995, 2003 # # All Rights Reserved # # Licensed Material - Property of IBM # # # # US Government Users Restricted Rights - Use, duplication or # # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # # # ######################################################################## Readme for IBM MQSeries for Sun Solaris V5.2 Download PTF U482979 ============================================ This readme file contains information you need for updating IBM MQSeries for Sun Solaris V5.2 (server and/or client), as well as a summary of the contents of the latest fix pack and any earlier fix packs. This is the sixth fix pack, corresponding to PTF U482979, and it is numbered 06. It will bring your MQSeries for Sun Solaris Version 5.2 installation up to service level U482979 (CSD06). This fix pack can be used to update the MQSeries for Sun Solaris V5.2 server. This fix pack can be used to update the MQSeries for Sun Solaris V5.2 client if you installed the client in one of the following ways: a) From the MQSeries for Sun Solaris V5.2 CD-ROM b) From the MQSeries V5.2 client CD-ROM c) By downloading the SupportPac MACO from the web and installing it. How to Download this Corrective Service ======================================= The corrective service files in this directory are of the form: U4xxxxx.tar.Z This means that they have been processed by the tar program and then compressed. The latest PTF (U482979) supersedes all previous PTFs for MQSeries for Sun Solaris V5.2 and it contains updates to the following components of MQSeries for Sun Solaris: runtime MQSeries Runtime support for external applications server MQSeries server support for client connections dce_server MQSeries support for DCE in server net_gtspl MQSeries Internet Gateway Samples sol_client MQSeries client libraries for Sun Solaris base MQSeries Base Kit for Client and Server samples MQSeries Samples De_DE MQSeries Messages - German Es_ES MQSeries Messages - Spanish Fr_FR MQSeries Messages - French It_IT MQSeries Messages - Italian Ja_JP MQSeries Messages - Japanese Ko_KR MQSeries Messages - Korean Pt_BR MQSeries Messages - Portuguese-Brazilian Zh_CN MQSeries Messages - Simplified Chinese Zh_TW MQSeries Messages - Traditional Chinese To use the latest PTF file, perform the following steps: 1) download the file to your local system in binary mode 2) uncompress U482979.tar.Z 3) tar -xvf U482979.tar PTF U482979 ----------- After installation of this fix pack, there is a MEMO.PTF file that contains information relating to this fix pack. You are advised to read this file which contains: o installation instructions for applying maintenance o a summary of the current and superseded service levels o Special Information which may be mandatory for complete resolution of one or more of the APAR fixes shipped by this fix pack. This fix pack is applicable to ALL releases of product 5765-B75-00, IBM MQSeries for Sun Solaris Version 5.2, namely the English version or any of the National Language versions. Installation and Maintenance Information ======================================== A) Applying Maintenance to MQSeries for Sun Solaris V5.2 ----------------------------------------------------- These steps will ensure that you are left with files that are installable using the normal install method for your platform. +--- PRECAUTIONS ---------------------------------------+ | | | Do not have any queue managers operating during | | installation of maintenance on MQSeries for Sun | | Solaris V5.2. | | | | Remove any existing MQSeries shared memory and/or | | semaphores before applying or removing maintenance | | updates to MQSeries for Sun Solaris V5.2. | | | +-------------------------------------------------------+ | | | To end all running queue managers: | | | | 1. End the queue manager by issuing the command: | | | | endmqm -i QMgrName | | | | 2. Check that the queue manager has ended. | | | | Use the command: | | | | endmqm -w QMgrName | | | | The message returning should show that the queue | | manager is not available. | | | | Alternatively, use the command: | | | | ps -ef | grep mq | | | | where | is the pipe symbol. Check that there are | | no processes listed that are running command | | lines commencing "amq" or "runmq". Ignore any | | that start with "amqi". | | | | 3. Issue the IPCS -A command to identify any shared | | memory segments or semaphore sets that were | | created by MQSeries. Remove these using the | | IPCRM command. | | | +-------------------------------------------------------+ B) SPACE REQUIREMENTS ------------------ The installation process for this fix pack requires 24MB of disk space for installation. In addition, the installation process requires an additional 24MB of disk space to save the previous level. This allows a fix pack to be removed, and the previous level to be automatically restored. If disk space is limited, the backup can be suppressed by creating an empty flag file called MQPTF_NOSAVE in the directory "/var/sadm/pkg". Note that if this option is used, the previous level will not be restored if a fix pack is removed. The only way to restore a previous level in this instance is to reinstall the product and then to reapply a previous fix pack image. C) APPLYING THE MAINTENANCE INFORMATION ------------------------------------ 1. Change to the directory where the fix pack is saved. 2. Install the software by entering and executing the following command: pkgadd -d ./mqm-U482979.image Note: this filename may be slightly different. For further information on using PKGADD to install software packages, see the Solaris documentation. D) RESTORING THE PREVIOUS SERVICE LEVEL ------------------------------------ To restore the previous service level: 1. Log in as root, or use the command su. 2. Use the PKGRM command to remove the latest fix pack from the system. For example, to remove PTF "U482979" issue the following command: pkgrm mqm-upd06 Error messages of the form "" can be ignored. Details of the PKGRM command can be found in the Solaris documentation, or by using the MAN PKGRM command. 3. If you have installed an MQI client, and the client was updated after installing the fix pack that is being removed, then you MUST specifically update your MQI client installation again, after the fix pack has been removed.