BUG

Applying the Portal for ArcGIS Log4j Patch on an Azure deployment may cause the Portal for ArcGIS service to fail to start

Last Published: April 30, 2022

Description

Applying the Portal for ArcGIS Log4j Patch on an Azure deployment may cause the Portal for ArcGIS service to fail to start (BUG-000148416).  This applies to Azure deployments that use the Azure Blob Storage to store the Portal for ArcGIS content directory.  The attached PowerShell script can be used to correct this issue.

Note:
New patches have been released to prevent this defect on Azure deployments.  The B patches are available for the following releases: 10.7.1, 10.8.1, and 10.9.1.  If the B patch is available for the release you have deployed, it is recommended to install the B patch rather than running the script.

The script is provided to address issues introduced on an Azure deployment after installing the Portal for ArcGIS Log4j patch on 10.6, 10.6.1, and 10.9 releases.

  • The problem only happens when Azure Blob Storage is used to store the Portal for ArcGIS content store.
  • The problem happens when Portal for ArcGIS is restarted after the Log4j patch is installed.  The Portal for ArcGIS service on Windows will start but will quickly stop with no error returned.
  • The attached PowerShell script is written to work on any Azure deployments.

Workaround

Workaround

The attached PowerShell script should be downloaded and executed on an Azure instance where the Log4j patch has been installed and the Portal for ArcGIS service fails to restart.

Download the zip file.  Ensure that the file has not been tampered with by computing the sha256 checksum as follows:

  1. Start Windows PowerShell.
  2. Change directory to the directory with the zip file.
  3. Type this command:
Get-FileHash log4jazurefix.zip
  1. Ensure the hash matches the string below:
874D0403527F28600344FDF2F8C51A3E53B82F220AB53B8B67753F115CA80E88

Extract
Extract the PowerShell script from the zip file.

Script Execution
The PowerShell script must be executed as an administrator.

  1. Start Windows PowerShell as an administrator.
  2. Change directory to the directory where the script was extracted.
  3. Execute the PowerShell script:
.\log4jazurefix.ps1
  1. The script returns a message if the Portal for ArcGIS Java classpath was updated in the Windows registry.  Once completed, you should be able to successfully start the Portal for ArcGIS service.

Article ID:000027608

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options

Related Information

Discover more on this topic