190 likes | 349 Views
SNMP Adapters and integration with TEC. Mike Hau, GRT EMEA haum@uk.ibm.com March 2005. TEC and SNMP Adapter(s). Agenda Introduction SNMP Adapter TEC related data Netview Integration. SNMP Adapters. Introduction
E N D
SNMP Adapters and integration with TEC Mike Hau, GRT EMEA haum@uk.ibm.com March 2005
TEC and SNMP Adapter(s) Agenda • Introduction • SNMP Adapter • TEC related data • Netview Integration
SNMP Adapters Introduction • Serves the function of collecting SNMP trap messages directly from the SNMP trap socket of a host and translating SNMP traps into appropriate IBM Tivoli Enterprise Console class instances. • Captures another source of data for monitoring • Network switches, applications, etc • Installable as TME and non-TME • Listens on default port (udp/162) on host machine • Only conforms to SNMPv1 (RFC 1157) definitions
MN oserv GW send_event upcall net_send tec MN oserv Endpoint TME Adapter event flow stub
SNMP Adapter architecture • Files installed as per normal adapter structure: • …/bin for binary and script files • init_tecad_snmp • tecad_snmp • …/etc for configuration files • tecad_snmp.cds • tecad_snmp.conf • tecad_snmp.err • tecad_snmp.oid
SNMP Adapter architecture • Other support files: • tecad_snmp.cfg part of the installation runtime • tecad_snmp.baroc TEC class definitions
SNMP Adapter Configuration options • Specific to the adapter in tecad_snmp.conf file: • AdapterSpecificFile=<path_to_OID_file> • SNMP_PORT • SNMP_TRAP • Other options • As documented in the Adapters Guide Chapter 1
SNMP Adapter Filtering • Very specific SNMP trap definitions • Not required unless ‘root’ (SNMP_Trap) class
adapter is not receiving events start adapter in debug mode see event correctly received on screen? no generate events for adapter yes wtdumprl: examine: config file lcfd.log gatelog wtrace odstat view parsing messages, etc. and use rule tracing if necessary. see event? no yes Adapter Troubleshooting
SNMP Adapter Diagnostic Mode • tecad_snmp starts the diagnostic • arguments: • -d shows diagnostic information • -c ConfigFile (full path) • Use snmp tool to generate events, eg snmptrap, wsnmptrap
SNMP Adapter - troubleshooting Usage of the tecad_snmp.err file • Trace different phases of the adapter engine
Selective Error Logging • The adapter has a tecad_snmp.err file that selectively configures the built-in logging. • (top of file) # # Format of a Line: # MODULE SEVERITY LOGFILE # # # MODULE Names for TEC Agents # =========================== # # ERROR for error functions # UTILS for utility functions # PARSER for parser part # KERNEL for general kernel operations # SELECT for selection process # FETCH for fetch process # MAP for mapping process # DRIVER for driver common part # DRVSPEC for driver specific part (SNMP, SNM, ...) # TECIO for T/EC server I/O # # Severity Levels: # ================ # # Errors: # # MINOR # MAJOR # FATAL # # Tracing: # # LOW # NORMAL # VERBOSE # # # MODULE = ERROR # ERROR MINOR /dev/null ERROR MAJOR /dev/null ERROR FATAL /dev/null change those options desired to a filepath
SNMP Adapter - troubleshooting Usage of the tecad_snmp.conf file • Use TestMode=YES • ServerLocation=<filename>
SNMP Adapter - development • Modify tecad_snmp.cds • Update tecad_snmp.oid • Use conversion tools to convert SNMP traps to baroc definitions • Test using steps as above • NOTE: Only SNMPV1 oid definitions are valid
TEC related data • tecad_snmp.baroc • Already part of the default rulebase • No rules!
Netview Integration • Part of the ACP component (nv6k adapter) • Configure via ACP profile • Supports SNMPv1 and SNMPv2 • Provides SCE/ZCE capabilities • Rules in default rulebase (part of e-business solution)
nvserverd EIF/NV6K SBC EIF TEC Server or Gateway SBC Buffer EIF Buffer Netview Integration Netview event flow