This tutorial shows how to install a 3-node MicroOVN cluster.

One big advantage of a multi-node cluster is that it provides redundancy (service failover). A 3-node deployment can tolerate up to one node failure.


You will need three (virtual or physical) machines that can communicate with each other over the network. They will be known here as node-1, node-2, and node-3.

Install the software

Install MicroOVN on each of the designated nodes with the following command:

sudo snap install microovn

Initialise the cluster

On node-1, initialise the cluster:

microovn cluster bootstrap

Generate access tokens

On node-1, generate access tokens for the other two nodes (cluster members). These will be needed to join these nodes to the cluster.

Let this token be for node-2:

microovn cluster add node-2

The output will be a special string such as: eyJuYW1lIjoibm9kZS0yIiwic2VjcmV0IjoiMzBlM....

Let this token be for node-3:

microovn cluster add node-3

Similarly, a string will be sent to the screen: eyJuYW1lIjoibm9kZS0zIiwic2VjcmV0IjoiZmZhY....

Complete the cluster

Join node-2 and node-3 to the cluster using their assigned access tokens.

On node-2:

microovn cluster join eyJuYW1lIjoibm9kZS0yIiwic2VjcmV0IjoiMzBlM...

On node-3:

microovn cluster join eyJuYW1lIjoibm9kZS0zIiwic2VjcmV0IjoiZmZhY...

Now all three nodes are joined to the cluster.

Manage the cluster

You can interact with OVN using its native commands prefaced with the string microovn.. For example, to show the contents of the OVN Southbound database:

microovn.ovn-sbctl show

The cluster can be managed from any of its nodes.