Better document how ovsdb-server is meant to be used.
authorBen Pfaff <blp@nicira.com>
Fri, 18 Jun 2010 22:58:13 +0000 (15:58 -0700)
committerBen Pfaff <blp@nicira.com>
Wed, 23 Jun 2010 16:54:14 +0000 (09:54 -0700)
DarkBls <darkbls@yahoo.com> had the idea that a single ovsdb-server could
be used to serve configuration details across the network to multiple
remote ovs-vswitchd instances.  This doesn't work, but the documentation
didn't spell it out.  This commit should help.

INSTALL.Linux
vswitchd/ovs-vswitchd.8.in

index bd7038c85321ff9d3f49d1669774e83fe1dcccc4..b4f9b767863a705d3439e5f8cad5a4d49434bf05 100644 (file)
@@ -229,9 +229,10 @@ Startup
 =======
 
 Before starting ovs-vswitchd itself, you need to start its
-configuration database, ovsdb-server.  Configure it to use the
-database you created during step 7 of installation, above, and to
-listen on a Unix domain socket, e.g.:
+configuration database, ovsdb-server.  Each machine on which Open
+vSwitch is installed should run its own copy of ovsdb-server.
+Configure it to use the database you created during step 7 of
+installation, above, and to listen on a Unix domain socket, e.g.:
 
       % ovsdb-server /usr/local/etc/ovs-vswitchd.conf.db --remote=punix:/usr/local/var/run/openvswitch/db.sock
 
index 0a7369e90c5adadcde032550187438cabf5c1d38..0e5d3188ef1d817aee0bc92bf20d05114547415b 100644 (file)
@@ -18,9 +18,10 @@ ovs\-vswitchd \- Open vSwitch daemon
 A daemon that manages and controls any number of Open vSwitch switches 
 on the local machine.
 .PP
-The mandatory \fIdatabase\fR argument specifies the
-\fBovsdb\-server\fR from which \fBovs\-vswitchd\fR's configuration
-should be retrieved.  It takes one of the following forms:
+The mandatory \fIdatabase\fR argument normally takes the form
+\fBunix:\fIfile\fR, where \fIfile\fR is the name of a Unix domain
+socket on which \fBovsdb-server\fR is listening.  However, all of the
+following forms are accepted:
 .so ovsdb/remote-active.man
 .so ovsdb/remote-passive.man
 .PP