1 This directory contains files for seamless integration of Open vSwitch on
2 Citrix XenServer hosts managed by the Citrix management tools.
4 Files in this directory are licensed on a file-by-file basis. Please
5 refer to each file for details.
7 Most of the files in this directory are installed on a XenServer system
8 under the same name; underscores are replaced by slashes. The files are:
10 etc_init.d_openvswitch
12 Initializes Open vSwitch at boot and shuts it down at shutdown.
14 etc_init.d_openvswitch-xapi-update
16 Init script to ensure openvswitch-cfg-update is called for the
19 etc_logrotate.d_openvswitch
21 Ensures that logs in /var/log/openvswitch are rotated
22 periodically and that appropriate daemons reopen their log
25 etc_profile.d_openvswitch.sh
27 Open vSwitch-related shell functions for the administrator's
30 etc_xapi.d_plugins_openvswitch-cfg-update
32 xapi plugin script to update the cache of configuration items
33 in the ovs-vswitchd configuration that are managed in the
34 xapi database when integrated with Citrix management tools.
36 etc_xensource_scripts_vif
38 Open vSwitch-aware replacement for Citrix script of the same name.
42 spec file for building RPMs to install on a XenServer host.
44 opt_xensource_libexec_interface-reconfigure
45 opt_xensource_libexec_InterfaceReconfigureBridge.py
46 opt_xensource_libexec_InterfaceReconfigure.py
47 opt_xensource_libexec_InterfaceReconfigureVswitch.py
49 Open vSwitch-aware replacements for Citrix script of the same
52 usr_lib_xsconsole_plugins-base_XSFeatureVSwitch.py
54 xsconsole plugin to configure the pool-wide configuration keys
55 used to control Open vSwitch when integrated with Citrix
58 usr_share_openvswitch_scripts_ovs-xapi-sync
60 Daemon to monitor the external_ids columns of the Bridge and
61 Interface OVSDB tables for changes that require interrogating
64 usr_share_openvswitch_scripts_sysconfig.template
66 Template for Open vSwitch's /etc/sysconfig/openvswitch
69 Open vSwitch installs a number of xen-bugtool extensions in
70 /etc/xensource/bugtool to gather additional information useful for
71 debugging. The sources for the extensions are in
72 ../utilities/bugtool/plugins:
74 kernel-info/openvswitch.xml
76 Collect kernel information relevant to Open vSwitch, such as
79 network-status/openvswitch.xml
81 Collect networking information relevant to Open vSwitch. Runs
82 the following scripts, which are described below:
84 * ovs-bugtool-bfd-show
85 * ovs-bugtool-cfm-show
86 * ovs-bugtool-fdb-show
87 * ovs-bugtool-lacp-show
88 * ovs-bugtool-list-dbs
89 * ovs-bugtool-ovsdb-dump
90 * ovs-bugtool-tc-class-show
91 * ovs-bugtool-bond-show
92 * ovs-bugtool-ovs-ofctl-show
93 * ovs-bugtool-ovs-ofctl-dump-flows
94 * ovs-bugtool-ovs-appctl-dpif
95 * ovs-bugtool-coverage-show
96 * ovs-bugtool-memory-show
97 * ovs-bugtool-vsctl-show
99 system-configuration/openvswitch.xml
101 Collect system configuration information relevant to Open vSwitch,
102 including timezone. Runs the following script which is described
105 * ovs-bugtool-daemons-ver
107 system-configuration.xml
109 Collect system configuration data. This category is configured
110 to collect up to 1Mb of data, take up to 60 seconds to collect
111 data, run every time and is hidden from display in XenCenter.
113 A number of scripts are installed in /usr/share/openvswitch/scripts to
114 assist Open vSwitch's xen-bugtool extensions. The sources for the
115 scripts are located in ../utilities/bugtool:
119 Script to dump detailed BFD information for all enabled interfaces.
123 Script to dump detailed CFM information for all enabled interfaces.
127 Script to collect a summary of learned MACs for each bridge.
129 ovs-bugtool-lacp-show
131 Script to dump detailed LACP information for all enabled ports.
135 Script to list the databases controlled by ovsdb-server.
137 ovs-bugtool-ovsdb-dump
139 Script to dump contents of Open vSwitch configuration database
140 in comma-separated value format.
142 ovs-bugtool-tc-class-show
144 Script to dump tc class configuration for all network interfaces.
146 ovs-bugtool-ovs-ofctl-show
148 Script to dump information about flow tables and ports of each bridge.
150 ovs-bugtool-ovs-ofctl-dump-flows
152 Script to dump openflow flows of each bridge.
154 ovs-bugtool-ovs-appctl-dpif
156 Script to collect a summary of configured datapaths and datapath flows.
158 ovs-bugtool-coverage-show
160 Script to count the number of times particular events occur during
161 ovs-vswitchd's runtime.
163 ovs-bugtool-memory-show
165 Script to show some basic statistics about ovs-vswitchd's memory usage.
167 ovs-bugtool-vsctl-show
169 Script to show a brief overview of the database contents.
171 ovs-bugtool-daemons-ver
173 Script to dump version information for all Open vSwitch daemons.
175 ----------------------------------------------------------------------
176 Copyright (C) 2009, 2010, 2011 Nicira, Inc.
178 Copying and distribution of this file, with or without modification,
179 are permitted in any medium without royalty provided the copyright
180 notice and this notice are preserved. This file is offered as-is,
181 without warranty of any kind.