ERROR

Portal for ArcGIS: Failed to configure the definition of the appBundles <app_bundle>

Last Published: September 5, 2024

Error Message

In Portal for ArcGIS, when attempting to update the license from the Portal Administrator Directory > License > Import License, the following errors are returned:

Error:
Failed to configure the definition of the appBundles Essential Apps
Code: 500
Error:
Failed to configure the definition of the appBundles Office Apps
Code: 500
The failed to configure the definitions of the appBundles Essentials Apps error

In the Portal logs, the following severe error is returned:

Error:
The server at https://<machine_name>.<domain_name>:7443/arcgis/sharing/rest/portals/configurableAppBundle' returned an error. Invalid app bundle. ["Invalid apps"]

The severe error message regarding invalid app bundles

In some instances, the certain pages or tab in Portal for ArcGIS loads indefinitely, thereby preventing full access to the page or tab. The affected pages or tabs are as follows:

  • The Organization tab.
  • The Members tab.
  • The Licenses tab.
  • The Settings page.
  • The item details page.

The image below shows the example of the Overview tab loading indefinitely.

The Overview tab with the Members and Add-on licenses sub-pages showing a constant 'Loading...' symbol

Cause

Default item file(s) or folder(s) in the portal's content directory is corrupted which results in an issue with reading and updating portal's licenses.

Solution or Workaround

Warning:   
The instructions below include making changes to essential parts of the ArcGIS Enterprise deployment and the operating system, which may affect other applications and functionalities on the machine. Esri recommends performing a backup of the ArcGIS Enterprise machine, including the registry, before proceeding. 
Esri cannot guarantee results from incorrect modifications while following these instructions and is not responsible for any changes made to the system. Consult a qualified computer systems professional if necessary.
  1. Navigate to the Portal Administrator Directory, and log in as an administrator using the following URL:
https://<machine_name>.<domain_name>/<web_adaptor_name>/portaladmin
  1. Run the Export Site operations to create a .portalsite backup file. Refer to ArcGIS REST APIs: Export Site for additional information.
    1. For the Destination parameter, select a folder path.
    2. Check the Validate location? check box.
    3. For the Format parameter, select the response format.
    4. Click Export Site.
  1. Perform a clean uninstallation of Portal for ArcGIS. Refer to How To: Perform a clean uninstallation of ArcGIS Enterprise base deployment components for steps.
  2. Install Portal for ArcGIS. Refer to ArcGIS Enterprise: Installing Portal for ArcGIS for steps.
  3. Create a new portal site. Refer to ArcGIS Enterprise: Create a single machine portal for steps.
  4. Stop the Portal for ArcGIS service. Refer to Portal for ArcGIS: Stop and start the portal for steps.
  5. In File Explorer, navigate to the following directory:
C:\arcgisportal\content\item
  1. Copy all files in the folder, excluding the following folders:
    • portal
    • portal-ha
    • groupinfo
  1. Create a temporary folder on the machine and paste the copied files into the newly created temporary folder.
  2. Start the Portal for ArcGIS service. Refer to Portal for ArcGIS: Stop and start the portal for steps.
  3. In Portal Administrator Directory, run the Import Site operations to restore the .portalsite backup file created in Step 2. Refer to ArcGIS REST APIs: Import Site for additional information.
    1. For the Source (File path with extension .portalside) parameter, select the folder path in Step 2a.
    2. Check the Validate location? check box.
    3. For the Format parameter, select the response format selected in Step 2c.
    4. Click Import Site.
  1. Stop the Portal for ArcGIS service. Refer to Portal for ArcGIS: Stop and start the portal for steps.
  2. Copy and paste the files from the folder created in Step 9 into the existing portal's content directory. When prompted by the Replace or Skip Files dialog box, select Replace the files in the destination.
  3. Start the Portal for ArcGIS service. Refer to Portal for ArcGIS: Stop and start the portal for steps.

The image below shows the Overview tab fully loaded.

The Overview tab with the Members and Add-on licenses sub-pages fully loaded

Article ID: 000032399

Software:
  • Portal for ArcGIS
  • ArcGIS Enterprise 11 0
  • ArcGIS Enterprise 11 1
  • ArcGIS Enterprise 11 2

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