Skip to main content

Prepare to install ArcGIS Enterprise Builder

Before you run ArcGIS Enterprise Builder, perform the following steps:

  1. Obtain the required authorization files.

    Each machine with an installation of ArcGIS Enterprise Builder requires an authorization file for ArcGIS Server Standard or Advanced. You can obtain an authorization file from My Esri (by email, fax, phone, or mail) before proceeding with the installation. Registration requires registration numbers similar in format to ABC123456789. Visit My Esri for more information.

    You also must obtain a portal license file from My Esri, which you'll use when configuring the ArcGIS Enterprise organization.

  2. Verify you do not have Portal for ArcGIS, ArcGIS Server, or ArcGIS Data Store installed on the machine.

  3. Verify you do not have Portal for ArcGIS, ArcGIS Server, ArcGIS Data Store or web adaptors named portal or server installed on the machine.

    The builder will install two web adaptors with default names of portal and server. If you choose to specify alternate web adaptor names, ensure those names are not already used for web adaptors installed on the machine.

  4. Verify that your machine has a supported operating system installed and sufficient free disk space and RAM. For more information, see the system requirements.

    Note:

    ArcGIS Enterprise Builder cannot be installed on machines that have multiple network interface cards.

  5. Verify that your machine has a Java server installed in preparation for the two required web adaptors.

  6. Verify that your machine has Microsoft .NET installed. The .NET Extension Support feature is automatically installed with ArcGIS Server and can be used to develop and deploy .NET server object extensions (SOEs) and server object interceptors (SOIs).

    Note:

    See the ArcGIS Server system requirements for the appropriate version of Microsoft .NET.

  7. Install the Java ArcGIS Web Adaptor software and deploy ArcGIS Web Adaptor twice on the same machine; one for Portal for ArcGIS and one for ArcGIS Server.

  8. Obtain the following files from My Esri:

    • An authorization file for ArcGIS Server Standard or Advanced. This file can be in either ECP or PRVC format.

    • A .json file that contains authorized user types and apps for ArcGIS Enterprise.

  9. Ensure that port 80 is enabled for HTTP communication.

  10. Create a domain certificate and enable HTTPS on your web server with the assistance of your IT administrator.

  11. Create a domain certificate and enable HTTPS on your web server with the assistance of your IT administrator. See the next section for details.

  12. Sign in to the machine as a user with administrative privileges.

  13. Close all applications on your computer.

Create a domain certificate and enable HTTPS

Successful completion of the ArcGIS Enterprise configuration wizard requires HTTPS to be enabled in IIS on the machine where the base deployment is installed.

If HTTPS is not enabled, the configuration wizard will not complete and will report the following error message:

The Web Adaptor URL https://mymachine.myexample.com/server cannot be reached. Please check that HTTPS has been enabled for your web server. For instructions on enabling HTTPS, navigate to the Help Topic: Introducing ArcGIS Enterprise > ArcGIS Enterprise Builder > Plan a base deployment.

Note:

In most cases, your IT administrator will give you certificates and bind them to HTTPS port 443.

In 2017, Chrome began only trusting certificates with a Subject Alternative Name (SAN) parameter, which cannot be configured when creating a certificate in the IIS Manager application.

If you are using IIS and need to create a domain certificate, see Create a domain certificate, which provides a script to run on your machine that will create the appropriate certificate and bind it to HTTPS port 443.

You are now ready to proceed with installation steps for the base ArcGIS Enterprise deployment.