QA:Testcase run Nova with Quantum

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
Line 18: Line 18:
 
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".
 
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
+
Create the database user that will be used by either the linuxbridge or openvswitch plugin:
$> 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:
+
$> mysql -u root -p -e "create user 'quantum'@'%' identified by 'quantum'"
 +
$> mysql -u root -p -e "create user 'quantum'@'localhost' identified by 'quantum'"
  
$> 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 openvswitch plugin, skip down to "Continue here to setup with the openvswitch plugin" below. If using the linuxbridge plugin, continue with the following instructions.
  
If using the linuxbridge plugin, configure quantum-server and create the database:
 
  
  $> sudo cp /etc/quantum/plugins.ini /etc/quantum/plugins.ini-orig
+
Install the linuxbridge plugin:
 +
 
 +
  $> sudo yum install --enablerepo=updates-testing openstack-quantum-linuxbridge
 +
 
 +
 
 +
Configure quantum-server to use the linuxbridge plugin and create its database:
 +
 
 
  $> sudo openstack-config-set /etc/quantum/plugins.ini PLUGIN provider quantum.plugins.linuxbridge.LinuxBridgePlugin.LinuxBridgePlugin
 
  $> 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 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'@'%'"
 
  $> mysql -u root -p -e "grant all on quantum_linux_bridge.* to 'quantum'@'localhost'"
 
  $> 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
+
Configure the linuxbridge plugin and agent:
$> 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 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 user quantum
Line 62: Line 49:
 
  $> sudo openstack-config-set /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini LINUX_BRIDGE physical_interface eth0
 
  $> sudo openstack-config-set /etc/quantum/plugins/linuxbridge/linuxbridge_conf.ini LINUX_BRIDGE physical_interface eth0
  
or, if using the openvswitch plugin:
+
In the step above, be sure to set physical_interface to the node's external interface, which must support VLAN trunking if using multiple compute nodes.
  
$> 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 the quantum-server and quantum-linuxbridge-agent daemons:
Enable and start quantum-server:
+
  
 
  $> sudo systemctl enable quantum-server.service
 
  $> sudo systemctl enable quantum-server.service
 
  $> sudo systemctl start quantum-server.service
 
  $> sudo systemctl start quantum-server.service
 +
$> sudo systemctl enable quantum-linuxbridge-agent.service
 +
$> sudo systemctl start quantum-linuxbridge-agent.service
  
  
If using the linuxbridge plugin, enable and start quantum-linuxbridge-agent:
+
Finally, configure nova to use QuantumManager as its NetworkManager and to use the proper drivers:
  
  $> sudo systemctl enable quantum-linuxbridge-agent.service
+
  TBD
$> 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
+
You are done setting up quantum with the linuxbridge plugin!
$> sudo systemctl start quantum-openvswitch-agent.service
+
  
  
Finally, configure Nova to use QuantumManager as its NetworkManager:
+
Continue here to setup quantum with the openvswitch plugin.
  
TBD
+
Install the openvswitch plugin:
  
If using the the linuxbridge plugin, enable its drivers for Nova:
+
$> sudo yum install --enablerepo=updates-testing openstack-quantum-openvswitch
 +
 
 +
 
 +
Configure openvswitch and create the integration bridge:
 +
 
 +
$> 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
 +
 
 +
 
 +
Configure quantum-server to use the openvswitch plugin and create its database:
 +
 
 +
$> 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'"
 +
 
 +
 
 +
Configure the openvswitch plugin and agent:
 +
 
 +
$> sudo openstack-config-set /etc/quantum/plugins/openvswitch/ovs_quantum_plugin.ini DATABASE sql_connection mysql://quantum:quantum@`hostname`/ovs_quantum
 +
 
 +
 
 +
Enable and start the quantum-server and quantum-openvswitch-agent daemons:
 +
 
 +
$> sudo systemctl enable quantum-server.service
 +
$> sudo systemctl start quantum-server.service
 +
$> sudo systemctl enable quantum-openvswitch-agent.service
 +
$> sudo systemctl start quantum-openvswitch-agent.service
  
TBD
 
  
or if using the openvswitch plugin, enable its drivers for Nova:
+
Finally, configure nova to use QuantumManager as its NetworkManager and to use the proper drivers:
  
 
  TBD
 
  TBD

Revision as of 14:08, 8 March 2012

Contents

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".


Create the database user that will be used by either the linuxbridge or openvswitch plugin:

$> mysql -u root -p -e "create user 'quantum'@'%' identified by 'quantum'"
$> mysql -u root -p -e "create user 'quantum'@'localhost' identified by 'quantum'"


If using the openvswitch plugin, skip down to "Continue here to setup with the openvswitch plugin" below. If using the linuxbridge plugin, continue with the following instructions.


Install the linuxbridge plugin:

$> sudo yum install --enablerepo=updates-testing openstack-quantum-linuxbridge


Configure quantum-server to use the linuxbridge plugin and create its database:

$> 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 "grant all on quantum_linux_bridge.* to 'quantum'@'%'"
$> mysql -u root -p -e "grant all on quantum_linux_bridge.* to 'quantum'@'localhost'"


Configure the linuxbridge plugin and agent:

$> 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

In the step above, be sure to set physical_interface to the node's external interface, which must support VLAN trunking if using multiple compute nodes.


Enable and start the quantum-server and quantum-linuxbridge-agent daemons:

$> sudo systemctl enable quantum-server.service
$> sudo systemctl start quantum-server.service
$> sudo systemctl enable quantum-linuxbridge-agent.service
$> sudo systemctl start quantum-linuxbridge-agent.service


Finally, configure nova to use QuantumManager as its NetworkManager and to use the proper drivers:

TBD


You are done setting up quantum with the linuxbridge plugin!


Continue here to setup quantum with the openvswitch plugin.

Install the openvswitch plugin:

$> sudo yum install --enablerepo=updates-testing openstack-quantum-openvswitch


Configure openvswitch and create the integration bridge:

$> 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


Configure quantum-server to use the openvswitch plugin and create its database:

$> 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'"


Configure the openvswitch plugin and agent:

$> sudo openstack-config-set /etc/quantum/plugins/openvswitch/ovs_quantum_plugin.ini DATABASE sql_connection mysql://quantum:quantum@`hostname`/ovs_quantum


Enable and start the quantum-server and quantum-openvswitch-agent daemons:

$> sudo systemctl enable quantum-server.service
$> sudo systemctl start quantum-server.service
$> sudo systemctl enable quantum-openvswitch-agent.service
$> sudo systemctl start quantum-openvswitch-agent.service


Finally, configure nova to use QuantumManager as its NetworkManager and to use the proper drivers:

TBD 

How to test

TBD

Expected Results

TBD