aboutsummaryrefslogtreecommitdiff
path: root/INSTALL.Linux
AgeCommit message (Collapse)Author
2012-03-02INSTALL.Linux: minor typoChris Wright
s/ovsdmonitor/ovsdbmonitor/ Signed-off-by: Chris Wright <chrisw@sous-sol.org> Signed-off-by: Ben Pfaff <blp@nicira.com>
2011-08-17INSTALL.Linux: Fix up reference to old option name --with-l26.Philippe Jung
2011-07-26ovs-vswitchd: Make database socket command-line argument optional.Ben Pfaff
In practice the default location is the only one used, so we might as well make it easy.
2011-07-26ovsdb-server: Make database command-line argument optional.Ben Pfaff
In practice the default location is the only one used, so we might as well make it easier.
2011-06-24datapath: Rename linux-2.6 and compat-2.6 directories.Jesse Gross
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-22configure: Change --with-l26 to --with-linux.Ben Pfaff
Linux 3.0 will be out soon, so it seems like a good idea to reflect that in our "configure" script options.
2011-04-21INSTALL.Linux: Mention that SSL options require building with SSL support.Ben Pfaff
Reported-by: Aaron Rosen <arosen@clemson.edu>
2011-04-06Update top-level documentation to bring it up to date with latest features.Ben Pfaff
2011-03-16Support vlan_group workaround implemented in XenServer kernels.Ben Pfaff
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-02-23ovs-kill: Remove.Ben Pfaff
This utility isn't used anywhere (except INSTALL.Linux), so remove it. Signed-off-by: Ben Pfaff <blp@nicira.com> Coverity #10708.
2011-02-18ovsdb: Remove 'managers' column from 'Open vSwitch' table.Andrew Evans
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-11xenserver: Merge upstream changes and drop pre-5.6.100 support.Andrew Evans
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-10docs: Consistently suggest /etc/openvswitch/conf.db as location for db.Ben Pfaff
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-07datapath: Add module parameter to allow TSO with vlans.Jesse Gross
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>
2010-12-22INSTALL.Linux: Make pkg-config a requirement to build.Ben Pfaff
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-10-01INSTALL.Linux: Describe how to upgrade the Open vSwitch database.Ben Pfaff
Suggested-by: Parham Kiani <pkiani@essex.ac.uk>
2010-08-30INSTALL.Linux: Don't discourage building Debian packages.Ben Pfaff
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-26configure: Enable OpenSSL support by default.Ben Pfaff
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-02INSTALL.Linux: Improve suggested ovsdb-server invocation.Ben Pfaff
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-06-24docs: Correct DB init instructions in INSTALL.Linux.Jesse Gross
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-24vswitchd: Add entity-relationship diagram to ovs-vswitchd.conf.db.5.Ben Pfaff
I've updated http://openvswitch.org/ovs-vswitchd.conf.db.5.pdf with example output.
2010-06-23Better document how ovsdb-server is meant to be used.Ben Pfaff
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-22INSTALL.Linux: Add some troubleshooting instructions for module loading.Ben Pfaff
Suggested-by: kk yap <yapkke@stanford.edu>
2010-06-11INSTALL.Linux: Note the need for CONFIG_TUN and /dev/net/tun.Ben Pfaff
2010-06-11Mention that /dev/urandom is needed.Ben Pfaff
2010-05-19gre: Check whether IPv6 is compiled into the kernel.Jesse Gross
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-13Add ovsdbmonitor GUI tool by Andy Southgate, contributed by Citrix.Andy Southgate
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-03-26Cleanup default file locations and XenServer packagingJustin Pettit
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-24INSTALL.Linux: Consistently assume installation in /usr/local.Ben Pfaff
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-24INSTALL.Linux: Document "ovs-vsctl init" step to installation.Ben Pfaff
If the database is not initialized then other programs will complain. Reported-by: Jeongkeun Lee <jklee@hp.com>
2010-03-08Raise minimum Autoconf version to 2.64.Ben Pfaff
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-04Update Open vSwitch documentation.Ben Pfaff
2010-02-25Remove PCRE dependency.Ben Pfaff
2010-02-08ovsdb: Fix support for systems where libpcre is not installed.Ben Pfaff
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.
2009-12-03Distribute ovsdb-idlc built sources, so Python is not required for build.Ben Pfaff
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-11-18Document userspace switch.Ben Pfaff
2009-11-18Update documentation to mention correct Autoconf version prerequisite.Ben Pfaff
2009-11-10Merge citrix branch into master.Jesse Gross
2009-11-09Make ovs-appctl easier to use and synchronize its interface with ovs-vsctl.Ben Pfaff
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-03Mention running boot.sh when pulling sources from GitJustin Pettit
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-07-16Minor documentation fixups.Keith Amidon
2009-06-25Adjust Open vSwitch mailing lists to reflect realityJustin Pettit
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-09Update documentation.Ben Pfaff