######################################################################## # # COMPONENT_NAME: MQSeries Enterprise Integrator # # FILE: MEMO.PTF # # Program Number 5648-A74 # (C) COPYRIGHT International Business Machines Corp. 1997, 1999, 2000 # All Rights Reserved # Licensed Material - Property of IBM # # US Government Users Restricted Rights - Use, duplication or # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # ######################################################################## HOW TO DOWNLOAD AND INSTALL THIS CORRECTIVE SERVICE =================================================== Download on AIX Platform ------------------------ For an AIX installation, download the file U200111.AIX.tar.Z in binary mode into a temporary directory and rename it as U200111.tar.Z. This corrective service has been processed by the tar program and then compressed. To prepare for installation: 1) uncompress the file: uncompress U200111.tar.Z 2) run the tar program against the uncompressed file: tar -xvf U200111.tar 3) this will create the 3 separate PTFs in this corrective service. Download on HP-UX Platform -------------------------- For an HP-UX installation, download the file U200111.HPUX.tar.Z in binary mode into a temporary directory and rename it as U200111.tar.Z. This corrective service has been processed by the tar program and then compressed. To prepare for installation: 1) uncompress the file: uncompress U200111.tar.Z 2) run the tar program against the uncompressed file: tar -xvf U200111.tar 3) this will create the PTF file for this corrective service. Download on Sun Solaris Platform -------------------------------- For a Sun Solaris installation, download the file U200111.SOLARIS.tar.Z in binary mode into a temporary directory and rename it as U200111.tar.Z. This corrective service has been processed by the tar program and then compressed. To prepare for installation: 1) uncompress the file: uncompress U200111.tar.Z 2) run the tar program against the uncompressed file: tar -xvf U200111.tar 3) this will create the PTF file for this corrective service. Download on Windows NT Platform ------------------------------- For a Windows NT installation, download the file U200111.NT.exe in binary mode into a temporary directory on your hard drive and rename it as U200111.exe. Execute the downloaded file U200111.exe to install the PTF. Users of MQSeries Enterprise Integrator (MQEI) may have experienced a trap when they ran agents on several threads. A Notes RIP file was generated. The cause of the problem was a Lotus script object which Notes has deleted and which MQEI still held a reference to it. When MQEI tried to access the object, the storage was invalid. If you want the APAR fix for APAR IC27866 for a Windows NT installation, download the file IC27866.zip in binary mode into a temporary directory on your hard drive and uncompress it. The instructions for installing this APAR fix are contained in a readme file README.TXT that will be created when the file IC27866.zip is uncompressed. The fix should be applied to MQEI CSD #2 (U200111). Download on OS/2 Platform ------------------------- For an OS/2 installation, download the file U200111.OS2.zip in binary mode into a temporary directory on your hard drive and uncompress it using InfoZip's Unzip to preserve the directory structure of the compressed files. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ INSTALLATION AND MAINTENANCE INFORMATION ======================================== Installation and Maintenance Information for AIX ------------------------------------------------ A) Applying Maintenance -------------------- This PTF requires approximately 10MB of disk space to save the previous level. This allows a PTF to be removed, and the previous level automatically restored. To apply maintenance updates to your MQEI product: 1. Log in as root (or use the command su). 2. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 3. After downloading the CSD from the World Wide Web then ensure you are connected to the server containing the CSD. 4. To display the appropriate SMIT panel, either enter the fastpath command: smitty install_selectable_all or if this is not available enter "smit" and and navigate to the "Install and Update From All Available Software" panel. 5. On the panel displayed, you need to enter the device name attached to your server, and the directory in which the maintenance resides. Use PF4 to get a list of input devices. 6. Select "SOFTWARE to install". To install the maintenance, press PF4 for a list and select "mqei". 7. It is recommended that you use the displayed default values for all other fields, except for "COMMIT software" which you should set to "no", and "SAVE replaced files" which you should set to "yes". This will apply the PTF, and save a backup copy of your installation. At a later time, you will be able to choose to commit the PTF updates, or reject the PTF updates and return to the backup level. If you change the "COMMIT software" value to "yes" then no backup copy is saved and the PTF will be permanently applied. When you are ready click "OK" or press ENTER. 8. To start the update click "OK" or press ENTER when the confirmation message appears. The command will run, terminating with an Installp Summary table confirming which components of MQEI have been updated. If the command does not complete successfully, then a full error log is saved in the file smit.log in your HOME directory. B) Restoring the Previous Backup Version ------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Log in as root (or use the command su). 2. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 3. To display the appropriate SMIT panel, either enter the fastpath command: smitty install_reject or if this is not available enter "smit" and and navigate to the "Reject Applied Software Updates (Use Previous Version)" panel. 4. Select "SOFTWARE name". To reject the maintenance, press PF4 for a list and select "mqei". 5. It is recommended that you use the displayed default values for all other fields. This will reject the current PTF level, and re-inistate the previous install level. When you are ready click "OK" or press ENTER. 6. To start the reject click "OK" or press ENTER when the confirmation message appears. The command will run, terminating with an Installp Summary table confirming which components of MQEI have been rejected. Installation and Maintenance Information for HP-UX -------------------------------------------------- A) Applying Maintenance -------------------- This PTF requires approximately 5MB of disk space for installation. The installation process requires another 5MB of disk space to save the previous level. This allows a PTF to be removed, and the previous level is 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 However, 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. To apply maintenance updates to your MQEI product: 1. Log in as root (or use the command su). 2. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 3. After downloading the CSD from the World Wide Web then ensure you are connected to the server containing the CSD. 4. Use the swinstall command to install the maintenance as follows: swinstall -s//hp/hp-U200111.v10 5. Select "MQEI", use the "Action" pulldown and select "Mark for install", then use the "Action" pulldown again and select "Install". 6. On the next panel displayed select "OK", then select "YES" when the confirmation panel is displayed. 7. When complete select "Done" to complete the install. If the command does not complete successfully, you can select "Logfile" to view any errors reported. To exit the install utility select the "File" pulldown then select "Exit". B) Restoring the Previous Backup Version ------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Log in as root (or use the command su). 2. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 3. Use the swremove command to remove the maintenance from the system. 4. Select "MQEI update B.10.1000.02", use the "Action" pulldown and select "Mark for remove", then use the "Action" pulldown again and select "Remove". 5. On the next panel displayed select "OK", then select "YES" when the confirmation panel is displayed. 6. When complete select "Done" to complete the remove. If the command does not complete successfully, you can select "Logfile" to view any errors reported. To exit the remove utility select the "File" pulldown then select "Exit". Installation and Maintenance Information for Sun Solaris -------------------------------------------------------- A) Applying Maintenance -------------------- The installation process for this PTF requires 5MB of disk space for the PTF and a further 5MB of disk space in the /var/sadm/pkg directory to save the previous level. This allows a PTF to be removed, and the previous level is 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/sadm/pkg However, 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 reapply a previous cumulative PTF image. To apply maintenance updates to your MQEI product: 1. Log in as root (or use the command su). 2. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 3. After downloading the CSD from the World Wide Web then ensure you are connected to the server containing the CSD. 4. Use the pkgadd command to install the maintenance as follows: pkgadd -d //solaris/mqei-U200111.image 5. When prompted to select package(s) to process, type "1" or "all" and press ENTER. B) Restoring the Previous Backup Version ------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Log in as root (or use the command su). 2. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 3. Use the pkgrm command to remove the latest PTF update: pkgrm mqei_upd2 Errors displayed of the form are of type "warning" and can be ignored. 4. When prompted to remove type "y" and press ENTER. 5. Press ENTER to confirm. Installation and Maintenance Information for Windows NT ------------------------------------------------------- A) Applying Maintenance -------------------- This PTF requires approximately 11MB of disk space to save the previous level. This allows a PTF to be removed, and the previous level automatically restored. To apply maintenance updates to your MQEI product: 1. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 2. After downloading the CSD from the World Wide Web, ensure you are connected to the drive containing the CSD. 3. On Windows NT V4.0 or Windows 95, select the Start menu then select "Run". On Windows NT V3.51, from Windows Program Manager select the "File" pulldown then select "Run". Then type ":\win32\mqeicsd2\setup" where is the drive letter you are installing from and click OK. 4. You will be presented with the "Welcome" dialog. Select the "Next>" button. 5. When prompted with the prompt "Do you wish to backup the current version of the product?", it is recommended that you reply "Yes". 6. Select the backup directory (it is recommended that you leave the default directory), and then select the "Next>" button. 7. From the "Start Copying Files" dialog, verify that the information displayed matches your requested choices, and then select the "Next>" button to proceed. 8. Select the "Finish" button to complete the installation of the CSD. B) Restoring the Previous Backup Version ------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 2. On Windows NT V4.0 or Windows 95, use the Start menu to navigate to the "Programs" sub menu, select "MQSeries Enterprise Integrator", and finally select the "Remove CSD02" icon. On Windows NT V3.51 open the MQSeries Enterprise Integrator folder, and double-click on the "Remove CSD02" icon. 3. If the CSD has been applied with rollback, you are given the option to uninstall the most recent CSD or uninstall the entire product. Select "Uninstall last APAR" then select the "Remove" button to remove the most recent CSD and return the installation to the state it was in before the CSD was applied. Notes: 1. The "Remove CSD02" icon is NOT removed from the menu or folder upon successful completion of the operation. C) Querying the Service Level -------------------------- On Windows NT V4.0 or Windows 95, use the Start menu to navigate to the "Programs" sub menu, select "MQSeries Enterprise Integrator", and finally select the memo.ptf file. On Windows NT V3.51 open the MQSeries Enterprise Integrator folder, and double-click on the memo.ptf file. This shows the memo.ptf file containing the service level and details of the maintenance applied (PTF number). This file is also included in the root directory of the CD. Installation and Maintenance Information for OS/2 ------------------------------------------------- A) Applying Maintenance -------------------- This PTF requires approximately 14MB of disk space to save the previous level. This allows a PTF to be removed, and the previous level automatically restored. To apply maintenance updates to your MQEI product: 1. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 2. After downloading the CSD from the World Wide Web ensure you are connected to the network drive containing the CSD. 3. Open the MQSeries Enterprise Integrator folder on the desktop and double-click on the "Installation and Maintenance" icon. 4. Click on "File". 5. Select "Open catalog", and from the sub-menu displayed select "Drive". 6. Select the drive containing the downloaded CSD, from the Drive pulldown. 7. Click on "Search", and a "Directory" list will be displayed. 8. Select and open the os2\mqeicsd2\En_US language directory from the "Directory" list. Next, select MQEICAT2.ICF from the "File" list and click on "OK". 9. You will return to the "Open drive catalog" window, with the selected catalog file displayed in the "Filename" list. You may verify your selection by clicking on "Description". 10. When you have selected the catalog file which corresponds to the product you have installed, click on "Open" to open the catalog file. 11. Click on the "View" choice on the menu bar, and then select "Current catalog"; the window should display: 01.00.00 IBM MQSeries Enterprise Integrator 12. Click on the "Details" choice on the menu bar, and then select "Product description". This should query the product information from files on the network drive, and display the product description for 'IBM MQSeries Enterprise Integrator'. If this fails, then check that you have selected the correct catalog file in step 7. 13. Click on the "Action" choice on the menu bar. 14. Click on "Update" to display the Update window. 15. It is recommended that you save a backup version of your installation when you apply this CSD. You do this by ensuring that the "Save backup version" option is selected. 16. Click on "Update" in the Update window. 17. During update, a status bar is displayed. On completion, follow the instructions given in the message windows. In particular, if it says to reboot your system then you must do this before continuing with any further use or maintenance of IBM MQSeries Enterprise Integrator. B) Restoring the Previous Backup Version ------------------------------------- If you need to restore from backup, to the previous level of maintenance: 1. Ensure that MQEI is not in use by Notes or Domino. You may have to terminate Notes or Domino to achieve this. 2. Open the MQSeries Enterprise Integrator folder and double-click on the "Installation and Maintenance" icon. 3. Click on the "Action" choice on the menu bar. 4. Click on "Restore" to display the Restore window. 5. Click on "Restore" in the Restore window. 6. During restore, a status bar is displayed. On completion, follow the instructions given in the message windows. In particular, if it says to reboot your system then you must do this before continuing with any further use or maintenance of IBM MQSeries Enterprise Integrator. Notes: 1. The Restore action is only applicable if, when using the Update action, the option to save a backup copy was selected. 2. The MQEI folder will be closed and reinitialized. This means that all folder settings will be reset to their default values. Due to a bug this means the mqeihelp.pdf icon will be lost from the folder. 3. All changed files at the current maintenance level will be overwritten, without requiring confirmation by the user, with corresponding files saved from the previous maintenance level. However new files at the current maintenance level will not be deleted. C) Querying the Service Level -------------------------- After installation, the service level should have the value "U200111" Service level is expressed in terms of the PTF number for a particular CSD. To query the service level: 1. Open the MQSeries Enterprise Integrator folder and double-click on the "Installation and Maintenance" icon. 2. If the current product selected is not IBM MQSeries Enterprise Integrator then click on the "View" choice on the menu bar, and then select "Installed products". Now select IBM MQSeries Enterprise Integrator. 3. Click on "Details" on the menu bar. 4. Click on "Product status" to display the Product status window. 5. Select one of the currently installed components, and click on "Service level" to display the Service level window. For the selected component this will show details of Install date, Origin (source from which MQEI was installed), and Level. Installation Instructions ========================= After installation of the PTF, you should read the MEMO.PTF file installed with this PTF for further details of this PTF. If after applying this PTF, you experience problems - please contact the IBM Support Center (ISC) at 1-800-237-5511 or an authorized IBM Personal Computer dealer, whichever is applicable.