2 .TH ovsdb\-server 1 "November 2009" "Open vSwitch" "Open vSwitch Manual"
6 ovsdb\-server \- Open vSwitch database server
11 [\fB--remote=\fIremote\fR]\&...
12 [\fB--run=\fIcommand\fR]
13 .so lib/daemon-syn.man
15 .so lib/common-syn.man
18 The \fBovsdb\-server\fR program provides RPC interfaces to an Open
19 vSwitch database (OVSDB). It supports JSON-RPC client connections
20 over active or passive TCP/IP or Unix domain sockets.
22 The name of the OVSDB file must be specified on the command line as
23 \fIdatabase\fR, which must already have been created and initialized
24 using, for example, \fBovsdb\-tool create\fR.
28 .IP "\fB\-\-remote=\fIremote\fR"
29 Adds \fIremote\fR as a connection method used by \fBovsdb\-server\fR.
30 \fIremote\fR must take one of the following forms:
33 .so ovsdb/remote-passive.man
34 .so ovsdb/remote-active.man
37 .IP "\fB\-\-run=\fIcommand\fR]"
38 Ordinarily \fBovsdb\-server\fR runs forever, or until it is told to
39 exit (see \fBRUNTIME MANAGEMENT COMMANDS\fR below). With this option,
40 \fBovsdb\-server\fR instead starts a shell subprocess running
41 \fIcommand\fR. When the subprocess terminates, \fBovsdb\-server\fR
42 also exits gracefully. If the subprocess exits normally with exit
43 code 0, then \fBovsdb\-server\fR exits with exit code 0 also;
44 otherwise, it exits with exit code 1.
46 This option can be useful where a database server is needed only to
47 run a single command, e.g.:
48 .B "ovsdb-server --remote=punix:socket --run='ovsdb-client dump unix:socket Open_vSwitch'"
56 .SH "RUNTIME MANAGEMENT COMMANDS"
57 \fBovs\-appctl\fR(8) can send commands to a running
58 \fBovsdb\-server\fR process. The currently supported commands are
60 .SS "OVSDB-SERVER COMMANDS"
61 These commands are specific to \fBovsdb\-server\fR.
63 Causes \fBovsdb\-server\fR to gracefully terminate.
64 .IP "\fBovsdb-server/compact\fR"
65 Compacts the database in-place. The database is also automatically
66 compacted occasionally.
67 .so lib/vlog-unixctl.man