IBM Enterprise Console manual Troubleshooting Adapters, Adapter Startup Errors, All Adapters

Troubleshooting Adapters

The following sections list troubleshooting guidelines for the different types of adapters.

Adapter Startup Errors

If the adapter fails to start, look in the /tmp directory for the tecadEH.log file. You might be able to learn why the adapter failed from reading this file. The following list shows examples of errors you might find in tecadEH.log:

tecad EH : error 2 invalid error config line: Normal

tecad EH : error 4 Init: Stat failed on error file </etc/tecad_hpov.err>

All Adapters

1.You receive a connection error when using wpostemsg or postemsg. The error indicates that you might be using a user ID other than Administrator or root. Thus, your ID does not have the correct permissions to create and write the file specified by the BufEvtPath keyword.

2.If the adapter receives the event and you can determine (through tracing or debugging) that the event matches the correct class, use the tracing output to verify if the event was sent to the event server, not sent, or cached. If the event was not sent to the event server, check the adapter configuration file to see if that class was filtered out.

3.If the event was sent to the event server, verify that the event server is actually running. Then run the wtdumprl command to check to see if the event server received the event but failed to parse the event correctly. Also check the current rule base rules to see if the event was dropped. See the IBM Tivoli Enterprise Console Reference Manual for more information about wtdumprl.

4.Check the cache files to see if the event was cached.

Managed Node Adapters

1.Use the tracing and debugging options detailed in each chapter. This helps determine if the adapter receives the event and how the adapter handles the event.

2.Use Tivoli Management Framework debugging output of the odstat and wtrace services. These services show what occurs after the adapter tries to send an event from the managed node oserv service to the IBM Tivoli Enterprise Console oserv services, and they also help debug problems that occur during Adapter Configuration Profile (ACP) distributions.

3.Use the managed node wpostemsg command from the system the adapter is running on to see if the event arrives at the event server. See the IBM Tivoli Enterprise Console Reference Manual for more information.

Endpoint Adapters

1.Use the wep ls command to make sure that the endpoint appears under the Tivoli Management Framework gateway you want. See the IBM Tivoli Enterprise Console Reference Manual for more information. Also make sure that any Tivoli Management Framework gateway the endpoint can log on to has ACF installed.

2.Source the endpoint environment and edit the last.cfg file in $LCF_DATDIR. Set log_threshold to 3 and then stop and restart the endpoint to enable endpoint tracing to the lcfd.log file. Check to make sure that the endpoint logged into an appropriate Tivoli Management Framework gateway.

Chapter 1. Understanding Adapters 21