Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
documentation.suse.com / SUSE OpenStack Cloud Crowbar 9 Documentation / Deployment Guide using Crowbar / Using Cisco Nexus Switches with neutron
Applies to SUSE OpenStack Cloud Crowbar 9

A Using Cisco Nexus Switches with neutron

A.1 Requirements

The following requirements must be met to use Cisco Nexus switches with neutron:

  • Cisco Nexus series 3000, 5000 or 7000

  • All Compute Nodes must be equipped with at least two network cards.

  • The switch needs to have the XML management interface enabled. SSH access to the management interface must be enabled (refer to the switch's documentation for details).

  • Enable VLAN trunking for all neutron managed VLANs on the switch port to which the controller node running neutron is connected to.

  • Before deploying neutron, check if VLAN configurations for neutron managed VLANs already exist on the switch (for example, from a previous SUSE OpenStack Cloud deployment). If yes, delete them via the switch's management interface prior to deploying neutron.

  • When using the Cisco plugin, neutron reconfigures the VLAN trunk configuration on all ports used for the nova-fixed traffic (the traffic between the instances). This requires to configure separate network interfaces exclusively used by nova-fixed. This can be achieved by adjusting /etc/crowbar/network.json (refer to Section 7.5, “Custom Network Configuration”). The following example shows an appropriate configuration for dual mode, where nova-fixed has been mapped to conduit intf1 and all other networks to other conduits. Configuration attributes not relevant in this context have been replaced with ....

    Example A.1: Exclusively Mapping nova-fixed to conduit intf1 in dual mode
    {
       "attributes" : {
          "network" : {
             "conduit_map" : [
                ...
             ],
             "mode" : "single",
             "networks" : {
                "nova_fixed" : {
                  ...,
                  "conduit" : "intf1"
                },
                "nova_floating" : {
                  ...,
                  "conduit" : "intf0"
                },
                "public" : {
                  ...,
                  "conduit" : "intf0"
                },
                "storage" : {
                  ...,
                  "conduit" : "intf0"
                },
                "os_sdn" : {
                  ...,
                  "conduit" : "intf0"
                },
                "admin" : {
                  ...,
                  "conduit" : "intf0"
                },
                "bmc" : {
                  ...,
                  "conduit" : "bmc"
                },
                "bmc_vlan" : {
                  ...,
                  "conduit" : "intf2"
                },
             },
             ...,
          },
       }
    }
  • Make a note of all switch ports to which the interfaces using the nova-fixed network on the Compute Nodes are connected. This information will be needed when deploying neutron.

A.2 Deploying neutron with the Cisco Plugin

  1. Create a neutron barclamp proposal in the Crowbar Web interface.

  2. As the Plugin, select ml2.

  3. As Modular Layer 2 mechanism drive, select cisco_nexus.

  4. In Modular Layer2 type drivers, select vlan.

  5. In the Cisco Switch Credentials table, enter the IP Address, the SSH Port number and the login credentials for the switch's management interface. If you have multiple switches, open a new row in the table by clicking Add and enter the data for another switch.

    The neutron barclamp: Cisco Plugin
    Figure A.1: The neutron barclamp: Cisco Plugin
  6. Choose whether to encrypt public communication (HTTPS) or not (HTTP). If choosing HTTPS, refer to SSL Support: Protocol for configuration details.

  7. Choose a node for deployment and Apply the proposal.

  8. Deploy nova (see Section 12.11, “Deploying nova”), horizon (see Section 12.12, “Deploying horizon (OpenStack Dashboard)” and all other remaining barclamps.

  9. When all barclamps have been deployed, return to the neutron barclamp by choosing Barclamps › OpenStack › neutron › Edit. The proposal now contains an additional table named Assign Switch Ports, listing all Compute Nodes.

    For each Compute Node enter the switch it is connected to and the port number from the notes you took earlier. The values need to be entered like the following: 1/13 or Eth1/20.

  10. When you have entered the data for all Compute Nodes, re-apply the proposal.

    Important
    Important: Deploying Additional Compute Nodes

    Whenever you deploy additional Compute Nodes to an active SUSE OpenStack Cloud deployment using the Cisco plugin with neutron, update the neutron barclamp proposal by entering their port data as described in the previous step.

Note
Note: Verifying the Setup

To verify if neutron was correctly deployed, do the following:

  1. Launch an instance (refer to the User Guide, chapter Launch and manage instances for instructions).

  2. Find out which VLAN was assigned to the network by running the command openstack network show fixed. The result lists a segmentation_id matching the VLAN.

  3. Log in to the switch's management interface and list the VLAN configuration. If the setup was deployed correctly, the port of the Compute Node the instance is running on, is in trunk mode for the matching VLAN.