mirror of
https://github.com/openvswitch/ovs
synced 2025-10-25 15:07:05 +00:00
bc39196036
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.
74 lines
2.7 KiB
Plaintext
74 lines
2.7 KiB
Plaintext
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
|
|
generic Linux host, see INSTALL.Linux instead.
|
|
|
|
These instructions have been tested with XenServer versions 5.5.0,
|
|
5.5.0-24648p (Update 1), 5.5.0-25727p (Update 2), and 5.5.900.
|
|
|
|
Building Open vSwitch for XenServer
|
|
-----------------------------------
|
|
|
|
The recommended build environment to build RPMs for Citrix XenServer
|
|
is the DDK VM available from Citrix. If you are building from an Open
|
|
vSwitch distribution tarball, this VM has all the tools that you will
|
|
need. If you are building from an Open vSwitch Git tree, then you
|
|
will need to first create a distribution tarball elsewhere, by running
|
|
"./boot.sh; ./configure; make dist" in the Git tree, because the DDK
|
|
VM does not include Autoconf or Automake that are required to
|
|
bootstrap the Open vSwitch distribution.
|
|
|
|
Once you have a distribution tarball, copy it into
|
|
/usr/src/redhat/SOURCES inside the VM. Then execute the following:
|
|
|
|
VERSION=<Open vSwitch version>
|
|
XENKERNEL=<Xen kernel version>
|
|
cd /tmp
|
|
tar xfz /usr/src/redhat/SOURCES/openvswitch-$VERSION.tar.gz
|
|
rpmbuild \
|
|
-D "openvswitch_version $VERSION" \
|
|
-D "xen_version $XENKERNEL" \
|
|
-bb openvswitch-$VERSION/xenserver/openvswitch-xen.spec
|
|
|
|
where:
|
|
|
|
<openvswitch version> is the version number that appears in the
|
|
name of the Open vSwitch tarball, e.g. 0.90.0.
|
|
|
|
<Xen kernel version> is the version number of the Xen kernel,
|
|
e.g. 2.6.18-128.1.1.el5.xs5.5.0.487.1006xen. This version number
|
|
appears as the name of a directory in /lib/modules inside the VM.
|
|
It always ends in "xen".
|
|
|
|
Two RPMs will be output into /usr/src/redhat/RPMS, whose names begin
|
|
with "openvswitch" and "openvswitch-debuginfo".
|
|
|
|
Installing Open vSwitch for XenServer
|
|
-------------------------------------
|
|
|
|
To install Open vSwitch on a XenServer host, or to upgrade to a newer
|
|
version, copy the "openvswitch" RPM to that host with "scp", then install
|
|
it with "rpm -U", e.g.:
|
|
|
|
scp openvswitch-$VERSION-1.i386.rpm root@<host>:
|
|
(At this point you will have to enter <host>'s root password.)
|
|
ssh root@<host>
|
|
(At this point you will have to enter <host>'s root password again.)
|
|
rpm -U openvswitch-$VERSION-1.i386.rpm
|
|
|
|
To uninstall Open vSwitch from a XenServer host, remove the package:
|
|
|
|
ssh root@<host>
|
|
(At this point you will have to enter <host>'s root password again.)
|
|
rpm -e openvswitch
|
|
|
|
After installing or uninstalling Open vSwitch, the XenServer should be
|
|
rebooted as soon as possible.
|
|
|
|
Reporting Bugs
|
|
--------------
|
|
|
|
Please report problems to bugs@openvswitch.org.
|