ovsdb/ovsdb-schemas.man

   1 .PP
   2 An OVSDB schema has a schema version number, and an OVSDB database
   3 embeds a particular version of an OVSDB schema.  These version numbers
   4 take the form \fIx\fB.\fIy\fB.\fIz\fR, e.g. \fB1.2.3\fR.  The OVSDB
   5 implementation does not enforce a particular version numbering scheme,
   6 but schemas managed within the Open vSwitch project use the following
   7 approach.  Whenever the database schema is changed in a non-backward
   8 compatible way (e.g. deleting a column or a table), \fIx\fR is
   9 incremented (and \fIy\fR and \fIz\fR are reset to 0).  When the
  10 database schema is changed in a backward compatible way (e.g. adding a
  11 new column), \fIy\fR is incremented (and \fIz\fR is reset to 0).  When
  12 the database schema is changed cosmetically (e.g. reindenting its
  13 syntax), \fIz\fR is incremented.
  14 .PP
  15 Some OVSDB databases and schemas, especially very old ones, do not
  16 have a version number.
  17 .PP
  18 Schema version numbers and Open vSwitch version numbers are
  19 independent.