Skip to content

Commit 88ab112

Browse files
authored
PR review: Update wording and grammar in gateway migration doc
Implement Acrolinx suggestions to raise file's overall Acrolinx score to at least 80.
1 parent b8fe1a5 commit 88ab112

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

articles/expressroute/gateway-migration.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -31,29 +31,29 @@ The ErGw1Az, ErGw2Az, ErGw3Az, and ErGwScale (Preview) SKUs, also known as Az-En
3131

3232
The Standard, HighPerformance, and UltraPerformance SKUs, which are also known as nonavailability zone enabled SKUs are historically associated with Basic IPs, don't support the distribution of the gateway across multiple availability zones.
3333

34-
For enhanced reliability, it's recommended to use an Availability-Zone Enabled virtual network gateway SKU. These SKUs support a zone-redundant setup and are, by default, associated with Standard IPs. This setup ensures that even if one zone experiences an issue, the virtual network gateway infrastructure remains operational due to the distribution across multiple zones. For a deeper understanding of zone redundant gateways, please refer to [Availability Zone deployments.](../reliability/availability-zones-overview.md)
34+
For enhanced reliability, we recommend using an Availability-Zone Enabled virtual network gateway SKU. These SKUs support a zone-redundant setup and are, by default, associated with Standard IPs. This setup ensures that even if one zone experiences an issue, the virtual network gateway infrastructure remains operational due to the distribution across multiple zones. For a deeper understanding of zone redundant gateways, refer to [Availability Zone deployments.](../reliability/availability-zones-overview.md)
3535

3636
## Gateway migration experience
3737

3838
Historically, users had to use the Resize-AzVirtualNetworkGateway PowerShell command or delete and recreate the virtual network gateway to migrate between SKUs.
3939

4040
With the guided gateway migration experience you can deploy a second virtual network gateway in the same GatewaySubnet and Azure automatically transfers the control plane and data path configuration from the old gateway to the new one. During the migration process, there will be two virtual network gateways in operation within the same GatewaySubnet. This feature is designed to support migrations without disruption. However, users may experience brief connectivity issues or interruptions during the migration process.
4141

42-
After completing the gateway migration and deleting the older gateway and its connections, the newly created gateway will be tagged with "CreatedBy : GatewaySKUMigration". This tag will serve as a key differentiator from your other gateways that have not been migrated and should not be deleted.
42+
After completing the gateway migration and deleting the older gateway and its connections, the newly created gateway will be tagged with "CreatedBy : GatewaySKUMigration". This tag serves as a key differentiator from your other gateways that haven't been migrated and shouldn't be deleted.
4343

4444

4545
### Steps to migrate to a new gateway
4646

4747
1. **Validate**: Ensure all resources are in a succeeded state to confirm the gateway is ready for migration. If prerequisites aren't met, validation fails, and you can't proceed.
48-
2. **Prepare**: Create a new Virtual Network gateway, Public IP, and connections. This operation can take up to 45 minutes. You can choose a preferred name for the new gateway and connections. If you don't change the name, the tag **_migrate** will be appended by default. During this process, the existing Virtual Network gateway will be locked, preventing any crgeation or modification of connections.
48+
2. **Prepare**: Create a new Virtual Network gateway, Public IP, and connections. This operation can take up to 45 minutes. You can choose a preferred name for the new gateway and connections. If you don't change the name, the tag **_migrate** is appended by default. During this process, the existing Virtual Network gateway is locked, preventing any creation or modification of connections.
4949
3. **Migrate**: Select the new gateway to transfer traffic from the old gateway to the new one. This operation can take up to 15 minutes and may cause brief interruptions.
5050
4. **Commit**: Finalize the migration by deleting the old gateway and connections.
5151

5252
> [!IMPORTANT]
5353
> After migration, validate your connectivity to ensure everything is functioning as expected. You can revert to the old gateway by selecting **Abort** after the prepare step, which will delete the new gateway and connections.
5454
5555

56-
| Migrate from Non-Az enabled Gateway SKU | Migrate to Az-enabled Gateway SKU |
56+
| Migrate from Non-Az-enabled Gateway SKU | Migrate to Az-enabled Gateway SKU |
5757
|---------------------------------------------|------------------------------------------------|
5858
| Standard, HighPerformance, UltraPerformance | ErGw1Az, ErGw2Az, ErGw3Az, ErGwScale (Preview) |
5959
| Basic IP | Standard IP |
@@ -64,11 +64,11 @@ After completing the gateway migration and deleting the older gateway and its co
6464

6565
The guided gateway migration experience supports:
6666

67-
* Non-Az-enabled SKU on Basic IP to Non-az enabled SKU on Standard IP.
67+
* Non-Az-enabled SKU on Basic IP to Non-az-enabled SKU on Standard IP.
6868
* Non-Az-enabled SKU on Basic IP to Az-enabled SKU on Standard IP.
6969
* Non-Az-enabled SKU on Standard IP to Az-enabled SKU on Standard IP.
7070

71-
It's recommended to migrate to an Az-enabled SKU for enhanced reliability and high availability. To learn more, see [Migrate to an availability zone-enabled ExpressRoute virtual network gateway using PowerShell](expressroute-howto-gateway-migration-powershell.md).
71+
We recommend migrating to an Az-enabled SKU for enhanced reliability and high availability. To learn more, see [Migrate to an availability zone-enabled ExpressRoute virtual network gateway using PowerShell](expressroute-howto-gateway-migration-powershell.md).
7272

7373
### Limitations
7474

0 commit comments

Comments
 (0)