tunnel: test VXLAN receive and UDP checksum
[cascardo/ovs.git] / INSTALL.XenServer.md
index e4408dd..0c64be3 100644 (file)
@@ -3,9 +3,12 @@ How to Install Open vSwitch on Citrix XenServer
 
 This document describes how to build and install Open vSwitch on a
 Citrix XenServer host.  If you want to install Open vSwitch on a
 
 This document describes how to build and install Open vSwitch on a
 Citrix XenServer host.  If you want to install Open vSwitch on a
-generic Linux or BSD host, see [INSTALL](INSTALL.md) instead.
+generic Linux or BSD host, see [INSTALL.md] instead.
+
+Open vSwitch should work with XenServer 5.6.100 and later.  However,
+Open vSwitch requires Python 2.7 or later, so using Open vSwitch with
+XenServer 6.5 or earlier requires installing Python 2.7.
 
 
-These instructions have been tested with XenServer 5.6 FP1.
 
 Building Open vSwitch for XenServer
 -----------------------------------
 
 Building Open vSwitch for XenServer
 -----------------------------------
@@ -19,8 +22,8 @@ RPMs for Citrix XenServer is the DDK VM available from Citrix.
    ./configure; make dist` in the Git tree.  You cannot run this in
    the DDK VM, because it lacks tools that are necessary to bootstrap
    the Open vSwitch distribution.  Instead, you must run this on a
    ./configure; make dist` in the Git tree.  You cannot run this in
    the DDK VM, because it lacks tools that are necessary to bootstrap
    the Open vSwitch distribution.  Instead, you must run this on a
-   machine that has the tools listed in [INSTALL](INSTALL.md) as
-   prerequisites for building from a Git tree.
+   machine that has the tools listed in [INSTALL.md] as prerequisites
+   for building from a Git tree.
 
 2. Copy the distribution tarball into /usr/src/redhat/SOURCES inside
    the DDK VM.
 
 2. Copy the distribution tarball into /usr/src/redhat/SOURCES inside
    the DDK VM.
@@ -80,6 +83,18 @@ where:
     The "xen" flavor is the main running kernel flavor and the "kdump" flavor is
     the crashdump kernel flavor. Commonly, one would specify "xen" here.
 
     The "xen" flavor is the main running kernel flavor and the "kdump" flavor is
     the crashdump kernel flavor. Commonly, one would specify "xen" here.
 
+For XenServer 6.5 or above, the kernel version naming no longer contains
+KERNEL_FLAVOR.  In fact, only providing the `uname -r` output is enough.
+So, the final "rpmbuild" step changes to:
+
+   ```
+   KERNEL_UNAME=<`uname -r` output>
+   rpmbuild \
+        -D "kenel_uname $KERNEL_UNAME" \
+        -bb xenserver/openvswitch-xen.spec
+   ```
+
+
 Installing Open vSwitch for XenServer
 -------------------------------------
 
 Installing Open vSwitch for XenServer
 -------------------------------------
 
@@ -190,3 +205,5 @@ Reporting Bugs
 --------------
 
 Please report problems to bugs@openvswitch.org.
 --------------
 
 Please report problems to bugs@openvswitch.org.
+
+[INSTALL.md]:INSTALL.md