Example of configuring interface-matching filters

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.
    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.