From: Aliasgar Ginwala <aginw...@ebay.com>
Update ovn-ic upgrade procedure when upgrading
from older 2.* ovn to latest/newer version.
Signed-off-by: Aliasgar Ginwala <aginw...@ebay.com>
---
0001-ic-Update-ovn-upgrade-document.patch | 53 ++++++++++++++++++++
Documentation/intro/install/ovn-upgrades.rst | 26 ++++++++++
2 files changed, 79 insertions(+)
create mode 100644 0001-ic-Update-ovn-upgrade-document.patch
diff --git a/0001-ic-Update-ovn-upgrade-document.patch
b/0001-ic-Update-ovn-upgrade-document.patch
new file mode 100644
index 000000000..9a591f11f
--- /dev/null
+++ b/0001-ic-Update-ovn-upgrade-document.patch
@@ -0,0 +1,53 @@
+From d71232cf4752b589a1cb4bd3be7efb42e0b9de46 Mon Sep 17 00:00:00 2001
+From: Aliasgar Ginwala <aginw...@ebay.com>
+Date: Wed, 29 Jan 2025 14:27:05 -0800
+Subject: [PATCH ovn v2] ic: Update ovn-upgrade document.
+
+Update ovn-ic upgrade procedure when upgrading
+from older 2.* ovn to latest/newer version.
+
+Signed-off-by: Aliasgar Ginwala <aginw...@ebay.com>
+---
+ Documentation/intro/install/ovn-upgrades.rst | 26 ++++++++++++++++++++
+ 1 file changed, 26 insertions(+)
+
+diff --git a/Documentation/intro/install/ovn-upgrades.rst
b/Documentation/intro/install/ovn-upgrades.rst
+index f3dea07dc..b67e34bf2 100644
+--- a/Documentation/intro/install/ovn-upgrades.rst
++++ b/Documentation/intro/install/ovn-upgrades.rst
+@@ -201,6 +201,32 @@ of known impactible schema changes and how to fix when
error encountered.
+ ovn-ic daemons in all availability zones first and after that convert OVS
+ schema (restart ovn-ic database daemon).
+
++#. Release 2.11 and earlier: The availability_zone name is added to the
++ external_ids in NB_Global. Therefore, when upgrading to latest versions,
++ update the name column in NB_Global for each availability zone before
++ starting the ovn-ic daemons. The Northbound database upgrade does not
++ handle populating the name column part of schema upgrade. Failing to do
++ this could result in data plane impact, such as remote AZs being unable
++ to update port bindings during gateway chassis failover, new gateway
++ chassis CRUD, etc. Run below command to set the name column in NB_Global
++ if upgrading from very old 2.* versions to latest/newer versions:
++
++ $ ovn-nbctl set NB_Global . name=<availability zone name>
++
++ Then restart ovn-ic daemons in all availability zones.
++
++ Missing above step will result in cpu of ovn-ic active instance spike
++ to 100%. This occurs due to null name column as ovn-ic in each
++ availability zones repeatedly fails in commiting transaction to South
++ bound in remote availability zones due to duplicate chassis. This will
++ also result in manual clean up remote availability zones gateway chassis
++ of type interconnection in local availability zone causing data plane
++ impact. Fix these issues by below command on each availability zone part
++ of upgrade from very old 2.* versions after stopping ovn-ic on all
++ availability zones:
++
++ $ ovn-nbctl set NB_Global . name=<availability zone name>
++ $ ovn-sbctl chassis-del <remote-ic-gateway-chassis-uuid>
+
+ Upgrade OVN Integration
+ ~~~~~~~~~~~~~~~~~~~~~~~
+--
+2.39.5 (Apple Git-154)
+
diff --git a/Documentation/intro/install/ovn-upgrades.rst
b/Documentation/intro/install/ovn-upgrades.rst
index f3dea07dc..b67e34bf2 100644
--- a/Documentation/intro/install/ovn-upgrades.rst
+++ b/Documentation/intro/install/ovn-upgrades.rst
@@ -201,6 +201,32 @@ of known impactible schema changes and how to fix when
error encountered.
ovn-ic daemons in all availability zones first and after that convert OVS
schema (restart ovn-ic database daemon).
+#. Release 2.11 and earlier: The availability_zone name is added to the
+ external_ids in NB_Global. Therefore, when upgrading to latest versions,
+ update the name column in NB_Global for each availability zone before
+ starting the ovn-ic daemons. The Northbound database upgrade does not
+ handle populating the name column part of schema upgrade. Failing to do
+ this could result in data plane impact, such as remote AZs being unable
+ to update port bindings during gateway chassis failover, new gateway
+ chassis CRUD, etc. Run below command to set the name column in NB_Global
+ if upgrading from very old 2.* versions to latest/newer versions:
+
+ $ ovn-nbctl set NB_Global . name=<availability zone name>
+
+ Then restart ovn-ic daemons in all availability zones.
+
+ Missing above step will result in cpu of ovn-ic active instance spike
+ to 100%. This occurs due to null name column as ovn-ic in each
+ availability zones repeatedly fails in commiting transaction to South
+ bound in remote availability zones due to duplicate chassis. This will
+ also result in manual clean up remote availability zones gateway chassis
+ of type interconnection in local availability zone causing data plane
+ impact. Fix these issues by below command on each availability zone part
+ of upgrade from very old 2.* versions after stopping ovn-ic on all
+ availability zones:
+
+ $ ovn-nbctl set NB_Global . name=<availability zone name>
+ $ ovn-sbctl chassis-del <remote-ic-gateway-chassis-uuid>
Upgrade OVN Integration
~~~~~~~~~~~~~~~~~~~~~~~
--
2.39.5 (Apple Git-154)
_______________________________________________
dev mailing list
d...@openvswitch.org
https://mail.openvswitch.org/mailman/listinfo/ovs-dev
