Upgrading an earlier version of Portal for ArcGIS

You can use the Portal for ArcGIS 10.2.2 setup to upgrade a previous version of Portal for ArcGIS to 10.2.2.

Before upgrading, see About upgrading Portal for ArcGIS to learn more about the upgrade behavior.

The upgrade process will restart Portal for ArcGIS. You should consider your site offline during the upgrade.

Note:

When upgrading Portal for ArcGIS 10.2.1 to 10.2.2, the setting that enables or disables automatic account creation is not preserved; automatic account creation is disabled after upgrading. This is unintended behavior and will be addressed in a future software release. If you enabled automatic account creation at 10.2.1, you can resolve this issue by immediately re-enabling the setting after upgrading to 10.2.2. For full instructions, see Automatic registration of enterprise accounts.

1. Back up any customization you've configured for your portal, such as properties you've modified in config.js to display social media links in the portal website, remove the account sign-up page in the portal website, or disable web searches on your portal's content. If you've heavily customized the previous version of your portal, it is recommended that you install 10.2.2 on a separate machine and prototype your portal upgrade.

   Note:

   Your services, site information, and security settings are all preserved when upgrading and do not need to be backed up. General settings you've edited through the portal website, such as adding your organization's logo and name to the website, are preserved when upgrading.

   When restoring your portal customizations in 10.2.2, it is recommended that you do not replace the files you modified in the previous version in 10.2.2. This may adversely affect your 10.2.2 deployment. You'll need to open each file at 10.2.2 and manually re-add your custom behavior from the previous version.

2. From the command prompt, launch the Portal for ArcGIS 10.2.2 setup script as the same user that was used to install the existing portal, for example, <CD ROOT or untar directory>/Setup.

   Tip:

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

3. The setup will detect your existing version of Portal for ArcGIS on the target machine and prompt you to continue or exit the upgrade. For example

   =========================================================================
   Portal for ArcGIS 10.2.2 (Linux)
   =========================================================================
   
   Your Portal for ArcGIS 10.2.1 is installed at:
   
   /home/ags/arcgis/portal
   
   Confirm Settings
   =========================================================================
   Product to update:             Portal for ArcGIS 10.2.1 (Linux)
   Location to update:            /home/ags/arcgis/portal
   
   Your Portal for ArcGIS 10.2.1 will be stopped when performing this 
   upgrade and restarted after installation.
   
     'y' to continue with these settings
     'q' to exit without applying this product
   
   Enter choice [y,q] (y):
   

4. Type y and press Enter to accept the detected settings and continue with the upgrade.

   Note:

   If you've previously authorized Portal for ArcGIS, you will not be prompted to reauthorize the software after upgrading. Your authorization information will be reused. If you have not authorized your portal for use, see Authorizing Portal for ArcGIS for authorization instructions.

After the installation completes, the portal website will open in a browser window. At this time, clear your browser's cache (including cookies). Information left over in the cache from the previous version of the website may cause the website to display incorrectly and you may not be able to log in. It is recommended that you clear the cache (including cookies) on all browsers that will be viewing the upgraded portal website.