diff options
author | Ben Pfaff <blp@ovn.org> | 2017-12-28 13:21:11 -0800 |
---|---|---|
committer | Ben Pfaff <blp@ovn.org> | 2018-03-24 12:04:52 -0700 |
commit | 53178986d7fc86bcfc2f297b547a97ee71a21bb7 (patch) | |
tree | bc01be74235a8c3e2cb80180f64c0ef61fac0ab3 /Documentation/ref/ovsdb.7.rst | |
parent | 10621d795331a3ddddb3e96086a9fda7ad156efc (diff) | |
download | openvswitch-53178986d7fc86bcfc2f297b547a97ee71a21bb7.tar.gz |
ovsdb: Add support for online schema conversion.
With this change, "ovsdb-client convert" can be used to convert a database
from one schema to another without taking the database offline.
This can be useful to minimize downtime for a database during a software
upgrade.
Signed-off-by: Ben Pfaff <blp@ovn.org>
Acked-by: Justin Pettit <jpettit@ovn.org>
Diffstat (limited to 'Documentation/ref/ovsdb.7.rst')
-rw-r--r-- | Documentation/ref/ovsdb.7.rst | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/Documentation/ref/ovsdb.7.rst b/Documentation/ref/ovsdb.7.rst index 25a6e5fc3..6adef7382 100644 --- a/Documentation/ref/ovsdb.7.rst +++ b/Documentation/ref/ovsdb.7.rst @@ -367,10 +367,17 @@ active-backup database, first stop the database server or servers, then use ``ovsdb-tool convert`` to convert it to the new schema, and then restart the database server. +OVSDB also supports online database schema conversion. +To convert a database online, use ``ovsdb-client convert``. +The conversion is atomic, consistent, isolated, and durable. ``ovsdb-server`` +disconnects any clients connected when the conversion takes place (except +clients that use the ``set_db_change_aware`` Open vSwitch extension RPC). Upon +reconnection, clients will discover that the schema has changed. + Schema versions and checksums (see Schemas_ above) can give hints about whether a database needs to be converted to a new schema. If there is any question, -though, the ``needs-conversion`` command on ``ovsdb-tool`` can provide a -definitive answer. +though, the ``needs-conversion`` command on ``ovsdb-tool`` and ``ovsdb-client`` +can provide a definitive answer. Working with Database History ----------------------------- |