Skip to content

Open vSwitch

This page is the starting point for Open vSwitch, the openvswitch role: the containers openvswitch_db and openvswitch_vswitchd, on the compute and network nodes of the example inventory, selected by the tag openvswitch. The risk register rates a restart or recreate of openvswitch_vswitchd Critical (R7). The lists below say where the study covers how to operate it, its impact, its dependencies and the evidence, what to check around a run and what stays open; the service card follows them.

Where to look

Operate

Impact and risk

Dependencies

Evidence

Before and after a run

  • Tags §3.1, row openvswitch: safe on its own "yes if unchanged (Set system-id reports changed without restarting); image changes per host batch"; prerequisite: the openvswitch kernel module.
  • R7, precautions: upgrade or recreate OVS host by host with evacuation or acceptance; never fleet-wide with serial 0.
  • Update container images §4: an OVS image change recreates openvswitch_vswitchd on every OVS host simultaneously (serial 0); NOT AVAILABLE whether VM networking is interrupted on every compute at the same time. Upgrade OVS per batch with ANSIBLE_SERIAL=<n> kolla-ansible -t openvswitch upgrade, or use --limit batches.
  • Reconfigure a single service §3: openvswitch is one of the tags that can restart the containers that Tags §3.1 traces to running VMs CODE; what those restarts do to running VMs is NOT AVAILABLE.

Known limits and open points

  • Known bugs and limitations, row openvswitch: Set system-id always reports changed. Status: CODE.
  • Known bugs and limitations, row ovs-dpdk: pull looks up a non-existent ovs_services variable; the NIC mapping file is written once; the 300 s wait handler has no port. Status: CODE.
  • Q3: "Data-plane loss during an openvswitch_vswitchd restart or recreate". Status: NOT AVAILABLE.
  • What is not known, row "openvswitch_vswitchd restart or recreate": the sources do not establish whether the OpenFlow tables are lost, whether the OVS agent or ovn-controller reprograms them, and whether all VM traffic on the host is interrupted, and for how long. Same table: whether VM network traffic stops under kolla-ansible stop.
  • What is not known: the sources do not establish whether services started by a shell wrapper that does not exec them (neutron-l3-agent, haproxy, ovs-vswitchd, ovsdb-server) receive SIGTERM at all before the container stops.
  • Q14, answered from the source CODE: agent, OVS and OVN images have no one-shot branch.
  • F13, "The Nova deploy order" puts nova-compute before OVS and the Neutron agents on new computes CODE; NOT AVAILABLE whether instances can be scheduled on such a compute before the later plays finish.
  • fact sheet A §6.8, "Operationally notable" for the ovs-dpdk role (no fact sheet covers openvswitch): any ovsdpdk-db restart also restarts ovs-vswitchd; NIC rebinding and unit installation run on every deploy, reconfigure, upgrade and genconfig; sticky configuration.
  • Kolla images §6, item 13: an openvswitch_vswitchd restart replaces only the userspace daemon; the kernel module stays loaded and conf.db keeps bridges and ports CODE. NOT AVAILABLE Whether the OpenFlow tables are lost and must be reprogrammed by the OVS agent or ovn-controller.

Service card

The rows of the card are explained in How to read a service card.

Item Value
Play site.yml:712
Tags openvswitch
Play host patterns openvswitch
Node types in play (example inventory) compute, network
Node types running its containers compute, network
Containers openvswitch_db, openvswitch_vswitchd
deploy/reconfigure flow (tasks/deploy.yml) config-host → config → check-containers → flush handlers → post-config
Task files check-containers.yml, check.yml, config-host.yml, config.yml, deploy-containers.yml, deploy.yml, main.yml, post-config.yml, precheck.yml, pull.yml, reconfigure.yml, stop.yml, upgrade.yml
Templates openvswitch-db-server.json.j2, openvswitch-vswitchd.json.j2, start-ovs.j2, start-ovsdb-server.j2
Handlers (definition order) Restart openvswitch-db-server container; Waiting for openvswitch_db service to be ready; Restart openvswitch-vswitchd container
Key variables enable_openvswitch, neutron_bridge_name, neutron_external_interface, computes_need_external_bridge
Role dependencies common (meta)