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 (U474388) 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-1.i386.rpm MQSeries Runtime support for external applications MQSeriesSDK-5.2.0-1.i386.rpm MQSeries base kit for client and server MQSeriesServer-5.2.0-1.i386.rpm MQSeries server support for client connections MQSeriesClient-5.2.0-1.i386.rpm MQSeries client libraries for Linux To use the latest PTF file, perform the following steps: 1) download the file to your local system in binary mode 2) gunzip -fv U474388.tar.gz. 3) tar -xvf U474388.tar >> Note: >> ===== >> >> This PTF has been refreshed on 6th June because the original >> packaging for the ftp site omitted the strmqm executable. >> >> If you installed the earlier version of this PTF then you >> can either remove the original PTF and reinstall the new PTF >> or alternatively you can download the additional executable >> from the file U474388.strmqm.tar.Z and install the >> library as follows: >> (1) Uncompress and tar the compressed tar file U474388.strmqm.tar.Z into a temporary directory (2) Do not have queue managers running while you are applying or removing maintenance updates to MQSeries for Linux V5.2 (3) Remove any existing MQSeries shared memory and/or semaphores before applying or removing maintenance updates to MQSeries for Linux V5.2 (4) Take a backup copy of the strmqm excutable on your system. (5) Copy over the new version of this executable to your system, into /opt/mqm/bin, after making a secure backup copy of the original executable. (6) Ensure that the owner and group of the executable is mqm/mqm using the command chown mqm:mqm .. (7) Ensure that the permissions of the executable is -r-xr-xr-x using the command chmod 555 .. (8) Restart the queue managers. PTF U474388 ----------- After installation of this CSD, there is a MEMO.PTF file that contains information relating to this PTF. 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 PTF. This PTF 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 ---------------------------------------- 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. | | | +-------------------------------------------------------+ SPACE REQUIREMENTS ------------------ This PTF requires 4MB hard disk space for installation. In addition, the installation process requires up to an identical amount of 4MB disk space to save the previous level. Files updated by a PTF installation are kept in a backup directory. This allows a PTF 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. APPLYING THE MAINTENANCE INFORMATION ------------------------------------ To apply the maintenance information in the PTF: 1. Change to the directory where the CSD is saved. 2. Install the software in the following sequence: MQSeriesRuntime-5.2.0-1.i386.rpm MQSeriesSDK-5.2.0-1.i386.rpm MQSeriesServer-5.2.0-1.i386.rpm MQSeriesClient-5.2.0-1.i386.rpm 3. Install each PTF by entering and executing the following commands: rpm -i --replacefiles MQSeriesRuntime-5.2.0-1.i386.rpm rpm -i --replacefiles MQSeriesSDK-5.2.0-1.i386.rpm rpm -i --replacefiles MQSeriesServer-5.2.0-1.i386.rpm rpm -i --replacefiles MQSeriesClient-5.2.0-1.i386.rpm For further information on using rpm to install software packages, see your Linux documentation. 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 PTF from your system.(For example, to remove a service update, enter the command: rpm -e MQSeriesServer-5.2.0-2 Details of the rpm command can be found in your Linux documentation, or by entering the man rpm command.