MQSeries Workflow 3.3.0 - Service Pack #1 ----------------------------------------- INDEX ------------------------------------------ 1. Installation of Service Pack #1 1.1 Installation on Microsoft Windows 1.2 Installation on IBM AIX 1.3 Installation on Sun Solaris 1.4 Installation on HP-Unix 2. Important Notices 3. Changes 3.1 Changes in Service Pack #1 ------------------------------------------ 1. Installation of Service Pack #1 =========================================== 1.1 Installing the Service Pack on Windows NT/2000/95/98 --------------------------------------------------------------------- 1.1.1 Which files must be downloaded? The Service Pack consists of several self-extracting and self-installing executables. One for each National Language version of IBM MQSeries Workflow. To make the distribution of client updates easier, there are three types of self-extracting executables to update Client, Buildtime or full installations, respectively. The Client and Buildtime packages contain only certain MQSeries Workflow components and they are only applicable if these components or a subset of these components are installed. Use the full package to update installations including more than these components. The Client package consists of the API Runtime Library, Program Execution Agent, Runtime Client, Lotus Notes Client, Admininstration Utility, Notes DB Templates, Samples, Java, CORBA Agent component. The Buildtime package includes Buildtime and Samples. Following the list of the self-extracting executables: Full Package: ------------- W330ENA1.EXE - U.S. English language version W330CSA1.EXE - Simplified Chinese language version W330CTA1.EXE - Traditional Chinese language version W330DAA1.EXE - Danish language version W330DEA1.EXE - German language version W330ESA1.EXE - Spanish language version W330FIA1.EXE - Finnish language version W330FRA1.EXE - French language version W330HEA1.EXE - Hebrew language version W330HUA1.EXE - Hungarian language version W330ITA1.EXE - Italian language version W330JPA1.EXE - Japanese language version W330KOA1.EXE - Korean language version W330NLA1.EXE - Dutch language version W330NOA1.EXE - Norwegian language version W330PLA1.EXE - Polish language version W330PBA1.EXE - Brazilian Portuguese language version W330PGA1.EXE - Portuguese language version W330TRA1.EXE - Turkish language version Client Package: --------------- W330ENC1.EXE - U.S. English language version W330CSC1.EXE - Simplified Chinese language version W330CTC1.EXE - Traditional Chinese language version W330DAC1.EXE - Danish language version W330DEC1.EXE - German language version W330ESC1.EXE - Spanish language version W330FIC1.EXE - Finnish language version W330FRC1.EXE - French language version W330HEC1.EXE - Hebrew language version W330HUC1.EXE - Hungarian language version W330ITC1.EXE - Italian language version W330JPC1.EXE - Japanese language version W330KOC1.EXE - Korean language version W330NLC1.EXE - Dutch language version W330NOC1.EXE - Norwegian language version W330PLC1.EXE - Polish language version W330PBC1.EXE - Brazilian Portuguese language version W330PGC1.EXE - Portuguese language version W330TRC1.EXE - Turkish language version Buildtime Package: ----------------- W330ENB1.EXE - U.S. English language version W330CSB1.EXE - Simplified Chinese language version W330CTB1.EXE - Traditional Chinese language version W330DAB1.EXE - Danish language version W330DEB1.EXE - German language version W330ESB1.EXE - Spanish language version W330FIB1.EXE - Finnish language version W330FRB1.EXE - French language version W330HEB1.EXE - Hebrew language version W330HUB1.EXE - Hungarian language version W330ITB1.EXE - Italian language version W330JPB1.EXE - Japanese language version W330KOB1.EXE - Korean language version W330NLB1.EXE - Dutch language version W330NOB1.EXE - Norwegian language version W330PLB1.EXE - Polish language version W330PBB1.EXE - Brazilian Portuguese language version W330PGB1.EXE - Portuguese language version W330TRB1.EXE - Turkish language version 1.1.2 Installing the Service Pack Make sure that you have stopped all running MQSeries Workflow processes and services before installing the Service Pack. Double click on the downloaded executable in the Windows Explorer. The program unpacks the files to the temporary directory and starts the installation right after unpacking. 1.1.3 Upgrading your existing MQSeries Workflow Configuration As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. Open a DOS Command Prompt and run fmczutil and choose the configuration identifier of the configuration you would like to update. Then choose the 'r'untime database menu and select 'b'ind. Now all bindings will be made for you. This may take several minutes. After these steps your system is ready to run. You may restart your MQSeries Workflow services and processes again. 1.2 Installation on IBM AIX --------------------------- 1.2.1 Which files must be downloaded? Please download the package wf330a1u.tar.gz (30 MB) and unpack the file to a temporary subdirectory. You need approximately 80 MB to unpack the file. 1.2.2 Installing the Service Pack 1) First, stop all running MQSeries Workflow processes, for example by shutting down the MQSeries Workflow System using the admin utility "fmcautil". 2) As root, perform the command 'slibclean'. 3) Update your MQSeries Workflow 3.3.0.x installation (with or without having hotfixes applied) using smit - "update to latest level" to level 3.3.0.10. Note: Your configuration (profiles, /var/fmc/...) will not be modified by the update. However, the installation profile /usr/lpp/fmc/fmcrc will be updated to reflect the new level "ServiceLevel=1". 4) As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. As user "fmc" invoke fmczutil and choose the configuration identifier of the configuration you would like to update. Then choose the 'r'untime database menu and select 'b'ind. Now all bindings will be made for you. This may take several minutes. After these steps your system is ready to run. You may restart your queue manager, the trigger monitor and the administration server as usual by invoking the following programs: strmqm FMCQM & runmqtrm -q FMCTRIGGER -m FMCQM & fmcamain & 1.3 Installation on SUN Solaris ------------------------------- 1.3.1 Which files must be downloaded? Please download the package wf330s1u.tar.gz (12 MB) and unpack the file to a temporary subdirectory. You need approximately 42 MB to unpack the file. 1.3.2 Installing the Service Pack 1) First, stop all running MQSeries Workflow processes, for example by shutting down the MQSeries Workflow System using the admin utility "fmcautil". Make sure that all MQSeries Workflow processes are stopped and no file of the product is in use. 2) This is how to update your MQSeries Workflow 3.3.0.x files (with or without having hotfixes applied) to level 3.3.0.10: Issue the following command line as user "root", replace the path "/tmp/fmc330u1.pkg" from this example with the fully qualified path and filename of your ".pkg" file: pkgadd -d /tmp/fmc330u1.pkg accept the installation of this package and overwriting files of the previous package 3.3.0.x. Note: Your configuration(s) (profiles, /var/fmc/...) will NOT be modified by the update. However, the installation profile /opt/fmc/fmcrc will be updated to reflect the new level "ServiceLevel=1". 3) As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. As user "fmc" invoke fmczutil and choose the configuration identifier of the configuration you would like to update. Then choose the 'r'untime database menu and select 'b'ind. Now all bindings will be made for you. This may take several minutes. After these steps your system is ready to run. You may restart your queue manager, the trigger monitor and the administration server as usual by invoking the following programs: strmqm FMCQM & runmqtrm -q FMCTRIGGER -m FMCQM & fmcamain & 1.4 Installation on HP-Unix --------------------------- 1.4.1 Which files must be downloaded? Please download the package wf330h1u.tar.gz and unpack the file to a temporary subdirectory. 1.4.2 Installing the Service Pack 1) First, stop all running MQSeries Workflow processes, for example by shutting down the MQSeries Workflow System using the admin utility "fmcautil". Make sure that all MQSeries Workflow processes are stopped and no file of the product is in use. 2) This is how to update your MQSeries Workflow 3.3.0.x files (with or without having hotfixes applied) to level 3.3.0.10: Use "sam" to install the new package. Use the "software" icon, and select "add software to local host". Then choose installation from disc and enter the fully qualified path to the file "FMC330U1.PKG" and the filename itself. Choose "Install" from the "Actions" pulldown menu and confirm twice. After installation you will be ready to go on with step 3. If you do not want to use sam, you can use "swinstall" with the appropriate command line parameters that suit your needs. Note: Your configuration(s) (profiles, /var/fmc/...) will NOT be modified by the update. 3) Run the command fmczinsx -o upd to update the installation profile /opt/fmc/fmcrc with the new level "ServiceLevel=1". This value reflects the current service pack level of the installation. 4) As updated DB2 bind files are included in this package, you have to bind the new files to your MQSeries Workflow runtime databases. As user "fmc" invoke fmczutil and choose the configuration identifier of the configuration you would like to update. Then choose the 'r'untime database menu and select 'b'ind. Now all bindings will be made for you. This may take several minutes. After these steps your system is ready to run. You may restart your queue manager, the trigger monitor and the administration server as usual by invoking the following programs: strmqm FMCQM & runmqtrm -q FMCTRIGGER -m FMCQM & fmcamain & 2. Applying service to the Web Client =========================================== It is recommended to have an own configuration for just the Web Client. This way you can easily apply service to the Web Client: - Install the MQSeries Workflow Service Pack - Back up the Web Client files that you have changed (for example, WebClient.properties) to a directory that is NOT a subdirectory of \cfgs, because the complete subtree of your old Web Client configuration will be deleted in the next step. - Delete the Web Client configuration using fmczutil - Create a Web Client configuration. If you do not change the configuration identifier, it is not necessary to redeploy the Web Client in the WebSphere Application Server. - Merge the changes you made with the new Web Client files. This includes re-installing the samples for the Web Client as, for example, the AuditTrailHandler and the Groupworklist sample. NOTE: For the AuditTrailHandler, the Web Client needs Xalan-Java 2, which is available on the following Web site: http://xml.apache.org/xalan-j It is strongly recommended that you delete the temporary directory that you created for the compiled JSPs of the Web Client on your application server. When using IBM WebSphere, this temporary directory is \temp\\MQWFClient-, for example, d:\WebSphere\AppServer\temp\default_host\MQWFClient-WEBC. 9:14 AM 6/27/2001 3. Changes =========================================== 3.1 Changes for Service Pack #1 ------------------------------ The following problems are fixed: Nr. PMR/APAR Desc. 14888 Web Client Work List not found 14996 Logon to Web Client fails after previous logoff 12585 Cleanup server floods the execution server queue 14942 Expiration time is not forwarded to MQ message expiration time. 14948 Pre-condition failure in fmcmproc.cxx 14960 Improve trace performance for AIX 14975 FMCEMAIN abends with SQL code 904 14976 Server Framework dumps when terminating 14978 Migration problem 14985 Access violation in fmccmqfr.dll 14986 L0 trace: Assertions don't contain failure location 15007 Memory leak with dynamic SQL for DB2 15085 Memory leak in MQ layer 14971 fmczinsx -o db2/ora: wrong links in a client only installation 15034 Syntax checker does not allow '-' (dashes) in TCP/IP hostnames 15036 HP-UX language support ja_JP.SJIS configuration incorrect