Patch-ID# 116392-12 NOTE: *********************************************************************** READ THE TERMS OF THE AGREEMENT ("AGREEMENT") IN THE LEGAL_LICENSE.TXT FILE CAREFULLY BEFORE USING THIS SOFTWARE. BY USING THE SOFTWARE, YOU AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS, PROMPTLY DESTROY THE UNUSED SOFTWARE. *********************************************************************** Keywords: sunwscmqs Synopsis: Sun Cluster 3.0/3.1 HA-WMQS patch Date: Mar/15/2006 Install Requirements: See Special Install Instructions Solaris Release: 8 9 10 SunOS Release: 5.8 5.9 5.10 Unbundled Product: Sun Cluster Unbundled Release: 3.1/3.0 Xref: Topic: Sun Cluster 3.0/3.1 HA-WMQS patch Relevant Architectures: sparc BugId's fixed with this patch: 4886209 4888567 4888572 4964269 4964275 4964277 4979428 4992038 4992041 5040493 6202395 6202554 6203135 6216284 6218994 6261251 6290351 6322458 6333590 6337604 6337608 6337622 6339443 6357110 6374255 Changes incorporated in this version: 6374255 6339443 Patches accumulated and obsoleted by this patch: Patches which conflict with this patch: Patches required with this patch: Obsoleted by: Files included with this patch: /opt/SUNWscmqs/bin/control_wmqs /opt/SUNWscmqs/bin/functions /opt/SUNWscmqs/chi/bin/functions /opt/SUNWscmqs/chi/bin/start-chi /opt/SUNWscmqs/chi/bin/stop-chi /opt/SUNWscmqs/chi/bin/test-chi /opt/SUNWscmqs/chi/etc/config /opt/SUNWscmqs/chi/util/chi_config /opt/SUNWscmqs/chi/util/chi_register /opt/SUNWscmqs/chi/util/chi_smf_register /opt/SUNWscmqs/chi/util/chi_smf_remove /opt/SUNWscmqs/csv/bin/functions /opt/SUNWscmqs/csv/bin/start-csv /opt/SUNWscmqs/csv/bin/stop-csv /opt/SUNWscmqs/csv/bin/test-csv /opt/SUNWscmqs/csv/etc/config /opt/SUNWscmqs/csv/util/csv_config /opt/SUNWscmqs/csv/util/csv_register /opt/SUNWscmqs/csv/util/csv_smf_register /opt/SUNWscmqs/csv/util/csv_smf_remove /opt/SUNWscmqs/etc/SUNW.mqs /opt/SUNWscmqs/lsr/bin/functions /opt/SUNWscmqs/lsr/bin/start-lsr /opt/SUNWscmqs/lsr/bin/stop-lsr /opt/SUNWscmqs/lsr/bin/test-lsr /opt/SUNWscmqs/lsr/etc/config /opt/SUNWscmqs/lsr/util/lsr_config /opt/SUNWscmqs/lsr/util/lsr_register /opt/SUNWscmqs/lsr/util/lsr_smf_register /opt/SUNWscmqs/lsr/util/lsr_smf_remove /opt/SUNWscmqs/mgr/bin/check-start /opt/SUNWscmqs/mgr/bin/create_tdq /opt/SUNWscmqs/mgr/bin/functions /opt/SUNWscmqs/mgr/bin/start-qmgr /opt/SUNWscmqs/mgr/bin/stop-qmgr /opt/SUNWscmqs/mgr/bin/test-qmgr /opt/SUNWscmqs/mgr/etc/config /opt/SUNWscmqs/mgr/util/mgr_config /opt/SUNWscmqs/mgr/util/mgr_register /opt/SUNWscmqs/mgr/util/mgr_smf_register /opt/SUNWscmqs/mgr/util/mgr_smf_remove /opt/SUNWscmqs/trm/bin/functions /opt/SUNWscmqs/trm/bin/start-trm /opt/SUNWscmqs/trm/bin/stop-trm /opt/SUNWscmqs/trm/bin/test-trm /opt/SUNWscmqs/trm/etc/config /opt/SUNWscmqs/trm/etc/sample_trm_queues_file /opt/SUNWscmqs/trm/util/trm_config /opt/SUNWscmqs/trm/util/trm_register /opt/SUNWscmqs/trm/util/trm_smf_register /opt/SUNWscmqs/trm/util/trm_smf_remove Problem Description: 6339443 WebSphere MQ support for Solaris 10 non-global zones 6374255 runmqlsr - AMQ7024: Arguments supplied to a command are not valid. (from 116392-11) 6357110 WebSphere MQ /opt/SUNWscmqs/bin/control_wmqs[75]: /opt/mqm/bin/dspmqver: not found (from 116392-10) 6337622 WebSphere MQ Listener needs an optional dependency on the queue manager 6337608 WebSphere MQ v6 support 6337604 WebSphere MQ support for Solaris 10 6333590 WebSphere MQ agent has issues with similar queue names 6322458 Sun Cluster 3.0/3.1 HA-WMQS patch introduced incorrect function (from 116392-09) 6290351 The functions scripts for the "chi", "csv", "lsr" and "trm" deliver wrong return codes (from 116392-08) 6261251 check_qmgr - (from 116392-07) 6218994 SC3.1 WebSphere MQ Agent - Dummy RTR file requires #% SERVICE_NAME entry for package upgrade 6216284 SC3.1 WebSphere MQ Agent - suppress informational channel FDC files when running endmqm (from 116392-06) 6203135 SC3.1 WebSphere MQ Agent - The stop command failed to stop the application 6202554 SC3.1 WebSphere MQ Agent - Registering the resource using mqr_register assumes values are set 6202395 SC3.1 WebSphere MQ Agent - long pauses or occasional probe timeouts (from 116392-05) 5040493 SC3.1 WebSphere MQ Agent - Bug with cleanup IPC entries (from 116392-04) 4992038 SC3.1 WebSphere MQ agent - Support for XAResourceManager 4992041 SC3.1 WebSphere MQ agent - Allow user defined userid for mq commands (from 116392-03) Revision skipped. (from 116392-02) 4964269 SC3.1 WebSphere MQ agent - Support for S9RM when issuing su 4964275 SC3.1 WebSphere MQ Agent - Cleanup IPC entries for MQ 4964277 SC3.1 WebSphere MQ agent - Tolerate manual start of application 4979428 Agent requires a dummy RTR file (from 116392-01) 4888572 TRM requires support for multiple process trees 4888567 Check Qmgr dependency not robust enough 4886209 Queue manager probe inefficient Patch Installation Instructions: -------------------------------- There are three (3) possible procedures for installing patches on Sun Cluster 3.0 and 3.1. The proper method to use and any additional instructions, for this patch are specified below in the "Special Install Instructions" section. Refer to the chapter entitled "Patching Sun Cluster Software and Firmware" in the Sun Cluster 3.0/3.1 System Administration Guide for a description of the different install processes and instructions on how to install Sun Cluster 3.x patches. For Solaris 8 release, refer to the man pages for instructions on using 'patchadd' and 'patchrm' scripts provided with Solaris. Special Install Instructions: ----------------------------- NOTE 1: If this patch is being applied to a Solaris 10 system, the patch must be applied to the global zone only by using the -G option for patchadd, e.g. # patchadd -G 116392-12 To remove the patch from a Solaris 10 system, you must also use the -G option for patchrm, e.g. # patchrm -G 116392-12 NOTE 2: When applying this patch, the files listed within the earlier section will get overwritten. If you are applying this patch to an existing deployment of WebSphere MQ within Sun Cluster, you will have previously amended the following file: /opt/SUNWscmqs/mgr/util/mgr_config and possibly these other files, if you have deployed these components: /opt/SUNWscmqs/chi/util/chi_config /opt/SUNWscmqs/csv/util/csv_config /opt/SUNWscmqs/lsr/util/lsr_config /opt/SUNWscmqs/trm/util/trm_config If you want to keep the configuration information within these files then save them somewhere else before applying this patch. If you are reading this after applying the patch, then remove this patch and then save your /opt/SUNWscmqs//util/_config file as required. After doing this, you can then re-apply this patch. NOTE 3: Info on BugID 6339443 WebSphere MQ support for Solaris 10 non-global zones Included within this patch is support for WebSphere MQ v5.3 and/or v6 running within a non-global (failover) zone, using the Sun Cluster Data Service for Solaris Containers. For additional information on configuring and registering WebSphere MQ within a non-global (failover) zone, refer to the appropriate config file, i.e. /opt/SUNWscmqs/mgr/util/mgr_config. NOTE 4: Info on BugID 6337608 WebSphere MQ v6 support Included within this patch is support for WebSphere MQ v6. With WebSphere MQ v6, some start commands have additional parameters. If you accept the default values for these parameters, then follow the actions below in "Note 1: No changes required." The commands with additional parameters are, Start queue manager (strmqm). This command now includes the "-ns" option to prevent several processes from automatically starting when the queue manager starts. By default the "-ns" option is not specified. If the "-ns" option needs to be specified, you must re-register the SC resource for the queue manager and specify SERVICES=NO within the /opt/SUNWscmqs/mgr/mgr_config file. Start listener (runmqlsr). This command now includes the "-i" option to specify the IP address for the listener. By default the "-i" option is not specified and the listener will monitor all configured IPv4 and IPv6 stacks. If the "-i" option needs to be specified, you must re-register the SC resource for the listener and supply the IP address to the IPADDR= parameter within the /opt/SUNWscmqs/lsr/lsr_config file. To re-register a resource, follow the steps below in "Note 2: Changes Required." For additional information on the strmqm and runmqlsr commands, refer to the strmqm(1) and runmqlsr(1) man pages respectively. NOTE 5: Info on BugIDs 4992038 & 4992041 Included within this patch are some new enhancements that may require the resource to be removed and re-registered. The following parameters have been added that either have default values or null values. If you need to change either the default values or include values then you must remove and re-register the resource. After the patch is installed, these parameters can be found in /opt/SUNWscmqs//util/_config where is a three-character abbreviation for the various WebSphere MQ components. Only USERID=mqm is included with the chi, csv, lsr and trm components. The mgr_config contains all the parameters. If you need to change the USERID= parameter, you should change all the _config files for those components you use, then run the _register script as shown in Note 2 below. New parameters with default and null values. CLEANUP=YES USERID=mqm DB2INSTANCE= ORACLE_HOME= ORACLE_SID= START_CMD= STOP_CMD= The parameters above are described below, CLEANUP=YES Deletes unused shared memory segments created by mqm USERID=mqm Userid mqm will be used to issue mq commands DB2INSTANCE= DB2 Instance name for XAResourceManager ORACLE_HOME= Oracle home directory for XAResourcemanager ORACLE_SID= Oracle SID for XaResourceManager START_CMD= / of renamed strmqm program STOP_CMD= / of renamed endmqm program XAResourceManager Processing allows WebSphere MQ to manage global units of work with DB2, Oracle and/or Sybase. If a WebSphere MQ queue manager's qmgr/log files are deployed on a global file system, renaming the strmqm/endmqm programs prevents the queue manager from being manually started on another node. Instead, the cluster framework will manage the startup. However, please refer to the Sun Cluster for WebSphere MQ for Solaris OS documentation on how to do this. NOTE 6: More info on changes required, or not required, as follow-on instructions to some of the above documented BugIDs. Note 1: No changes required --------------------------- If you have no need to change either the default values or include values to the parameters above, then simply apply this patch and follow "How to Apply a Non-Rebooting Sun Cluster Patch" in the Sun Cluster 3.0/3.1 System Administration Guide. Note 2: Changes required ------------------------ If you need to change either the default values or include values to the parameters above, then you must remove and re-register the resource, as follows. 1. Save the WebSphere MQ resource definitions. scrgadm -pvv -g > 2. Offline the WebSphere MQ resources using scswitch -n -j 3. Remove the WebSphere MQ resources using scrgadm -r -j 4. Add the patch (On all nodes within the cluster) 5. Edit /opt/SUNWscmqs/mgr/util/mgr_config and set the parameters as required. 6. Run /opt/SUNWscmqs/mgr/util/mgr_register to register the WebSphere MQ resource. 7. Repeat Steps 2-6 for any other WebSphere MQ components Edit /opt/SUNWscmqs//_config Run /opt/SUNWscmqs//_register 8. Rerun 1. above to a different file. scrgadm -pvv -g > 9. Check that no resource property values have been reset, i.e. timeout values diff 10. Amend any resource property values that have been reset. scrgadm -c -j -x|y = 11. Bring Online the resources using scswitch -e -j README -- Last modified date: Wednesday, March 15, 2006