openstack/neutron-vpnaas
Code Issues Proposed changes

Update openvswitch plugin README

Browse Source 
(address code review feedback)

Change-Id: Id9407001d82eea131c0e88775d9836dd1b769430
This commit is contained in:
Brad Hall 2011-09-07 00:03:54 -07:00
parent 56218f5e54
commit 53420d1964
1 changed files with 13 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
quantum/plugins/openvswitch/README
View File

@ -1,7 +1,7 @@
# -- Background # -- Background
The quantum openvswitch plugin is a simple plugin that allows you to The quantum openvswitch plugin is a plugin that allows you to manage
manage connectivity between VMs on hypervisors running openvswitch. connectivity between VMs on hypervisors running openvswitch.
The quantum openvswitch plugin consists of three components: The quantum openvswitch plugin consists of three components:
@ -55,10 +55,10 @@ provider = quantum.plugins.openvswitch.ovs_quantum_plugin.OVSQuantumPlugin
# -- Database config. # -- Database config.
The OVS quantum service requires access to a mysql database in order The Open vSwitch quantum service requires access to a mysql database in order
to store configuration and mappings that will be used by the agent. to store configuration and mappings that will be used by the agent. Here is
Here is how to set up the database on the host that you will be how to set up the database on the host that you will be running the quantum
running the quantum service on. service on.
MySQL should be installed on the host, and all plugins and clients MySQL should be installed on the host, and all plugins and clients
must be configured with access to the database. must be configured with access to the database.
@ -72,8 +72,8 @@ communicate with the host running the quantum service:
# log in to mysql service # log in to mysql service
$ mysql -u root -p $ mysql -u root -p
# The OVS Quantum agent running on each compute node must be able to # The Open vSwitch Quantum agent running on each compute node must be able to
make a mysql connection back to the main database server. # make a mysql connection back to the main database server.
mysql> GRANT USAGE ON *.* to root@'yourremotehost' IDENTIFIED BY 'newpassword'; mysql> GRANT USAGE ON *.* to root@'yourremotehost' IDENTIFIED BY 'newpassword';
# force update of authorization changes # force update of authorization changes
mysql> FLUSH PRIVILEGES; mysql> FLUSH PRIVILEGES;
@ -127,17 +127,19 @@ $ python ovs_quantum_agent.py ovs_quantum_plugin.ini
This will show help all of the available commands. This will show help all of the available commands.
An example session looks like this: An example session (to attach a vm interface with id 'foo') looks like
this:
$ export TENANT=t1 $ export TENANT=t1
$ export VIF_UUID=foo # This should be the uuid of the virtual interface
$ python bin/cli create_net $TENANT network1 $ python bin/cli create_net $TENANT network1
Created a new Virtual Network with ID:e754e7c0-a8eb-40e5-861a-b182d30c3441 Created a new Virtual Network with ID:e754e7c0-a8eb-40e5-861a-b182d30c3441
$ export NETWORK=e754e7c0-a8eb-40e5-861a-b182d30c3441 $ export NETWORK=e754e7c0-a8eb-40e5-861a-b182d30c3441
$ python bin/cli create_port $TENANT $NETWORK $ python bin/cli create_port $TENANT $NETWORK
Created Virtual Port:5a1e121b-ccc8-471d-9445-24f15f9f854c on Virtual Network:e754e7c0-a8eb-40e5-861a-b182d30c3441 Created Virtual Port:5a1e121b-ccc8-471d-9445-24f15f9f854c on Virtual Network:e754e7c0-a8eb-40e5-861a-b182d30c3441
$ export PORT=5a1e121b-ccc8-471d-9445-24f15f9f854c $ export PORT=5a1e121b-ccc8-471d-9445-24f15f9f854c
$ python bin/cli plug_iface $TENANT $NETWORK $PORT ubuntu1-eth1 $ python bin/cli plug_iface $TENANT $NETWORK $PORT $VIF_UUID
Plugged interface "ubuntu1-eth1" to port:5a1e121b-ccc8-471d-9445-24f15f9f854c on network:e754e7c0-a8eb-40e5-861a-b182d30c3441 Plugged interface "foo" to port:5a1e121b-ccc8-471d-9445-24f15f9f854c on network:e754e7c0-a8eb-40e5-861a-b182d30c3441
(.. repeat for more ports and interface combinations..) (.. repeat for more ports and interface combinations..)