Skip To Content

Configure an existing ArcGIS Enterprise deployment for high availability

To make an existing ArcGIS Enterprise deployment highly available, make each component highly available and update the privatePortalURL and ArcGIS Server URLs to be highly available.

The following steps summarize the process of configuring an existing ArcGIS Enterprise deployment to make it highly available.

  1. Contact all users of the portal and ArcGIS Server sites to let them know you'll need to stop the system for a short period of time.
  2. Once you're sure no one is connected and creating content, follow the instructions in Change the portal content directory to copy the Portal for ArcGIS content directory from its existing location and place it on a shared network location.
  3. Complete Step 3: Install and configure the second portal machine to add a machine to your portal.
  4. If your portal uses web-tier authentication, complete Step 4: Install and configure ArcGIS Web Adaptor.
  5. Complete Step 5: Configure a load balancer to create a highly available URL for the portal.
  6. If your portal uses web-tier authentication, complete Step 6: Install and configure the second ArcGIS Web Adaptor to achieve web server tier high availability.
  7. Set the privatePortalURL property to the highly available URL.
    1. Open a web browser and sign in to the Portal Administrator Directory as a member of the default administrator role in your organization.

      The Portal Administrator Directory URL is formatted as follows: https://portal.domain.com:7443/arcgis/portaladmin.

    2. Click System > Properties > Update Properties.
    3. On the Update System Properties dialog box, insert the following JSON, substituting your own load balancer URL.
      {
         "privatePortalURL": "https://lbprivate.domain.com:7443/arcgis"
      }
      Note:

      Do not set the X-Forwarded-Host header for this URL.

    4. Click Update Properties to apply your changes.
  8. Configure all federated ArcGIS Server sites, including the hosting server, to recognize the updated privatePortalURL. Repeat these steps for each federated server (including the hosting server).
    1. Sign in to the ArcGIS Server Administrator Directory as the primary site administrator or by generating and providing a Portal for ArcGIS administrator token. The ArcGIS Server Administrator Directory URL is in the format https://server.domain.com:6443/arcgis/admin.
    2. Click Security > Config > Update.
    3. On the Update Security Configuration dialog box, update the privatePortalURL value in the following list to your own load balancer URL.

      In the following example, the privatePortalURL is set to https://lbprivate.domain.com:7443/arcgis:

      {
       "portalUrl": "https://loadbalancer.domain.com/arcgis",
       "privatePortalUrl": "https://lbprivate.domain.com:7443/arcgis",
       "portalSecretKey": "< secret key >",
       "portalMode": "ARCGIS_PORTAL_FEDERATION",
       "serverId": "<ArcGIS Server site ID >",
       "serverUrl": "https://loadbalancer.domain.com/server"
      }

    4. Click Update to apply your changes for this federated server site.
  9. Follow the instructions in Configure multiple-machine ArcGIS Server sites to make the portal's hosting server highly available.

    If you have additional ArcGIS Server sites federated with your portal and you want those sites to be highly available as well, follow these same steps for each of those sites.

  10. Update your portal to consume the highly available URL for your hosting server.
    1. Sign in to the ArcGIS Portal Directory (in the format https://loadbalancer.domain.com/arcgis/sharing/rest) as a member of the default administrator role to update the hosting server information.
    2. From the home page of the ArcGIS Portal Directory, open Portals > Self > Servers and click Server Id for your portal's hosting server.
    3. Click Update Server and type or paste the highly available URL for your portal's hosting server in the Server Admin URL field.
    4. Click Update to apply your changes.
    5. Validate your federated servers using the Portal Administrator Directory. Sign in to https://portal.domain.com:7443/arcgis/portaladmin and browse to Federation > Servers. Validate each of your federated server sites.
  11. If you made other federated servers highly available, update the portal to consume the highly available URLs for those sites as well. Click the Server Id of the correct federated ArcGIS Server site when updating.
  12. To make ArcGIS Data Store highly available, add machines to each data store type you have registered with your portal's hosting server.

Once you've made all components of the ArcGIS Enterprise deployment highly available, notify users that they can resume working with it.