IBM Tivoli Netcool Performance Manager Operations and Engineering Dashboards Document Revision R2E1

Transcription

1 IBM Tivoli Netcool Performance Manager Operations and Engineering Dashboards Document Revision R2E1 Troubleshooting Operations and Engineering Dashboards IBM

2 Note Before using this information and the product it supports, read the information in Notices on page 7. Copyright IBM Corporation 2016, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 Contents Chapter 1. Log files in Operations and Engineering Dashboards Setting the retention period for log files Chapter 2. Known problems and solutions Operations and Engineering Dashboards installation issues Missing a technology pack installation from the use cases Geographic Event Performance System Map widget fails to load Error in fetching data on Alarm Summary dashboard Diagnosing and resolving too many files open issue Always clear your browser cache before you access the dashboards Operations and Engineering Dashboards upgrade issues Ignore the error message that you might see when you run the summaries and UDCs Operations and Engineering Dashboards administration and usage issues Double scroll bar on Operations and Engineering Dashboards Menu item in the Dashboard Menu page appears truncated if the category name is long Exported reports in Operations and Engineering Dashboards show TimePeriod string in English instead of the selected language Operation type is unclear for UDP Jitter and VoIP Jitter link Voltage level data for ASR/Nexus type device is not standardized with the unit used correctly.. 6 Non-default DataView root context is not supported Custom Operations and Engineering Dashboards issues Duplicate values in the title of the Badge widget. 6 Notices Trademarks Terms and conditions for product documentation.. 10 Copyright IBM Corp. 2016, 2017 iii

4 iv Troubleshooting Operations and Engineering Dashboards

5 Chapter 1. Log files in Operations and Engineering Dashboards Log files are generated during the usage of the Operations and Engineering Dashboards. These logs can be used to examine processing results and problems. The log files are located in: <JazzSm_Home>/profile/log. For example: tnpm log -rw-r--r-- 1 root system Jun 07 16:33 tnpm log -rw-r--r-- 1 root system Jun 08 16:22 tnpm log -rw-r--r-- 1 root system Jun 09 15:57 tnpm log -rw-r--r-- 1 root system Jun 10 15:51 tnpm log -rw-r--r-- 1 root system Jun 13 16:36 tnpm log -rw-r--r-- 1 root system Jun 14 07:13 tnpm.log Setting the retention period for log files The default retention period for Operations and Engineering Dashboards log files is 30 days. About this task Modify the logback-test.xml file that is available at: <JazzSM_Home>/profile/installedApps/JazzSMNode01Cell/tnpmoed.ear/ oed <build_number>.war/web-inf/classes/logback-test.xml The default <JazzSM_Home> is opt/ibm/jazzsm. Procedure Set the value 30 for the following parameter in the logback-test.xml file: <maxhistory>30</maxhistory> The logback-test.xml file contents are as follows: <?xml version="1.0" encoding="utf-8"?> <configuration> <contextname>tnpm</contextname> <appender name="file" class="ch.qos.logback.core.rolling.rollingfileappender"> <file>log/tnpm.log</file> <rollingpolicy class="ch.qos.logback.core.rolling.timebasedrollingpolicy"> <filenamepattern>log/tnpm.%d{dd-mm-yyyy}.log</filenamepattern> <maxhistory>30</maxhistory> <historyasfilecount>true</historyasfilecount> </rollingpolicy> <append>true</append> <encoder> <pattern>[%level] [%date{yyyy-mm-dd HH:mm:ss.SSS GMT XXX}] %logger </encoder> </appender> <logger name="nextgen-ui" level="debug" additivity="false"> <appender-ref ref="file"/> </logger> <root level="debug"> <appender-ref ref="file"/> </root> </configuration> %msg%n</pattern> Copyright IBM Corp. 2016,

6 What to do next Restart the Operations and Engineering Dashboards application. For more information, see Administering and Using Operations and Engineering Dashboards. 2 Troubleshooting Operations and Engineering Dashboards

7 Chapter 2. Known problems and solutions A list of known problems and their solutions are described here. Before you install and use Operations and Engineering Dashboards, read these known issues. Operations and Engineering Dashboards installation issues A list of problems that might occur during installation of Operations and Engineering Dashboards and how to resolve them. Missing a technology pack installation from the use cases If you do not install any technology pack that is needed for wireline use case or wireless use cases, you might see the message Error in fetching data in the area of the widget that pertains to the technology pack in the dashboard. Geographic Event Performance System Map widget fails to load Alarm Summary dashboard populates the following error message on the maps widget: Oops! Something went wrong This page didn't load Google Maps correctly. See the JavaScript console for technical details. Causes Typically, this error appears because you didn t key in a valid Google Maps API key during Operations and Engineering Dashboards installation. Resolving the problem Key in a valid Google Maps API key by running the following commands: 1. Run the following SQL query in your database administration tool, for example, SQuirreL SQL Client: Update preferencetable set preferences = <Google_Map_API_Key> where field = GOOGLEMAPSAPIKEY 2. Restart the WebSphere Application Server. Related information Restarting Jazz for Service Management application servers Error in fetching data on Alarm Summary dashboard Alarm Summary dashboard populates the following error message: Error in fetching data Causes Typically, this error appears because the Geographic Event Performance System service is not started. Resolving the problem Start the Geographic Event Performance System service. Copyright IBM Corp. 2016,

8 1. Start the Geographic Event Performance System application by using the following commands: cd /app/geps/bin./geps start 2. Verify the Geographic Event Performance System service is up and running. ps -ef grep -i geps Diagnosing and resolving too many files open issue When you install the Operations and Engineering Dashboards application, you might notice the following error message: Problem: 'too many open files' error in the installation.<dd-mm-yyyy>.log file Resolving the problem To resolve this issue, follow these steps: 1. Uninstall the Operations and Engineering Dashboards application by using uninstall.sh script. 2. Remove H2 database. 3. Configure the ulimit settings for soft limit and hard limit as follows: ulimit -Hn ulimit -Sn Restart WebSphere Application Server. 5. Install the Operations and Engineering Dashboards application. Always clear your browser cache before you access the dashboards The dashboards might not display correctly after the following procedures: v Installation of Operations and Engineering Dashboards on your system. v If you have performed an upgrade of Operations and Engineering Dashboards on your system. v If you have edited any of the Operations and Engineering Dashboards properties files. Resolving the problem It is recommended to clear your browser cache. Operations and Engineering Dashboards upgrade issues A list of problems that might occur during upgrade of Operations and Engineering Dashboards and how to resolve them. Ignore the error message that you might see when you run the summaries and UDCs When you run the summaries and UDCS during upgrade, you might see some error messages. For example: Error : Summary creation failed for summary <Summary_Name> Causes 4 Troubleshooting Operations and Engineering Dashboards

9 Typically, this error appears because some of the UDCs and summaries are imported from the previous build and you try to reimport the same summaries and UDCs. Resolving the problem You can ignore these error messages as they do not have any functional impact. Check the <DIST_DIR>/oed <build_number>/tnpmoed/scripts/ log_file.txt file for the following errors: UDC Could not create <UDC_Name>: The required hourly interval is already provisioned in the summary Summary ERROR: <Summary_Name>: import failed as field <Summary_Name> already has UUID GXG7MWFDH4YLC assigned Operations and Engineering Dashboards administration and usage issues A list of problems that might occur during using and administering Operations and Engineering Dashboards. Double scroll bar on Operations and Engineering Dashboards You might notice a double vertical scroll bar on the drill-down pages across Operations and Engineering Dashboards. Resolving the problem To resolve this issue, press F11 to maximize the screen to view in full screen mode. Menu item in the Dashboard Menu page appears truncated if the category name is long If the category name is more that 18 characters in length, the name in menu item appears truncated in the Dashboard Menu page. Resolving the problem Always create a category name that is less than 18 characters in length. Exported reports in Operations and Engineering Dashboards show TimePeriod string in English instead of the selected language The Operations and Engineering Dashboards are translated to the following languages: v Chinese (Simplified) v Portuguese (Brazil) The reports that are exported to PDF or Excel show TimePeriod string in English and not in the selected supported language. Chapter 2. Known problems and solutions 5

10 Operation type is unclear for UDP Jitter and VoIP Jitter link Link Info grid chart in Device Details and Interface Details reports does not differentiate the UDP Jitter and VOIP Jitter and displays them as Jitter only. Click the link to see the correct operation type from the drill-down Link Info report. Voltage level data for ASR/Nexus type device is not standardized with the unit used correctly In the Cisco Device technology pack version , the voltage level (mid-87010) data for ASR/Nexus type of Cisco device contains data in two different units; AC has Volts and DC has milli Volts. When the data is aggregated into summary level reports, the average of the data from both units is done without conversion to a single unit. This issue results in incorrect data display on the Device Details dashboards for the device Non-default DataView root context is not supported Currently, the default DataView root context PV is hardcoded in the queries that are used for all widgets in Wireline use case. The non-default DataView root context is not supported. Custom Operations and Engineering Dashboards issues A list of problems that might occur when you develop custom Operations and Engineering Dashboards. Duplicate values in the title of the Badge widget You might see some duplication in the title of the badge widget in your customized dashboards. Colon for the value element in the badge widget JSON code causes a duplication in the title. Example JSON code snippet: { "type": "Badge", "id": "brdtitlebadge", "xpos": "3", "chartidentity": [{ "name": "InterfaceMatricBadge", "drilldowntype": "masterlistener", "type": "listener", "master": "gridinterfacesfoundmaster" }], }, "value": "item.intbadgetitle", "badgelabel": "Interface", "badgetype": "rangebadge" The result of "value": "item.intbadgetitle", might be IF "1 Gbps" "ethernet0/5/7 Site: 3095-RNC " and you might see IF "1 Gbps" "ethernet0/5/7 Site: 3095-RNC ": 3095-RNC ". 6 Troubleshooting Operations and Engineering Dashboards

11 Notices This information was developed for products and services offered in the US. This material might be available from IBM in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it. 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 grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY US For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd , Nihonbashi-Hakozakicho, Chuo-ku Tokyo , Japan 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. Any references in this information to non-ibm websites are provided for convenience only and do not in any manner serve as an endorsement of those Copyright IBM Corp. 2016,

12 websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you provide 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 Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY US 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. The performance data discussed herein is presented as derived under specific operating conditions. Actual results may vary. The client examples cited are presented for illustrative purposes only. Actual performance results may vary depending on specific configurations and operating conditions. 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. Statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. 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 actual people or business enterprises is entirely coincidental. COPYRIGHT LICENSE: 8 Troubleshooting Operations and Engineering Dashboards

13 This information contains 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. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. Each copy or any portion of these sample programs or any derivative work must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, other countries, or both. IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce. 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. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. ITIL is a registered trademark, and a registered community trademark of The Minister for the Cabinet Office, and is registered in the U.S. Patent and Trademark Office. UNIX is a registered trademark of The Open Group in the United States and other countries. Notices 9

14 Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom. Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries. Terms and conditions for product documentation Permissions for the use of these publications are granted subject to the following terms and conditions. Applicability These terms and conditions are in addition to any terms of use for the IBM website. Personal use You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of IBM. Commercial use You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM. Rights Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein. IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed. You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations. 10 Troubleshooting Operations and Engineering Dashboards

15 IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE. Notices 11

16 12 Troubleshooting Operations and Engineering Dashboards

17

18 IBM Printed in USA