INSTALL.XenServer

This software is distributed under the following license:
http://sflow.net/license.html

Citrix XenServer
================

To compile for XenServer, install these sources into the
equivalent XenServer DDK VM.  For XenServer 7.0 you will
also need to follow these steps on the DDK:

(1) enable yum repo /etc/yum.repos.d/CentOS-Base
 * - substitute "7" for $releasever everwhere
 * - change "enabled=0" to "enabled=1" for each repo
 * - uncomment base URL for each repo
(2) download XenServer Developement Packages (binpkg.iso)
    and mount somewhere that is URL accessible,  then
    add a new repo file for it. For example, on a
    Linux server with httpd at 10.0.0.23 I ran:
mkdir /var/www/html/binpkg
mount -o loop XenServer-7.0.0-binpkg.iso /var/www/html/binpkg
    Then added /etc/yum.repos.d/xen.repo with:
[binpkg]
name=CitrixXenServer7
enabled=1
baseurl=http://10.0.0.23/binpkg
gpgcheck=0

(3) install the extra packages:
yum install xen-libs-devel xen-dom0-libs-devel dbus-devel

Now compile with:

DDK> make xenserver

The Xenserver .iso will now be accessible as
xenserver-ddk/hsflowd-xenserver.iso.

To install, copy it to the XenServer dom0 and run these commands:

mkdir /tmp/iso 
mount -o loop hsflowd-xenserver.iso /tmp/iso 
cd /tmp/iso 
./install 
cd 
umount /tmp/iso

If Open VSwitch is running (it is the default virtual switch
in XenServer 6.0 and later), then make sure /etc/hsflowd.conf
has the line:

  ovs {}

to enable the OVS module. This will propagate sFlow configuration
from hsflowd to the switch via ovs-vsctl(1).  This in turn will
turn on standard sFlow monitoring of all the traffic through
 the virtual switch, providing L2-L7 visibility into the traffic
patterns (including MAC, VLAN, ARP, FCoE, IPv4, IPv6, TCP, UDP
and ICMP) as well as providing a feed of standard interface-counter
data for every virtual port on the switch.

Now start the daemon.  On XenServer 7.0 or later, run:
systemctl daemon-reload
systemctl start hsflowd

Otherwise, run:
chkconfig --add hsflowd
service hsflowd start

Output will go to /var/log/messages.