Skip To Content

Migrate to new machines

To replace a machine in your deployment without losing content or interrupting service, use the Join Site operation to migrate machines running ArcGIS Server and Portal for ArcGIS. You can use a similar workflow for machines running ArcGIS Data Store.

Note:

Each workflow below involves temporarily joining your old and new machines in a multiple-machine configuration. While machines running different OS versions (such as Windows Server 2016) can run in the same software component, machines running different operating systems (such as Windows and Linux) cannot coexist in this way.

Migrate a machine running Portal for ArcGIS

In this workflow, your new machine replaces the old machine hosting your ArcGIS Enterprise portal.

  1. Move the portal content directory from the old machine to a shared network location. Copy the content from the old location to the new before changing the directory location.

    The content directory remains in the shared location until the old machine is unregistered from the site.

  2. Install Portal for ArcGIS on the new machine, but do not create a portal. Use the same install directory and location for the default content directory as your original Portal for ArcGIS machine.
  3. Sign in to the new machine's ArcGIS Portal Administrator Directory, click Join Site, and provide the existing portal URL (in the format https://portalhost.domain.com:7443) and the credentials to its primary site administrator account.

    Both the old and new machines are joined to the portal.

  4. On the Administrator Directory home page, click Machines > unregister. On the subsequent operation page, select the old machine's name from the drop-down menu, and click Unregister to remove the old machine from the portal.
  5. Move the portal content directory from the shared network location to the local drive of the new machine, mirroring the workflow in step 1.
  6. If your deployment is using a front-end proxy or load balancer, and the privatePortalURL property in your portal's system properties still points to the old portal machine's URL, update the property. Click System > Properties > Update Properties and modify the privatePortalURL property.

Migrate a machine running ArcGIS Server

In this workflow, your new machine replaces the old machine in your ArcGIS Server site.

To preserve content and configuration settings, the server directories and configuration store are first migrated from the local drive of the old machine to a shared location on your network, and then to the local drive of the new machine. If you already have a multiple-machine ArcGIS Server site and these folders are located on a network share, omit steps 1 and 5 from the following workflow.

  1. Move the server directories and configuration store for the server from the old machine to a shared network location.

    This can be done from ArcGIS Server Manager. The directories and configuration store remain in the shared location until the old machine is unregistered from the site.

  2. Install ArcGIS Server on the new machine, but do not create a server site. Use the same install directory as your original ArcGIS Server machine.
  3. Sign in to the new machine's ArcGIS Server Administrator Directory, click Join Site, and provide the URL and initial administrator account credentials for the old machine's ArcGIS Server site.

    Both machines are joined in the site.

  4. On the administrator directory home page, browse to machines, click the old machine's name, and click the unregister operation. Confirm the operation on the next page to unregister the old machine from the site.
  5. Move the server directories and configuration store from the shared location to the local drive of the new machine, mirroring the workflow in step 1.
  6. Update the administrator URL for the federated server. Log in to the Portal REST endpoint as an administrator. From your user page, click the Org ID link. In the Child Resources section, click Servers, and select the Server ID of your federated server. Click Update Server. On the dialog box, provide the fully qualified ArcGIS Server administrative URL of your new machine. Click Update.

Migrate a machine running ArcGIS Data Store

In this workflow, your new machine replaces the old machine hosting your relational ArcGIS Data Store.

  1. Install ArcGIS Data Store on your new machine. Use the same install directory as your original ArcGIS Data Store machine.
  2. Register the new relational data store as a standby machine with the portal's hosting ArcGIS Server site using the ArcGIS Data Store configuration wizard.
  3. Sign in to the ArcGIS Server Administrator Directory (in the URL format https://gisserver.domain.com:6443/arcgis/admin) and browse to data > items > /enterpriseDatabases > [ArcGIS Data Store] > machines. Select the new machine and click makePrimary.

    The new machine is promoted to the primary role and the old machine is downgraded to a standby role.

  4. Click [ArcGIS Data Store] > machines, click the old machine (now standby), and choose remove.

    The new machine is the sole item in your ArcGIS Data Store.