HOW TO

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

Last Published: June 13, 2023

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
  1. Click the administrator username at the top right corner of the ArcGIS Portal Directory page, and click the Org ID hyperlink under User (<username>).
the Ord ID hyperlink to access the organization
  1. Scroll to the bottom of the page, and click Servers under Child Resources.
The Servers resources hyperlink
  1. Copy the new URL under Server URL.
  2. Click the administrator account name on the top-right of the page.
  3. At the bottom of the page, under Related Resources, click User Content.
  4. Under User Content (<username>), click the item to update.
  5. At the bottom of the page, click Update Item.
  6. For Url, replace the old URL with the new URL from Step 4.
The url parameter that can be updated with the new url
  1. Scroll down and click Update Item.
The Update Item button used to save changes in the Update Item page
  1. Right-click the taskbar and click Task Manager.
  2. In the Services tab, right-click Portal for ArcGIS and click Restart.
The Services tab used to restart Portal for ArcGIS

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
  1. Click the administrator username at the top right corner of the ArcGIS Portal Directory page, and click the Org ID hyperlink under User (<username>).
the Ord ID hyperlink to access the organization
  1. Scroll to the bottom of the page, and click Servers under Child Resources.
The Servers resources hyperlink
  1. Copy the new URL under Server URL.
  2. On the machine, navigate to the following directory:
<Portal Installation Directory>\arcgis\arcgisportal\content\items
  1. Open the item folder named based on the item's ID.
  2. Click the esriinfo folder.
  3. Open the iteminfo.xml file in a text editor, for example Notepad.
  4. Replace the old URL with the new URL from Step 4.
The item URL to be updated in the text editor
  1. Click File > Save to save the edits.
  2. Right-click the taskbar and click Task Manager.
  3. In the Services tab, right-click Portal for ArcGIS and click Restart.

Article ID: 000020459

Software:
  • ArcGIS Server
  • ArcGIS Enterprise 10 9 x
  • ArcGIS Enterprise 11 0
  • ArcGIS Enterprise 11 1

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options