PROBLEM

Unable to upgrade ArcGIS Enterprise 11.1 on Kubernetes to 11.2 using Azure Container Registry

Last Published: December 15, 2023

Description

Unable to upgrade ArcGIS Enterprise 11.1 on Kubernetes to 11.2 when the organization uses Azure Container Registry.

The upgrader job returns a NullPointerException while verifying container image availability during the upgrade pre-requisite check.

Example log messages as shown in the next image include:

  • Failed to write/zip exported upgrade files
  • Exception occurred in upgrader job.
  • Error starting upgrade. Retry upgrade.
  • Image availability check failed

Cause

If the ArcGIS Enterprise on Kubernetes organization is configured to pull images from an Azure Container Registry (ACR) instance, the upgrade from version 11.1 to 11.2 fails. Since the upgrade fails before any operations that change the state of the organization, the upgrade can be retried without redeploying or restoring from backup after implementing the following workaround.

Solution or Workaround

To resolve this issue, you can skip the validation check to ensure the availability of images before starting the upgrade process. Since the validation check will not be run, it is important to confirm that all the required images are present in the registry prior to implementing this workaround.

  1. Ensure all forty-one container images for version 11.2 (tag 11.2.0.5207) are available in the ACR instance.
  2. Use the ArcGIS Enterprise Administrator API to set the system property to skip validation of availability of container images:
    • Go to https://<machine.domain.com>/<context>/admin/system/properties/update and update the system properties with below json and click Update properties:
{"skipImageAvailabilityCheck":true}

Article ID: 000031676

Software:
  • ArcGIS Enterprise on Kubernetes

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

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options