Jump to: navigation, search

Difference between revisions of "GroupBasedPolicy/InstallCiscoACI"

(Devstack Installation)
(Devstack Installation)
 
(9 intermediate revisions by 2 users not shown)
Line 3: Line 3:
  
 
=== Devstack Installation ===
 
=== Devstack Installation ===
0. Install Ubuntu 14.04.
 
  
1. git clone http://github.com/group-policy/devstack -b stable/juno-gbp-apic
+
1. Follow the instructions here: https://github.com/group-policy/gbp-devstack/tree/juno until step 6.
  
 
2. cd devstack
 
2. cd devstack
Line 11: Line 10:
 
3. Configure the local.conf file.  
 
3. Configure the local.conf file.  
  
 +
* Replace the "resource_mapping" driver with the "apic" driver as follows:
 +
<pre>
 +
[group_policy]
 +
policy_drivers=implicit_policy,apic
 +
</pre>
 +
 +
* Set the appropriate L3 plugin as follows in the default section:
 +
<pre>
 +
service_plugins =group_policy,servicechain,apic_gbp_l3
 +
</pre>
 +
 +
* Replace enable_service q-agt with disable_service q-agt
 
* Set HOST_IP
 
* 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 /.   
 
* 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 /.   
Line 16: Line 27:
 
4. Configure ml2_conf_cisco.ini at the path you chose.  For complete instructions on available options see [http://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/1-x/api/openstack/b_Cisco_APIC_OpenStack_Driver_Install_Guide.html this] document.  An example file would look like this:
 
4. Configure ml2_conf_cisco.ini at the path you chose.  For complete instructions on available options see [http://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/1-x/api/openstack/b_Cisco_APIC_OpenStack_Driver_Install_Guide.html this] document.  An example file would look like this:
  
<sub>[DEFAULT]
+
<pre>
 +
[DEFAULT]
 
# Unique Name for identifying the Openstack Cluster
 
# Unique Name for identifying the Openstack Cluster
 
apic_system_id=gbp3
 
apic_system_id=gbp3
 +
 
[ml2_cisco_apic]
 
[ml2_cisco_apic]
 
# Host Name for the APIC Controller
 
# Host Name for the APIC Controller
Line 35: Line 48:
 
[apic_switch:101]
 
[apic_switch:101]
 
ubuntu-gbp=1/5  
 
ubuntu-gbp=1/5  
</sub>
+
</pre>
 +
 
 +
5. pip install apicapi
 +
 
 +
6. pip install python-opflex-agent
  
4. ./stack.sh
+
7. ./stack.sh
  
5. source openrc demo demo
+
8. Ensure your uplink to ACI fabric is up and a port is created on OVS.
 +
<pre>
 +
sudo ovs-vsctl add-port br-em1 eth1
 +
</pre>
 +
 +
8. source openrc demo demo
  
6. Use the "gbp" CLI binary ("gbp --help" will give you the commands)
+
9. Use the "gbp" CLI binary ("gbp --help" will give you the commands)

Latest revision as of 00:28, 3 November 2015

Installing and Running GBP with Cisco APIC

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

Devstack Installation

1. Follow the instructions here: https://github.com/group-policy/gbp-devstack/tree/juno until step 6.

2. cd devstack

3. Configure the local.conf file.

  • Replace the "resource_mapping" driver with the "apic" driver as follows:
[group_policy]
policy_drivers=implicit_policy,apic
  • Set the appropriate L3 plugin as follows in the default section:
service_plugins =group_policy,servicechain,apic_gbp_l3
  • Replace enable_service q-agt with disable_service q-agt
  • 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 

5. pip install apicapi

6. pip install python-opflex-agent

7. ./stack.sh

8. Ensure your uplink to ACI fabric is up and a port is created on OVS.

sudo ovs-vsctl add-port br-em1 eth1

8. source openrc demo demo

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