Preventive Service Planning
Abstract
MustGather documents aid in problem determination and save time resolving Problem Management Records (PMRs).
Content
Collecting MustGather data early, even before opening the PMR, helps IBM® Support quickly determine if:
Symptoms match known problems (rediscovery).
There is a non-defect problem that can be identified and resolved.
There is a defect that identifies a workaround to reduce severity.
Locating root cause can speed development of a code fix.
MustGather: Readme first table of contents:
| Gathering general information |
For IBM Tivoli Monitoring UNIX Agent v6 or later, you can use the IBM Support Assistant (ISA) to capture general information. Alternatively you can manually collect general information from the environment.
Entering general information into an electronically-opened PMR (SR) eliminates waiting on the phone to provide general information to Level 1 support.
Since the ITM UNIX Agent is enabled with default RAS (Reliability, Accessibility and Serviceability) settings. If you do not know what the problem is then collecting the general agent logs and configuration files are helpful to IBM Support in further isolating the problem. For these instances see the section on manually collecting information and send the data with the default trace settings.
| Gathering component specific information |
There are several components that can be involved in a problem with the UNIX Agent. This section will detail the common component areas and some trace settings that can be helpful in isolating issues related to the UNIX Agent. These trace settings are suggested but will not isolate every problem scenario. You can provide the logs with the default trace settings and IBM Support will review these logs and suggest additional trace settings based on information in the logs.
ITM UNIX Agent V6 and Related Components
UNIX Agent
|
Tivoli Enterprise Management Server (TEMS)
|
Tivoli Enterprise Portal Server (TEPS)
|
Once the component traces have been set and the components have been restarted, then recreate the problem and collect the logs.
| Collector Tool |
Once the you have collected the PD information with pdcollect, this information should be uploaded to IBM using the steps provided in this URL Exchanging information with IBM Technical Support.
| Manually gathering general information |
This section details how to manually collect information from a system running the UNIX Agent.
- From a command prompt collect this:
# export PATH=$PATH:$CANDLEHOME/bin
# cinfo -t > /tmp/itm61_ux_install.out
- Collect the UNIX Agent data
- $CANDLEHOME/logs/*ux*
- $CANDLEHOME/logs/*UX*
- $CANDLEHOME/config/ux*
| Additional information for the UNIX Agent |
- Operating system and level
- Hostname and IP address
- netstat -a
- Firewall configuration information (if applicable)
- Operating system error log messages (if applicable)
- AIX - errpt -a
- Solaris - /var/adm/messages*
| Submitting information to IBM Support |
If using SR, update the PMR to indicate that data has been sent. If you are using the IBM Support Assistant (ISA) tool then it will allow you to upload data to IBM Support.
| Related information |
IBM Tivoli Monitoring Problem Determination Guide
IBM Tivoli UNIX Agent User's Guide
Exchanging information with IBM Technical Support
| Change History |
Rate this page:
Average rating
Copyright and trademark information
IBM, the IBM logo and ibm.com are 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 www.ibm.com/legal/copytrade.shtml.