: Configure the Cisco ACI Plugin
Focus
Focus

Configure the Cisco ACI Plugin

Table of Contents
End-of-Life (EoL)

Configure the Cisco ACI Plugin

Establish a connection between Panorama and the APIC.
After installing the plugin, you must set the monitoring interval, configure a notify group, and establish a connection between Panorama and the APIC fabric.
  1. (Optional) Configure the full-sync interval.
    1. Log in to the Panorama CLI.
    2. Enter configure mode.
      admin@Panorama> configure
    3. Use the following command to set the full-sync interval. The default interval is 600 seconds (10 minutes). The range is 600 seconds to 86,400 seconds (one day).
      admin@Panorama#
      set plugins cisco full-sync-interval <interval-in-seconds>
  2. Log in to the Panorama web interface.
  3. You must add the firewalls as managed devices on Panorama and create Device Groups so that you can configure Panorama to notify these groups with the VM information it retrieves. Device groups can include VM-Series firewalls or virtual systems on the hardware firewalls.
  4. Enable monitoring, set the monitoring interval, and enable bypass proxy.
    1. Select
      Panorama
      Cisco ACI
      Setup
      General
      .
    2. Select
      Enable Monitoring
      . This enables monitoring for all clusters in your deployment.
    3. Set the
      Monitoring Interval
      in seconds. The monitoring interval is how often Panorama retrieves updated network information from the APIC. The default value is 60 seconds and the range is 60 seconds to 86,400 seconds (one day).
    4. (
      Optional
      ) Select Bypass Proxy to Bypass proxy server settings, configured on Panorama under
      Panorama
      Setup
      Services
      Proxy Server
      , for communication between Panorama and the APIC. This allows Panorama to communicate directly with the APIC while maintaining proxied communication for other services.
  5. Create a notify group.
    1. Select
      Panorama
      Cisco ACI
      Setup
      Notify Groups
      .
    2. Click
      Add
      .
    3. Enter a descriptive
      Name
      for your notify group.
    4. Select the device groups in your ACI deployment.
  6. Add ACI fabric information.
    1. Select
      Panorama
      Cisco ACI
      Setup
      ACI Fabric
      .
    2. Enter a descriptive
      Name
      for your cluster.
    3. Enter the IP address or FQDN for each APIC in the cluster as a comma-separated list.
      When using FQDN, do not include https:// in the URL.
    4. Enter your APIC username.
    5. Enter and confirm your APIC password.
    6. Click
      OK
      .
  7. Configure the Monitoring Definition.
    1. Select
      Panorama
      Cisco ACI
      Monitoring Definition
      and click
      Add
      .
    2. Enter a descriptive
      Name
      and optionally a description to identify the Cisco ACI cluster for which you use this definition.
    3. Select the
      Cluster Info
      and
      Notify Group
      .
    4. Click
      OK
      .
  8. Commit
    your changes.
  9. Verify that you can view the EPG information on Panorama, and define the match criteria for Dynamic Address Groups.
    Some browser extensions may block API calls between Panorama and the APIC which prevents Panorama from receiving match criteria. If Panorama displays no match criteria and you are using browser extensions, disable the extensions and Synchronize Dynamic Objects to populate the tags available to Panorama.
    Panorama does not immediately process new monitoring definitions and populate the match criteria available to dynamic address. You should wait for the duration of your configured monitoring interval before verifying that EPG information.
  10. Verify that addresses in your EPGs are added to dynamic address groups.
    1. Select
      Panorama
      Objects
      Address Groups
      .
    2. Click
      More
      in the Addresses column of a dynamic address group.
      Panorama displays a list of IP addresses added to that dynamic address group based on the match criteria you specified.
  11. Use dynamic address groups in policy.
    1. Select
      Policies
      Security
      .
    2. Click
      Add
      and enter a
      Name
      and a
      Description
      for the policy.
    3. Add the
      Source Zone
      to specify the zone from which the traffic originates.
    4. Add the
      Destination Zone
      at which the traffic is terminating.
    5. For the
      Destination Address
      , select the Dynamic address group you just created.
    6. Specify the action—
      Allow
      or
      Deny
      —for the traffic, and optionally attach the default security profiles to the rule.
    7. Repeats Steps 1 through 6 to create another policy rule.
    8. Click
      Commit
      .
      See Use Dynamic Address Groups in Policy for more information.
  12. You can update the dynamic objects from the APIC at any time by synchronizing dynamic objects. Synchronizing dynamic objects enables you to maintain context on changes in the virtual environment and allows you to enable applications by automatically updating the Dynamic Address Groups used in policy rules.
    1. Select
      Panorama
      Cisco ACI
      Monitoring Definition
      .
    2. Click
      Synchronize Dynamic Objects
      .
    On HA failover, the newly active Panorama attempts to reconnect to the APIC and retrieve tags for all monitoring definitions. If there is an error with reconnecting even one monitoring definition, Panorama generates a system log message
    Unable to process subscriptions after HA switch-over; user-intervention required.
    When you see this error, you must log in to Panorama and fix the issue, for example remove an invalid APIC IP or provide valid credentials, and commit your changes to enable Panorama to reconnect and retrieve the tags for all monitoring definitions. Even when Panorama is disconnected from the APIC, the firewalls have the list of all tags that had been retrieved before failover, and can continue to enforce policy on that list of IP addresses. If you perform a commit before resolving the failover error, the newly active Panorama will not push any IP-to-tag mapping information and clearing the mapping information from the firewalls. As a best practice, to monitor this issue, configure action-oriented log forwarding to an HTTPS destination from Panorama so that you can take immediate action.

Recommended For You