This section describes the process of migrating from a classic router to an L3 HA router, which is available starting from the Mitaka release.
Similar to the classic scenario, all network traffic on a project network that requires routing actively traverses only one network node regardless of the quantity of network nodes providing HA for the router. Therefore, this high-availability implementation primarily addresses failure situations instead of bandwidth constraints that limit performance. However, it supports random distribution of routers on different network nodes to reduce the chances of bandwidth constraints and to improve scaling.
This section references parts of Linux bridge: High availability using VRRP and Open vSwitch: High availability using VRRP. For details regarding needed infrastructure and configuration to allow actual L3 HA deployment, read the relevant guide before continuing with the migration process.
The migration process is quite simple, it involves turning down the router by
setting the router’s admin_state_up
attribute to False
, upgrading the
router to L3 HA and then setting the router’s admin_state_up
attribute back
to True
.
Warning
Once starting the migration, south-north connections (instances to internet) will be severed. New connections will be able to start only when the migration is complete.
Here is the router we have used in our demonstration:
$ openstack router show router1
+-------------------------+-------------------------------------------+
| Field | Value |
+-------------------------+-------------------------------------------+
| admin_state_up | UP |
| distributed | False |
| external_gateway_info | |
| ha | False |
| id | 6b793b46-d082-4fd5-980f-a6f80cbb0f2a |
| name | router1 |
| project_id | bb8b84ab75be4e19bd0dfe02f6c3f5c1 |
| routes | |
| status | ACTIVE |
+-------------------------+-------------------------------------------+
Source the administrative project credentials.
Set the admin_state_up to False
. This will severe south-north
connections until admin_state_up is set to True
again.
$ openstack router set router1 --disable
Set the ha
attribute of the router to True
.
$ openstack router set router1 --ha
Set the admin_state_up to True
.
After this, south-north connections can start.
$ openstack router set router1 --enable
Make sure that the router’s ha
attribute has changed to True
.
$ openstack router show router1
+-------------------------+-------------------------------------------+
| Field | Value |
+-------------------------+-------------------------------------------+
| admin_state_up | UP |
| distributed | False |
| external_gateway_info | |
| ha | True |
| id | 6b793b46-d082-4fd5-980f-a6f80cbb0f2a |
| name | router1 |
| project_id | bb8b84ab75be4e19bd0dfe02f6c3f5c1 |
| routes | |
| status | ACTIVE |
+-------------------------+-------------------------------------------+
To return to classic mode, turn down the router again, turning off L3 HA and starting the router again.
Warning
Once starting the migration, south-north connections (instances to internet) will be severed. New connections will be able to start only when the migration is complete.
Here is the router we have used in our demonstration:
$ openstack router show router1
+-------------------------+-------------------------------------------+
| Field | Value |
+-------------------------+-------------------------------------------+
| admin_state_up | DOWN |
| distributed | False |
| external_gateway_info | |
| ha | True |
| id | 6b793b46-d082-4fd5-980f-a6f80cbb0f2a |
| name | router1 |
| project_id | bb8b84ab75be4e19bd0dfe02f6c3f5c1 |
| routes | |
| status | ACTIVE |
+-------------------------+-------------------------------------------+
Source the administrative project credentials.
Set the admin_state_up to False
. This will severe south-north
connections until admin_state_up is set to True
again.
$ openstack router set router1 --disable
Set the ha
attribute of the router to True
.
$ openstack router set router1 --no-ha
Set the admin_state_up to True
.
After this, south-north connections can start.
$ openstack router set router1 --enable
Make sure that the router’s ha
attribute has changed to False
.
$ openstack router show router1
+-------------------------+-------------------------------------------+
| Field | Value |
+-------------------------+-------------------------------------------+
| admin_state_up | UP |
| distributed | False |
| external_gateway_info | |
| ha | False |
| id | 6b793b46-d082-4fd5-980f-a6f80cbb0f2a |
| name | router1 |
| project_id | bb8b84ab75be4e19bd0dfe02f6c3f5c1 |
| routes | |
| status | ACTIVE |
+-------------------------+-------------------------------------------+
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.