The system and hardware required to run Portal for ArcGIS are listed below. A diagnostics tool runs during the setup to help you determine if your machine meets the minimum system requirements.
If your Portal for ArcGIS organization will use ArcGIS Pro or Drone2Map for ArcGIS, you will also need ArcGIS License Manager 2019.2 to configure your licenses to specify which members can use these applications. See the Portal for ArcGIS administrator guide, License Manager reference guide, and License Manager system requirements for more information.
It's recommended that you review the deprecation notice to determine if your hardware and software components are still compatible with version 10.8.
Linux operating system requirements
The following 64-bit operating systems satisfy the minimum operating system requirements. Support is not provided for 32-bit operating systems; the setup will only proceed if the operating system is 64 bit.
Portal for ArcGIS is only supported on Linux x86_64, on CPUs that adhere to the x86_64 architecture (64 bit), with supported Linux releases.
Machines with an underscore (_) in the name are not supported. The setup will not proceed if an underscore is detected in the machine name.
You cannot install the software as a root user. If you attempt to do this, the installation will not proceed and a diagnostics tool will display an error message indicating that you cannot install as root.
The software should not be installed on an OS (binary) that has been modified. Esri does not provide support for products installed on a developer's release of an operating system.
Supported operating systems | Latest update or service pack tested |
---|---|
Red Hat Enterprise Linux (RHEL) Server 7 | Update 7 |
RHEL Server 6 | Update 10 |
SUSE Linux Enterprise Server 12 | Service Pack 4 |
Ubuntu Server LTS 18 | 18.04.3 |
Ubuntu Server LTS 16 | 16.04.6 |
CentOS Linux 7 | 7.7 |
CentOS Linux 6 | 6.10 |
Scientific Linux 7 | 7.7 |
Scientific Linux 6 | 6.10 |
Oracle Linux 7 | Update 7 |
Oracle Linux 6 | Update 10 |
Prior and future updates or service packs on these operating system versions are supported unless otherwise stated. The operating system version and updates must also be supported by the operating system provider.
Note:
Esri Technical Support is available for CentOS, Scientific Linux, and Oracle Linux versions that provide full binary compatibility with an equivalent supported RHEL Server version. As a prerequisite for logging a defect, any software issue on these operating systems will be attempted to be reproduced on Red Hat Enterprise Linux Server. For Oracle Linux, support is predicated on the use of the RHEL Server compatible kernel.
Tip:
The X Window System package group is required on the machine to run the following using the operating system graphical user interface (GUI):
- Portal for ArcGIS installation wizard
- Check for Updates tool
The following package groups are required.
Red Hat Enterprise Linux Server requirements
Red Hat Enterprise Linux Server 6 and 7
- gettext
SUSE Linux Enterprise Server
SUSE Linux Enterprise Server 12
- gettext-runtime
Ubuntu Server LTS
Ubuntu Server 16.04 LTS and 18.04 LTS
- gettext-base
Hardware requirements
The following are the minimum hardware requirements to install Portal for ArcGIS:
- Processor: 2 cores minimum for development and testing, 4 cores minimum highly recommended for production systems
- Memory/RAM: 8 GB
- Disk space: 10 GB
All content created by your users will also be stored on disk. Carefully consider how data will be uploaded and created by your users and allocate disk space accordingly. If desired, you can change the location of where the portal stores its content after installing the software.
Temp space requirements
By default, resources are extracted to the system /tmp directory. This directory must have read, write, and execute permissions enabled. If the required space is not available in the /tmp directory, the setup program will attempt to extract resources to the user's HOME directory. If the required space is not available in the user's HOME directory, the setup program will report an error indicating this problem. Optionally, you can specify an alternate temp location by setting the IATEMPDIR environment variable.
File system requirements
On Linux systems, the ext3 file system limits the number of item subfolders to less than 32,000; this means your portal is limited to having no more than 32,000 items. No new items can be added to Portal for ArcGIS when this limit is reached. It is recommended that you update or move the installation directory to an ext4 or xfs file system that does not have this limitation. The file system must also be supported by the operating system provider.
Note:
The btrfs file system is supported only if adequate disk space is allocated for the metadata used by btrfs. Run the following command to confirm: btrfs filesystem df /File handle limits
For the portal to run properly, the file handle limits for the installation user are required to be set to a minimum of 65,535. An installation diagnostics tool will check whether the limits are set properly in the /etc/security/limits.conf file. If the limits are set incorrectly, the diagnostics check will fail.
There are soft and hard limits for file handles on Linux. To determine the limits, use the following commands:
- Soft limit: ulimit -Sn
- Hard limit: ulimit -Hn
To increase the soft and hard limits, edit the /etc/security/limits.conf file with superuser access. For example, add two lines in the file like this:
<Portal for ArcGIS installation user> soft nofile <file handle limit>
<Portal for ArcGIS installation user> hard nofile <file handle limit>
After making this change, sign out and sign back in with the particular user for the new values to take effect. To verify that the limits have been modified appropriately, use the ulimit -Sn and ulimit -Hn commands as described above.
Firewall settings
Portal for ArcGIS communicates through specific ports. You'll need to open these ports on your firewall before installing the software. For information on the ports Portal for ArcGIS requires for communication, see Ports used by Portal for ArcGIS.
Domain name service and fully qualified domain name requirements
Your organization's domain name service (DNS) must include an entry of the fully qualified domain name (FQDN) of the machine hosting Portal for ArcGIS. Similarly, if you'll be using ArcGIS Server with your portal, it's recommended that you include FQDN entries for each site you intend to federate with Portal for ArcGIS.
Note:
Portal for ArcGIS only supports a single DNS.
Optionally, you can configure your DNS to use a friendly name for the portal (for example, friendly.domain.com instead of portal.domain.com). When doing this, assign the name to the portal machine before you install the software. Then use the friendly name when setting up the portal. For example, setup activities that require use of the friendly name include the following:
- Configure ArcGIS Web Adaptor with your portal.
- Federate an ArcGIS Server site with your portal.
- Add Portal for ArcGIS to your organization's reverse proxy server. If you're not using a reverse proxy server, it's recommended that you assign a friendly name to the machine hosting ArcGIS Web Adaptor.
Caution:
If you configure a friendly DNS name after setting up your portal, existing items in the portal may become unusable, as they will include the nonfriendly name. You'll need to manually re-create each item to use them again.
SSL certificates
Portal for ArcGIS is preconfigured with a self-signed server certificate, which allows the portal to be initially tested and to help you quickly verify that your installation was successful. You must request a certificate from a trusted certificate authority (CA) and configure the portal to use it. The certificate can be signed by a corporate (internal) or commercial CA.
You should configure each applicable ArcGIS component in your organization with a certificate from a corporate or commercial CA. Common examples include ArcGIS Web Adaptor and ArcGIS Server. For example, ArcGIS Server includes a preconfigured self-signed certificate. If you'll be federating an ArcGIS Server site with your portal, it's very important that you request a CA-signed certificate and configure the ArcGIS Server site and Web Adaptor to use it.
For more information, see Security best practices.
ArcGIS Web Adaptor
ArcGIS Web Adaptor is a required component of Portal for ArcGIS that allows you to integrate your portal with your existing web server and your organization's security mechanisms. You cannot deploy Portal for ArcGIS in your organization without the Web Adaptor.
You can only use the Web Adaptor with port 80 or 443. Using other ports is not supported. See the ArcGIS Web Adaptor documentation for details.
Supported web browsers
For the best performance in the portal website, use the latest versions of the browsers listed below. The website leverages the local storage capabilities (similar to cookies) of the browser. If this storage is disabled, the site will not function properly. To learn how to enable local storage, consult the browser's documentation.
- Google Chrome
- Microsoft Edge
- Microsoft Internet Explorer 11 (Active scripting must be enabled for the portal website to function correctly.)
- Mozilla Firefox
- Safari
- Android Browser
- Chrome for Android
Scene Viewer has its own browser and hardware requirements. Some of the common clients of Portal for ArcGIS have different requirements. See their documentation for details.
External access
If you'll be using services provided by Esri, such as basemaps, ArcGIS Living Atlas of the World content, and data from ArcGIS Online, the machine hosting Portal for ArcGIS must have access to the internet. If your portal will not have access to the internet, you'll need to perform some additional configuration steps to ensure that your portal is pointing to local resources. For instructions, see Configure a disconnected deployment.
ArcGIS Enterprise on cloud platforms
You can deploy ArcGIS Enterprise on many cloud platforms. Any cloud platform that provides virtual machines that meet the basic system requirements for operating system and system specifications is supported for use with ArcGIS Enterprise.
In addition to basic support, Esri provides deployment tooling and prebuilt virtual machine images on two cloud platforms: Amazon Web Services (AWS) and Microsoft Azure. When deploying on these two cloud platforms, it's recommended that you use the specialized tooling and images to simplify deployment and technical support.
Esri does not provide technical support for provisioning and configuring cloud infrastructure beyond what ArcGIS Enterprise deployment tooling creates and manages as part of its normal operations. For cloud platforms for which Esri does not provide specialized deployment tooling, support is limited to troubleshooting software-specific issues.
ArcGIS Enterprise also supports native cloud functionality such as storage and databases on several cloud platforms. Examples include Amazon Simple Storage Service (S3) and Microsoft Azure SQL Database. See the documentation for each ArcGIS component for information on the native cloud functionality that's supported.
Supported virtualization environments
All components of ArcGIS Enterprise are fully supported on virtual environments as long as they run on supported operating systems. When running third-party applications with ArcGIS Enterprise, such as relational databases, the application must also be supported in a virtual environment. Check the third-party vendor for its virtualization support.
The following virtualization environments are known to perform well with ArcGIS Enterprise and its components:
- VMware vSphere 6.5, 6.7
- Microsoft Hyper-V
Inclusion on the above list does not imply an endorsement or higher level of support. A lack of inclusion on the above list does not imply that an environment or specific version is not supported, simply that it is not an environment or version that Esri or its partners have explicitly tested.
For additional information, see Virtualization and ArcGIS Server.