Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

About the Topology Filter Page

To access this page, click Configuration > Network Settings > Topology Filter.

The topology filter service allows you to limit the nodes appearing in your topology map to a subset of the nodes in your network. This capability is important when your network contains more nodes than your license covers and you want to control which nodes are recognized. You might also want to filter out nodes that are not important for traffic engineering management such as aggregation layer nodes or route reflectors.

The topology filter is available only in installations utilizing BGP Monitoring Protocol (BMP) for the topology acquisition method. The topology filter is added to the BMP messaging pipeline between the BMP monitor and the topology server.

Filtering the topology involves creating a set of rules. Each rule consists of the field (Condition Field) to search on, the value (Condition Value) to look for, the Condition Type to be applied (match or regular expression) and the Action to be taken if the value is a match. The rules are automatically applied in a sequence to the topology map. Once a node is matched based on the rule, it cannot be matched by a subsequent rule. The highest rule or the rule at the top of the list of topology filter rules, controls this decision. For example, once a decision is made about the node (accept or reject), it will not change even if a rule below in the list provides the opposite result. The topology filter service checks links and removes links that involve an rejected node, even if the rejected node is reporting information to the traffic engineering database.

Enable the Topology Filter Service

Before using the topology filter in the UI, you must first enable the topology filter service by modifying the configuration file.

You must modify the BMP host and port values in the northstar-config configuration map file using a text editing tool such as vi.

To enable the topology filter service:

  1. Log in to the Paragon Automation primary node.

  2. Edit the northstar-config file by executing

  3. Set the following parameters:

    • (Default is bmp-grpc which is the bmpMonitor endpoint.)

    • (Default is 10002.)

  4. Save the northstar-config file and exit.

    All the pods using this configuration file are restarted automatically.

    Note:

    You can confirm if the status of the services are up by executing:

Tasks You Can Perform

You can perform the following tasks from this page:

  • View the existing the topology filters rules. For more details, click More > Detail or click the Details icon. The Result Of Applied Filters page appears.

  • Add a topology filter rule. See Add a Topology Filter Rule.

  • Edit a topology filter rule. See Edit a Topology Filter Rule.

  • Delete a topology filter rule. See Delete a Topology Filter Rule.

  • View detailed information about the topology filter rule by clicking the details icon that appears when you hover over the filter rule or select More > View Details. A Result of Applied Filters page appears on the right displaying the filter rule details.

  • Export all the topology filter rules to a CSV file by clicking More > Export Rules.

  • Import topology filter rules from a CSV file by clicking More > Import Rules. On the Import Filter Rule page, click Browse and select the CSV file that you want to import. Click OK.

    The Filter Rules table is updated with the new topology filter rules from the CSV file.

    Note:

    If you have multiple rules to add, we recommend that you:

    1. Export the current topology rules to a CSV file.

    2. Update that CSV file with the new rules.

    3. Import the updated CSV file.

  • Show/Hide Columns: Choose to show or hide a specific column in the Filter Rules table.

    Hover over the More Options (vertical ellipses) > Show/Hide Columns and select the Column-Name check box of the column you want to display in the table.

Field Descriptions

Table 1: Fields on Topology Filter Page

Field

Description

Condition

Select one of the following fields as a condition for filtering a node:

  • hostname

  • router-id

  • sys-id

Type

Type of value to be matched. You can select either text or regular expression to match the condition.

Value

Value to be matched.

Action

Action to be performed when the condition value matches the condition set. You can select either Accept or Reject.

If you select:
  • Accept—Nodes matching the condition are displayed on the topology map.

  • Reject—Nodes not matching the condition are not displayed on the topology map.