Description
Deploy the Quantum virtual network service and configure Nova to use QuantumManager as its NetworkManager.
Quantum includes several plugins. The linuxbridge and openvswitch plugins are covered here. Feel free to experiment with the cisco, nicira, and/or ryu plugins as well, but note that deploying these requires additional software or hardware.
For clarity, these instructions assume a single node acts as the controller and compute node. They also assume that nova and mysql-server have already been installed and configured as described in the main test cases.
If using multiple compute nodes, all compute nodes will need to be connected via a network interface and switch with VLAN trunking enabled. Non-controller compute nodes require installation and configuration of the linuxbridge or openvswitch agent along with nova-compute, but do not require the quantum-server to be run or database to be configured.
Setup
Install openstack-quantum:
$> sudo yum install --enablerepo=updates-testing openstack-quantum
If running on Fedora 17, until an updated RPM is available, as root edit /usr/lib/python2.7/site-packages/quantum-2012.1-py2.7.egg-info/requires.txt and change "lxml==2.3" to "lxml>=2.3".
Install one or more plugins:
$> sudo yum install --enablerepo=updates-testing openstack-quantum-linuxbridge $> sudo yum install --enablerepo=updates-testing openstack-quantum-openvswitch $> sudo yum install --enablerepo=updates-testing openstack-quantum-cisco $> sudo yum install --enablerepo=updates-testing openstack-quantum-nicira $> sudo yum install --enablerepo=updates-testing openstack-quantum-ryu
If you are using the openvswitch plugin, configure openvswitch:
$> sudo yum install --enablerepo=updates-testing openvswitch [Note - will become dependency of openstack-quantum-openvswitch] $> sudo systemctl enable openvswitch.service $> sudo systemctl start openvswitch.service $> sudo ovs-vsctl add-br br-int
If using the linuxbridge plugin, configure quantum-server and create the database:
$> sudo cp /etc/quantum/plugins.ini /etc/quantum/plugins.ini-orig $> sudo openstack-config-set /etc/quantum/plugins.ini PLUGIN provider quantum.plugins.linuxbridge.LinuxBridgePlugin.LinuxBridgePlugin $> mysql -u root -p -e "create database quantum_linux_bridge" $> mysql -u root -p -e "create user 'quantum'@'%' identified by 'quantum'" $> mysql -u root -p -e "create user 'quantum'@'localhost' identified by 'quantum'" $> mysql -u root -p -e "grant all on quantum_linux_bridge.* to 'quantum'@'%'" $> mysql -u root -p -e "grant all on quantum_linux_bridge.* to 'quantum'@'localhost'"
or, if using the openvswitch plugin, configure quantum-server and create the database:
$> sudo cp /etc/quantum/plugins.ini /etc/quantum/plugins.ini-orig $> sudo openstack-config-set /etc/quantum/plugins.ini PLUGIN provider quantum.plugins.openvswitch.ovs_quantum_plugin.OVSQuantumPlugin $> mysql -u root -p -e "create database ovs_quantum" $> mysql -u root -p -e "grant all on ovs_quantum.* to 'quantum'@'%'" $> mysql -u root -p -e "grant all on ovs_quantum.* to 'quantum'@'localhost'"
If using the linuxbridge plugin, configure the linuxbridge plugin and agent:
$> sudo cp /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini-orig
$> sudo openstack-config-set /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini DATABASE connection mysql
$> sudo openstack-config-set /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini DATABASE user quantum
$> sudo openstack-config-set /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini DATABASE pass quantum
$> sudo openstack-config-set /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini DATABASE host hostname
$> sudo openstack-config-set /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini LINUX_BRIDGE physical_interface eth0
or, if using the openvswitch plugin:
$> sudo cp /etc/quantum/plugins/openvswitch/ovs_quantum_plugin.ini /etc/quantum/plugins/openvswitch/ovs_quantum_plugin.ini-orig
$> sudo openstack-config-set /etc/quantum/plugins/openvswitch/ovs_quantum_plugin.ini DATABASE sql_connection mysql://quantum:quantum@hostname/ovs_quantum
Enable and start quantum-server:
$> sudo systemctl enable quantum-server.service $> sudo systemctl start quantum-server.service
If using the linuxbridge plugin, enable and start quantum-linuxbridge-agent:
$> sudo systemctl enable quantum-linuxbridge-agent.service $> sudo systemctl start quantum-linuxbridge-agent.service
or, if using the openvswitch plugin, enable and start quantum-openvswitch-agent:
$> sudo systemctl enable quantum-openvswitch-agent.service $> sudo systemctl start quantum-openvswitch-agent.service
Finally, configure Nova to use QuantumManager as its NetworkManager:
TBD
If using the the linuxbridge plugin, enable its drivers for Nova:
TBD
or if using the openvswitch plugin, enable its drivers for Nova:
TBD
How to test
TBD
Expected Results
TBD