GroupBasedPolicy/InstallCiscoACI

Installing and Running GBP with Cisco APIC

The following are a set of instructions for installing and working with the Cisco APIC:

Devstack Installation

0. Install Ubuntu 14.04.

1. git clone http://github.com/group-policy/devstack -b stable/juno-gbp-apic

2. cd devstack

3. Configure the local.conf file.

Set HOST_IP
Set Q_PLUGIN_EXTRA_CONF_PATH. This should point to the path where the ml2_conf_cisco.ini file resides. Note it should NOT start with a /.

4. Configure ml2_conf_cisco.ini at the path you chose. For complete instructions on available options see this document. An example file would look like this:

[DEFAULT]
# Unique Name for identifying the Openstack Cluster
apic_system_id=gbp3

[ml2_cisco_apic]
# Host Name for the APIC Controller
apic_hosts=172.31.100.1

# Username for the APIC Controller
apic_username=admin

# Password for the APIC Controller
apic_password=cisco123

# How to map  names to APIC: use_uuid or use_name
apic_name_mapping=use_name

# Switch to hypervisor port mapping
[apic_switch:101]
ubuntu-gbp=1/5

4. ./stack.sh

5. source openrc demo demo

6. Use the "gbp" CLI binary ("gbp --help" will give you the commands)