You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Fix Scenario 2 to use staged deployment and add EDPM warnings
Updated Scenario 2 (Different Namespace) to properly use staged deployment
and added critical EDPM hostname warnings to both Scenarios 2 and 3.
Changes to Scenario 2:
- Added staged deployment with infrastructure-only annotation
- Added database and PVC restore steps while paused
- Added resume deployment step
- Renumbered steps to match correct flow
- Uses filtered secrets/configmaps like Scenario 1
EDPM warnings added to both scenarios:
- CRITICAL: Hostnames MUST NOT change (Nova instance management)
- Scenario 2: EDPM deployment required (Since namespace changes DNS)
- Scenario 3: EDPM deployment may be required (If endpoints/namespace change)
- Added prerequisite about maintaining EDPM hostnames
If namespace and endpoint IPs remain the same, EDPM nodes may reconnect
without redeployment.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/dev/backup-restore-ctlplane.md
+60-14Lines changed: 60 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1442,13 +1442,16 @@ Data plane nodes use the restored RabbitMQ credentials for immediate connectivit
1442
1442
1443
1443
⚠️ **NOTE**: This scenario has not been tested yet. Use with caution and verify each step.
1444
1444
1445
-
**WARNING**: Namespace changes are complex due to DNS endpoints in OpenStack databases. This procedure assumes you're **NOT** restoring database state.
1445
+
⚠️ **CRITICAL - EDPM Hostname Requirements**: If you have EDPM nodes (compute/network nodes), **the hostnames MUST NOT change!** Nova-compute registers with a hostname, and all running VM instances are associated with that hostname. Changing hostnames will cause you to lose the ability to manage existing instances.
1446
+
1447
+
⚠️ **EDPM Deployment Required**: Since this scenario changes the namespace, DNS names change (e.g., `rabbitmq.openstack.svc` → `rabbitmq.openstack-restored.svc`). You MUST run an EDPM deployment to update node configurations before nodes can reconnect to the control plane.
1446
1448
1447
1449
**Prerequisites:**
1448
1450
-**Operator versions match the backup** (same cluster, so this should already be true)
1449
1451
- New namespace will be created
1450
1452
- Operator managing the new namespace
1451
1453
- Storage classes available
1454
+
-**EDPM node hostnames must remain the same** (see warning above)
1452
1455
1453
1456
**Steps:**
1454
1457
@@ -1499,37 +1502,62 @@ for file in *-backup.json; do
1499
1502
done
1500
1503
```
1501
1504
1502
-
#### 3. Restore in New Namespace
1505
+
#### 3. Restore in New Namespace with Staged Deployment
1503
1506
1504
-
**Follow the correct restore order:**
1507
+
**Follow the correct restore order using staged deployment:**
**IMPORTANT**: Since you changed namespace, DNS names will change:
1613
1654
- Old: `keystone.openstack.svc.cluster.local`
@@ -1651,11 +1692,16 @@ Without running EDPM deployment, data plane nodes will continue trying to connec
1651
1692
1652
1693
⚠️ **NOTE**: This scenario has not been tested yet. Use with caution and verify each step.
1653
1694
1695
+
⚠️ **CRITICAL - EDPM Hostname Requirements**: If you have EDPM nodes (compute/network nodes), **the hostnames MUST NOT change!** Nova-compute registers with a hostname, and all running VM instances are associated with that hostname. Changing hostnames will cause you to lose the ability to manage existing instances.
1696
+
1697
+
⚠️ **EDPM Deployment May Be Required**: If the namespace, control plane endpoint IPs, or DNS server endpoint IP change, you MUST run an EDPM deployment to update node configurations before nodes can reconnect to the control plane.
1698
+
1654
1699
**Prerequisites:**
1655
1700
- Target cluster has **EXACT same operator versions installed** as source cluster
1656
1701
- Target cluster has required storage classes
1657
1702
- Network connectivity for external access
1658
1703
- Compatible OpenShift version
1704
+
-**EDPM node hostnames must remain the same** (see warning above)
0 commit comments