IBM Tivoli Netcool Performance Manager 1.4.3Operations and Engineering DashboardsDocument Revision R2E1

Troubleshooting Operations andEngineering Dashboards

IBM

NoteBefore using this information and the product it supports, read the information in “Notices” on page 7.

© Copyright IBM Corporation 2016, 2017.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Chapter 1. Log files in Operations andEngineering Dashboards . . . . . . . 1Setting the retention period for log files . . . . . 1

Chapter 2. Known problems andsolutions . . . . . . . . . . . . . . 3Operations and Engineering Dashboards installationissues. . . . . . . . . . . . . . . . . 3

Missing a technology pack installation from theuse cases . . . . . . . . . . . . . . 3Geographic Event Performance System Mapwidget fails to load . . . . . . . . . . . 3Error in fetching data on Alarm Summarydashboard . . . . . . . . . . . . . . 3Diagnosing and resolving too many files openissue . . . . . . . . . . . . . . . . 4Always clear your browser cache before youaccess the dashboards . . . . . . . . . . 4

Operations and Engineering Dashboards upgradeissues. . . . . . . . . . . . . . . . . 4

Ignore the error message that you might see whenyou run the summaries and UDCs . . . . . . 4

Operations and Engineering Dashboardsadministration and usage issues . . . . . . . . 5

Double scroll bar on Operations and EngineeringDashboards . . . . . . . . . . . . . . 5Menu item in the Dashboard Menu page appearstruncated if the category name is long . . . . . 5Exported reports in Operations and EngineeringDashboards show TimePeriod string in Englishinstead of the selected language . . . . . . . 5Operation type is unclear for UDP Jitter and VoIPJitter link . . . . . . . . . . . . . . 6Voltage level data for ASR/Nexus type device isnot standardized with the unit used correctly . . 6Non-default DataView root context is notsupported . . . . . . . . . . . . . . 6

Custom Operations and Engineering Dashboardsissues. . . . . . . . . . . . . . . . . 6

Duplicate values in the title of the Badge widget . 6

Notices . . . . . . . . . . . . . . . 7Trademarks . . . . . . . . . . . . . . . 9Terms and conditions for product documentation. . 10

© Copyright IBM Corp. 2016, 2017 iii

iv Troubleshooting Operations and Engineering Dashboards

Chapter 1. Log files in Operations and EngineeringDashboards

Log files are generated during the usage of the Operations and EngineeringDashboards. These logs can be used to examine processing results and problems.

The log files are located in: <JazzSm_Home>/profile/log. For example:tnpm.06-06-2016.log-rw-r--r-- 1 root system 12755248 Jun 07 16:33 tnpm.07-06-2016.log-rw-r--r-- 1 root system 30474583 Jun 08 16:22 tnpm.08-06-2016.log-rw-r--r-- 1 root system 35103440 Jun 09 15:57 tnpm.09-06-2016.log-rw-r--r-- 1 root system 31048940 Jun 10 15:51 tnpm.10-06-2016.log-rw-r--r-- 1 root system 12576656 Jun 13 16:36 tnpm.13-06-2016.log-rw-r--r-- 1 root system 22847 Jun 14 07:13 tnpm.log

Setting the retention period for log filesThe default retention period for Operations and Engineering Dashboards log filesis 30 days.

About this task

Modify the logback-test.xml file that is available at:<JazzSM_Home>/profile/installedApps/JazzSMNode01Cell/tnpmoed.ear/oed.1.4.3.0-<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 %msg%n</pattern>

</encoder></appender>

<logger name="nextgen-ui" level="DEBUG" additivity="false"><appender-ref ref="FILE"/>

</logger>

<root level="DEBUG"><appender-ref ref="FILE"/>

</root>

</configuration>

© Copyright IBM Corp. 2016, 2017 1

What to do next

Restart the Operations and Engineering Dashboards application.

For more information, see Administering and Using Operations and EngineeringDashboards.

2 Troubleshooting Operations and Engineering Dashboards

Chapter 2. Known problems and solutions

A list of known problems and their solutions are described here. Before you installand use Operations and Engineering Dashboards, read these known issues.

Operations and Engineering Dashboards installation issuesA list of problems that might occur during installation of Operations andEngineering Dashboards and how to resolve them.

Missing a technology pack installation from the use casesSymptomsIf you do not install any technology pack that is needed for wireline use case orwireless use cases, you might see the message “Error in fetching data” in thearea of the widget that pertains to the technology pack in the dashboard.

Geographic Event Performance System Map widget fails toload

SymptomsAlarm Summary dashboard populates the following error message on the mapswidget:Oops! Something went wrongThis page didn't load Google Maps correctly. See the JavaScript console for technical details.

CausesTypically, this error appears because you didn’t key in a valid Google Maps APIkey during Operations and Engineering Dashboards installation.

Resolving the problemKey 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 preferencetableset 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 dashboardSymptomsAlarm Summary dashboard populates the following error message:Error in fetching data

CausesTypically, this error appears because the Geographic Event Performance Systemservice is not started.

Resolving the problemStart the Geographic Event Performance System service.

© Copyright IBM Corp. 2016, 2017 3

1. Start the Geographic Event Performance System application by using thefollowing 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 issueSymptomsWhen you install the Operations and Engineering Dashboards application, youmight notice the following error message:Problem: 'too many open files' error in the installation.<dd-mm-yyyy>.log file

Resolving the problemTo 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 65536ulimit -Sn 65536

4. Restart WebSphere Application Server.5. Install the Operations and Engineering Dashboards application.

Always clear your browser cache before you access thedashboards

SymptomsThe 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 problemIt is recommended to clear your browser cache.

Operations and Engineering Dashboards upgrade issuesA list of problems that might occur during upgrade of Operations and EngineeringDashboards and how to resolve them.

Ignore the error message that you might see when you runthe summaries and UDCs

SymptomsWhen you run the summaries and UDCS during upgrade, you might see someerror messages. For example:Error : Summary creation failed for summary <Summary_Name>

Causes

4 Troubleshooting Operations and Engineering Dashboards

Typically, this error appears because some of the UDCs and summaries areimported from the previous build and you try to reimport the same summariesand UDCs.

Resolving the problemYou can ignore these error messages as they do not have any functional impact.

Check the <DIST_DIR>/oed.1.4.3.0-<build_number>/tnpmoed/scripts/log_file.txt file for the following errors:

UDCCould not create <UDC_Name>:

The required hourly interval is already provisioned in the summary

SummaryERROR:<Summary_Name>: import failed as field <Summary_Name> already hasUUID GXG7MWFDH4YLC assigned

Operations and Engineering Dashboards administration and usageissues

A list of problems that might occur during using and administering Operationsand Engineering Dashboards.

Double scroll bar on Operations and Engineering DashboardsSymptomsYou might notice a double vertical scroll bar on the drill-down pages acrossOperations and Engineering Dashboards.

Resolving the problemTo resolve this issue, press F11 to maximize the screen to view in full screen mode.

Menu item in the Dashboard Menu page appears truncated ifthe category name is long

SymptomsIf the category name is more that 18 characters in length, the name in menu itemappears truncated in the Dashboard Menu page.

Resolving the problemAlways create a category name that is less than 18 characters in length.

Exported reports in Operations and Engineering Dashboardsshow TimePeriod string in English instead of the selectedlanguage

SymptomsThe Operations and Engineering Dashboards are translated to the followinglanguages:v Chinese (Simplified)v Portuguese (Brazil)

The reports that are exported to PDF or Excel show TimePeriod string in Englishand not in the selected supported language.

Chapter 2. Known problems and solutions 5

Operation type is unclear for UDP Jitter and VoIP Jitter linkSymptomsLink Info grid chart in Device Details and Interface Details reports does notdifferentiate the UDP Jitter and VOIP Jitter and displays them as Jitter only. Clickthe link to see the correct operation type from the drill-down Link Info report.

Voltage level data for ASR/Nexus type device is notstandardized with the unit used correctly

SymptomsIn the Cisco Device technology pack version 2.6.0.0, the voltage level (mId-87010)data for ASR/Nexus type of Cisco device contains data in two different units; AChas Volts and DC has milli Volts. When the data is aggregated into summary levelreports, the average of the data from both units is done without conversion to asingle unit. This issue results in incorrect data display on the Device Detailsdashboards for the device

Non-default DataView root context is not supportedSymptomsCurrently, the default DataView root context PV is hardcoded in the queries that areused for all widgets in Wireline use case. The non-default DataView root context isnot supported.

Custom Operations and Engineering Dashboards issuesA list of problems that might occur when you develop custom Operations andEngineering Dashboards.

Duplicate values in the title of the Badge widgetYou might see some duplication in the title of the badge widget in yourcustomized dashboards.

Colon for the value element in the badge widget JSON code causes a duplicationin 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- 234922432 "1 Gbps""ethernet0/5/7 Site: 3095-RNC422-53005016 " and you might see IF- 234922432"1 Gbps" "ethernet0/5/7 Site: 3095-RNC422-53005016 ": 3095-RNC422-53005016".

6 Troubleshooting Operations and Engineering Dashboards

Notices

This information was developed for products and services offered in the US. Thismaterial might be available from IBM in other languages. However, you may berequired to own a copy of the product or product version in that language in orderto access it.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785US

For license inquiries regarding double-byte character set (DBCS) information,contact the IBM Intellectual Property Department in your country or sendinquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer ofexpress or implied warranties in certain transactions, therefore, this statement maynot apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM websites are provided forconvenience only and do not in any manner serve as an endorsement of those

© Copyright IBM Corp. 2016, 2017 7

websites. The materials at those websites are not part of the materials for this IBMproduct and use of those websites is at your own risk.

IBM may use or distribute any of the information you provide in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785US

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 materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

The performance data discussed herein is presented as derived under specificoperating conditions. Actual results may vary.

The client examples cited are presented for illustrative purposes only. Actualperformance results may vary depending on specific configurations and operatingconditions.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

Statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subjectto change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to actual people or business enterprises is entirelycoincidental.

COPYRIGHT LICENSE:

8 Troubleshooting Operations and Engineering Dashboards

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. The sampleprograms are provided "AS IS", without warranty of any kind. IBM shall not beliable 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 mustinclude 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_.

TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational 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 andtrademark information" at www.ibm.com/legal/copytrade.shtml.

Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registeredtrademarks 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 andTelecommunications Agency which is now part of the Office of GovernmentCommerce.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks orregistered trademarks of Intel Corporation or its subsidiaries in the United Statesand other countries.

Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both

Microsoft and Windows are trademarks of Microsoft Corporation in the UnitedStates, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of TheMinister for the Cabinet Office, and is registered in the U.S. Patent and TrademarkOffice.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Notices 9

Java and all Java-based trademarks and logosare trademarks or registered trademarks ofOracle and/or its affiliates.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in theUnited States, other countries, or both and is used under license therefrom.

Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo aretrademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.

Terms and conditions for product documentationPermissions for the use of these publications are granted subject to the followingterms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the IBMwebsite.

Personal use

You may reproduce these publications for your personal, noncommercial useprovided that all proprietary notices are preserved. You may not distribute, displayor make derivative work of these publications, or any portion thereof, without theexpress consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within yourenterprise provided that all proprietary notices are preserved. You may not makederivative works of these publications, or reproduce, distribute or display thesepublications or any portion thereof outside your enterprise, without the expressconsent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses orrights are granted, either express or implied, to the publications or anyinformation, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in itsdiscretion, the use of the publications is detrimental to its interest or, asdetermined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in fullcompliance with all applicable laws and regulations, including all United Statesexport laws and regulations.

10 Troubleshooting Operations and Engineering Dashboards

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESEPUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUTWARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDINGBUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY,NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Notices 11

12 Troubleshooting Operations and Engineering Dashboards

IBM®

Printed in USA