Skip to content

Commit

Permalink
docs: require ovn-set-local-ip for co-located ovn-controllers
Browse files Browse the repository at this point in the history
Without using the setting, ovn-controllers will fail to create their
tunnel ports pointing to the same remote chassis due to identical
configuration used (same remote_ips and no different in local_ips).

The error observed then is:

```
2023-08-01T13:55:37.772Z|00050|tunnel|WARN|ovn-hv3-0: attempting to
add tunnel port with same config as port 'ovn0-hv3-0' (::->1.1.202.26,
key=flow, legacy_l2, dp port=3)
2023-08-01T13:55:37.772Z|00051|ofproto|WARN|br-hv1: could not add port
ovn-hv3-0 (File exists)
2023-08-01T13:55:37.772Z|00052|bridge|WARN|could not add network
device ovn-hv3-0 to ofproto (File exists)
```

Fixes: ce126c9 ("Document experimental support for co-hosted controllers")
Signed-off-by: Ihar Hrachyshka <ihrachys@redhat.com>
Signed-off-by: Dumitru Ceara <dceara@redhat.com>
(cherry picked from commit 3efa120)
  • Loading branch information
booxter authored and dceara committed Oct 10, 2023
1 parent 32ab7d9 commit 16bdac7
Showing 1 changed file with 9 additions and 4 deletions.
13 changes: 9 additions & 4 deletions controller/ovn-controller.8.xml
Original file line number Diff line number Diff line change
Expand Up @@ -363,7 +363,10 @@
The boolean flag indicates if <code>ovn-controller</code> when create
tunnel ports should set <code>local_ip</code> parameter. Can be
heplful to pin source outer IP for the tunnel when multiple interfaces
are used on the host for overlay traffic.
are used on the host for overlay traffic. This is also useful when
running multiple <code>ovn-controller</code> instances on the same
chassis, in which case this setting will guarantee that their tunnel
ports have unique configuration and can exist in parallel.
</dd>
<dt><code>external_ids:garp-max-timeout-sec</code></dt>
<dd>
Expand Down Expand Up @@ -398,9 +401,11 @@
names on the same host using the same <code>vswitchd</code> instance.
This may be useful when running a hybrid setup with more than one CMS
managing ports on the host, or to use different datapath types on the
same host. Note that this ability is highly experimental and has known
limitations (for example, stateful ACLs are not supported). Use at your
own risk.
same host. Make sure you also set
<code>external_ids:ovn-set-local-ip</code> when using such
configuration. Also note that this ability is highly experimental and
has known limitations (for example, stateful ACLs are not supported).
Use at your own risk.
</p>

<p>
Expand Down

0 comments on commit 16bdac7

Please sign in to comment.