Upgrade Portal for ArcGIS

The Portal for ArcGIS 11.2 setup is designed to detect and upgrade an existing installation of Portal for ArcGIS.

Prepare to upgrade

Before upgrading, carefully review the following information:

Upgrade concepts

• The time it takes to complete the upgrade varies, depending on how much content your portal contains and how many accounts are registered, as well as how many components and customizations you deploy.
• The version of all base ArcGIS Enterprise components must be the same.
• You don't need to upgrade ArcGIS Pro at the same time as ArcGIS Enterprise.
• If the ArcGIS Server site you've federated with the portal includes multiple machines, upgrade your GIS servers sequentially.
• If your portal is currently in read-only mode, turn the mode off before running the upgrade.
• If you cannot update your current Web Adaptor, you can alternatively install a 11.2 version of ArcGIS Web Adaptor (IIS) alongside your previous version on the same machine. For example, you can retain your 10.5 version of ArcGIS Web Adaptor (IIS) and install 11.2 on the same web server. You must keep the same Web Adaptor context when upgrading. To do this, uninstall the Web Adaptor currently configured with your portal, and then install the 11.2 Web Adaptor with the same name used previously. Note that two Web Adaptors with the same context cannot be installed on the same machine.

Licensing

If you are upgrading to 11.2, you need to obtain a new portal license file from My Esri and reauthorize your software.

Note:

The license file you input during the upgrade is used to license your portal's users and apps. Ensure the new license file is adequate for your current user and app configuration.

Version details

• Upgrading directly to Portal for ArcGIS 11.2 from versions 10.6.1 or earlier is not supported. To upgrade Portal for ArcGIS 10.6.1 or earlier, first upgrade it to an interim version (10.7.x - 10.9.x) and then upgrade that version to 11.2. Read the upgrade documentation for the interim version to confirm direct upgrades are supported for the Portal for ArcGIS version you start with.
• If you are at version 10.7 or later, running the Portal for ArcGIS 11.2 setup automatically upgrades your portal to 11.2. There is no need to obtain and install each previously released version in sequence or to uninstall your previous version of Portal for ArcGIS.
• Organizations that have upgraded from a version of ArcGIS Enterprise earlier than 11.2 may still have the legacy home page settings available. However, as part of the upgrade process, your home page is automatically updated to the modern, mobile-friendly home page experience featuring item galleries, links, and custom colors and fonts. You can view the legacy home page as a reference to customize your modern home page.
• When upgrading from a Portal for ArcGIS version prior to 10.7 to an interim version (10.7.x - 10.9.x), automatic account creation is disabled. To allow new users to create their own built-in accounts, you must set a default user type and role for new members and enable automatic account creation. These settings will be maintained in future upgrades.
• When upgrading to Portal for ArcGIS 11.2 from a 10.8.1 or 10.9 deployment that has Map Viewer Beta installed, Map Viewer Beta will be automatically uninstalled during the upgrade. The new Map Viewer (formerly known as Map Viewer Beta) is included in 11.2 alongside Map Viewer Classic.
• Starting at 10.8.1, the administrative contacts list is used to send automatic email notifications if email settings are configured for your organization. If no administrative contacts are set, the oldest administrator account in the organization or the Initial Administrator Account will receive the email notification.
• If you are upgrading from 10.8 to 10.8.1 or later, and you have an information banner configured, you must enable the banner through your advanced site settings to have your information banner display on sites created with ArcGIS Enterprise Sites. After upgrading from 10.8 and enabling this setting, it will be retained for future upgrades.

Content

• If you have registered items in your portal from a nonfederated ArcGIS Server site, you do not need to upgrade this ArcGIS Server site to 11.2 to use the site's services with your portal. Services from previous versions of ArcGIS Server can be consumed by Portal for ArcGIS 11.2.
• If you created a custom basemap or configurable app group, and shared Esri basemaps or ArcGIS Configurable Apps to this group, you must share these items to the group again after upgrade.
• If you use ArcGIS Living Atlas of the World content in maps or apps, confirm that the items you use are not in a mature support or deprecated status before you upgrade. At each release, some ArcGIS Living Atlas content is retired and no longer available. If you are using one of these items, it will no longer function once you upgrade. For a list of the ArcGIS Living Atlas content retired at this release, see ArcGIS Living Atlas content life cycles and updates.

Apps

• If you published applications based on ArcGIS Configurable Apps templates, check to see if the app template was retired. Retired configurable app templates will not function once you upgrade your portal to 11.0. You will need to re-create these apps using ArcGIS Instant Apps, ArcGIS StoryMaps, ArcGIS Experience Builder, ArcGIS Web AppBuilder, or ArcGIS Dashboards. Note that if your portal is several releases old, you need to check the retired templates for each release in their respective What's new in Portal topics. For example, if you're upgrading from Portal for ArcGIS 10.7, check the list of retired templates for all releases between 10.7 and the current release.
• If you have Esri apps configured with your portal, ensure you are at a version that's compatible with the 11.2 portal after upgrading.
• If you configured ArcGIS Insights, you do not need to uninstall it prior to upgrading ArcGIS Enterprise. If you are upgrading both ArcGIS Enterprise and ArcGIS Insights, it is best practice to complete the ArcGIS Enterprise upgrade first, including the post-upgrade steps, before upgrading ArcGIS Insights.
• If you configured ArcGIS Navigator mobile map packages with your portal, you need to reconfigure them after upgrading the portal to 11.2.

Highly available portals

If you configured a highly available portal, there are specific steps you need to follow to complete the upgrade. These steps are outlined in Configure a highly available portal.

Note:

Starting at 10.6, highly available deployments use available ports 5701, 7005, 7099, 7654, 7120, and 7220 for intermachine communications. You must ensure that your firewall allows local communication on these ports and that they are not currently in use by another application.

Back up your content

Create a full backup of each type of ArcGIS Data Store configured with your portal's hosting server before upgrading.

If you configured advanced portal options by modifying the properties in the config.js file, you also need to create a back up of the file. After upgrading to 11.0, you can use the backed-up file as a reference to customize your portal's behavior through the ArcGIS Portal Directory (Sharing API).

Legacy:

Previously, you were required to back up the certificate keystore (portal.ks) containing certificates you imported into the portal. Starting at 10.4.1, this is no longer necessary and the portal keystore is automatically migrated during upgrade.

• If you heavily customized the previous version of your portal, it is recommended that you install 11.2 on a separate machine and prototype your portal upgrade.
• You must also back up extensions for ArcGIS Dashboards or ArcGIS Web AppBuilder. The upgrade will not preserve any extensions you have deployed for these clients. Once your upgrade is complete, you must redeploy your extensions.
• Conversely, your content, services, site information, and security settings are all automatically backed up and preserved when upgrading. General settings you edited through the portal website, such as adding your organization's logo and name to the website, are also preserved when upgrading. You don't need to manually back up this information before upgrading.
• To ensure you have enough disk space to support the automatic backup created during the upgrade, determine the amount of space allocated to the portal's content, index, db, and temp directories. Validate that the amount of free space available on disk is at least 2.5 times this amount. If not, allocate at least 2.5 times more space on disk. The portal upgrade needs this free space to successfully back up and upgrade your portal's content, site information, and security settings. The default location for these directories is <Portal for ArcGIS installation directory>/arcgisportal.
• It is also recommended that you back up the arcgisportal content directory folder. If your upgrade encounters issues and you then need to revert to your previously installed version, you can apply this folder to restore your portal's content.

ArcGIS Enterprise upgrade order

The recommended order to upgrade the components in your ArcGIS Enterprise deployment is as follows:

1. Upgrade Portal for ArcGIS.
2. Upgrade ArcGIS Web Adaptor (for Portal for ArcGIS).
3. Upgrade the ArcGIS Server site serving as the portal's hosting server.
4. Upgrade ArcGIS Web Adaptor (for ArcGIS Server).
5. Upgrade ArcGIS Data Store.
6. If your ArcGIS Enterprise deployment includes them, upgrade federated servers.

   Most federated servers must match the version of the base ArcGIS Enterprise deployment. For information on supported versions for federated servers, see Federate an ArcGIS Server with your portal.

   See the upgrade information for the type of federated servers you need to upgrade.

   • ArcGIS GIS Server or ArcGIS Image Server sites
   • ArcGIS GeoEvent Server
   • ArcGIS GeoAnalytics Server
   • ArcGIS Notebook Server
   • ArcGIS Mission Server
   • ArcGIS Workflow Manager
   • ArcGIS Knowledge Server

Perform an upgrade of your portal deployment

Caution:

Your portal deployment, any ArcGIS Server site you federated with your portal, ArcGIS Data Store, and ArcGIS Pro (if licensed through the portal), will be offline during the upgrade.

Note:

Before upgrading the portal, ensure that port 50432 is available (free) on each Portal for ArcGIS machine.

1. Back up the following information:

   Tip:

   You can follow steps below to back up your site, or you can use the webgisdr utility to create a back up of your ArcGIS Enterprise deployment. To do so, follow steps to export ArcGIS Enterprise.

   • The config.js file if you configured advanced portal options by modifying the properties in the file. You can use the backed-up file as a reference to customize your portal's behavior through the ArcGIS Portal Directory (Sharing API) after upgrade. If you heavily customized the previous version of your portal, it is recommended that you install 11.2 on a separate machine and prototype your portal upgrade.
   • All data stores deployed through ArcGIS Data Store. See Upgrade ArcGIS Data Store for details on running the backup.
   • Any extensions you have deployed for Dashboards or Web AppBuilder. These are not preserved upon upgrading and must be redeployed after the upgrade is complete.
   • Back up your ArcGIS Server site so that when you need to revert your site to the earlier version, you can import and restore the site.
2. Determine the amount of disk space allocated to the portal's content, index, db, and temp directories. Validate that the amount of free space available on disk is at least 2.5 times this amount. If not, allocate at least 2.5 times more space on disk. The portal upgrade needs this free space to successfully back up and upgrade your portal's content, site information, and security settings. The default location for these directories is <Portal for ArcGIS installation directory>/arcgisportal. If the content directory resides on a different machine, the same recommendation applies.

   Note:

   When the upgrade completes, the backed-up information is retained on disk. For example, a new folder called upgrade-backup is created and contains version specific folders with backed up contents. It's recommended you move this information to another location to save disk space.

3. From the command prompt, launch the Portal for ArcGIS setup script as the same user that was used to install the existing portal (for example, <CD ROOT or untar directory>/Setup). You do not need to stop Portal for ArcGIS before launching this script.

   Tip:

   To launch the setup script from the Portal for ArcGIS setup media, click the setup script, and select the Run in Terminal button.

4. The setup detects the existing version of Portal for ArcGIS on the target machine and prompts you to continue or exit the upgrade. See the following example:

   =========================================================================
   Portal for ArcGIS 11.2 (Linux)
   =========================================================================
   
   Your Portal for ArcGIS 10.7 is installed at:
   
   /home/ags/arcgis/portal
   
   Confirm Settings
   =========================================================================
   Product to upgrade:             Portal for ArcGIS 10.7 (Linux)
   Location to upgrade:            /home/ags/arcgis/portal
   
   Your Portal for ArcGIS 10.7 will be stopped when performing the 
   upgrade and Portal for ArcGIS 11.2 
   will be started after the upgrade completes.
   
     'y' to continue with these settings
     'q' to exit without upgrading this product
   
   Enter choice [y,q] (y):

5. Type y, and press Enter to accept the detected settings and continue with the upgrade. You must authorize your software with a new .json authorization file. When the portal upgrade completes, the portal website opens in a browser window.
6. Clear your browser's cache (including cookies). Information left over in the cache from the previous version of the website may cause the upgraded website to display incorrectly, and you may not be able to sign in. It's recommended that you clear the cache (including cookies) on all browsers that will view the upgraded portal website.
7. On the Import License File page, browse to your portal license file (.json). This file is obtained from My Esri and contains your portal's user and app license information. Click Continue Portal Upgrade. This triggers the upgrade and creates a backup of your portal's content, site information, and security settings. This step will take a few minutes to complete.

   Note:

   The license file you input during the upgrade is used to license your portal's users and apps. Ensure the new license file is adequate for your current user and app configuration.

   If you are upgrading within the same release version, you will not be prompted to import a new license file. You can import a new license file at any time once the upgrade is complete.

Note:

You can use the upgradeportal command line utility to complete the upgrade and post-upgrade operations silently. In the command line, navigate to your <Portal install directory>/tools/upgradeportal folder and run the following: upgradeportal.sh -lf <path to portal json file> -s. For assistance, run the command with -h or --help. You can also use the upgrade operation in the ArcGIS Portal Administrator API to upgrade Portal for ArcGIS. For more information on the upgrade operation, see the Upgrade documentation in the ArcGIS Portal Admin API help.
8. Sign in to the machine hosting the ArcGIS Web Adaptor you're using with your portal, and uninstall ArcGIS Web Adaptor. For full instructions, see the uninstallation topic for Java (Linux). Be sure to note the name of the Web Adaptor before you uninstall it.
9. Install the Web Adaptor that will be used with your portal. For full instructions, see the installation topic for Java (Linux). Ensure that you use the Web Adaptor name that you used in the previous version.
10. Configure ArcGIS Web Adaptor with your portal. For full instructions, see the configuring topic for Java (Linux).

    Note:

    If present, the DNS alias should be used to access the WA when re-registering with the portal if there is no WebContextURL set in the System Properties.

11. Verify that you can sign in to the portal website through the ArcGIS Web Adaptor URL as an administrator of your organization. The URL is formatted https://webadaptorhost.domain.com/webadaptorname/home.

    Note:

    • If you receive a notice that post-upgrade steps are required, you must click OK on the message dialog box to complete the required post-upgrade steps. These include upgrading ArcGIS Living Atlas of the World content, re-indexing content, and updating the association between portal machines in a highly available portal.
    • If you receive a notice regarding licenses when you sign in to the portal after an upgrade, you may not have imported a license file that meets your current licensing configuration, or your users may be assigned a temporary user type. See Considerations after upgrading Portal for ArcGIS for more details.

12. If you federated an ArcGIS Server site with your portal and you're using ArcGIS Web Adaptor with your site, sign in to the machine hosting the Web Adaptor and uninstall Web Adaptor. Take note of the Web Adaptor name; you need to use the same name when you reinstall. For full instructions, see the uninstallation topic for Java (Linux).
13. If you federated an ArcGIS Server site with your portal, upgrade each site to 11.2. There is no need to uninstall and reinstall. You need to run the setup on each ArcGIS Server machine in each site. Upgrade your ArcGIS Server sites sequentially (back-to-back). For full instructions, see Upgrade a previous version of ArcGIS Server.

    If you have multiple server sites federated with your portal, upgrade the portal's hosting server first, followed by additional server sites in the deployment.

14. When the server upgrade completes, verify you can access the local URL of the ArcGIS REST Services Directory. The local URL is formatted https://gisserver.domain.com:6443/arcgis/rest/services.
15. Sign in to the machine hosting the ArcGIS Web Adaptor you're using with your server, and uninstall ArcGIS Web Adaptor. For full instructions, see the uninstallation topic for Java (Linux). Be sure to note the name of the Web Adaptor before you uninstall it.
16. Install the Web Adaptor that will be used with your server. For full instructions, see the installation topic for Java (Linux). Ensure that you use the Web Adaptor name that you used in the previous version.
17. Configure ArcGIS Web Adaptor with your server. For full instructions, see the configuring topic for Java (Linux). If you had previously enabled administrative access to your ArcGIS Server through Web Adaptor, ensure that you enable it again. This is especially important if you used the Web Adaptor URL for the administrative URL when federating your portal and ArcGIS Server site.
18. Verify that you can access the ArcGIS REST Services Directory through the ArcGIS Web Adaptor URL. The URL is formatted https://webadaptorhost.domain.com/webadaptorname/rest/services.
19. If your portal's hosting server is using ArcGIS Data Store, create a backup of the data store, upgrade ArcGIS Data Store, and reconfigure the data store to work with ArcGIS Server. See Upgrade ArcGIS Data Store for specific instructions.
20. If you configured ArcGIS Pro or Drone2Map licenses with your organization, optionally upgrade ArcGIS License Server Administrator. When upgrading ArcGIS License Server Administrator, members with ArcGIS Pro licenses will be unable to access ArcGIS Pro. If members are currently logged in to ArcGIS Pro, they will see a message stating that the program will be closed in twenty-four hours. Members can complete or save their work within this time period. You must import the same license file (.json) that you imported into your portal into the ArcGIS License Server Administrator.
21. Restore any customization you previously configured for your portal. When restoring your portal customizations in 11.2, do not replace the files you modified in the previous version in 11.2. This adversely affects your 11.2 deployment. You must open each file at 11.2 and manually re-add your custom behavior from the previous version.

    Tip:

    Esri recommends using the portalScan.py script to check for security best practices with your upgraded ArcGIS Enterprise portal.

22. You must additionally install the Web Styles setup if you want to use a complete set of 3D symbology from Scene Viewer. For additional information, see Scene Viewer requirements.

Considerations after upgrading

After upgrading, carefully review the following information.

• After upgrading, the portal website does not display correctly or I can't log in. What's wrong?
• After upgrading, I don't see all of my items, groups, and users in my portal. What's going on?
• After upgrading to 11.2, ArcGIS Living Atlas content is no longer accessible in my portal.
• After upgrading, automatic account creation is failing with a software authorization error.
• When I log into portal, I receive a notice stating that "the number of licenses assigned exceeds the number of licenses available. Members assigned these licenses may not be able to access the portal. Go to the Licenses tab for more details". How do I resolve this issue?
• There was an error creating my initial administrator account. How do I resolve this to complete the upgrade?
• Do I need to do anything with my utility services after upgrading?
• My portal is configured with ArcGIS World Geocoding Service. Do I need to reconfigure after upgrading?
• My ArcGIS Enterprise portal is configured with Routing services. Do I need to reconfigure after upgrading?

After upgrading, the portal website does not display correctly or I can't sign in. What's wrong?

Clear your browser's cache (including cookies). These errors are typically due to leftover information from the previous version of the website being cached in the browser. If you still can't sign in, make sure you are using the initial administrator account or an account that has administrative privileges to your portal. If the cards on the Organization Overview tab are not loading, import your portal license file (.json). You can import the license file through the Portal Administrator Directory using the URL https://portal.domain.com:7443/arcgis/portaladmin/license/importLicense. Ensure that this is the correct license file for your portal. When importing a new license file, any user types or app licenses in your portal are overwritten by the new license file.

After upgrading, I don't see all of my items, groups, and users in my portal. What's going on?

After installing the software and specifying the initial administrator account, a reindex of your portal is initialized. Initially, you may not see all of your items, groups, and users because the reindex is not complete. Depending on the number of users and volume of content in your portal, it will take some time for the reindex to complete. For example, a small organization (hundreds of users and content items) running Portal for ArcGIS on a machine with 8 cores may take 15 minutes to reindex. Conversely, a large organization (tens of thousands of users and content items) running Portal for ArcGIS on a machine with 8 cores may take over 3 hours to reindex.

You can check the status of the reindex by following the steps below. When the store and index counts are equal, the reindex and upgrade are complete.

1. Open the Portal Administrator API and sign in with the initial administrator account. The URL is formatted https://portal.domain.com:7443/arcgis/portaladmin.
2. Click System > Indexer > Index Status.
3. Refresh the page to obtain the latest status.

After upgrading to 11.2, ArcGIS Living Atlas content is no longer accessible in my portal.

If a ArcGIS Living Atlas layer is not accessible in your portal after you upgrade, it's possible that the item is retired at this release. Check ArcGIS Living Atlas content life cycles and updates for an updated list of retired items.

If subscriber or premium content items cannot be opened post-upgrade, verify that the ArcGIS Online account you used when you configured the portal to access this content is still valid. If it is not, you must complete additional steps to update this account and the ArcGIS Living Atlas content.

After upgrading, automatic account creation is failing with a software authorization error.

If you are upgrading from a version prior to 10.7 to an interim version (10.7.x - 10.9.x), automatic account creation is disabled. After completing the upgrade, you need to assign a default user type and role for new members and enable automatic account creation in the ArcGIS Portal Administrator Directory. Starting at 10.8, the default user type and role for new members can be set in the organization settings in the portal or using the setUserDefaultSettings operation in the portal self resource in the ArcGIS Portal Directory.

When I log into portal, I receive a notice stating that "the number of licenses assigned exceeds the number of licenses available. Members assigned these licenses may not be able to access the portal. Go to the Licenses tab for more details". How do I resolve this issue?

This notice displays for administrators when they sign in to the portal and the portal's licensing is in overdraft. The number of users assigned a user type or add on license exceeds the number of licenses available.

The administrator can navigate to the Licenses tab to view the licenses in overdraft. Licenses in overdraft have a greater number assigned than the number available. Depending on your organization's needs, you can reassign licenses or obtain a new portal license file with the correct allocation of licenses.

There was an error creating my initial administrator account. How do I resolve this to complete the upgrade?

If you receive this error when creating the initial administrator account, information in the portal logs can help you resolve the issue. Often, this error may occur if network connectivity was temporarily lost when creating the account. To access the logs, browse to the logs directory and open the most recent log file (for example, <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20141201.095803-8596-0.0.log). If necessary, you can share this information with Esri Support.

If you are reverting to your previous deployment, before you revert to the earlier version, copy all log files to aid in troubleshooting your support incident. (To access the logs, browse to the logs directory (for example, <Portal for ArcGIS installation directory>/arcgisportal/logs/).

Do I need to do anything with my utility services after upgrading?

If you use the OfflinePackaging, RasterUtilities, or GeocodingTools utility services, you need to manually update them after you upgrade:

1. Once your upgrade is complete, log in to ArcGIS Server Manager as the user who owns the utility services.
2. On the Manage Services section of the Services tab, click the Utilities folder.
3. Click the Sharing Properties icon.
4. On the dialog box that appears, click Save. This updates the service in your ArcGIS Enterprise portal.
5. Sign in to the portal as an administrator. On the Content tab, locate the service you've updated. Click Share. Update the sharing settings if needed, then click OK. This updates the service with each group it's shared to.
6. Repeat these steps for each applicable service.

My portal is configured with ArcGIS World Geocoding Service. Do I need to reconfigure after upgrading?

If you upgraded from version 10.2.x, you need to re-create the proxy item in your portal to ArcGIS World Geocoding Service. Then, configure the item as a geocoder for the portal. As of 10.3.1, you do not need to update the proxy item to ArcGIS World Geocoding Service.

My ArcGIS Enterprise portal is configured with Routing services. Do I need to reconfigure after upgrading?

If you configure routing services by publishing routing services using your network dataset, it is recommended that you reconfigure your routing services after server upgrade to use the latest capabilities. For geoprocessing based routing services, new service parameters and new service capabilities will only be available when you republish routing services after upgrading your server.

To republish routing services using your network dataset, follow the steps below:

1. Sign in as a default administrator or custom role with the correct privileges to manage portal settings.
2. At the top of the site, click Organization and click the Settings.
3. Click Utility services on the left side of the page.
4. Click Directions and Routing on the right side of the page.
5. Click Update routing services button and choose A network dataset that I'd like to publish.
6. Follow the steps here to configure routing services using your network dataset.

Once it runs successfully, you can use ArcGIS Server Manager to delete the folder containing routing services published previously.