######################################################################## # # # COMPONENT_NAME: MQSeries # # # # FILE: README.TXT # # # # Program Number 5639-I84 # # (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 Linux Version 5.2 Download PTF U486932 ============================================= This readme file contains information you need for updating IBM MQSeries for Linux Version 5.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 eighth fix pack, corresponding to PTF U486932, and it is numbered 08. It will bring your MQSeries for Linux Version 5.2 installation up to service level 5.2.0.8 (PTF U486932 - fix pack CSD08). This fix pack can be used to update the MQSeries for Linux V5.2 server. This fix pack can be used to update the MQSeries for Linux V5.2 client if you installed the client in one of the following ways: a) From the MQSeries for Linux V5.2 CD-ROM b) From the MQSeries V5.2 client CD-ROM c) By downloading the SupportPac MACI 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 (U486932) supersedes all previous PTFs for MQSeries for Linux V5.2 and it contains updates to the following components of MQSeries for Linux: MQSeriesRuntime-5.2.0-7.i386.rpm MQSeries Runtime support for external applications MQSeriesSDK-5.2.0-7.i386.rpm MQSeries base kit for client and server MQSeriesServer-5.2.0-7.i386.rpm MQSeries server support for client connections MQSeriesClient-5.2.0-7.i386.rpm MQSeries client libraries for Linux MQSeriesSamples-5.2.0-7.i386.rpm MQSeries Samples MQSeriesMsg_de-5.2.0-7.i386.rpm MQSeries Messages - English MQSeriesMsg_es-5.2.0-7.i386.rpm MQSeries Messages - Spanish MQSeriesMsg_fr-5.2.0-7.i386.rpm MQSeries Messages - French MQSeriesMsg_it-5.2.0-7.i386.rpm MQSeries Messages - Italian MQSeriesMsg_ja-5.2.0-7.i386.rpm MQSeries Messages - Japanese MQSeriesMsg_ko-5.2.0-7.i386.rpm MQSeries Messages - Korean MQSeriesMsg_pt-5.2.0-7.i386.rpm MQSeries Messages - Portuguese-Brazilian MQSeriesMsg_Zh_CN-5.2.0-7.i386.rpm MQSeries Messages - Simplified Chinese MQSeriesMsg_Zh_TW-5.2.0-7.i386.rpm MQSeries Messages - Traditional Chinese To use the latest fix pack files, perform the following steps: 1) download the file to your local system in binary mode 2) gunzip -fv U486932.tar.gz. 3) tar -xvf U486932.tar PTF U486932 ----------- 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 5639-I84-00, IBM MQSeries for Linux Version 5.2, namely the English version or any of the National Language versions. Installation and Maintenance Information ======================================== A) Applying Maintenance to MQSeries for Linux 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 Linux | | V5.2. | | | | Remove any existing MQSeries shared memory and/or | | semaphores before applying or removing maintenance | | updates to MQSeries for Linux 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. | | | +-------------------------------------------------------+ B) SPACE REQUIREMENTS ------------------ This fix pack requires 7MB hard disk space for installation. In addition, the installation process requires up to an identical amount of 7MB disk space to save the previous level. Files updated by a fix pack installation are kept in a backup directory. This allows a fix pack to be removed and the previous level to be automatically restored. Previous levels are stored in the directory /opt/mqm/ptf_backup. Do not delete or move these directories and files. C) APPLYING THE MAINTENANCE INFORMATION ------------------------------------ To apply the maintenance information in the fix pack: 1. Change to the directory where the fix pack components are saved. 2. Install the software in the following sequence: MQSeriesRuntime-5.2.0-8.i386.rpm MQSeriesSDK-5.2.0-8.i386.rpm MQSeriesServer-5.2.0-8.i386.rpm MQSeriesClient-5.2.0-8.i386.rpm MQSeriesSamples-5.2.0-8.i386.rpm 3. Install each fix pack component by entering and executing the following commands: rpm -i --replacefiles MQSeriesRuntime-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesSDK-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesServer-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesClient-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesSamples-5.2.0-8.i386.rpm 4. Install any required MQSeries message files: MQSeriesMsg_de-5.2.0-8.i386.rpm MQSeriesMsg_es-5.2.0-8.i386.rpm MQSeriesMsg_fr-5.2.0-8.i386.rpm MQSeriesMsg_it-5.2.0-8.i386.rpm MQSeriesMsg_ja-5.2.0-8.i386.rpm MQSeriesMsg_ko-5.2.0-8.i386.rpm MQSeriesMsg_pt-5.2.0-8.i386.rpm MQSeriesMsg_Zh_CN-5.2.0-8.i386.rpm MQSeriesMsg_Zh_TW-5.2.0-8.i386.rpm 5. Install each required MQSeries message file by entering and executing the following commands: rpm -i --replacefiles MQSeriesMsg_de-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_es-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_fr-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_it-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_ja-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_ko-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_pt-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_Zh_CN-5.2.0-8.i386.rpm rpm -i --replacefiles MQSeriesMsg_Zh_TW-5.2.0-8.i386.rpm For further information on using rpm to install software packages, see your Linux documentation. D) RESTORING THE PREVIOUS SERVICE LEVEL ------------------------------------ To restore the previous service level: 1.Log in as root or use the command su. 2.Enter the rpm command to remove the latest fix pack from your system.(For example, to remove a service update, enter the command: rpm -e MQSeriesServer-5.2.0-8 Details of the rpm command can be found in your Linux documentation, or by entering the man rpm command.