Active Fabric Manager (AFM) Plug-in for OpenStack Guide 2.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2013 Dell Inc. All Rights Reserved.
Contents 1 AFM Plug-in Overview ...............................................................................................................5 OpenStack Networking Deployment Use Cases...................................................................................................... 6 Supported Deployment Topologies.......................................................................................................................... 7 Pre-requisites for Using the Plug-In.............................
AFM Plug-in Overview 1 Use the Active Fabric Manager (AFM) plug-in for OpenStack to configure VLAN interfaces on the Dell Force10 Network switches to orchestrate virtual networks through the AFM Restful APIs. The AFM plug-in enables you to configure VLANs for a Layer 2 fabric, which is created by AFM administrators. It delegates the physical network configuration logic to the AFM server by making requests to the AFM server through AFM Restful APIs.
OpenStack Networking Deployment Use Cases The AFM plug-in supports the following OpenStack use cases: 1. Single Flat Network — All VMs can talk to each other via the shared network and to external network through the physical route. In the simplest use case, a single OpenStack Networking network exists. This is a "shared" network, meaning it is visible to all tenants through the OpenStack Networking API.
Supported Deployment Topologies The AFM Plug-in supports the following topologies: Six S4810 switches with two aggregation nodes and four access nodes. The AFM Plugin is installed on the OpenStack Controller Node. The Dell OVS Agent is installed on each Nova Compute node and Network node. At runtime, the OpenStack Neutron Server communicates with the AFM Server through a restful API to manage the physical topology.
• Ensure that the DNS is enabled in the OpenStack Neutron server. • Ensure that the AFM administrator has created a fabric with the Openstack Neutron Managed option enabled at the Fabric Name and Type screen using the AFM Design Wizard and has deployed a complete fabric that is ready for service. Key Considerations When using the AFM plug-in consider the following: • The AFM Plug-in for OpenStack resides on the OpenStack Neutron server. • The AFM plug-in supports VLANs.
Step 1: Installing the AFM Plug-in 2 To install the AFM plug-in for Openstack onto the Controller node where the Neutron server is located: 1. Obtain the AFM Plug-in for Openstack tar file, AFMOpenStackPlugin2.0.0.0.tar.gz from iSupport. See the Release Notes. 2. On the Openstack server, go to the /usr/lib/python2.7/dist-packages/ directory. 3. Untar the AFMOpenStackPlugin2.0.0.0.tar.gz. file using the following syntax: tar –zxvf AFMOpenStackPlugin2.0.0.0.tar.
[PORT_MAPPING:] = = = [PORT_MAPPING:] = = = 10
Step 2: Configuring the AFM Plug-in 3 To configure the OpenVSwitch to support the AFM Plug-in: 1. On the Controller where the Neutron server is located, set the parameter in the ovs_quantum_plugin.ini file in the /etc/quantum/plugins/openvswitch/ directory as shown in the following example: sql_connection = mysql://:@/ovs_quantum?charset=utf8 2.
Step 3: (Optional) Configuring Static Switch Server Connectivity 4 The AFM Plug-in supports dynamic discovery of server switch connectivity using LLDP and static configuration of server switch connectivity. The Dell OVS agent supports dynamic discovery of server switch connectivity on the Nova Compute Node or Network Node. Dell recommends that you use dynamic discovery. For information about dynamic discovery, see Installing the LLDP Package.
Step 4: Installing the LLDP and Port Bonding 5 Before you install and configure the Dell OVS agent install the following on the Nova compute node and network node: • LLDP package. NOTE: Use the LLDP package for dynamic discovery of server switch connectivity. If you are using static switch server connectivity, see Configuring Static Switch Server Connectivity. • Port Bonding Step 4.1: Installing the LLDP Package To install LLDP on the Nova compute node. : 1.
lp rtc bonding If the bonding module is not there, add the bonding keyword word into /etc/modules file. 3. Configure the network interfaces as an active and slave to the bonding interface using the following command: sudo vi /etc/network/interfaces The following example shows you to associate eth4 and eth5 as slaves to the bonding interface bond0.
netmask 255.255.255.0 bond-mode 802.3ad bond-miimon 100 bond-lacp-rate 1 bond-slaves none 4. Restart the network service by rebooting the compute node at /etc/init.d/networking restart 5. After the reboot is complete, verify the bonding interface by checking the /proc/net/bonding/ directory The following example shows how to check the bond0 interface. In this example, the bonding mode and the slave interface eth4 and eth5 have a MII Status of Up.
Permanent HW addr: 00:10:18:d0:3d:62 Aggregator ID: 2 Slave queue ID: 0 18
Step 5: Installing the Dell OVS Agent 6 The Dell OVS Agent supports dynamic discovery of Server Switch connections using LLDP. To use the Dell OVS agent, install it on the nova compute nodes and network node. To install the Dell OVS Agent on the nova compute nodes and network nodes: 1. Obtain the AFM Plug-in for Openstack tar file, AFMOpenStackPlugin2.0.0.0.tar.gz, from iSupport. 2. On each Nova compute node and network node, go to /usr/lib/python2.7/dist-packages/. 3. At the /usr/lib/python2.
Step 6: Configuring the Dell OVS Agent 7 To configure the Dell OVS Agent: 1. Create the physical and integration bridge 2. Configure the Dell OVS Plug-in 3. Configure the Rootwrap 4. Restart the Dell OVS Agent on Nova Compute Node or Network Node 5. Configure the Nova Compute Node or Network Node Step 1: Creating the Physical and Integration bridge This section describes how to add the physical port and bonding to the Dell OVS agent.
2.
ovs-ofctl_sbin: CommandFilter, /sbin/ovs-ofctl, root ovs-ofctl_sbin_usr: CommandFilter, /usr/sbin/ovs-ofctl, root xe: CommandFilter, /sbin/xe, root xe_usr: CommandFilter, /usr/sbin/xe, root hostname: CommandFilter, /bin/hostname, root lldpctl: CommandFilter, /usr/sbin/lldpctl, root # ip_lib ip: IpFilter, /sbin/ip, root ip_usr: IpFilter, /usr/sbin/ip, root ip_exec: IpNetnsExecFilter, /sbin/ip, root ip_exec_usr: IpNetnsExecFilter, /usr/sbin/ip, root Step 4: Restart the Dell OVS Agent on Nova Compute Node or
export OS_TENANT_NAME=admin export OS_AUTH_URL=http://localhost:5000/v2.
Step 7: Connecting to the AFM Server 8 To connect to the AFM server: 1. Configure the AFM server IP address and port on the Openstack Controller node 2. Configure the AFM user credentials for the AFM Plug-in on the AFM server Step 1: Configure the AFM server IP address and Port The AFM plug-in requires that you configure the AFM server IP and port on the Openstack Controller node to connect to the AFM server for Restful API calls.
3. Click the Add User link. 4. From the Role pull-down menu, select the Admin option. 5. In the First Name and Last Name fields, enter the name of the user. 6. In the User Name field, enter the user name. For example, quantumuser. 7. In the Password field, enter the password. 8. In the Confirm Password field, confirm the password. 9. In the Sessions Allowed pull-down menu, select 5 for the number sessions allowed for the user. 10.
Uninstalling the AFM Plug-in for OpenStack 9 The AFM Plug-in is located at the OpenStack Neutron plugins directory. To uninstall the AFM Plug-in, restore the configuration files that you have changed and then remove the AFM plug-in directory. 1. Run the following command to stop the Dell Neutron plugin. root@dev1-openstack06:~# service quantum-server stop 2. Modify the following statement by removing the line "--config-file /etc/quantum/plugins/dell/ dell_quantum_plugins.ini \ from the quantum-server.
Uninstalling the Dell OVS Agent 10 To uninstall the Dell OVS agent: 1. Run the service quantum-plugin-openvswitch-agent stop command. 2. Restore the /usr/bin/quantum-openvswitch-agent file from the backup. 3. Restore the /etc/init/quantum-plugin-openvswitch-agent.conf file. 4. Remove the /etc/quantum/plugins/dell directory and all the files in it.