Update the ArcGIS Enterprise organization URL, Item/Services URL and Federation URLs

Summary

In an ArcGIS Enterprise organization, it is sometimes neccessary to update the organizational URL along with the following associated URLs, as follows:

Updating these URLs may be necessary in situations such as:

• Rebranding: The organization has been acquired or rebranded, requiring all URLs to reflect a new domain. For example, changing from:

https://organization.example.com

to

https://neworganization.example.com

• Environment Transitions: Moving between development, staging, and production environments and it is necessary to adjust content accordingly
• Web Adaptor Reconfiguration: Updating the Web Adaptor name.
• Domain Migration: Moving from one domain to another for strategic, technical, or branding reasons, for example, switching from a .com to a .org or from a legacy domain to a modernized one.
• Infrastructure Changes: Rehosting services on new servers, cloud platforms, or geographic regions may involve domain or subdomain changes. Migrating from on-premises to a cloud-hosted environment.

Procedure

1. Sign into the Portal for ArcGIS sharing/rest endpoint: https://organization.example.com/portal/sharing/rest
   1. Click Home > Portals > Self.
   2. At the bottom of the Self resource page, click URLs.

2. Update the Portal URL:
   1. Click Update Portal URL.
   2. Provide the new Portal URL.
   3. The URL should be in the format: https://new.organization.com/portal
   4. Click Update URL.
3. Update the Federated Server URL:
   1. Go back to Step 1.
   2. Click Update Federated Server URL.
   3. Paste the ID in the Server Id text box. This can be found from Step 4(d), below.
   4. Provide the New Server URL.
   5. The URL should be in the format: https://new.organization.com/server
   6. Click Update URL.
4. Once the Organizational URLs are updated using the above steps, update the federation URLs with the latest ones.
   1. Navigate to Portal for ArcGIS' sharing/rest endpoint: https://new.organization.com/portal/sharing/rest, and sign in.
   2. Click Home > Portals > Self.
   3. At the bottom of the Self resource page, click Servers. The following page displays:

4. Click on the Server Id and click Update Server
5. Click Update after providing the new organizational details, as shown in the image below:

Note:
• If the URLs listed in your organization's server certificates differ from the new URLs, you must update the certificates accordingly.
• If items in your organization were created from binary or compressed files, the URLs within those files were not updated. To resolve this, update the file and re-add it to your organization.
• This feature is available in ArcGIS Enterprise version 11.4 onwards.