------------------------------------------------------------------------ IBM(R) Tivoli(R) OMEGAMON(R) XE for Mainframe Networks Application Support Files Version 5 Release 3 Fix Pack 1 for Java certificate refresh 5.3.0-TIV-KN3-FP0001.README Licensed material - Property of IBM © Copyright IBM Corporation 2005, 2015. ------------------------------------------------------------------------ CONTENTS 1 About this fix pack 2 Installation, migration, upgrade, and configuration information 3 Service history 4 Support information 5 Notices and trademarks ========================================================================= 1.0 ABOUT THIS FIX PACK ========================================================================= Set the font to monospace to better view this file. This is the README document for OMEGAMON XE for Mainframe Networks Version 5 Release 3 Fix Pack 1. The following product application support files are included: IBM Tivoli OMEGAMON XE for Mainframe Networks V5.3.0 Fixes for these APARs are included: OA49195 Fixes for these defects are included: None This fix pack includes all maintenance since GA of IBM Tivoli OMEGAMON XE for Mainframe Networks V5.3.0 Application Support Files. This fix pack can be applied directly to the base V5.3.0 product release or any previous fix pack or interim fix level. ----------------------- 1.1 Cross-Product compatibility ----------------------- - This fix pack requires IBM Tivoli Monitoring (ITM) Version 6.3.0 Fix Pack 2 (6.3.0-TIV-ITM-FP0002) or higher version of ITM. The best practice minimum requirement is ITM Version 6.3.0 Fix Pack 6 (6.3.0-TIV-ITM-FP0006). - IBM Tivoli Monitoring V6.3.0 can be obtained by ordering either 5724-C04 IBM Tivoli Monitoring through Passport Advantage or 5698-A79 IBM Tivoli Monitoring Services on z/OS through ShopzSeries. - You must upgrade your TEPS and Hub TEMS on a distributed platform to the required level of ITM maintenance prior to installing the OMEGAMON application support files with this image. ========================================================================= 2.0 INSTALLATION, MIGRATION, UPGRADE, AND CONFIGURATION INFORMATION ========================================================================= ----------------------- 2.1 Hardware and Software Requirements ----------------------- This maintenance update requires: - IBM Tivoli Monitoring (ITM) V6.3.0 Fix Pack 2 or higher. The best practice minimum requirement is ITM Version 6.3.0 Fix Pack 6 (6.3.0-TIV-ITM-FP0006). - Installation of IBM Tivoli OMEGAMON XE for Mainframe Networks V5.3.0 Fix Pack 1 requires the following PTFs: UA79597 - If you have previously installed a language pack image, you must install the corresponding language pack, 5.3.0-TIV-KN3-LP0001. - This maintenance update includes a renewed Java certificate (valid from 8/2/15 07:00 PM until 11/1/18 06:59 PM). If you have not done so already, install Tivoli Enterprise Portal Server at IBM Tivoli Monitoring V6.3.0 Fix Pack 6 or higher, which includes the matching Java certificate for this component. Refer to technote #1269613 to locate the current install images: http://www.ibm.com/support/docview.wss?uid=swg21269613 - Refer to technote #1290883 for a complete list of recommended maintenance levels. http://www.ibm.com/support/docview.wss?uid=swg21290883 ----------------------- 2.2 Installation steps: ----------------------- - Before proceeding with the installation process, please make note of these important points: - It is a best practice to run the ITMSuper tool before installing the fix pack to create a baseline snapshot of your Tivoli Monitoring environment which can be used to compare against a second ITMSuper snapshot collected after applying this fix pack. The baseline snapshot can be done by selecting the Topology, Connectivity, and TEMS Servers tabs and saving the session. Information about the ITMSuper tool can be found at the following URL: http://www.ibm.com/software/brandcatalog/ismlibrary/details?catalog.label=1TW10TM6L - It is a best practice to make a record of the version, release, modification, fix pack, and interim fix level of the existing installation by running the KinCInfo command on Windows systems or the cinfo command on UNIX or Linux systems. After the installation of the maintenance completes, this will help in validating the installation. You can find instruction on cinfo/KinCInfo command in the post-install step in this section. - Follow these steps to install: a. Copy the maintenance update zip or tar file to the Tivoli Enterprise Monitoring Server(s) and Tivoli Enterprise Portal Server system(s). b. Extract the maintenance update zip or tar file, using a command such as: On Windows systems: - unzip -v 5.3.0-TIV-KN3-FP0001.zip On UNIX or Linux systems: - if the version of tar used supports the z option, then tar -zxvf 5.3.0-TIV-KN3-FP0001.tar.gz - if the version of tar used does not support the z option, then gunzip 5.3.0-TIV-KN3-FP0001.tar.gz tar -xvf 5.3.0-TIV-KN3-FP0001.tar c. As a best practice, manually stop the Tivoli Enterprise Portal Server and Tivoli Enterprise Monitoring Server running on the distributed platform where this fix pack is to be installed prior to performing this installation. While the distributed installer will attempt to stop all running processes, there are times when a running process will fail to stop and lead to unexpected upgrade failures if the upgrade is allowed to continue. If any process fails to stop during a manual shutdown, restart the system before proceeding with the upgrade. d. Start the distributed installer by using the following command from within the install directory: On Windows systems: - WINDOWS\setup.exe On UNIX or Linux systems: - ./install.sh e. Follow the on-screen installation instructions. Please make note of the following points during the post-installation configuration steps if you are adding application support to the TEMS. - If you are adding the application support files for products and this is the first time you have attempted installation of the application support files for this product, select the "New" option which will add the default managed system groups to all applicable situations from the product support packages being seeded for the first time. Modifications are not made to managed system groups in previously upgraded product support packages. "New" is the default. - If you are updating the application support files for products which were previously installed (upgrade), select the "All" option which will add the default managed system groups to all applicable situations. "None" is the default. - Post-installation, you can validate your installation by running the KinCInfo command on Windows systems or the cinfo command on UNIX or Linux systems and comparing the version information to that recorded prior to the installation. On Windows systems: - \installITM\KinCInfo -t n3 On UNIX or Linux systems: - /bin/cinfo -t n3 Sample output for the KinCInfo command on Windows systems to list product components installed in the manager server and/or portal server: \installITM\KinCInfo -t n3 PC APPLICATION SUPPORT DESC PLAT APP VER N3 OMEGAMON XE for Mainframe Networks WICMS 05.30.01.00 N3 OMEGAMON XE for Mainframe Networks WICNS 05.30.01.00 N3 OMEGAMON XE for Mainframe Networks WIXEB 05.30.01.00 N3 OMEGAMON XE for Mainframe Networks WIXEW 05.30.01.00 Sample output for the cinfo command on Linux or UNIX systems to list product components installed in the manager server and/or portal server: /bin/cinfo -t n3 PC APPLICATION SUPPORT DESC PLAT APP VER N3 OMEGAMON XE for Mainframe Networks tms 05.30.01.00 N3 OMEGAMON XE for Mainframe Networks tpd 05.30.01.00 N3 OMEGAMON XE for Mainframe Networks tps 05.30.01.00 N3 OMEGAMON XE for Mainframe Networks tpw 05.30.01.00 Where Version Format is: VV.RM.FF.II (V: Version; R: Release; M: Modification; F: Fix Pack; I: Interim Fix) ----------------------- 2.3 Known limitations, problems, and workarounds ----------------------- - The following message will appear during the installation of the application support from this image into a TEMS running on a Linux or UNIX platform: KCIIN2463W Warning: This installation media does not contain any components which can be run on the current system platform architecture. To install components which can run on this system, please locate the installation media containing files similar to .jar. If you are installing application support, continue with the installation to see a list of support files. This message can be ignored, as this image only contains application support files. Press enter to continue with the installation. - You may receive the following warning message: WARNING - you are about to install the SAME version of OMEGAMON XE for Mainframe Networks V5.3.0 Do you want to install the SAME version [ y or n; "n" is default ]? If you have previously installed one of the fix packs listed in section 3.0 SERVICE HISTORY, you should reply "y" to this message; otherwise, this message is an indication that you have already applied a later level of maintenance than is included in this fix pack. - You may see the following warning message when you are installing the application support on a Linux or UNIX system: "KCIIN1421W WARNING - unable to copy eclipse agent plugin file /products/itm/ls3263/cw/iehs/kxx/eclipse/plugins/com.ibm.kxx.doc" If you see this message, no action is required. Press Enter to continue. - During the install of IBM Tivoli OMEGAMON Application Support Files for z/OS V5.3.0 into an environment running IBM Tivoli Monitoring V6.3.0 on Windows, you may see the following installation error message: "Unable to copy a file to the drive where Program Files exists, cannot continue." Refer to the technote #1403443 for workaround details. http://www.ibm.com/support/docview.wss?uid=swg21403443. - If you are running your TEPS on Linux on System z and you use the manual method to add application support to a non-local TEMS running on z/OS, prior to installing the OMEGAMON XE application support files from this fix pack, you should delete the OMEGAMON XE agent catalog (KN3CAT) and attribute files (KN3ATR) from the &rhilev.&rte.RKANDATV file allocated to your non-local TEMS on z/OS. If you do not delete these files, you may encounter the following problem: Problem Description: When a TEPS is running on Linux on System z, if an attempt to FTP the catalog (KN3.cat) and attribute (KN3.atr) files from Manage Tivoli Enterprise Manage Services (MTEMS) fails, review the itm_config.trc log for the following error messages: ITMinstall.ftptems.SupportFileList transferFiles __ERROR__ (traceKey:1329933202902) sun.net.ftp.FtpProtocolException: PORT :503 EPSV ALL received - PORT not allowed after EPSV ALL If you encounter this problem, the following is a workaround: Execute following command in logs directory: grep "PORT not allowed after EPSV ALL" itm_config*.trc If it returns following text: sun.net.ftp.FtpProtocolException: PORT :503 EPSV ALL received - PORT not allowed after EPSV ALL then delete the selected catalog and attribute files from the non-local TEMS running on z/OS and retry the file transfer, using Manage Tivoli Enterprise Monitoring Server (MTEMS) or use another FTP client to replace existing catalog and attribute files on z/OS. - If you are using the TEP Webstart client you may see a pop-up dialog box during start-up indicating that the application's digital signature has expired. If you click the "More Information..." link on the pop-up dialog box, the following message will be shown: "Although the application has a digital signature, the application's associated file (JNLP) does not have one. A digital signature ensures that a file is from a vendor and that it has not been altered." This message can be safely ignored as the associated file (JNLP) is intentionally unsigned. Click "Close" to close the "More Information" dialog box and then click "Run" to continue with the TEP Webstart client start-up. ========================================================================= 3.0 SERVICE HISTORY ========================================================================= This refreshed image supersedes prior maintenance updates: - IBM Tivoli OMEGAMON XE for Mainframe Networks V5.3.0 fix packs: None. - IBM Tivoli OMEGAMON Application Support Files for z/OS V5.3.0 DVD Publication number LCD7-5139-nn. Where nn is 00, 01, 02, 03, 04, 05, 06, 07, 08 or 09. ----------------------- 3.1 Product fix history ----------------------- The following APARs are addressed in this maintenance update: APAR OA49195 - EXPIRED JAVA CERTIFICATE WARNING Problem Summary: The Java certificates used by the TEP browser and TEP Java webstart clients will expire April 16, 2016. The application support files must be resigned with the renewed Tivoli Java certificate. Conclusion: This maintenance updates the Self-Describing Agent (SDA) deliverables with a renewed Java certificate (Valid from: 8/02/15 7:00 PM to 11/01/18 6:59 PM). The following defects are addressed in this maintenance update: None. ========================================================================= 4.0 SUPPORT INFORMATION ========================================================================= ----------------------- 4.1 Contacting IBM Software Support ----------------------- If you have a problem with your IBM software, you want to resolve it quickly. Options for obtaining support for IBM software products is maintained in the IBM Software Support Handbook, which is available from this link: http://www.ibm.com/software/support/handbook.html For support for IBM products included on this DVD, contact IBM Software Support. Use this link to obtain worldwide contact information for IBM product support: http://www.ibm.com/planetwide/region.html IBM problem management records (PMR) can be submitted using one of the following methods: - Submit a problem management record (PMR) electronically at IBMSERV/IBMLINK. - Submit a problem management record (PMR) electronically from the support Web site at: http://www.ibm.com/software/sysmgmt/products/support/ The support Web site offers extensive information, including a guide to support services (the IBM Software Support Handbook); frequently asked questions (FAQs); and documentation for all products, including Release Notes, Redbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases. Here is a link to the IBM Software Support Web site: http://www.ibm.com/software/support/ Product Lifecycle information is provided that indicates when the IBM products that you are using are nearing the end of support date for a particular version or release. Support Lifecycle information can be obtained from this link: http://www.ibm.com/software/sysmgmt/products/support/lifecycle/ ----------------------- 4.2 Receiving weekly support updates ----------------------- To receive weekly e-mail notifications about fixes and other software support news, follow these steps: - Go to the IBM Software Support Web site at http://www.ibm.com/software/support/ - In the "Support notifications" section, select "Sign in to create, manage or view your subscriptions". - If you have not registered, you will be prompted to complete the registration form using your e-mail address as your IBM ID. - After you have completed your registration and successfully signed in, in the "Support notifications" section, select "Product notifications". - Enter Product in Product Lookup. Click on Subscribe. - Click on "Delivery preferences" to change your e-mail address, e-mail frequency, format and/or your language preference. - Click on "Submit" when you have completed your updates. If you experience problems with the My support feature, you can obtain help in one of the following ways: Online: Send an e-mail message to erchelp@ca.ibm.com, describing your problem. By phone: Call 1-800-IBM-4You (1-800-426-4968). ========================================================================= 5.0 NOTICES AND TRADEMARKS ========================================================================= ----------------------- 5.1 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-1785 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. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information may contain 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. COPYRIGHT LICENSE: This information may contain sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces. ----------------------- 5.2 Trademarks: ----------------------- IBM, CICS, OMEGAMON, Tivoli, Tivoli Enterprise, z/OS, zSeries, pSeries, AIX, IBMLink, S/390, ibm.com, IBM DeveloperWorks, Passport Advantage, Rational, Lotus, eServer, and IBM Redbooks are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Intel and Pentium are trademarks 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. Microsoft(R) and Windows are registered trademarks of Microsoft Corporation in the United States, other countries, or both. Solaris(TM), Java(TM) and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. UNIX(R)is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. =========================================================================