Skip To Content

Checking portal diagnostics

Portal for ArcGIS includes a diagnostics tool that you can use to validate that your machine meets the minimum system requirements and verify the software is working as expected. If any issues are encountered when running the tool, it will list a possible cause and solution to the problem.

When you initially launch the software installation, the tool runs automatically to validate that your machine meets the minimum system requirements. Address any issues noted by the tool before proceeding with the installation. If you experience issues after installation, run the tool to help you identify and diagnose problems. For example, you can run the tool to verify if all core Portal for ArcGIS services are started.

Running the tool

You'll run the portal diagnostics tool from the command line on the machine hosting Portal for ArcGIS. To run the tool, browse to the <Portal for ArcGIS installation directory>/arcgis/portal/tools/portaldiag directory in the command line and execute portaldiag.

Keep in mind that you'll need to run this tool using the account that was used to install Portal for ArcGIS. This is the account that owns the Portal for ArcGIS installation directory. For the tool to execute, the account needs at least read and write permissions to the /tmp directory on the machine hosting Portal for ArcGIS.

Interpreting portal diagnostics

After running the tool, a report is generated that contains a summary of all the portal diagnostic checks performed. It also indicates if the checks display a warning, or if they passed, failed, or are not applicable to the system.

Each check is identified with a code formatted DIAG<number> followed by the status of the check performed. For an explanation of each diagnostics check, see the table below. You can use this information to analyze the current state of the machine hosting Portal for ArcGIS.

Check numberCheck titleDescription


Check for installation as root

Installing Portal for ArcGIS as root is not supported. This check will fail if Portal for ArcGIS is detected to be installed as root.


Check for 64-bit architecture

Portal for ArcGIS is supported only on 64-bit architecture. If the machine is 32-bit architecture, this check will fail. Consult the system requirements for supported operating systems.


Check OS version

A warning will display if the operating system is not of a supported Linux distribution or version. Consult the system requirements for supported Linux platforms and OS versions. If the operating system is not of a supported Linux distribution, all the other checks will not be performed.


Check host name for invalid characters

Valid characters for the host name of the machine hosting Portal for ArcGIS include alphanumeric a–z, 0–9, and minus (-) and dot (.) characters, as outlined in the RFC 952 specification. The check will fail if the host name contains one or more invalid characters.


Check installed packages

Depending on the Linux distribution used, this check validates that the required operating system packages are installed for the proper support of Portal for ArcGIS. If the check fails, it will return a warning with the missing packages needed for the machine. Consult the system requirements for details.


Check system limits

For the portal to run properly, the file handle soft and hard limits for the installation user are required to be set to 65535. This check validates whether this limit is set properly in the /etc/security/limits.conf file. If the limits are set incorrectly, this check fails. To verify, run the following:

ulimit -Hn

ulimit -Sn

For additional details, see the system requirements.


Check Portal for ArcGIS ports

Portal for ArcGIS communicates through port 7080. When SSL is enabled, Portal for ArcGIS uses port 7443 by default. Other required ports include 7005, 7654, 7199, and 7099. This check verifies if the required default ports are in use by another user or process. If this check returns a warning, Portal for ArcGIS will not run properly. To correct this issue, open ports 7080, 7005, 7443, 7654, 7199, 7099, and restart Portal for ArcGIS.


Check host name IP address mismatches

If the host name entry for the machine in the /etc/hosts file does not match the IP address of the machine, this check will return a warning. This will cause Portal for ArcGIS to function improperly. To correct this issue, fix the host name entry and restart Portal for ArcGIS.


Check localhost resolution

Portal for ArcGIS requires localhost to be resolved to, otherwise creating the portal will fail. Run ping localhost to make sure the localhost (loopback) address is resolved to before creating your portal.


Check processes for Portal for ArcGIS core services

The check verifies if all the core services are started after Portal for ArcGIS is started. It returns a warning if one or more core services are not started. To correct this issue, start Portal for ArcGIS by running the script or restart Portal for ArcGIS if it is already running.


Check data directory

Portal for ArcGIS requires that the account used to install the software be granted the following access permissions to the portal's directories:

  • db (exactly 700)
  • content (at least 700)
  • index (at least 700)
  • temp (at least 700)
  • logs (at least 700)

The diagnostics check will fail if the above requirements are not met. To view the location of the portal's directories, log in to the ArcGIS Portal Directory and click System > Directories. The URL to the Portal Directory is formatted


Check file system type

Your Portal for ArcGIS installation directory is targeted to an 'ext3' file system. This file system limits the number of item subfolders to less than 32,000. Portal for ArcGIS will not function properly when this limit is exceeded. It's recommended that you update or move the installation directory to an 'ext4' file system which does not have this limitation.