eb4f299cd2
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
4.0 KiB
title, shortTitle, intro, type, topics, versions
| title | shortTitle | intro | type | topics | versions | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| Changing your platform | Changing platform | How to change the platform that runs {% data variables.location.product_location %} | how_to |
|
|
In some cases, you may need to change the platform on which {% data variables.location.product_location %} runs, such as moving from VMware to Azure.
Recommendations
You should carefully plan any out migration procedures and consider first testing on a staging environment. For more information, see AUTOTITLE.
Moving platforms using a replica will require the least amount of time for the migration process but will require you to make changes to your live environment in order to setup the replication.
Moving via backup and restore will not require any changes to your live environment, however the migration will take a significant amount of time. The specific amount of time to complete the migration will vary based the performance of your backup host, and the network speeds between your backup host and the new instance. Maintenance mode should also be enabled throughout the process otherwise users may be able to make changes which will not be reflected on your new instance.
Warning
You should not use utilities which convert {% data variables.location.product_location %} from one platform to another. Doing so could cause unintended side effects such as system instability.
Move platforms using a HA replica
- Set up a new {% data variables.product.prodname_ghe_server %} instance on your chosen platform. See AUTOTITLE.
- Configure your new {% data variables.product.prodname_ghe_server %} instance as a replica. See AUTOTITLE.
- Failover to your replica. See AUTOTITLE.
Moving platforms using backup and restore
-
Setup backups for your existing {% data variables.product.prodname_ghe_server %} instance. See AUTOTITLE.
-
Set up a new {% data variables.product.prodname_ghe_server %} instance on your chosen platform. See AUTOTITLE.
-
Communicate the upcoming downtime to your users and enable maintenance mode. For more information, see the following articles.
-
Create a new backup of your existing {% data variables.product.prodname_ghe_server %} instance.
-
Restore the backup to your new {% data variables.product.prodname_ghe_server %} instance. If you are using {% data variables.product.prodname_actions %}, see AUTOTITLE
-
Update the DNS to point to the address of your new {% data variables.product.prodname_ghe_server %} instance.
-
Disable maintenance mode and let users know they can continue normal operations.