Question & Answer
Question
Would you like a tool that automates the collection of troubleshooting data for ITNM, instead of manually trying to find, format, group, and collect what Support needs to remotely diagnose your problem ?
Answer
This is the MustGather document for the IBM Tivoli Network Manager IP(ITNM) product, including the TIP and TCR. The attached "itnm_data.pl" utility knows how to format and collect the data files that IBM Support need in order to diagnose problems with the ITNM product.
Introduction to itnm_data.pl
The itnm_data.pl utility was created to assist you with gathering the information necessary to troubleshoot IBM Tivoli Network Manager issues.
This utility may capture the following information, based on the collection type:
Environmental(OS, ulimits, hardware specs)
Version information
Logs and traces(ITNM/TIP/TCR as necessary)
Configuration files
Disco agents/stitchers
Poller status/targets/policies
Disco/Model cache
Network Views
Instructions for Use
There are two types of command line flags that will affect what is collected via itnm_data.pl. The first type of flags are used to indicate what kind of collection is being done. If you are unsure of which collection to use, use the general(-g) collection and if needed, support will request a more specific collection later. You can only use one collection type per run.
The collection types are:
-e Reporting(BIRT/Cognos)
-d Discovery
-g General
-i Install
-p Polling
-t ITM Agent
-r RCA
-u GUI(TIP)
-dc Disco Cache
-mc Model Cache
The next set of flags will make specific modifications to the data being collected:
-o output directory(/tmp by default)
-x skip $NCHOME/log/precision directory
-c collect core files(could be large)
-f automatically FTP the file to IBM(-pmr required)
-pmr PMR Number(in xxxxx,xxx,xxx format, used to name output file)
To run the script use:
ncp_perl $NCHOME/precision/scripts/perl/scripts/itnm_data.pl -domain DOMAINNAME
followed by the appropriate flags as documented above.
Providing the data to IBM
You can automatically send the data to IBM, if your machine has external(Internet) access, by using the -f and -pmr flags. Otherwise, you can use your normal method or the customer portal to upload the data once the file is created. When the script completes, it will alert you to where the file exists.
Downloading the itnm_data.pl package
IBM's recommended browser is Firefox. It is therefore recommended that you use Firefox to download the attached tar file. Chrome has also been tested with success.
WARNING: Experience has shown that Internet Explorer (IE) can corrupt the tar file during its download process, though this may depend on the version of IE being used ... sorry, no IE version details available.
Ensure you always FTP the tar package using binary mode. Un-tar on the system where it is to be used, preferably in the $NCHOME/precision/scripts/perl/scripts directory.
Click on the following icon link to download the latest version (v1.4.1) of the itnm_data.pl utility:
Introduction to itnm_data.pl
The itnm_data.pl utility was created to assist you with gathering the information necessary to troubleshoot IBM Tivoli Network Manager issues.
This utility may capture the following information, based on the collection type:
Environmental(OS, ulimits, hardware specs)
Version information
Logs and traces(ITNM/TIP/TCR as necessary)
Configuration files
Disco agents/stitchers
Poller status/targets/policies
Disco/Model cache
Network Views
Instructions for Use
There are two types of command line flags that will affect what is collected via itnm_data.pl. The first type of flags are used to indicate what kind of collection is being done. If you are unsure of which collection to use, use the general(-g) collection and if needed, support will request a more specific collection later. You can only use one collection type per run.
The collection types are:
-e Reporting(BIRT/Cognos)
-d Discovery
-g General
-i Install
-p Polling
-t ITM Agent
-r RCA
-u GUI(TIP)
-dc Disco Cache
-mc Model Cache
The next set of flags will make specific modifications to the data being collected:
-o output directory(/tmp by default)
-x skip $NCHOME/log/precision directory
-c collect core files(could be large)
-f automatically FTP the file to IBM(-pmr required)
-pmr PMR Number(in xxxxx,xxx,xxx format, used to name output file)
To run the script use:
ncp_perl $NCHOME/precision/scripts/perl/scripts/itnm_data.pl -domain DOMAINNAME
followed by the appropriate flags as documented above.
Providing the data to IBM
You can automatically send the data to IBM, if your machine has external(Internet) access, by using the -f and -pmr flags. Otherwise, you can use your normal method or the customer portal to upload the data once the file is created. When the script completes, it will alert you to where the file exists.
Downloading the itnm_data.pl package
IBM's recommended browser is Firefox. It is therefore recommended that you use Firefox to download the attached tar file. Chrome has also been tested with success.
WARNING: Experience has shown that Internet Explorer (IE) can corrupt the tar file during its download process, though this may depend on the version of IE being used ... sorry, no IE version details available.
Ensure you always FTP the tar package using binary mode. Un-tar on the system where it is to be used, preferably in the $NCHOME/precision/scripts/perl/scripts directory.
Click on the following icon link to download the latest version (v1.4.1) of the itnm_data.pl utility:
[{"Product":{"code":"SSSHRK","label":"Tivoli Network Manager IP Edition"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Not Applicable","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"3.9;4.1;4.1.1;4.2","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
12 August 2019
UID
swg21653437