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
Copy file name to clipboardExpand all lines: articles/api-management/migrate-stv1-to-stv2.md
+10-5Lines changed: 10 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ For more information about the `stv1` and `stv2` platforms and the benefits of u
33
33
34
34
API Management platform migration from `stv1` to `stv2` involves updating the underlying compute alone and has no impact on the service/API configuration persisted in the storage layer.
35
35
36
-
* The upgrade process involves creating a new compute in parallel the old compute. Both instances coexist for 48 hours.
36
+
* The upgrade process involves creating a new compute in parallel to the old compute. The old compute takes 15-45 mins to be deleted with an option to delay it for up to 48 hours.
37
37
* The API Management status in the Portal will be "Updating".
38
38
* Azure manages the management endpoint DNS, and updates to the new compute immediately on successful migration.
39
39
* The Gateway DNS still points to the old compute if custom domain is in use.
@@ -205,7 +205,7 @@ On successful migration, update any network dependencies including DNS, firewall
205
205
206
206
-**Will the migration cause a downtime?**
207
207
208
-
***VNet-injected instances:*** there's no downtime as the old and new managed gateways are available for 48 hours, to facilitate validation and DNS update. However, if the default domain names are in use, traffic is routed to the new managed gateway immediately. It's critical that all network dependencies are taken care of upfront, for the impacted APIs to be functional.
208
+
***VNet-injected instances:***since the old gateway is purged only after the new compute is healthy and online, there shouldn't be any downtime if default hostnames are in use. It's critical that all network dependencies are taken care of upfront, for the impacted APIs to be functional. However, if custom domains are in use, they'll be pointing to the purged compute until they're updated which may cause a downtime. Alternatively, you can request for the old gateway to be retained for up to 48 hours by creating a support ticket in advance. Having the old and the new compute coexist will facilitate validation, and then you can update the custom DNS entries at will.
209
209
210
210
***Non-VNet instances:*** there's a downtime of approximately 15 minutes only if you choose to preserve the original IP address. However, there's no downtime if you migrate with a new IP address.
211
211
@@ -262,7 +262,7 @@ On successful migration, update any network dependencies including DNS, firewall
262
262
263
263
-**Can I roll back the migration if required?**
264
264
265
-
Yes, you can. If there's a failure during the migration process, the instance will automatically roll back to the `stv1` platform. However, if you encounter any other issues post migration, you have 48 hours to request a rollback by contacting Azure support. You should contact support if the instance is stuck in an "Updating" status for more than 2 hours.
265
+
Yes, you can. If there's a failure during the migration process, the instance will automatically roll back to the stv1 platform. However, if you encounter any other issues post migration, you can roll back only if you have requested an extension to the old gateway purge. By default, the old gateway is purged in 15 mins that can be extended up to 48 hours by contacting support in advance. You should make sure to contact support before the old gateway is purged, if a rollback is required. Note to contact support if the instance is stuck in an "Updating" status for more than 2 hours.
266
266
267
267
-**Is there any change required in custom domain/private DNS zones?**
268
268
@@ -282,14 +282,14 @@ On successful migration, update any network dependencies including DNS, firewall
282
282
-**Can I upgrade my stv1 instance to the same subnet?**
283
283
284
284
- You can't migrate the stv1 instance to the same subnet in a single pass without downtime. However, you can optionally move your migrated instance back to the original subnet. More details [here](#optional-migrate-back-to-original-vnet-and-subnet).
285
-
- The old gateway takes up to 48 hours to vacate the subnet, so that you can initiate the move. However, you can request for a faster release of the subnet by submitting the subscription IDs and the desired release time through a support ticket.
285
+
- The old gateway takes between 15 mins to 45 mins to vacate the subnet, so that you can initiate the move. However, you can request to increase this time to up to 48 hours by a support ticket.
286
286
- Releasing the old subnet calls for a purge of the old gateway, which forfeits the rollback to the old gateway if desired.
287
287
- A new public IP is required for each switch
288
288
- Ensure that the old subnet networking for [NSG](./api-management-using-with-internal-vnet.md?tabs=stv2#configure-nsg-rules) and [firewall](./api-management-using-with-vnet.md?tabs=stv2#force-tunnel-traffic-to-on-premises-firewall-using-expressroute-or-network-virtual-appliance) is updated for `stv2` dependencies.
289
289
290
290
-**Can I test the new gateway before switching the live traffic?**
291
291
292
-
-Post successful migration, the old and the new managed gateways are active to receive traffic. The old gateway remains active for 48 hours.
292
+
-By default, the old and the new managed gateways coexist for 15 mins, which is a small window of time to validate the deployment. You can request to increase this time to up to 48 hours through a support ticket. This change keeps the old and the new managed gateways active to receive traffic and facilitate validation.
293
293
- The migration process automatically updates the default domain names, and if being used, the traffic routes to the new gateways immediately.
294
294
- If custom domain names are in use, the corresponding DNS records might need to be updated with the new IP address if not using CNAME. Customers can update their host file to the new API Management IP and validate the instance before making the switch. During this validation process, the old gateway continues to serve the live traffic.
295
295
@@ -313,6 +313,11 @@ On successful migration, update any network dependencies including DNS, firewall
0 commit comments