Note about quantum database and plug-ins is inaccurate.

[Stephen Gordon]

In the openstack-network book section on install Quantum and plug-ins [1][2] we find a note that says:

"Different plugins can use different database schemas, so when switching a plugin, you must always drop the quantum database and start fresh."

It's been brought to my attention [3] that this is somewhat inaccurate in as much as the plug-ins actually create separate databases such as:

 cisco => quantum_l2network
 linuxbridge => quantum_linux_bridge
 metaplugin => quantum_metaplugin
 nec => ovs_quantum
 nicira => nvp_quantum
 openvswitch => ovs_quantum
 ryu => ryu_quantum

Obviously there is an exception here (there's always one...) in that the nec and openvswitch plug-ins actually use the same database. That said, the issues with the existing note are:

- It makes it sound like there is a single "quantum" database involved here that the plug-ins 'fight' for.
- It states that you must always drop the plug-in database when switching - but it appears this isn't actually necessary (maybe advisable but that's different to must always)?

I think the note needs to be updated to reflect these factors or removed and this information reflected elsewhere (I am still considering how best to present this information).

[1] http://docs.openstack.org/trunk/openstack-network/admin/content/install_quantum_server.html
[2] http://docs.openstack.org/trunk/openstack-network/admin/content/fedora_q_server.html
[3] https://bugzilla.redhat.com/show_bug.cgi?id=908202

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/24006

[Tom Fifield (fifieldt)]

https://review.openstack.org/24006

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/24006
Committed: http://github.com/openstack/openstack-manuals/commit/680981d734fec3321a257a9bf8894bc44c5fc4b4
Submitter: Jenkins
Branch: master

commit 680981d734fec3321a257a9bf8894bc44c5fc4b4
Author: Tom Fifield <email address hidden>
Date: Sun Mar 10 13:04:26 2013 +1100

    Removes misleading note in quantum doc

    fixes bug 1134849

    As precisely report by Stephen Gordon in the bug report,
    different quantum plugins use different databases with one
    exception. As we're trying to reduce the cruft in the docs
    and no longer cover every single exception, removing both
    instances of the note.

    Change-Id: If6e553bad6b1a4e78f29c859dfb69d84fd9aa609