Cisco CatOS
I started creating my own Cisco CatOS xml plugin based on the the snmp netscreen howto. I got much of the plugin working, but ran into some problems. Then I checked the existing Cisco IOS plugin from hyperic and borrowed what I needed.
There have been several revisions of this and so some of the mibs listed below may not be necessary for the plugin to work. But as of this version it calls on CISCO-PROCESS-MIB.my, CISCO-SMI.my, CISCO-TC.my, CISCO-MEMORY-POOL-MIB.my, CISCO-QOS-PIB-MIB.my, CISCO-VTP-MIB.my, ENTITY-MIB.my, TOKEN-RING-RMON-MIB.my, TOKEN-RING-RMON-MIB.my, FDDI-SMT73-MIB.my, and CISCO-STACK-MIB.my. You'll need to get them from cisco's website. A quick google search should turn them up. A good start would be ftp://ftp-sj.cisco.com/pub/mibs/supportlists/ They should be placed in /usr/share/snmp/mibs. Drop the attached .xml in the $HQ_INSTALL/hq-plugins dir (server and/or agent dirs should be at the same level as hq-plugins). I believe that the server and agent will automatically pickup the plugin if the hq-plugins dir already existed, but you might want to restart them both to be safe.
To add a device, just:
- add a new platform.
- For the "Name" enter whatever you want to identify the device.
- For the platform type, select "Cisco CatOS" (if this doesn't appear, you didn't install the plugin correctly and should consult hyperic's official documentation for troubleshooting).
- The "Agent Connection" can be any agent that you can snmpwalk the device.
- Enter in the "Fully Qualified Domain Name" as required.
- The "Ip Address" is the ip address of the Cisco device that the agent will be performing snmp queries on.
- Go down to "Configuration Properties" and click "Edit".
- The "snmpIp" is the same ip you entered before in the "IP Address" field.
- Enter in the "snmpCommunity" that is defined on your switch.
You should be good to go. Once in hyperic, it should start collecting metrics for the device after about 5 min or so. The default "monitor" tab for the new platform should show you some basic info about the device, cpu, and mem info. You should see the interfaces for the device by browsing to the new platform, clicking on "inventory" and then clicking on "devices". The availability lights should turn green also after about 5 min.
If you run into issues, check to make sure you can actually snmpwalk the agent that you're checking from.
# snmpwalk -Os -M /usr/share/snmp/mibs -m all -v2c -c SNMP_COMMUNITY SWITCH_IP_ADDRESS system # snmpwalk -Os -M /usr/share/snmp/mibs -m all -v2c -c SNMP_COMMUNITY SWITCH_IP_ADDRESS ifIndex
The only thing left is to add the "portName" OID to the description of each service (each interface). Please leave comments if worked or not for you...any feedback would be appreciated.