Specify routing data manually

Relevant for: AFA Administrators

This topic explains how AFA administrators can manually change the device's routing data.

AFA compiles routing and topology data collected from each device into a unified routing table (URT) file, which stores the data in AFA's generic format. By default, this file automatically regenerates every time the device is monitored or analyzed.

AFA administrators can manually change the device's routing and topology data in two ways:

  • Static method: a static representation of the device is added to the URT file. Subsequently, AFA will not regenerate updated URT files for this device automatically. The administrator must manually update the URT file again for any configuration changes made.
  • Hybrid method: only the customized part of routing info (for example, additional interface or routes) are manually added to the URT file for the device. Subsequently, AFA will regenerate updated URT files for this device automatically.

For example, say a device has three interfaces (interfaces A, B, and C). The administrator manually adds a new interface, interface D to the URT.

Later in a configuration change, interface E is added to the device.

  • If interface D was added to the URT Using the Static method: to see interface E, the administrator must again manually update the URT file adding interface E.
  • If interface D was added to the URT Using the Hybrid method: when AFA regenerates updated URT files for this device, interface E appears automatically.

To specify routing data manually

Note: You can only specify routing data for AWS VPC and Transit Gateway from the map, see To specify routing data from the map

Specifying routing data manually for primary devices with sub-devices is done differently than for primary devices without secondary devices.

If sub-devices are defined in the URT file, specify routing data manually for each sub-device (not for the parent device). If the primary device has no secondary device, specify routing data manually for it directly.

Do the following:

  1. Access the Devices Setup page. For details, see Access the DEVICES SETUP page.

  2. From the tree on the left, select the device or sub-device you want to edit, and then click Edit on the right.

  3. In the Route Collection area, select Static Routing Table (URT).

  4. Do one of the following:

    • If you already have a URT defined that you want to edit, click Download current URT file.
    • To create a new URT file, click Download Sample file.

  5. Edit the file with the routing information you want to import. See an example for manually specifying routing information at How to manually specify routing information for Cisco Layer 2 devices in AlgoPedia..

  6. Again access the Devices Setup page. For details, see Access the DEVICES SETUP page.

  7. From the tree on the left, select the device or sub-device you want to edit, and then click Edit on the right.

  8. In the Route Collection area, select Static Routing Table (URT).

  9. Click Upload new file, and select the edited file.

    AFA validates your file, and notifies you if any syntax or content error is found.

  10. When complete, click OK.

The new routing table will take affect after the next device analysis.

To manually specify routing data in Hybrid mode for a device or sub-device:

Do the following:

  1. Create new URT files, edit an existing or edit a downloaded sample URT.

    1. Access the Devices Setup page. For details, see Access the DEVICES SETUP page.

    2. From the tree on the left, select any device and then click Edit on the right.

    3. In the Route Collection area, select Automatic.

    4. Click Download Sample file.

  1. For a single device with no sub-devices, on the URT, specify additional routes. When a device has sub-devices, make URT files for each sub-device and not for the parent device. Specify additional routes for the sub-device. See an example for manually specifying routing information at How to manually specify routing information for Cisco Layer 2 devices in AlgoPedia.
  2. Name the file(s) additionalRoutes.urt (make sure to name each URT file exactly as shown. The filename is case sensitive).
  3. Save the file(s) in the folder /home/afa/.fa/firewalls/<deviceTreeName> for a single device with no sub-devices or, when a device has sub-devices, save in each subfolder /home/afa/.fa/firewalls/<deviceTreeName>/<sub-device name>.
  4. Analyze the device. 

After the analysis/monitoring, the results of URT appear: topology is changed and URT shows on  the map.

To specify routing data from the map

This procedure describes how to specify routing data manually using the Static method directly from the map , instead of the Devices Setup page.

Do the following:

  1. In AFA, view the graphic network map. Click DEVICES, select a device, and then click MAP.

  2. Locate and right-click the device you want to edit, and select Routing Information.

    The Routing information dialog shows the current URT file. For example:

  3. Select Static Routing Table (URT), and then do one of the following:

    • If you already have a URT defined that you want to edit, click Download current URT file.
    • To create a new URT file, click Download Sample files.

  4. Edit the file with the routing information you want to import. See an example for manually specifying routing information at How to manually specify routing information for Cisco Layer 2 devices in AlgoPedia.

  5. Again access the Devices Setup page. For details, see Access the DEVICES SETUP page.

  6. From the tree on the left, select the device or sub-device you want to edit, and then click Edit on the right.
  7. In the Route Collection area, select Static Routing Table (URT).

  8. click Upload new file, and select the your edited file.

    AFA validates your file, and notifies you if any syntax or content error is found.

  9. When complete, click OK.

    The new routing table will take affect after the next device analysis.