Mapping Files
When the Master Agent passes a Get-request to the SNMP Adapter for WBEM, the Adapter uses the mapping files in /var/sadm/wbem/snmp/map to translate the Get-request into a CIM object request. The Solaris operating environment includes a mapping file for you in this directory. You can also define your own mapping file for the CIM instrumentation that you want to view through an SNMP Manager.
This section shows the contents of a mapping file that the Solaris environment provides, and describes what you need to know to create an Adapter mapping file.
Contents of the Mapping File That Is Included in Solaris
This example shows the contents of the mapping file that the Solaris operating environment includes for you:
# #pragma ident "@(#)050SUNWwbcou.map 1.0 01/04/03 SMI" # # Copyright (c) 2001 by Sun Microsystems, Inc. # All rights reserved. # # *** Description of contents *** # # First non-commented non-blank line contains required Version label. # Remaining non-commented non-blank lines are considered map entries # used as described below: # # Column 1 - SNMP OID - Uniquely describes an SNMP variable # Column 2 - CIM Class Name - CIM class associated with this variable # Column 3 - CIM Property Name - CIM property that maps to SNMP OID variable # Column 4 - ASN.1 type - SNMP datatype that dictates how data is mapped # to/from SNMP requests. Supported types are: SnmpString, SnmpOid, # SnmpTimeticks, SnmpCounter, SnmpInt, SnmpGauge, SnmpIpAddress, # SnmpOpaque) # Column 5 and greater are ignored # Version 1.0 1.3.6.1.2.1.1.1.0 Solaris_ComputerSystem Description SnmpString 1.3.6.1.2.1.1.3.0 Solaris_OperatingSystem LastBootUpTime SnmpTimeticks 1.3.6.1.2.1.1.4.0 Solaris_ComputerSystem PrimaryOwnerContact SnmpString 1.3.6.1.2.1.1.5.0 Solaris_ComputerSystem Name SnmpString 1.3.6.1.2.1.25.1.5.0 Solaris_OperatingSystem NumberOfUsers SnmpGauge 1.3.6.1.2.1.25.1.6.0 Solaris_OperatingSystem NumberOfProcesses SnmpGauge 1.3.6.1.2.1.25.1.7.0 Solaris_OperatingSystem MaxNumberOfProcesses SnmpGauge 1.3.6.1.2.1.25.1.2.0 Solaris_OperatingSystem LocalDateTime SnmpString |
The contents of this mapping file associate the SNMP MIB-2 System Group scalar objects with their corresponding CIM objects.
|
MIB-2 System Group Scalar Object |
CIM Object |
|---|---|
|
sysDescr |
Solaris_ComputerSystem.Description |
|
sysUpTime |
Solaris_OperatingSystem.LastBootUpTime |
|
sysContact |
Solaris_ComputerSystem.PrimaryOwnerContact |
|
sysName |
Solaris_ComputerSystem.Name |
The contents of this mapping file also associate the SNMP Host Resources MIB objects with their corresponding CIM objects.
|
SNMP Host Resources MIB Object |
CIM Object |
|---|---|
|
hrSystemNumUsers |
Solaris_OperatingSystem.NumberOfUsers |
|
hrSystemProcesses |
Solaris_OperatingSystem.NumberOfProcesses |
|
hrSystemMaxProcesses |
Solaris_OperatingSystem.MaxNumberOfProcesses |
|
hrSystemDate |
Solaris_OperatingSystem.LocalDateTime |
The syntax of the contents of a mapping file is described in Syntax of the Contents of a Mapping File.
Note –
At present, the only way to retrieve host resource data is through the CIM Object Manager, as Solaris does not currently provide an SNMP Host Resource agent.
Syntax of a Mapping File Name
To ensure that the Adapter reads your mapping file, name the file according to this syntax:
alphanumeric-string.map
alphanumeric-string represents an alphanumeric string. For example, here is the name of the mapping file that Solaris includes:
050SUNWwbcou.map
You include the three digits to ensure that the Adapter reads the files in a more precise order. For example, 002SUNWlvma.map is read before 050SUNWwbcou.map.
Note –
You must allow root to at least read the mapping files that you create.
$ chmod 400 002SUNWlvma.map
Syntax of the Contents of a Mapping File
The following table describes the elements and the syntax of the contents of a mapping file.
Table 3–1 Contents of a Mapping File
- © 2010, Oracle Corporation and/or its affiliates