The Nexus switch must have SSH access enabled. The switch must be connected to management network separate from the Openstack data network. The plugin communicates with the switch over this network to set up your data flows. Each compute (Nova) host should should be connected to a port on the Nexus switch over a dedicated interface just for Openstack data traffic. <br>

-

1. Make a backup copy of quantum/etc/quantum.conf.

+

'''Plugin Installation Instructions'''

-

2. Edit quantum/etc/quantum.conf and edit the "core_plugin" for v2 API:

+

1. Make a backup copy of quantum/etc/quantum.conf.

-

core_plugin = quantum.plugins.cisco.network_plugin.PluginV2

+

2. Edit quantum/etc/quantum.conf and edit the "core_plugin" for v2 API:

-

3. MySQL database setup

+

core_plugin = quantum.plugins.cisco.network_plugin.PluginV2

-

a. Create quantum_l2network database in mysql with the following command:

4. Make sure that SSH host key of the Nexus switch is known to the host on which you are running the Quantum service. You can do this simply by logging in to your Quantum host as the user that Quantum runs as and SSHing to the switch at least once. If the host key changes (e.g. due to replacement of the supervisor or clearing of the SSH config on the switch), you may need to repeat this step and remove the old hostkey from ~/.ssh/known_hosts.<br>

-

3. Make sure that SSH host key of the Nexus switch is known to the

+

5. Verify that you have the correct credentials for each IP address listed in quantum/plugins/cisco/conf/credentials.ini. Example:

-

host on which you are running the Quantum service. You can do this simply by logging in to your Quantum host as the user that Quantum runs as and SSHing to the switch at least once. If the host key changes (e.g. due to replacement of the supervisor or clearing of the SSH config on the switch), you may need to repeat this step and remove the old hostkey from ~/.ssh/known_hosts.

+

-

4. Verify that you have the correct credentials for each IP address listed in quantum/plugins/cisco/conf/credentials.ini. Example:

+

# Provide the Nexus credentials, if you are using Nexus switches. IP address, username and password.

+

# If not this will be ignored.

+

[10.0.0.1]

+

username=admin

+

password=mySecretPasswordForNexus

-

# Provide the Nexus credentials, if you are using Nexus switches. IP address, username and password.

+

In general, make sure that Nexus switch used in your system has a credential entry in the above file. This is required for the system to be able to communicate with those switches.<br>

-

# If not this will be ignored.

+

-

[10.0.0.1]

+

-

username=admin

+

-

password=mySecretPasswordForNexus

+

-

In general, make sure that Nexus switch used in your system, has a credential entry in the above file. This is required for the system to be able to communicate with those switches.

+

<br> '''OpenVSwitch sub-plugin configuration'''

+

By using the OpenVSwitch plugin as a sub-plugin, parity with pre-Folsom Nova networking is achieved. VLAN mode must be enabled. To use it together with the Nexus device sub-plugin perform the following steps:

-

OpenVSwitch sub-plugin configuration

+

1. Update /etc/quantum/plugins/cisco/l2network_plugin.ini so that the [MODEL] and [SEGMENTATION] sections contain single items:

-

By using the OpenVSwitch plugin as a sub-plugin, parity with pre-Folsom Nova networking is achieved. VLAN mode must be enabled. To use it together with the Nexus device sub-plugin perform the following steps:

The Nexus switch must have SSH access enabled. The switch must be connected to management network separate from the Openstack data network. The plugin communicates with the switch over this network to set up your data flows. Each compute (Nova) host should should be connected to a port on the Nexus switch over a dedicated interface just for Openstack data traffic.

Plugin Installation Instructions

1. Make a backup copy of quantum/etc/quantum.conf.

2. Edit quantum/etc/quantum.conf and edit the "core_plugin" for v2 API:

core_plugin = quantum.plugins.cisco.network_plugin.PluginV2

Nexus switch sub-plugin configuration

To turn on support for Cisco Nexus switches:

1. Uncomment the nexus_plugin property in /etc/quantum/plugins/cisco/cisco_plugins.ini to read:

2. Enter the relevant configuration in the /etc/quantum/plugins/cisco/nexus.ini file. Example:

[SWITCH]
# Change the following to reflect the Nexus switch details
nexus_ip_address=<put_nexus_switch_ip_address_here>
# Interfaces connected from the Nexus Switch to the compute hosts ports, e.g.: 1/10 and 1/11
ports=<put_interfaces_names_here_separated_by_commas>
# Port number where the SSH will be running at the Nexus Switch, e.g.: 22 (Default)
nexus_ssh_port=22
[DRIVER]
name=quantum.plugins.cisco.nexus.cisco_nexus_network_driver_v2.CiscoNEXUSDriver

3. Update the database configuration info in the quantum/plugins/cisco/conf/db_conn.ini file:

4. Make sure that SSH host key of the Nexus switch is known to the host on which you are running the Quantum service. You can do this simply by logging in to your Quantum host as the user that Quantum runs as and SSHing to the switch at least once. If the host key changes (e.g. due to replacement of the supervisor or clearing of the SSH config on the switch), you may need to repeat this step and remove the old hostkey from ~/.ssh/known_hosts.

5. Verify that you have the correct credentials for each IP address listed in quantum/plugins/cisco/conf/credentials.ini. Example:

# Provide the Nexus credentials, if you are using Nexus switches. IP address, username and password.
# If not this will be ignored.
[10.0.0.1]
username=admin
password=mySecretPasswordForNexus

In general, make sure that Nexus switch used in your system has a credential entry in the above file. This is required for the system to be able to communicate with those switches.

OpenVSwitch sub-plugin configuration

By using the OpenVSwitch plugin as a sub-plugin, parity with pre-Folsom Nova networking is achieved. VLAN mode must be enabled. To use it together with the Nexus device sub-plugin perform the following steps:

1. Update /etc/quantum/plugins/cisco/l2network_plugin.ini so that the [MODEL] and [SEGMENTATION] sections contain single items: