Note: You can read about a second method to migrate ArcGIS Enterprise to new machines in our April 2019 blog.
Migrating to new machines without disrupting service is a common desire for ArcGIS Enterprise administrators. There are many reasons you may want or need to swap out a machine in your ArcGIS Enterprise deployment without changing anything else. Perhaps you’re experiencing hardware performance issues, or you want to run a newer operating system. Today, we’d like to highlight a simple process to achieve this.
The Join Site operation in ArcGIS Server and Portal for ArcGIS is typically used to add a standby machine to a site for high availability and disaster recovery, protecting your ArcGIS Enterprise deployment from system downtime and data loss in the event of tech failure.
However, Join Site can be utilized to swap out a machine from your server site or portal as well. The important thing to remember is that when you do this, you first make a complete copy of important directories – the ArcGIS Enterprise portal’s content directory, and the ArcGIS Server directories and configuration store – before you remove the old machine from the site.
After we go over these workflows for a portal and a server site, we’ll also see how a similar approach replaces a machine in an ArcGIS Data Store site.
Utilize Join Site to migrate a machine
This can be used to migrate a machine running an ArcGIS Enterprise portal or an ArcGIS Server site. In this method, content directories are moved from the local drive on your old machine to a shared location on the network. The joinSite operation is performed to connect the new machine; then, the old machine is unregistered, the content directory is moved to the local drive of the new machine, and any relevant URLs are redirected to the new machine.
Note: due to the dependency on shared storage between machines that participate in the same site, this should only be used if the machine you’re migrating to is within the same data center as the original machine. If you are migrating to machines in a separate data center, consider using the WebGIS DR tool method described here.
Steps for the ArcGIS Enterprise portal
- Validate the federated server to update the server’s configuration store with the new administrator URL. Log in to the Portal for ArcGIS Administrator Directory and navigate to Federation > Servers. Click the link of the server’s name, and then click Validate. This will perform the operation and should return a page with a status of success and detailed messages.