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:
- Perform a MIB walk of the device to obtain a list of interfaces for the device.
- 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.”
- To obtain the values (interface-matching patterns) for the device, go to the BASEDIR/smarts/bin directory of theIP Managerinstallation area and type the following commands:dmctl “s <IP Managerinstance name> invokeICF_TopologyManager::ICF-TopologyManager findParameterIFIndexPattern-.1.3.6.1.4.1.664.1.430dmctl “s <IP Managerinstance name>invokeICF_TopologyManager::ICF-TopologyManager findParameterIFDescrPattern-.1.3.6.1.4.1.664.1.430dmctl “s <IP Managerinstance name> invokeICF_TopologyManager::ICF-TopologyManager findParameterIFTypePattern-.1.3.6.1.4.1.664.1.430
- 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 donotcontain the string “Ethernet” can match the “~*Ethernet*” value.
- Type the following command to open the tpmgr-param.conf file:sm_edit conf/discovery/tpmgr-param.conf
- 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 ~*
- Save and close the file.The modified version of the tpmgr-param.conf file is saved to the BASEDIR/smarts/local/conf/discovery directory.
- To force the ICF-TopologyManager to read the tpmgr-param.conf file, type the following command:sm_tpmgr -s <IP Managerinstance name> --load-conf=tpmgr-param.conf
- To confirm that your configuration has been read by the ICF-TopologyManager, type the following commands:dmctl -s <IP Managerinstance name> invokeICF_TopologyManager::ICF-TopologyManager findParameterIFDescrPattern-.1.3.6.1.4.1.664.1.430dmctl -s <IP Managerinstance name>invokeICF_TopologyManager::ICF-TopologyManager findParameterIFTypePattern-.1.3.6.1.4.1.664.1.430
- 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.
- Attach the Domain Manager Administration Console to theIP 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.
- Delete every instance of the Adtran Atlas 830 Router device in the topology tree. To delete a device, right-click its name and selectDelete.When you delete a device, all of its components (including interfaces) and all of its connections are also deleted.
- Rediscover the device by selectingTopology>Add Agent and specifying the hostname or IP address of the device.Or create a seed file and import it by usingTopology>Import from seed file.
- Expand theRouterclass in the topology tree to see the Adtran Atlas 830 Router instances that theIP Managerjust rediscovered.
- Verify in theAttributestab that the Description attribute does not contain the “Ethernet” string.