2
0
mirror of https://github.com/openvswitch/ovs synced 2025-10-19 14:37:21 +00:00
Commit Graph

42 Commits

Author SHA1 Message Date
Philippe Jung
338fb44ad6 INSTALL.Linux: Fix up reference to old option name --with-l26. 2011-08-17 11:39:36 -07:00
Ben Pfaff
80df177a5f ovs-vswitchd: Make database socket command-line argument optional.
In practice the default location is the only one used, so we might as well
make it easy.
2011-07-26 16:50:08 -07:00
Ben Pfaff
2970119462 ovsdb-server: Make database command-line argument optional.
In practice the default location is the only one used, so we might as well
make it easier.
2011-07-26 16:50:08 -07:00
Jesse Gross
22bcc0e70b datapath: Rename linux-2.6 and compat-2.6 directories.
The linux-2.6 and compat-2.6 directories apply equally to the upcoming
Linux 3.0 release, so this drops the 2.6 suffix and updates Makefiles.

Signed-off-by: Jesse Gross <jesse@nicira.com>
Acked-by: Ben Pfaff <blp@nicira.com>
2011-06-24 14:37:49 -07:00
Ben Pfaff
8a2d6596f2 configure: Change --with-l26 to --with-linux.
Linux 3.0 will be out soon, so it seems like a good idea to reflect that
in our "configure" script options.
2011-06-22 14:05:53 -07:00
Ben Pfaff
d3e3fb58ad INSTALL.Linux: Mention that SSL options require building with SSL support.
Reported-by: Aaron Rosen <arosen@clemson.edu>
2011-04-21 09:44:56 -07:00
Ben Pfaff
c9d3af4e88 Update top-level documentation to bring it up to date with latest features. 2011-04-06 09:51:48 -07:00
Ben Pfaff
431488e663 Support vlan_group workaround implemented in XenServer kernels.
Some Linux network drivers support a feature called "VLAN acceleration",
associated with a data structure called a "vlan_group".  A vlan_group is,
abstractly, a dictionary that maps from a VLAN ID (in the range 0...4095)
to a VLAN device, that is, a Linux network device associated with a
particular VLAN, e.g. "eth0.9" for VLAN 9 on eth0.

Some drivers that support VLAN acceleration have bugs that fall roughly
into the following categories:

    * Some NICs strip VLAN tags on receive if no vlan_group is registered,
      so that the tag is completely lost.

    * Some drivers size their receive buffers based on whether a vlan_group
      is enabled, meaning that a maximum size packet with a VLAN tag will
      not fit if a vlan_group is not configured.

    * On transmit some drivers expect that VLAN acceleration will be used
      if it is available (which can only be done if a vlan_group is
      configured).  In these cases, the driver may fail to parse the packet
      and correctly setup checksum offloading and/or TSO.

The correct long term solution is to fix these driver bugs.  To cope until
then, we have prepared a patch to the Linux kernel network stack that works
around these problems.  This commit adds support for the workaround
implemented by that patch.

Signed-off-by: Ben Pfaff <blp@nicira.com>
Acked-by: Jesse Gross <jesse@nicira.com>
2011-03-16 14:39:17 -07:00
Ben Pfaff
fbca1e20e8 ovs-kill: Remove.
This utility isn't used anywhere (except INSTALL.Linux), so remove it.

Signed-off-by: Ben Pfaff <blp@nicira.com>
Coverity #10708.
2011-02-23 15:14:42 -08:00
Andrew Evans
289df16d29 ovsdb: Remove 'managers' column from 'Open vSwitch' table.
We had retained but deprecated the use of the older 'managers' column in the
'Open vSwitch' table for compatibility with applications that might still use
it, but that created more problems than it solved. This commit removes the
'managers' column from the schema, and removes all references to it from the
code, init scripts, documentation, and tests.
2011-02-18 11:09:29 -08:00
Andrew Evans
404c169247 xenserver: Merge upstream changes and drop pre-5.6.100 support.
Citrix have made modifications to the various interface configuration scripts
that OVS replaces, so at present those modifications are lost when OVS is
installed on e.g. XenServer 5.6.100. This commit applies those changes while
preserving OVS-specific modifications that have been made in the interim.

One major change introduced by these updates is the removal of support for
XenServer releases prior to 5.6.100.

This commit also updates the OVS-supplied xen-bugtool in similar fashion. We
will soon remove xen-bugtool from OVS altogether and move the added OVS
functionality to an XML extension as described in the Supplemental Pack DDK
guide.
2011-02-11 13:03:06 -08:00
Ben Pfaff
028415b60c docs: Consistently suggest /etc/openvswitch/conf.db as location for db.
Our Debian and XenServer packages use /etc/openvswitch/conf.db as the
location for the database but some of the docs suggested
/etc/ovs-vswitchd.conf.db.  This settles on the former consistently.
The manpage is still ovs-vswitchd.conf.db but I don't know what to do
about that.
2011-02-10 13:20:27 -08:00
Jesse Gross
3f6256afdc datapath: Add module parameter to allow TSO with vlans.
We currently perform GSO on packets before adding a vlan tag,
which is reliable but hurts performance.  Even NICs that support
TSO on vlan tagged packets typically expect vlan acceleration to
be used.  Before 2.6.37 we can't use vlan acceleration and must
place the tag in the packet itself, which is risky when used with
TSO.  However, if the driver is known to work with internally
tagged packets and TSO this exposes a module parameter to enable it.

Signed-off-by: Jesse Gross <jesse@nicira.com>
Acked-by: Ben Pfaff <blp@nicira.com>
2011-02-07 13:49:01 -08:00
Ben Pfaff
9f8bf569bd INSTALL.Linux: Make pkg-config a requirement to build.
pkg-config is needed to detect the presence of libssl, so it is needed even
if the build system doesn't need to be rebuilt.

In theory we'd only need pkg-config if OpenSSL is to be used, but I don't
see much point in being that explicit.

Reported-by: Bryan Osoro <bosoro@nicira.com>
2010-12-22 10:02:32 -08:00
Ben Pfaff
8b055d9253 INSTALL.Linux: Describe how to upgrade the Open vSwitch database.
Suggested-by: Parham Kiani <pkiani@essex.ac.uk>
2010-10-01 13:51:54 -07:00
Ben Pfaff
90a249dc93 INSTALL.Linux: Don't discourage building Debian packages.
For a while the Debian packages were not well maintained or regularly used,
but we at Nicira use them all the time now.  We now aim to have them
accepted into Debian downstream, so we should at least not discourage
users from trying them out.

Signed-off-by: Ben Pfaff <blp@nicira.com>
2010-08-30 11:38:51 -07:00
Ben Pfaff
f272ec7373 configure: Enable OpenSSL support by default.
Years ago some users had broken OpenSSL libraries that didn't actually
work, so we disabled OpenSSL by default.  By now, I hope that those users
have fixed their systems.
2010-08-26 13:51:38 -07:00
Ben Pfaff
8084a2800f INSTALL.Linux: Improve suggested ovsdb-server invocation.
ovsdb-server should ordinarily connect to managers specified in the
database itself, as well as use the SSL configuration specified in the
database, but the suggested ovsdb-server command line didn't do that.
This commit adds all the relevant arguments that the XenServer integration
passes by default.

Reported-by: Hao Zheng <hzheng@nicira.com>
2010-08-02 16:04:47 -07:00
Jesse Gross
de4f3c10b2 docs: Correct DB init instructions in INSTALL.Linux.
We tell people to run "ovs-vsctl init" before starting
ovs-vswitchd but this causes it to hang until it times
out so add "--no-wait" as well.
2010-06-24 15:50:53 -07:00
Ben Pfaff
f8d739a9fa vswitchd: Add entity-relationship diagram to ovs-vswitchd.conf.db.5.
I've updated http://openvswitch.org/ovs-vswitchd.conf.db.5.pdf with
example output.
2010-06-24 13:18:43 -07:00
Ben Pfaff
cb8141b233 Better document how ovsdb-server is meant to be used.
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.
2010-06-23 09:54:14 -07:00
Ben Pfaff
dd2d79ce3e INSTALL.Linux: Add some troubleshooting instructions for module loading.
Suggested-by: kk yap <yapkke@stanford.edu>
2010-06-22 13:59:04 -07:00
Ben Pfaff
26bb189de2 INSTALL.Linux: Note the need for CONFIG_TUN and /dev/net/tun. 2010-06-11 10:52:11 -07:00
Ben Pfaff
6e8e271c0d Mention that /dev/urandom is needed. 2010-06-11 10:52:11 -07:00
Jesse Gross
6f4709828b gre: Check whether IPv6 is compiled into the kernel.
Add guards to check whether IPv6 is supported by the kernel instead
of causing the module to fail to load.  If IPv6 is not supported
these packets can still be encapsulated but they will not receive any
special treatment such as path MTU discovery.
2010-05-19 12:33:33 -07:00
Andy Southgate
436f27dd88 Add ovsdbmonitor GUI tool by Andy Southgate, contributed by Citrix.
With Makefiles and Autoconfiscation by Ben Pfaff.

Signed-off-by: Thomas Lacroix <thomas.lacroix@citrix.com>
Signed-off-by: Ben Pfaff <blp@nicira.com>
2010-05-13 14:53:39 -07:00
Justin Pettit
bc39196036 Cleanup default file locations and XenServer packaging
This commit cleans up the locations of a number of files and directories
used.  These include:

    - Config file lives in /etc/openvswitch/conf.db
    - Logs go into /var/log/openvswitch
    - ovsdb-server socket is /var/run/openvswitch/db.sock
    - Schema goes into /usr/share/openvswitch/vswitch.ovsschema
    - PID files go in /var/run/openvswitch

For XenServer, these additional changes are made:

    - Cores go in /var/xen/openvswitch
    - OVS binaries run in /var/xen/openvswitch

In addition, it attempts to cleanup the XenServer packaging.  This
includes referring to the project as "openvswitch" as opposed to the
somewhat presumptuous "vswitch".

Note: Changes to the Debian packaging will be forthcoming.
2010-03-26 14:40:31 -07:00
Ben Pfaff
e1bd9cce54 INSTALL.Linux: Consistently assume installation in /usr/local.
The documentation was inconsistent about assuming whether the installation
was to / or to /usr/local.  Since the default is /usr/local, use that.

Reported-by: Jeongkeun Lee <jklee@hp.com>
2010-03-24 14:42:25 -07:00
Ben Pfaff
332b4e0986 INSTALL.Linux: Document "ovs-vsctl init" step to installation.
If the database is not initialized then other programs will complain.

Reported-by: Jeongkeun Lee <jklee@hp.com>
2010-03-24 14:42:23 -07:00
Ben Pfaff
55aa00e0df Raise minimum Autoconf version to 2.64.
Our configure scripts were actually using Autoconf features introduced in
version 2.64 (e.g. AT_SKIP_IF, AT_CHECK_UNQUOTED), so we should not
claim 2.63 as prerequisite.

Reported-by: Andy Southgate <andy.southgate@citrix.com>
2010-03-08 14:25:20 -08:00
Ben Pfaff
3b12addabb Update Open vSwitch documentation. 2010-03-04 10:05:44 -08:00
Ben Pfaff
a26cc67c16 Remove PCRE dependency. 2010-02-25 14:59:41 -08:00
Ben Pfaff
bfe8e67ad5 ovsdb: Fix support for systems where libpcre is not installed.
This is one of the loose ends that I intended to fix up and test before
pushing off my commits to add use of PCRE, but obviously I forgot.
2010-02-08 15:37:49 -08:00
Ben Pfaff
195b5c3563 Distribute ovsdb-idlc built sources, so Python is not required for build.
The Xen DDK VM does not include Python, so it's best if we don't have to
require it for the build.

The built sources are still regenerated if necessary.
2009-12-03 17:06:46 -08:00
Ben Pfaff
d377243b85 Document userspace switch. 2009-11-18 12:57:18 -08:00
Ben Pfaff
37c9895288 Update documentation to mention correct Autoconf version prerequisite. 2009-11-18 10:03:34 -08:00
Jesse Gross
d65349ea28 Merge citrix branch into master. 2009-11-10 15:12:01 -08:00
Ben Pfaff
3fbe1d307e Make ovs-appctl easier to use and synchronize its interface with ovs-vsctl.
It is inconvenient to type the whole path to the Unix daemon socket when
using ovs-appctl.  Allow the name of the daemon to be used instead when
a pidfile exists in the default location, and contact ovs-vswitchd by
default.

Also, the various options for manipulating vlog were invented before the
general-purpose command mechanism existed.  Get rid of all of the action
options in favor of just specifying the command to be executed as
non-option arguments.

Finally, there simply wasn't much value in allowing multiple targets or
options to be specified; these variations were never used in practice.  So
simplify the interface by making it one target, one action per invocation.

Also, make ovs-vsctl use the same syntax for its --target option.

Based on work by Justin Pettit.
2009-11-09 14:46:38 -08:00
Justin Pettit
30746a1b6a Mention running boot.sh when pulling sources from Git
When the sources are pulled directly from Git, it is necessary to run
"./boot.sh" before "./configure" can be run.  This commit documents that
useful bit of information.
2009-11-03 15:37:03 -08:00
Keith Amidon
e5660bae19 Minor documentation fixups. 2009-07-16 18:07:56 -07:00
Justin Pettit
37ea6436bd Adjust Open vSwitch mailing lists to reflect reality
We've gone through a couple of iterations for names of these mailing
lists.  Currently, there are three: announce, discuss, and git.  There
are aliases that point "bugs" and "dev" to the "discuss" mailing list.
This commit drops the "ovs-" prefix to mailing lists, since we're not
using them.
2009-06-25 00:36:42 -07:00
Ben Pfaff
4b11d5e8d3 Update documentation. 2009-06-09 13:09:08 -07:00