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 CSD consists of 2 related PTFs: U471444 and U473018 This set of PTFs forms a complete replacement for any previous CSD that you have applied to your MQSeries for HP-UX V5.1 (HP-UX Version 11) installation. The latest PTFs (U471444 and U473018) supersede all previous PTFs for MQSeries for HP-UX V5.1 (HP-UX Version 11) and they contain updates to the following components of MQSeries for HP-UX: A) PTF U471444 MQM-RUNTIME MQSeries Runtime support for external applications MQM-SERVER MQSeries server support for client connections MQM-CL-HPUX MQSeries client for HP-UX MQM-SAMPLES MQSeries sample application programs MQM-BASE MQSeries Base Kit for Client and Server MQM-MC-JABASE MQSeries Java Base MQM-MC-JABIND MQSeries Java Bindings MQM-MC-JACLNT MQSeries Java Client MQM-MC-CHINES MQSeries Messages - Simplified Chinese MQM-MC-CHINET MQSeries Messages - Traditional Chinese MQM-MC-FRENCH MQSeries Messages - French MQM-MC-GERMAN MQSeries Messages - German MQM-MC-ITALIAN MQSeries Messages - Italian MQM-MC-JAPAN MQSeries Messages - Japanese MQM-MC-KOREAN MQSeries Messages - Korean MQM-MC-PORT MQSeries Messages - Portuguese-Brazilian MQM-MC-SPANISH MQSeries Messages - Spanish B) PTF U473018 MQM-DCE MQSeries server support for DCE All installations require PTF U471444 but PTF U473018 is only required by installations that use DCE. In addition there is an additional APAR fix provided which may also be downloaded and applied on any installation at service level U471444 or U473018 (CSD06). This optional APAR fix is IY17668. The files to be downloaded and the instructions for installing for this APAR fix are specified below. It is recommended that you apply this APAR fix if you connect your V5.1 queue manager to an MQSeries V2 queue manager or you use a zero heartbeat interval. PTFs U471444 and U473018 ------------------------ The PTFs have been processed by the tar program and then compressed. To prepare for installation: 1) download the file U471444.tar.Z to your local drive in binary format 2) uncompress the file: uncompress U471444.tar.Z 3) run the tar program against the uncompressed file: tar -xvf U471444.tar 4) this will create the 2 separate PTFs in this CSD and you should select and install the subset of those PTFs that you need for your installation. APAR IY17668 ------------ After applying V5.1 CSD06, installations that connected their V5.1 queue managers to MQSeries V2 queue managers and installations that specified a zero heartbeat may have encountered channel time-out conditions that did not occur prior to applying the CSD. The APAR fix (IY17668.tar.Z) for this problem consists of a single compressed tar file which contains replacements for the following libraries in MQSeries for HP-UX V5.1: All installations ----------------- libmqic.sl libmqic_r.sl libmqicb.sl libmqicb_r.sl libmqmr.sl libmqmr_r.sl DCE installations only ---------------------- libmqic_d.sl libmqicb_d.sl libmqmr_d.sl PTF U471444 is a pre-requisite for this APAR fix. PTF U473018 is a pre-requisite for this APAR fix for DCE installations. To apply the fix :- (1) Uncompress and tar the compressed tar file IY17668.tar.Z into a temporary directory (2) Do not have queue managers running while you are applying or removing maintenance updates to MQSeries for HP-UX V5.1 (3) Remove any existing MQSeries shared memory and/or semaphores before applying or removing maintenance updates to MQSeries for HP-UX V5.1 (4) Take backup copies of the following libraries on your system: libmqic.sl libmqic_r.sl libmqicb.sl libmqicb_r.sl libmqmr.sl libmqmr_r.sl (5) Copy over the new version of these libraries to your system, into /opt/mqm/lib, after making secure backup copies of the original libraries. (6) DCE installations should also take backup copies of the following libraries on the system: libmqic_d.sl libmqicb_d.sl libmqmr_d.sl (7) DCE installations should also copy over the new version of these libraries to the system, into /opt/mqm/lib, after making secure backup copies of the original libraries. (8) Ensure that the owner and group of the libraries is mqm/mqm using the command chown mqm:mqm .. (9) Ensure that the permissions of the libraries is -r-xr-xr-x using the command chmod 555 .. (10) Restart the queue managers. Applying Maintenance for MQSeries for HP-UX V5.1 ------------------------------------------------ Now you will need to use swinstall to install the resulting output files, which are in the form: hp-U471444.v11 hp-U473018.v11DCE +--- PRECAUTIONS ---------------------------------------+ | | | Do not have any queue managers operating during | | installation of maintenance on MQSeries for HP-UX | | V5.1 (Version 11). | | | | Remove any existing MQSeries shared memory and/or | | semaphores before applying or removing maintenance | | updates to MQSeries for HP-UX V5.1 (Version 11). | | | +-------------------------------------------------------+ | | | 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. | | | +-------------------------------------------------------+ SPACE REQUIREMENTS ------------------ The installation process for PTF U471444 requires 21MB of disk space for installation. In addition, the installation process requires an additional 21MB of disk space to save the previous level. The installation process for PTF U473018 requires 11MB of disk space for installation. In addition, the installation process requires an additional 11MB of disk space to save the previous level. This allows the PTF(s) 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/adm/sw/patch". Note that if this option is used, the previous level will not be restored if a PTF is removed. The only way to restore a previous level in this instance is to reinstall the product and then to reapply a previous PTF image. APPLYING THE MAINTENANCE INFORMATION ------------------------------------ To apply the maintenance information: 1. Log in as root, or use the command su. 2. Use the SWINSTALL command to install the patch from the supplied medium. Details of the SWINSTALL command can be found in the HP-UX Administration Guide or by using the MAN SWINSTALL command. 3. If you have installed an MQI client from your MQSeries for HP-UX installation, and if one or more of these client components have been modified by installing an update, then you MUST specifically update your MQI client installation. RESTORING THE PREVIOUS SERVICE LEVEL ------------------------------------ To restore the previous service level: 1. Log in as root, or use the command su. 2. Use the SWREMOVE command to remove the patch from the system. For example, to remove patch "U471444" issue the following command: swremove MQSERIES.U471444 Details of the SWREMOVE command can be found in the HP-UX Administration Guide or by using the MAN SWREMOVE command. 3. If you have installed an MQI client, and the client was updated after installing the PTF which is being removed, then you MUST specifically update your MQI client installation again, after the PTF has been removed.