--- title: Charmhub | Deploy Ovn Dedicated Chassis using Charmhub - The Open Operator Collection description: Deploy the latest version of Ovn Dedicated Chassis on any cloud. url: https://charmhub.io/ovn-dedicated-chassis/configurations --- # Ovn Dedicated Chassis [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers") * [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers") * [Cloud](https://charmhub.io/?filter=cloud) * [Networking](https://charmhub.io/?filter=networking) Platform: 24.04 23.10 23.04 22.10 22.04 20.04 18.04 22.03/stable 91f8805 ``` juju deploy ovn-dedicated-chassis --channel 22.03/stable ``` [Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications) * [bridge-interface-mappings](https://charmhub.io/ovn-dedicated-chassis/configurations#bridge-interface-mappings) * [disable-mlockall](https://charmhub.io/ovn-dedicated-chassis/configurations#disable-mlockall) * [dpdk-runtime-libraries](https://charmhub.io/ovn-dedicated-chassis/configurations#dpdk-runtime-libraries) * [enable-auto-restarts](https://charmhub.io/ovn-dedicated-chassis/configurations#enable-auto-restarts) * [enable-version-pinning](https://charmhub.io/ovn-dedicated-chassis/configurations#enable-version-pinning) * [nagios\_context](https://charmhub.io/ovn-dedicated-chassis/configurations#nagios_context) * [nagios\_servicegroups](https://charmhub.io/ovn-dedicated-chassis/configurations#nagios_servicegroups) * [new-units-paused](https://charmhub.io/ovn-dedicated-chassis/configurations#new-units-paused) * [ovn-bridge-mappings](https://charmhub.io/ovn-dedicated-chassis/configurations#ovn-bridge-mappings) * [ovn-source](https://charmhub.io/ovn-dedicated-chassis/configurations#ovn-source) * [pmd-cpu-set](https://charmhub.io/ovn-dedicated-chassis/configurations#pmd-cpu-set) * [prefer-chassis-as-gw](https://charmhub.io/ovn-dedicated-chassis/configurations#prefer-chassis-as-gw) * [source](https://charmhub.io/ovn-dedicated-chassis/configurations#source) * [vpd-device-spec](https://charmhub.io/ovn-dedicated-chassis/configurations#vpd-device-spec) [Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration) * bridge-interface-mappings | string A space-delimited list of key-value pairs that map a network interface MAC address or name to a local ovs bridge to which it should be connected. Note: MAC addresses of physical interfaces that belong to a bond will be resolved to the bond name and the bond will be added to the ovs bridge. Bridges referenced here must be mentioned in the `ovn-bridge-mappings` configuration option. If a match is found the bridge will be created if it does not already exist, the matched interface will be added to it and the mapping found in `ovn-bridge-mappings` will be added to the local OVSDB under the `external_ids:ovn-bridge-mappings` key in the Open\_vSwitch table. An example value mapping two network interface mac address to two ovs bridges would be: ``` br-internet:00:00:5e:00:00:42 br-provider:enp3s0f0 ``` Note: OVN gives you distributed East/West and highly available North/South routing by default. You do not need to add provider networks for use with external Layer3 connectivity to all chassis. Doing so will create a scaling problem at the physical network layer that needs to be resolved with globally shared Layer2 (does not scale) or tunneling at the top-of-rack switch layer (adds complexity) and is generally not a recommended configuration. Add provider networks for use with external Layer3 connectivity to individual chassis located near the datacenter border gateways by adding the MAC address of the physical interfaces of those units. * disable-mlockall | boolean Disable Open vSwitch use of mlockall(). . When mlockall() is enabled, all of ovs-vswitchd's process memory is locked into physical RAM and prevented from paging. This avoids network interruptions but can lead to memory exhaustion in memory-constrained environments. . By default, the charm will disable mlockall() if it is running in a container. Otherwise, the charm will default to mlockall() enabled if it is not running in a container. . Changing this config option will restart openvswitch-switch, resulting in an expected data plane outage while the service restarts. * dpdk-runtime-libraries | string Space delimited list of additional DPDK runtime libraries that should be installed when DPDK is enabled. . By default, only the runtime libraries that are recommended with the dpdk libraries are installed. Environments that need additional libraries installed should include those library packages. The runtime libraries can be defined either by the full package name (e.g. librte-pmd-bnx2x20.0) or by the simple name (e.g. bnx2x). When providing the simple name, a search is done of the apt-cache for a name matching `librte-**` for installation and will install all matching packages that are found. . Only used when DPDK is enabled. * enable-auto-restarts | boolean Default: True Allow the charm and packages to restart services automatically when required. * enable-version-pinning | boolean Default: True OVN is a distributed system, and special consideration must be given to the process used to upgrade OVN. In order to successfully perform a rolling upgrade, the ovn-controller process needs to understand the structure of the database for the version you are upgrading from and to simultaneously. Rolling upgrades are supported as long as the span of versions used in the system is within the previous and the next upstream OVN LTS version. If you are upgrading across LTS boundaries you may need to use version pinning to avoid data plane outage during the upgrade. * nagios\_context | string Default: juju A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them. * nagios\_servicegroups | string Comma separated list of nagios servicegroups for the service checks. * new-units-paused | boolean Start new units of the application as paused. . When set to 'true' newly deployed units of the application will install the charm and any packages required on the sytem, but keep any services from actually starting. . To start the services the operator must run the `resume` action on each unit. . This is useful for use with OpenStack for controlled unit by unit migration of deployments from the legacy Neutron ML2 OVS topology to the OVN topology. Both topologies make use of Open vSwitch and the 'br-int' integration bridge on the hypervisor and during a migration the operator may want to shut down and clean up after the ML2 OVS components before the `ovn-controller` takes over and reprograms the bridge flow rules. * ovn-bridge-mappings | string A space-delimited list of key-value pairs that map a physical network name to a local ovs bridge that provides connectivity to that network. The physical network name can be referenced when the administrator programs the OVN logical flows either by talking directly to the Northbound database or by interfacing with a Cloud Management System (CMS). Each charm unit will evaluate each key-value pair and determine if the configuration is relevant for the host it is running on based on matches found in the `bridge-interface-mappings` configuration option. If a match is found the bridge will be created if it does not already exist, the matched interface will be added to it and the mapping will be added to the local OVSDB under the `external_ids:ovn-bridge-mappings` key in the Open\_vSwitch table. An example value mapping two physical network names to two ovs bridges would be: ``` physnet1:br-internet physnet2:br-provider ``` NOTE: Values in this configuration option will only have effect for units that have a interface referenced in the `bridge-interface-mappings` configuration option. * ovn-source | string Overlay repository from which to install OVS+OVN. The default for this configuration option is determined at charm runtime. When charm is deployed into a fresh environment on Ubuntu 20.04 (Focal Fossa), the default will be 'cloud:focal-ovn-22.03'. When charm is upgraded or deployed into a fresh environment on a different series the default will be to not use the overlay repository. To disable the overlay repository, set this option to 'distro'. Note that updating this setting to a source that is known to provide a later version of OVN will trigger a software upgrade. * pmd-cpu-set | string Comma separated list of cpus used for DPDK datapath packet processing. The range and caret operators are supported. Example: 2,4,5-9,^7,16-23,^20,^22 Only used when DPDK is enabled. NOTE: It is recommended to avoid overlap between datapath (pmd-cpu-mask) and non-datapath (dpdk-lcore-mask) cpus. The charm will go into blocked state if an overlap is detected. * prefer-chassis-as-gw | boolean Prefer units of this application in CMS (Cloud Management System) scheduling of HA chassis groups (aka. gateways) over units of other OVN chassis applications present in this deployment. . By default the CMS will schedule HA chassis groups across all chassis with bridge- and bridge interface mappings configured. . This configuration option would allow you to influence where gateways are scheduled when all units have equal bridge- and bridge interface mapping configuration. . NOTE: If none of the OVN chassis named applications in the deployment have this option enabled, the CMS will fall back to schedule gateways to chassis with bridge- and bridge interface mapping configured. . NOTE: It is also possible to enable this option on several OVN chassis applications at the same time, e.g. on 2 out of 3. * source | string Default: distro Repository from which to install packages. May be one of the following: distro (default) ppa:somecustom/ppa (PPA name must include UCA OpenStack Release name) deb url sources entry|key id or a supported Ubuntu Cloud Archive pocket. Supported Ubuntu Cloud Archive pockets include: cloud:xenial-pike cloud:xenial-queens cloud:bionic-rocky Note that updating this setting to a source that is known to provide a later version of OVN will trigger a software upgrade. * vpd-device-spec | string A list of specs used by the charm to identify a device to be used as a primary source of Vital Product Data (VPD) containing a NIC serial number. This option can be used to enable SmartNIC DPU support. . Based on the retrieved information the charm will set up a mapping between a chassis hostname and a unique card serial number of a NIC in the OVN southbound database. It can then used by the CMS to look up which chassis should service a port plugging request based on the information provided from a hypervisor host. . Multiple items can be specified in the list in order to allow for hosts with different kinds of hardware or to specify the order of precedence if multiple devices from the list are present on a host. This should not normally happen with DPUs that only have one chip exposed. . Examples: [{"bus": "pci", "vendor\_id": "15b3", "product\_id": "a2d6" },