------------------------------------------------------------------------ IBM Tivoli OMEGAMON XE on z/OS Version 5 Release 1 Interim Fix 7 Interim Fix: 5.1.0-TIV-KM5-IF0007 Licensed material - Property of IBM © Copyright IBM Corporation 2005, 2016. ------------------------------------------------------------------------ CONTENTS 1 About this interim fix 2 Installation, migration, upgrade, and configuration information 3 Service history 4 Support information 5 Notices and trademarks ========================================================================= 1.0 ABOUT THIS INTERIM FIX ========================================================================= Set the font to monospace to better view this file. This maintenance update is Interim Fix 7 for Tivoli OMEGAMON XE on z/OS V5.1.0 and V5.1.1. The following product application support files are included: IBM Tivoli OMEGAMON XE on z/OS V5.1.0 It includes interim feature support for the following APAR: OA49226 (PTF UA80032) OMEGAMON XE z/OS Java Certificates will expire in April 2016. A new certificate is required for continued operation. If you have previously installed a language pack image, you must install the corresponding language pack deliverable. Refer to the "Recommended Maintenance" technote #1290883 for a complete list of recommended maintenance levels, including language packs. http://www.ibm.com/support/docview.wss?uid=swg21290883 ----------------------- 1.1 Cross-Product compatibility ----------------------- - Install ITM Version 6.3.0 Fix Pack 6 (6.3.0-TIV-ITM-FP0006) or higher, which includes the matching Java certificate. - IBM Tivoli Monitoring 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. - If you are using the Tivoli Enterprise Portal Browser Client or the Tivoli Enterprise Portal Java Webstart Client with IBM Tivoli Monitoring (ITM), you should review IBM Technote #1672459 and perform the recommended workarounds, which includes installing provisional maintenance. Refer to technote #1672459 for important information regarding the latest Java Support requirements. http://www.ibm.com/support/docview.wss?uid=swg21672459 Additionally, you should review technote #1269613, which contains a list of the Tivoli OMEGAMON and Tivoli Netview fix packs that must also be installed to resolve Java related security issues. Refer to technote #1269613 for important information regarding the latest Agent fix pack requirements for Java Security Support. http://www.ibm.com/support/docview.wss?uid=swg21269613 ========================================================================= 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 6 (6.3.0-TIV-ITM-FP0006) or higher, which includes the matching Java certificate. - This fixpack includes all maintenance since GA of OMEGAMON XE on z/OS V5.1.0. This fixpack can be applied directly to the base V5.1.0 product release or any previous fix pack or interim fix level. - IBM Tivoli OMEGAMON XE on z/OS V5.1.0 and V5.1.1 require PTF UA80032 - 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, migration, upgrade, and configuration notes ----------------------- - 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. - When you have enabled Self Describing Agent support, do not install the OMEGAMON XE on z/OS application support files at the Tivoli Enterprise Portal Server or Tivoli Enterprise Management Server. You do need to install the application support files at the Tivoli Enterprise Portal desktop client. - Follow these steps to install: a. Before starting your Interim Fix installation, use SMP/E to confirm that PTF UA80032 has been installed. b. Copy the maintenance update zip or tar file to the systems running Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Server, and Tivoli Enterprise Portal desktop client. c. Extract the maintenance update zip or tar file, using a command such as: On Windows systems: - unzip -v 5.1.0-TIV-KM5-IF0007.zip On UNIX or Linux systems: - unzip - 5.1.0-TIV-KM5-IF0007.tar.gz - if the version of tar used does not support the z option, then gunzip 5.1.0-TIV-KM5-IF0007.tar.gz tar -xvf 5.1.0-TIV-KM5-IF0007.tar d. As a best practice, manually stop all IBM Tivoli Monitoring components 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. e. 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 f. 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 M5 On UNIX or Linux systems: - /bin/cinfo -t M5 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 M5 PC APPLICATION SUPPORT DESC PLAT APP VER M5 OMEGAMON XE on z/OS WICMS 05.10.00.07 M5 OMEGAMON XE on z/OS WICNS 05.10.00.07 M5 OMEGAMON XE on z/OS WIXEB 05.10.00.07 M5 OMEGAMON XE on z/OS WIXEW 05.10.00.07 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 M5 PC APPLICATION SUPPORT DESC PLAT APP VER M5 OMEGAMON XE on z/OS tms 05.10.00.07 M5 OMEGAMON XE on z/OS tpd 05.10.00.07 M5 OMEGAMON XE on z/OS tps 05.10.00.07 M5 OMEGAMON XE on z/OS tpw 05.10.00.07 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 on z/OS V5.1.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 interim fix. - 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.1.0 into an environment running IBM Tivoli Monitoring 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 upgrading OMEGAMON XE on z/OS and have customized the OMEGAMON Service Level Analysis (SLA) definitions which are stored in the RKCPDEFW file, we recommend that you run the Service Level Analysis Batch utility to export the file definitions prior to starting the upgrade. Refer to the IBM Tivoli OMEGAMON XE on z/OS: Planning and Configuration guide for further instructions. - 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 interim fix, you should delete the OMEGAMON XE agent catalog (KM5CAT) and attribute files (KM5ATR) 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 (KM5.cat) and attribute (KM5.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 configuring OMEGAMON XE on z/OS using the GUI interface and your hub TEMS is on a Linux/UNIX platform, prior to adding application support for OMEGAMON XE on z/OS to the hub TEMS, run TEMS configuration using the command line interface: /bin/itmcmd support -t cp The defect causing this problem is in the ITM platform code. This problem is being tracked in APAR IZ89936. - IBM Tivoli Monitoring will be providing Agent support on Windows® Server 2012 for Version 6.2.2 and full support with the release of IBM Tivoli Monitoring 6.2.3 Fix Pack 3 (and later versions). Refer to the technote #1615385 for additional information. http://www.ibm.com/support/docview.wss?uid=swg21615385 ========================================================================= 3.0 SERVICE HISTORY ========================================================================= This refreshed image supersedes prior maintenance updates: - IBM Tivoli OMEGAMON XE on z/OS V5.1.0 fix packs: 5.1.0-TIV-KM5-IF0001 5.1.0-TIV-KM5-IF0002 5.1.0-TIV-KM5-IF0003 (a beta IF superceded by IF0004) 5.1.0-TIV-KM5-IF0004 5.1.0-TIV-KM5-IF0005 5.1.0-TIV-KM5-IF0006 ----------------------- 3.1 Product fix history ----------------------- The following APARs are addressed in this maintenance update: OA49226 OMEGAMON XE Z/OS APPLICATION SUPPORT FILES FOR JAVA CERTIFICATE REFRESH. These fixes are carried forward from 5.1.0-TIV-KM5-IF0006: OA44405 PROVIDE SYSTEM SNAPSHOT RMF MVS CPU% AND ADDRESS SPACE RMF MVS NORMALIZED CPU% This maintenance update adds new attributes to the following Tivoli OMEGAMON XE on z/OS tables: -System CPU Utilization -Address Space CPU Utilization table -License Manager MSU WLM Cap table. These fixes are carried forward from 5.1.0-TIV-KM5-IF0005: OA44130 This maintenance update includes renewed support for Oracle Java 1.7 U51. These fixes are carried forward from 5.1.0-TIV-KM5-IF0004: OA42128 OMEGAMON support for z/OS zAware built on analytics, with product provided alerts of z/OS issues from zAware. These fixes are carried forward from 5.1.0-TIV-KM5-IF0002: OA40839 The TEP Coupling Facility System Data for Sysplex workspace Status column shows 'Okay' when the Coupling Facility is unavailable. PROBLEM SUMMARY: The Status attribute did not accurately reflect the usability state of the Coupling Facility. CONCLUSION: The Status attribute will show a 'NoConnect' state when the Coupling Facility is available but no z/OS images are connected to the facility. No APAR exists for the problem described below PROBLEM SUMMARY: New Java(R) certificate required. CONCLUSION: This maintenance update includes a renewed Java(R) certificate (Valid from: 1/15/13 7:00 PM to 4/16/16 7:59 PM). If you have previously installed a language pack image, you must install the corresponding language pack image, 5.1.0-TIV-KM5-LP0001 with the matching certificate. This fix is carried forward from 5.1.0-TIV-KM5-IF0001: OA39009 Address Space CPU Utilization new attributes to provide IFA and zIIP percent values that include the specialty processor's Enclave home SRB time. PROBLEM SUMMARY: The CPU% value includes Enclave Home SRB time on General Processors, IFAs and zIIPs. IFA% that includes Enclave Home SRB time on IFAs, and zIIP% that includes Enclave Home SRB time on zIIPs is now added. CONCLUSION: Provide needed IFA% and zIIP% values. Also, a CPU% without Enclave Home SRB time is added for consistency with other reported values in the Address Space CPU Utilization reports. ========================================================================= 4.0 SUPPORT INFORMATION ========================================================================= If you have a problem with your IBM software, you want to resolve it quickly. This section describes options for obtaining support for IBM software products. ----------------------- 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: ----------------------- Notices 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 jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may 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. Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version. Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: the Excluded Components are provided on an "AS IS" basis IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE IBM will not be liable to you or indemnify you for any claims related to the Excluded Components IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components. ----------------------- 5.2 Trademarks: ----------------------- Copyright and trademark information http://www.ibm.com/legal/copytrade.shtml =========================================================================