laptop and a wrench

Bogue

Portal for ArcGIS upgrade fails when the default self-signed certificate named ‘portal’ is deleted prior to the upgrade.

Portal for ArcGIS
Numéro d’ID de bogue BUG-000171951
EnvoiOctober 31, 2024
Dernière modificationOctober 8, 2025
S’applique àPortal for ArcGIS
Version trouvée11.1
Système d’exploitationWindows Server
Version du système d’exploitation2019 64 Bit
Version de correction12.0
StatutFixed

Solution de contournement

1.     Prior to an upgrade, use the ‘generate’ operation to re-create a self-signed certificate with the alias ‘portal’.

a.     https://developers.arcgis.com/rest/enterprise-administration/portal/generate-certificate-ha/

2.     After the upgrade fails, reinstall ArcGIS Enterprise. Ensure that the default ‘portal’ self-signed certificate is not deleted, then proceed with an upgrade.

a.     Note that performing a reinstall of ArcGIS Enterprise will likely require the customer to restore from a WebGIS DR backup to ensure that all the expected content is available before an upgrade.

3.     During the upgrade, edit the Portal for ArcGIS server.xml file to point the keyAlias property to the Web Server SSL Certificate configured prior to starting the upgrade. Note that this should be considered a “last effort” attempt, as it is not recommended to modify the Portal for ArcGIS server.xml file in this manner.

a.     In Windows Services, stop Portal for ArcGIS.

b.   Open the Portal for ArcGIS server.xml file in Notepad++ (administrator mode).

c.    Update the keyAlias property to the correct Web Server SSL Certificate value. In this example, the keyAlias was changed back to the Web Server SSL Certificate named ‘cutsp11’.

d.     Save the Portal for ArcGIS server.xml file.

e.     In Windows Services, start Portal for ArcGIS and verify that the “Continue Portal Upgrade” endpoint is now reachable.

Étapes pour reproduire

ID de bogue: BUG-000171951

Logiciel:

  • Portal for ArcGIS

Recevoir une notification lorsque le statut d’un bogue change

Télécharger l’application Esri Support

En savoir plus sur ce sujet

Obtenir de l’aide auprès des experts ArcGIS

Contacter le support technique

Télécharger l’application Esri Support

Accéder aux options de téléchargement