Querying Dynamic MAC Addresses on S Series Switches Through MIB

This document describes how to use MIB to query dynamic MAC addresses learned by S series switches. This document uses the MIB browser as the NMS software to illustrate the operations. If you use other NMS software, refer to documentation of the specified software. Please download and install the MIB Browser tool yourself.

The operations described in this document are performed in the lab environment and apply to all versions of S series switches.

hwDynMacAddrQueryTable in the Huawei-specific MIB HUAWEI-L2MAM-MIB allows users to query dynamic MAC address entries on switches based on specified conditions. The first 11 objects are table indexes, and the remaining objects specify information about a MAC address table in hwDynMacAddrQueryTable.

Table 1-1 describes the rules for setting the values in hwDynMacAddrQueryConditionMode.

• MIB Browser has been installed and the compiled HUAWEI-L2MAM-MIB file has been loaded.
• MIB Browser has been connected to an S series switch which uses SNMPv2c or SNMPv3.
• When MIB Browser is used to connect to an S series switch, Get Bulk parameters have been set according to Figure 1-1. Among the Get Bulk parameters, Non repeaters has been set to 0, and Max repetitions has been set to 1, indicating that one MAC address entry can be obtained in a Get Bulk operation. To query multiple MAC address entries at a time, set this parameter to a larger value. For example, to obtain 10 MAC address entries at a time, set Max repetitions to 10.
  Figure 1-1 Get Bulk parameter settings
  

1. Right-click hwDynMacAddrQueryEntry and choose Multiple Variable Bindings > Prompt For Instance... from the shortcut menu, as shown in Figure 1-2.
   Figure 1-2 Selecting Prompt For Instance...
   

2. In the displayed dialog box, set the index for querying dynamic MAC address entries based on the VLAN ID 107, that is 0.1.48.1.48.0.0.0.0.0.0.0.8.1.48.1.48.107.0.0, as shown in Figure 1-3.
   Figure 1-3 Index for querying dynamic MAC address entries based on a VLAN ID
   

   The following describes the index from the leftmost digit to the rightmost digit:

   1. 0: indicates the hwDynMacAddrQueryVlanId object, which is not used. The value is set to the default value 0 of the integer type.
   2. 1.48: indicates the hwDynMacAddrQueryVsiName object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of the character string 0.
   3. 1.48: indicates the hwDynMacAddrQuerySiName object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   4. 0: indicates the hwDynMacAddrQueryBridgeId object, which is not used. The value is set to the default value 0 of the integer type.
   5. 0.0.0.0.0.0: indicates the hwDynMacAddrQueryMacAddr object, which is not used. The value is set to the default value 0 of the integer type.
   6. 8: indicates the hwDynMacAddrQueryConditionMode object. The value is set to 8, indicating showbyvlan.
   7. 1.48 indicates the hwDynMacAddrQueryConditionStringA object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   8. 1.48: indicates the hwDynMacAddrQueryConditionStringB object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   9. 107: indicates the hwDynMacAddrQueryConditionDigitA object. The value is set to 107, indicating VLAN 107.
   10. 0.0: indicates the hwDynMacAddrQueryConditionDigitB and hwDynMacAddrQueryConditionDigitC objects, respectively. They are not used and are set to the default value 0 of the integer type.

3. Click OK. A query dialog box is displayed, as shown in Figure 1-4.
   Figure 1-4 Dialog box for querying dynamic MAC address entries based on a VLAN ID
   

4. Modify the objects in Figure 1-4 as follows:
   • Change the operation from Get to Get Bulk.
   • Delete the 11 index objects because they cannot be queried.
   • Delete unnecessary objects. For example, if only the type and interface index of the MAC address table need to be queried, delete objects other than hwDynMacAddrQueryType and hwDynMacAddrQueryIfIndex in the dialog box.
   The objects after modification are shown in Figure 1-5.

   Figure 1-5 Modified objects
   

5. Click Get Bulk to query the dynamic MAC address entry with the VLAN ID 107. Figure 1-6 shows a dynamic MAC address entry. The VLAN ID of the dynamic MAC address entry is 107, the MAC address is 0.0.0.0.1.2 (0000-0000-0102), the type is dynamic, and the interface index is 4899.
   To obtain the interface name based on the interface index, see step 6.

   Figure 1-6 Queried MAC address entry
   

   The number of MAC address entries obtained each time by clicking Get Bulk is determined by the Max repetitions parameter. For details, see Figure 1-1.

   Click Get Bulk multiple times to query all dynamic MAC entries with the VLAN ID 107. When information about other objects is displayed in the query result, the query of dynamic MAC address entries based on a VLAN ID is complete.

6. Perform the following operations to obtain an interface name specified in a MAC address entry based on an interface index using ifTable in IF-MIB.
   1. Right-click ifDescr and choose Multiple Variable Bindings > Prompt For Instance... from the shortcut menu, as shown in Figure 1-7.
      Figure 1-7 Selecting ifDescr
      
   2. In the displayed dialog box, set the interface index 4899, as shown in Figure 1-8.
      Figure 1-8 Setting an interface index
      
   3. Click OK. A query dialog box is displayed, as shown in Figure 1-9.
      Figure 1-9 Dialog box for querying an interface name using an interface index
      
   4. Click Get to query the interface name corresponding to the interface index 4899, as shown in Figure 1-10. According to the query result, the interface name corresponding to the interface index 4899 is GigabitEthernet1/0/12.
      Figure 1-10 Interface name query result
      

The procedure for querying dynamic MAC addresses learned by an S series switch based on an interface name is similar to that for querying dynamic MAC addresses learned by an S series switch based on a VLAN ID. You only need to change the index entered in step 2.

The following describes how to query the dynamic MAC addresses learned by GE1/0/12.

1. Obtain the interface index corresponding to the interface according to ifTable in IF-MIB.
   Right-click ifDescr and choose Walk from the shortcut menu to obtain all interface names on a switch, as shown in Figure 1-11. The command output shows that the interface index of GE1/0/12 is 4899.

   Figure 1-11 Obtaining the interface index
   

2. Change the index value to be entered in step 2 based on the index format. The index for querying dynamic MAC address learned by GE1/0/12 is 0.1.48.1.48.0.0.0.0.0.0.0.9.1.48.1.48.0.4899.0. as shown in Figure 1-12.
   Figure 1-12 Query dynamic MAC address entries based on an interface index
   

   The following describes the index from the leftmost digit to the rightmost digit:

   1. 0: indicates the hwDynMacAddrQueryVlanId object, which is not used. The value is set to the default value 0 of the integer type.
   2. 1.48: indicates the hwDynMacAddrQueryVsiName object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of the character string 0.
   3. 1.48: indicates the hwDynMacAddrQuerySiName object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   4. 0: indicates the hwDynMacAddrQueryBridgeId object, which is not used. The value is set to the default value 0 of the integer type.
   5. 0.0.0.0.0.0: indicates the hwDynMacAddrQueryMacAddr object, which is not used. The value is set to the default value 0 of the integer type.
   6. 9: indicates the hwDynMacAddrQueryConditionMode object. The value is set to 9, indicating showbyport.
   7. 1.48 indicates the hwDynMacAddrQueryConditionStringA object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   8. 1.48: indicates the hwDynMacAddrQueryConditionStringB object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   9. 0: indicates the hwDynMacAddrQueryConditionDigitA object, which is not used. The value is set to the default value 0 of the integer type.
   10. 4899: indicates the hwDynMacAddrQueryConditionDigitB object. The value is set to 4899, indicating the interface index.
   11. 0: indicates the hwDynMacAddrQueryConditionDigitC object, which is not used. The value is set to the default value 0 of the integer type.

The procedure for querying dynamic MAC addresses learned by an S series switch based on a VLAN ID and an interface name is similar to that for querying dynamic MAC addresses learned by an S series switch based on a VLAN ID. You only need to change the index entered in step 2.

The following describes how to query dynamic MAC address entries learned by GE1/0/12 in VLAN 107.

1. Obtain the interface index corresponding to the interface according to ifTable in IF-MIB.
   Right-click ifDescr and choose Walk from the shortcut menu to obtain all interface names on a switch, as shown in Figure 1-13. The command output shows that the interface index of GE1/0/12 is 4899.

   Figure 1-13 Obtaining the interface index
   

2. Change the index value to be entered in step 2 based on the index format. The index for querying dynamic MAC address entries learned by GE1/0/12 in VLAN 107 is 0.1.48.1.48.0.0.0.0.0.0.0.10.1.48.1.48.107.4899.0, as shown in Figure 1-14.
   Figure 1-14 Querying dynamic MAC address entries based on a VLAN ID and an interface name
   

   The following describes the index from the leftmost digit to the rightmost digit:

   1. 0: indicates the hwDynMacAddrQueryVlanId object, which is not used. The value is set to the default value 0 of the integer type.
   2. 1.48: indicates the hwDynMacAddrQueryVsiName object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of the character string 0.
   3. 1.48: indicates the hwDynMacAddrQuerySiName object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   4. 0: indicates the hwDynMacAddrQueryBridgeId object, which is not used. The value is set to the default value 0 of the integer type.
   5. 0.0.0.0.0.0: indicates the hwDynMacAddrQueryMacAddr object, which is not used. The value is set to the default value 0 of the integer type.
   6. 10: indicates thehwDynMacAddrQueryConditionMode object. The value is set to 10, indicating showbyportvlan.
   7. 1.48 indicates the hwDynMacAddrQueryConditionStringA object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   8. 1.48: indicates the hwDynMacAddrQueryConditionStringB object, which is not used. The value is set to the default value 0 of the character string type, which is expressed as 1.48 in the index. The value 1 indicates the length of the character string, and the value 48 indicates the ASCII code of character string 0.
   9. 107: indicates the hwDynMacAddrQueryConditionDigitA object. The value is set to 107, indicating the VLAN ID.
   10. 4899: indicates the hwDynMacAddrQueryConditionDigitB object. The value is set to 4899, indicating the interface index.
   11. 0: indicates the hwDynMacAddrQueryConditionDigitC object, which is not used. The value is set to the default value 0 of the integer type.

For more information, see the following documents:

• Obtain and load the MIB file
• Querying the Mapping Between MAC Addresses and Interfaces
• MIB Reference