README

This directory contains files for seamless integration of Open vSwitch on
Citrix XenServer hosts managed by the Citrix management tools.

Files in this directory are licensed on a file-by-file basis.  Please
refer to each file for details.

Most of the files in this directory are installed on a XenServer system
under the same name; underscores are replaced by slashes.  The files are:

    etc_init.d_openvswitch

        Initializes Open vSwitch at boot and shuts it down at shutdown.

    etc_init.d_openvswitch-xapi-update

        Init script to ensure openvswitch-cfg-update is called for the
        current host at boot.

    etc_logrotate.d_openvswitch

        Ensures that logs in /var/log/openvswitch are rotated
        periodically and that appropriate daemons reopen their log
        files at that point.

    etc_profile.d_openvswitch.sh

        Open vSwitch-related shell functions for the administrator's
        convenience.

    etc_xapi.d_plugins_openvswitch-cfg-update

        xapi plugin script to update the cache of configuration items
        in the ovs-vswitchd configuration that are managed in the
        xapi database when integrated with Citrix management tools.

    etc_xensource_scripts_vif

        Open vSwitch-aware replacement for Citrix script of the same name.

    openvswitch-xen.spec

        spec file for building RPMs to install on a XenServer host.

    opt_xensource_libexec_interface-reconfigure
    opt_xensource_libexec_InterfaceReconfigureBridge.py
    opt_xensource_libexec_InterfaceReconfigure.py
    opt_xensource_libexec_InterfaceReconfigureVswitch.py

        Open vSwitch-aware replacements for Citrix script of the same
        names.

    usr_lib_xsconsole_plugins-base_XSFeatureVSwitch.py

        xsconsole plugin to configure the pool-wide configuration keys
        used to control Open vSwitch when integrated with Citrix
        management tools.

    usr_share_openvswitch_scripts_ovs-xapi-sync

        Daemon to monitor the external_ids columns of the Bridge and
        Interface OVSDB tables for changes that require interrogating
        XAPI.

    usr_share_openvswitch_scripts_sysconfig.template

        Template for Open vSwitch's /etc/sysconfig/openvswitch
        configuration file.

Open vSwitch installs a number of xen-bugtool extensions in
/etc/xensource/bugtool to gather additional information useful for
debugging.  The sources for the extensions are in
../utilities/bugtool/plugins:

    kernel-info/openvswitch.xml

        Collect kernel information relevant to Open vSwitch, such as
        slabinfo.

    network-status/openvswitch.xml

        Collect networking information relevant to Open vSwitch.  Runs
        the following scripts, which are described below:

            * ovs-bugtool-bfd-show
            * ovs-bugtool-cfm-show
            * ovs-bugtool-fdb-show
            * ovs-bugtool-lacp-show
            * ovs-bugtool-list-dbs
            * ovs-bugtool-ovsdb-dump
            * ovs-bugtool-tc-class-show
            * ovs-bugtool-bond-show
            * ovs-bugtool-ovs-ofctl-show
            * ovs-bugtool-ovs-ofctl-dump-flows
            * ovs-bugtool-ovs-appctl-dpif
            * ovs-bugtool-coverage-show
            * ovs-bugtool-memory-show
            * ovs-bugtool-vsctl-show

    system-configuration/openvswitch.xml

        Collect system configuration information relevant to Open vSwitch,
        including timezone. Runs the following script which is described
        below:

            * ovs-bugtool-daemons-ver

    system-configuration.xml

        Collect system configuration data.  This category is configured
        to collect up to 1Mb of data, take up to 60 seconds to collect
        data, run every time and is hidden from display in XenCenter.

A number of scripts are installed in /usr/share/openvswitch/scripts to
assist Open vSwitch's xen-bugtool extensions.  The sources for the
scripts are located in ../utilities/bugtool:

    ovs-bugtool-bfd-show

        Script to dump detailed BFD information for all enabled interfaces.

    ovs-bugtool-cfm-show

        Script to dump detailed CFM information for all enabled interfaces.

    ovs-bugtool-fdb-show

        Script to collect a summary of learned MACs for each bridge.

    ovs-bugtool-lacp-show

        Script to dump detailed LACP information for all enabled ports.

    ovs-bugtool-list-dbs

        Script to list the databases controlled by ovsdb-server.

    ovs-bugtool-ovsdb-dump

        Script to dump contents of Open vSwitch configuration database 
        in comma-separated value format.

    ovs-bugtool-tc-class-show

        Script to dump tc class configuration for all network interfaces.

    ovs-bugtool-ovs-ofctl-show

        Script to dump information about flow tables and ports of each bridge.

    ovs-bugtool-ovs-ofctl-dump-flows

        Script to dump openflow flows of each bridge.

    ovs-bugtool-ovs-appctl-dpif

        Script to collect a summary of configured datapaths and datapath flows.

    ovs-bugtool-coverage-show

        Script to count the number of times particular events occur during
        ovs-vswitchd's runtime.

    ovs-bugtool-memory-show

        Script to show some basic statistics about ovs-vswitchd's memory usage.

    ovs-bugtool-vsctl-show

        Script to show a brief overview of the database contents.

    ovs-bugtool-daemons-ver

        Script to dump version information for all Open vSwitch daemons.

----------------------------------------------------------------------
Copyright (C) 2009, 2010, 2011 Nicira, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without warranty of any kind.