SNMP - Simple Network Management Protocol
http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol
1. In the management process two types of data are being used:
- OID (http://en.wikipedia.org/wiki/OID); a standardized, tree-structured registry of devices and manufacturers, available at http://www.oid-info.com .
In the case of a 3ware product the OID is 1.3.6.1.4.1.1458, which is assembled as follows:
iso(1)
identified-organization(3)
dod(6)
internet(1)
private(4)
enterprise(1)
3ware(1458)
Here, the OID ends with 1458, standing for the manufacturer 3ware.
- MIB (http://en.wikipedia.org/wiki/Management_Information_Base) is a formal record of objects describing a particular device, and is provided by its manufacturer. For 3ware, it is provided (along with SNMP agents) at http://www.3ware.com/KB/article.aspx?id=10438 .
2. SNMP messages supported by our product:
- Get
3. SNMP agent tools
The snmpwalk agent is a free tool for downloading and displaying values from the SNMP information tree. Here's an example of a command for a password-protected user account in our product:
snmpwalk -v 3 -u "statistics" -a MD5 -A "password" -x DES -X "password" -l authpriv 192.168.XXX.XXX 1.3.6.1.4.1.1458.100 -m MIB:AMCC-RAID-MIB
legend:
-v - SNMP protocol version
-u - user name
-a - authentication protocol (MD5|SHA)
-A - authentication protocol pass phrase
-x - privacy protocol (DES|AES)
-X - privacy protocol pass phrase
-l - security level (noAuthNoPriv|authNoPriv|authPriv)
-m - MIB definition name (including ALL)
4. Troubleshooting
Customers who encounter issues with retrieval of adapter information and receive it in numerical form, i.e.:
iso.3.6.1.4.1.1458.100.1.0 = STRING: "AMCC RAID SNMP Agent Version
1.00.00.009A"
iso.3.6.1.4.1.1458.100.2.0 = STRING: "2.04.00.003"
iso.3.6.1.4.1.1458.100.3.0 = Gauge32: 1
iso.3.6.1.4.1.1458.100.20.1.2.1 = Gauge32: 7
iso.3.6.1.4.1.1458.100.20.1.3.1 = STRING: "9550SX-4LP"
...
are most likely missing the MIB definition, and need to install it on their SNMP agent. For AMCC chipsets from 3ware, the MIB definition can be found in the AMCC-RAID-MIB.txt file provided by the manufacturer (available at http://www.3ware.com/KB/article.aspx?id=10438).
Translated via the MIB, the information takes the following form:
AMCC-RAID-MIB::amccRaidAgentVersion.0 = STRING: "AMCC RAID SNMP Agent
Version 1.00.00.009A"
AMCC-RAID-MIB::amccRaidAPIVersion.0 = STRING: "2.04.00.003"
AMCC-RAID-MIB::amccRaidNumOfControllers.0 = Gauge32: 1
AMCC-RAID-MIB::amccRaidControllerNumber.1 = Gauge32: 7
AMCC-RAID-MIB::amccRaidModel.1 = STRING: "9550SX-4LP"
AMCC-RAID-MIB::amccRaidArchitectureId.1 = INTEGER: 6
AMCC-RAID-MIB::amccRaidSerialNumber.1 = STRING: "L20904A5280029"
AMCC-RAID-MIB::amccRaidPCBRevisions.1 = STRING: "Rev 032"
AMCC-RAID-MIB::amccRaidChipVersions.1 = STRING:
"A-Chip=1.70&P-Chip=1.60"
AMCC-RAID-MIB::amccRaidFirmwareVersion.1 = STRING: "FE9X 3.01.00.028"
AMCC-RAID-MIB::amccRaidDriverVersion.1 = STRING: "2.26.08.004-2.6.26"
AMCC-RAID-MIB::amccRaidNumberOfPorts.1 = Gauge32: 4
AMCC-RAID-MIB::amccRaidNumberOfDrives.1 = Gauge32: 1
AMCC-RAID-MIB::amccRaidNumberOfUnits.1 = Gauge32: 1
AMCC-RAID-MIB::amccRaidNumberOfEnclosures.1 = Gauge32: 0
AMCC-RAID-MIB::amccRaidBackgroundRebuildRate.1 = INTEGER: 1
AMCC-RAID-MIB::amccRaidRebuildScheduleState.1 = INTEGER: DriverLoad(2)
AMCC-RAID-MIB::amccRaidBackgroundVerifyRate.1 = INTEGER: 1
...
5. Security
Below are links to resources pertaining to SNMP security and configuration:
http://www.cert.org/tech_tips/snmp_faq.html
http://www.comsoc.org/livepubs/surveys/public/4q98issue/stallings.html
6. Information sources:
http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol
http://en.wikipedia.org/wiki/OID
http://www.net-snmp.org/
http://www.3ware.com/KB/article.aspx?id=10438
