Update the service URLs of portal items in a federated ArcGIS Enterprise deployment

Summary

An item’s URL is used to represent web-accessible items, such as map services, stored in ArcGIS Enterprise. For example, a map service can be embedded in ArcGIS Experience Builder using the map service’s URL. In some instances, such as moving services from one machine to another, the item’s URL needs to be updated to reflect the new machine’s hostname.

This article provides two methods used to update the service URLs of portal items in a federated ArcGIS Enterprise deployment.

Procedure

Note:
The following workflows do not apply to hosted feature layers.

Note:
The following workflows require restarting Portal for ArcGIS. Depending on the machine's capability, Portal for ArcGIS may take several minutes to restart. Services associated with Portal for ArcGIS are unavailable during this period.

Update the item's URL in the ArcGIS Portal Directory

1. Navigate to the ArcGIS Portal Directory using the following URL and log in as an administrator or the item owner:

https://machine.domain.com/webadaptor/sharing/rest

2. Click the administrator username at the top right corner of the ArcGIS Portal Directory page, and click the Org ID hyperlink under User (<username>).

3. Scroll to the bottom of the page, and click Servers under Child Resources.

4. Copy the new URL under Server URL.
5. Click the administrator account name on the top-right of the page.
6. At the bottom of the page, under Related Resources, click User Content.
7. Under User Content (<username>), click the item to update.
8. At the bottom of the page, click Update Item.
9. For Url, replace the old URL with the new URL from Step 4.

10. Scroll down and click Update Item.

11. Right-click the taskbar and click Task Manager.
12. In the Services tab, right-click Portal for ArcGIS and click Restart.

Update the item's URL in the item's iteminfo.xml file

1. Navigate to the ArcGIS Portal Directory using the following URL and log in as an administrator or the item owner:

https://machine.domain.com/webadaptor/sharing/rest

2. Click the administrator username at the top right corner of the ArcGIS Portal Directory page, and click the Org ID hyperlink under User (<username>).

3. Scroll to the bottom of the page, and click Servers under Child Resources.

4. Copy the new URL under Server URL.
5. On the machine, navigate to the following directory:

<Portal Installation Directory>\arcgis\arcgisportal\content\items

6. Open the item folder named based on the item's ID.
7. Click the esriinfo folder.
8. Open the iteminfo.xml file in a text editor, for example Notepad.
9. Replace the old URL with the new URL from Step 4.

10. Click File > Save to save the edits.
11. Right-click the taskbar and click Task Manager.
12. In the Services tab, right-click Portal for ArcGIS and click Restart.