+-----------------+ |Table of Contents| +-----------------+ 1. Title 2. Problem abstract 3. Symptom 4. Cause 5. Resolving the problem 6. Notices 6.1 Trademarks +---------+ | 1. Title| +---------+ Upgrade of the existing Tivoli Integration Portal installed with Tivoli Common Reporting 1.2 to Tivoli Integration Portal 1.1.1.11. +--------------------+ | 2. Problem abstract| +--------------------+ Existing Tivoli Common Reporting 1.2 customers may wish to upgrade their Tivoli Integration Portal version to 1.1.1.11 in order to take full advantage of this version. This version has many fixes for defects and APARs to make Tivoli Integrated Portal more efficient and robust. This version also comes with an updated embedded Websphere Application Server which supports many security fixes. +------------+ | 3. Symptom| +------------+ The existing Tivoli Integrated Portal which is installed with Tivoli Common Reporting 1.2 contains embedded Websphere Application Server which has multiple security vulnerabilities that may affect the customer's environment. +---------+ | 4. Cause| +---------+ At the time of Tivoli Common Reporting 1.2 development and release, the latest Tivoli Integrated Portal version was picked which does not address some of the security vulnerabilities seen today. +-------------------------+ | 5. Resolving the problem| +-------------------------+ The problem can be resolved by following the below steps below: 1. Make sure that the Tivoli Common Reporting 1.2 is installed with the Tivoli Intergrated Portal. Check the version of the Tivoli Integrated Portal by following the below commands. - On Windows Navigate to: %ProgramFiles%\IBM\Common\acsi\bin and execute: listIU.cmd - On Unix (for non-root installs) Navigate to: /home//.acsi_/bin (for root installs) Navigate to:/usr/ibm/common/acsi/bin and execute: listIU.sh The output should contain minimum version of the TIPCore 1.1.0.0 IU RootIU UUID: 2ADC4A33F09F4E85AD27963E850290C3 Name: TIPCore Version: 1.1.0.0 IU RootIU UUID: C00DA95AFD9B7E0397153CD944B5A255 Name: eWAS Version: 6.1.0.2100 If the list has the TIPCore version 1.1.1.11, then it is not required to install this fix. 2. Unpack the Interim Fix to any folder in the file system. 3. Before upgrading the Tivoli Integrated Portal to 1.1.1.11, the WAS Update Installer (WUI) has to be installed. Extract the file /cdimage/7.0.0.7-WS-UPDI-.zip to the same folder; where identifies the Operating System and the architecture. 4. Navigate to the /cdimage/UpdateInstaller folder and edit the "responsefile.updiinstaller.txt" to set the below properties to the values given. Please read the file carefully before editing. a) Under the "License Acceptance" section, edit the below value to "true" -OPT silentInstallLicenseAcceptance="true" b) Under the "Install Location" section, edit the below value to the desired installation location depending on the OS. -OPT installLocation="" c) If the installation is performed from a non-root user, then uncomment the following line under the "NonRoot Install Settings" section and make sure the value is set to "true" -OPT allowNonRootSilentInstall="true" 5. Save the file and execute the following command to install the WUI in a command-line interface. - On Windows Navigate to: /cdimage/UpdateInstaller and execute: install.exe -options responsefile.updiinstaller.txt -silent - On Unix Navigate to: /cdimage/UpdateInstaller and execute: ./install -options ./responsefile.updiinstaller.txt -silent The command prompt returns after installation. Verify the WUI installation by opening the "version.txt" file present in the . The version should read as 7.0.0.7. 6. Navigate to the /cdimage folder and edit the "sampleFP1_response.txt" to set the below properties to the values given. a) LICENSE_ACCEPTED=true b) USER_INSTALL_DIR= Example: For Windows - USER_INSTALL_DIR=C:\\IBM\\tivoli\\tip For Unix - USER_INSTALL_DIR=/opt/IBM/tivoli/tip c) IAGLOBAL_WUI_HOME= Example: For Windows - IAGLOBAL_WUI_HOME=C:\\IBM\\WebSphere\\UpdateInstaller For Unix - IAGLOBAL_WUI_HOME=/opt/IBM/Websphere/UpdateInstaller d) IAGLOBAL_BACKUP_PROCEDURE_DONE=true e) IAGLOBAL_WASUserID= Example: IAGLOBAL_WASUserID=tipadmin f) IALOCAL_WASPassword= Example: IALOCAL_WASPassword=tipadmin 7. Save the file and now open the command prompt and navigate to the folder: /cdimage Execute the following command to run the silent installation of the Tivoli Integrated Portal. - On Windows install.exe -f - On Unix ./install.sh -f 8. The install log "IA-TIPInstallFP11-00.log" will be created under the below folder to track the silent installation. - On Windows C:\Documents and Settings\ Example: C:\Documents and Settings\Administrator -> if Administrator is the logged-in user. - On Unix It will be under the user's home directory like /home/ OR under /root, if root is the logged-in user. - In this log file, one should see "Exiting with exit code: 0" to understand that the installation has completed successfully. 9. Now check the version of the Tivoli Integrated Portal by following the below commands. - On Windows Navigate to: %ProgramFiles%\IBM\Common\acsi\bin and execute: listIU.cmd - On Unix (for non-root installs) Navigate to: /home//.acsi_/bin (for root installs) Navigate to:/usr/ibm/common/acsi/bin and execute: listIU.sh The output should now contain the below entry which confirms the Tivoli Integrated Portal version 1.1.1.11 installation. IU RootIU UUID: 2ADC4A33F09F4E85AD27963E850290C3 Name: TIPCore Version: 1.1.1.11 IU RootIU UUID: C00DA95AFD9B7E0397153CD944B5A255 Name: eWAS Version: 6.1.0.2900 10. Follow the below steps to Uninstall the solution. 11. Locate the sample uninstall response file "uninstallFP1_response.txt" from the path: /cdimage 12. Edit this file to replace the existing WAS username and password. a) IAGLOBAL_WASUserID= Example: IAGLOBAL_WASUserID=tipadmin b) IALOCAL_WASPassword= Example: IALOCAL_WASPassword=tipadmin Save the file. 13. If Windows is the OS, locate ‘tipundo.bat’ from the /cdimage, and place it the folder: \ _uninst\TIPInstallFP11 14. From a command prompt, navigate to \ _uninst\TIPInstallFP11 folder and issue the following command: - On Windows undo.bat –f - On Unix ./undo.sh –f 15. Uninstall log "IA-TIPUnInstallFP11-00.log" will be created under the below folder to track the silent uninstallation. - On Windows C:\Documents and Settings\ Example: C:\Documents and Settings\Administrator -> if Administrator is the logged-in user. - On Unix It will be under the user's home directory like /home/ OR under /root, if root is the logged-in user. 16. Now check the version of the Tivoli Integrated Portal by following the below commands. - On Windows Navigate to: %ProgramFiles%\IBM\Common\acsi\bin and execute: listIU.cmd - On Unix (for non-root installs) Navigate to: /home//.acsi_/bin (for root installs) Navigate to:/usr/ibm/common/acsi/bin and execute: listIU.sh The output should NOT contain the below entries which confirms the uninstallation of Tivoli Integrated Portal version 1.1.1.11. IU RootIU UUID: 2ADC4A33F09F4E85AD27963E850290C3 Name: TIPCore Version: 1.1.1.11 IU RootIU UUID: C00DA95AFD9B7E0397153CD944B5A255 Name: eWAS Version: 6.1.0.2900 At this time, The TIP server will be stopped. Please start the TCR server to access the console. +----------+ | 6 Notices| +----------+ This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-178, U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. +--------------+ |6.1 Trademarks| +--------------+ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM The IBM logo AIX DB2 DB2® Universal Database Tivoli WebSphere zSeries Microsoft®, Windows®, and the Windows logo are registered trademarks, of Microsoft Corporation in the U.S. and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Intel® is a trademark of Intel Corporation in the United States, other countries, or both. Linux® is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others.