This section presents an example of configuring interface-matching filters that will exclude any interface that has “Ethernet” in its description during the discovery of an Adtran Atlas 830 Router device, which has a sysObjectID of .1.3.6.1.4.1.664.1.430.

Be aware that your matching patterns and the retrieved interface descriptions are not case-sensitive because the IP Manager transforms both of them to uppercase letters before comparing them with one another.

To configure the interface-matching filters for the Adtran Atlas 830 Router device:

  1. Perform a MIB walk of the device to obtain a list of interfaces for the device.

  2. Inspect the interfaces and attempt to form a matching pattern for the interfaces that you want to exclude from the discovered topology.

    For example, look at their IfType (.1.3.6.1.2.1.2.2.1.3) values and ifDescr (.1.3.6.1.2.1.2.2.1.2) values and determine if the interfaces that you want to exclude all have the same type or all have the same string in their descriptions.

    In this procedure, the matching pattern “~*Ethernet*” will be used, a pattern that appears in interface ifDescr descriptions such as “Ethernet0” and “FastEthernet1/0.”

  3. To obtain the values (interface-matching patterns) for the device, go to the BASEDIR/smarts/bin directory of the IP Manager installation area and type the following commands:

                   dmctl “s <
               
                  IP Manager
               
                instance name
               > invoke 
               
                  ICF_TopologyManager::ICF-TopologyManager findParameter 
               
                     IFIndexPattern-.1.3.6.1.4.1.664.1.430
               dmctl “s <
               
                  IP Manager
               
                instance name>
                invoke 
               
                  ICF_TopologyManager::ICF-TopologyManager findParameter 
               
                     IFDescrPattern-.1.3.6.1.4.1.664.1.430
               dmctl “s <
               
                  IP Manager
               
                instance name
               > invoke 
               
                  ICF_TopologyManager::ICF-TopologyManager findParameter 
               
                     IFTypePattern-.1.3.6.1.4.1.664.1.430

  4. Whatever values you start with (the default values or the values obtained from the dmctl commands), change those values to exclude the interfaces that have “Ethernet” in their descriptions.

    The following values will be used in this example:

    • IFIndexPattern-.1.3.6.1.4.1.664.1.430 ~*

      • IFDescrPattern-.1.3.6.1.4.1.664.1.430 ~*Ethernet*

      • IFTypePattern-.1.3.6.1.4.1.664.1.430 ~*

        No interface descriptions can match the “~*” value, and only interface descriptions that do not contain the string “Ethernet” can match the “~*Ethernet*” value.

  5. Type the following command to open the tpmgr-param.conf file:

                   sm_edit conf/discovery/tpmgr-param.conf

  6. Add the following two lines to the file:

    IFDescrPattern-.1.3.6.1.4.1.664.1.430 ~*Ethernet*
IFTypePattern-.1.3.6.1.4.1.664.1.430 ~*

  7. Save and close the file.

    The modified version of the tpmgr-param.conf file is saved to the BASEDIR/smarts/local/conf/discovery directory.

  8. To force the ICF-TopologyManager to read the tpmgr-param.conf file, type the following command:

                   sm_tpmgr -s <
               
                  IP Manager
               
                instance name
               > --load-conf=tpmgr-param.conf

  9. To confirm that your configuration has been read by the ICF-TopologyManager, type the following commands:

                   dmctl -s <
               
                  IP Manager
               
                instance name
               > invoke 
               
                  ICF_TopologyManager::ICF-TopologyManager findParameter 
               
                    IFDescrPattern-.1.3.6.1.4.1.664.1.430
               dmctl -s <
               
                  IP Manager
               
                instance name>
                invoke 
               
                  ICF_TopologyManager::ICF-TopologyManager findParameter 
               
                     IFTypePattern-.1.3.6.1.4.1.664.1.430

  10. Examine the returned values and confirm that they are the same ones added to the tpmgr-param.conf file in step 6.

    Note:

    The following steps verify that the interface-matching filters are configured properly.

  11. Attach the Domain Manager Administration Console to the IP Manager.

    Instructions for opening the Domain Manager Administration Console are presented in Chapter 3, “Opening the Global Console in the section “Opening the Global Console” on page 16.

  12. Delete every instance of the Adtran Atlas 830 Router device in the topology tree. To delete a device, right-click its name and select Delete.

    When you delete a device, all of its components (including interfaces) and all of its connections are also deleted.

  13. Rediscover the device by selecting Topology > Add Agent and specifying the hostname or IP address of the device. Or create a seed file and import it by using Topology > Import from seed file.

  14. Expand the Router class in the topology tree to see the Adtran Atlas 830 Router instances that the IP Manager just rediscovered.

  15. Verify in the Attributes tab that the Description attribute does not contain the “Ethernet” string.