ERROR

User name is longer than 20 characters

Last Published: March 31, 2025

Error Message

Attempts to install or upgrade ArcGIS Enterprise fail, and return the following error:

Error:
User name is longer than 20 characters.

The error message window during installation

Cause

This is a known limitation when using the user principle name (UPN) format which uses the symbol '@', for example, testlongusername@domain.esri.com as the Portal for ArcGIS or ArcGIS Server and ArcGIS Datastore Windows service account. This results in ArcGIS Enterprise counting the domain together with the username and returns the error.

Solution or Workaround

Install ArcGIS Server, ArcGIS Datastore or Portal for ArcGIS

When specifying the ArcGIS Enterprise Windows service account name, use the domain\username format and ensure the username contains less than 20 characters. The ArcGIS Enterprise only counts the username portion of the account name and omits the domain portion when counting the number of characters.

Upgrade ArcGIS Enterprise

  1. Ensure the installer is not running.
  2. Run services.msc.
  3. Locate the Portal for ArcGIS/ArcGIS Server/ArcGIS Datastore service and stop the service.
Stopping ArcGIS services in services.msc
  1. Right click on the respective service and select Properties.
  2. Click the Log On tab. Select 'This account', update the name to use theĀ domain\username format as shown in the example below and ensure the username contains less than 20 characters. Click OK.

  1. Start the service and re-run the upgrade process.

Article ID: 000027233

Software:
  • Portal for ArcGIS
  • ArcGIS Server

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