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 (U469659) supersedes all previous PTFs for MQSeries for HP-UX V5.0 and it contains updates to the following components of MQSeries for HP-UX: MQM-RUNTIME MQSeries Runtime support for external applications MQM-SERVER MQSeries server support for client connections MQM-CL-HPUX MQSeries client for HP-UX and client for Java MQM-MQLINK MQSeries link to Lotus Notes MQM-SAMPLES MQSeries sample application programs MQM-MC-JAPAN MQSeries Messages - Japanese MQM-BASE MQSeries Base Kit for Client and Server MQM-MC-JACLNT MQSeries Client for Java - Runtime 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-KOREAN MQSeries Messages - Korean MQM-MC-PORT MQSeries Messages - Portuguese-Brazilian MQM-MC-SPANISH MQSeries Messages - Spanish MQM-MC-JABIND MQSeries Java Bindings MQM-MC-JABASE MQSeries Java Base In addition there is an additional APAR fix provided which may also be downloaded and applied on any installation at service level U469659 (CSD #8). 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.0 queue manager to an MQSeries V2 queue manager or you use a zero heartbeat interval. PTF U469659 ----------- To use the latest PTF file, perform the following steps: 1) download the file to directory /var/spool/sw in binary mode 2) uncompress U469659.tar.Z 3) tar -xvf U469659.tar APAR IY17668 ------------ After applying V5.0 CSD08, installations that connected their V5.0 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.0: libmqic.sl libmqic_r.sl libmqicb.sl libmqicb_r.sl libmqmr.sl libmqmr_r.sl PTF U469659 is a pre-requisite for this APAR fix. 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.0 (3) Remove any existing MQSeries shared memory and/or semaphores before applying or removing maintenance updates to MQSeries for HP-UX V5.0 (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) Ensure that the owner and group of the libraries is mqm/mqm using the command chown mqm:mqm .. (7) Ensure that the permissions of the libraries is -r-xr-xr-x using the command chmod 555 .. (8) Restart the queue managers. Applying Maintenance for MQSeries for HP-UX V5.0 ------------------------------------------------ Now you will need to use swinstall to install the resulting output file, which is in the form: hp-U469659.v10 +--- ATTENTION --------------------------------------------------+ | | | Do not have any queue managers operating during installation | | of maintenance on MQSeries for HP-UX V5.0. | | | | Remove any existing MQSeries shared memory and/or semaphores | | before applying or removing maintenance updates to MQSeries | | for HP-UX. | | | +----------------------------------------------------------------+ | | | 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 -p QMgrName | | | | and check that the message queue manager is not running. | | | | Alternatively, use the command: | | | | ps -ef | grep amq | | | | where | is the pipe symbol. Check that there are no | | amq***** files listed, ignoring any commencing with amqi. | | | +----------------------------------------------------------------+ SPACE REQUIREMENTS ------------------ A PTF requires hard disk space for installation. In addition, the installation process requires an identical amount of disk space to save the previous level. This PTF requires approximately 22MB of disk space for installation and another 22MB of disk space to save the previous level. This allows a PTF 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. The easiest way to do this is to use the GUI front-end to swinstall, and in the box which says 'source depot path', put the path and file name: /var/spool/sw/hp-U469659.v10 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 "U469659" issue the following command: swremove MQSERIES.U469659 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.