Install ArcGIS Enterprise

ArcGIS Enterprise Builder installs the four software components of ArcGIS Enterprise on your machine.

The first component, ArcGIS Server, makes your geographic information available to others in your organization, and optionally to anyone with an Internet connection. This is accomplished through web services, which allow a powerful server computer to receive and process requests for information sent by other devices. ArcGIS Enterprise Builder installs one instance of ArcGIS Server as the hosting server.

Portal for ArcGIS shares maps, scenes, apps, and other geographic information with other people in your organization. The front end that ArcGIS Enterprise portal users interact with is powered by the back-end infrastructure of Portal for ArcGIS. The portal administrator can customize the ArcGIS Enterprise portal to fit your organization's look and feel.

ArcGIS Data Store configures data storage for the hosting server used with your ArcGIS Enterprise portal. It provides you with a convenient setup and configuration experience. ArcGIS Enterprise Builder installs a relational data store to host feature layer data, and a tile cache data store to host caches that make your scene layers run faster.

ArcGIS Web Adaptor integrates ArcGIS Server and your ArcGIS Enterprise portal with your existing web server. It runs in your existing website and forwards requests to your machines. ArcGIS Web Adaptor facilitates web-tier authentication and security policies, and allows you to configure a single sign-on (SSO) experience for your users. ArcGIS Enterprise Builder installs one adaptor with your hosting server and one adaptor with your portal.

Obtain the builder and your authorization files

When you run the ArcGIS Enterprise Builder wizard, you'll need to provide two authorization files: one for ArcGIS Server and one for Portal for ArcGIS. You'll obtain these from the My Esri website.

  1. Review the current documentation for hardware and operating system requirements.
  2. If necessary, download your authorization files from My Esri.

Install ArcGIS Enterprise Builder

Now that you have the necessary elements for installation, you'll start the builder wizard. To open the wizard, you'll sign in to your machine as a user with administrative privileges.

Note:

Before beginning, the following prerequisites must be installed on the machine where ArcGIS Web Adaptor (IIS) will be installed:

To learn more about these required files, read prerequisites.

  1. The setup program should start automatically after the download has completed. If the setup program does not start automatically, browse to the location of the downloaded setup files and double-click Builder.exe. If your machine does not meet the system requirements, the setup program will notify you.
  2. If necessary, click Yes to let the builder make changes to your device.

    The ArcGIS Enterprise Builder window appears. This allows you to configure the necessary Microsoft Internet Information Services (IIS) components needed for ArcGIS Enterprise. IIS Components allow you to host a website from a server or computer.

  3. In the ArcGIS Enterprise Builder window, click I Agree.

    IIS requirements verification

    Installing the components may take several minutes.

    Note:

    If you did not install the prerequisite files, you'll be asked to install them. After installing the necessary files, run Builder.exe again.

    The builder wizard opens to the Welcome to the ArcGIS Enterprise Builder window.

  4. Click Next.

    Welcome to the ArcGIS Enterprise Builder window

  5. Read the master agreement and accept it. Click Next.
  6. Specify the destination folder for installing the base ArcGIS Enterprise components.

    Note:

    The location you provide must have a minimum of 30 GB of free disk space to proceed.

    The default location is C:\Program Files\ArcGIS. All components of ArcGIS Enterprise will be installed to subdirectories at this location. Portal for ArcGIS and Portal for ArcGIS Web Styles will be installed to \ArcGIS\Portal, ArcGIS Server will be installed to \ArcGIS\Server, and ArcGIS Data Store will be installed to \ArcGIS\DataStore.

    Portal for ArcGIS database services use a directory to store user-generated content, as well as the default content initially installed. The content will remain on the machine after ArcGIS Enterprise Builder has been uninstalled, enabling subsequent Portal for ArcGIS installations to use existing content. A content directory will also be created at this root location (such as C:\arcgis\arcgisportal).

    Destination Folder

    If Python 2.7.18 or Numerical Python 1.9.3 is not installed on your machine, the setup automatically installs them for you at the drive location you specified for ArcGIS Enterprise Builder. The installation location is <destination folder>\Python27.

  7. Click Next.
  8. Specify the account name and password to run ArcGIS Enterprise.

    This account will be the owner of various processes and will be used by your base deployment for functions such as accessing operating system locations. The default account name is arcgis. It can be created or changed using the following guidelines:

    • The account can be a local or domain account.
    • The specified account does not have to be part of the Administrators group.
    • If you use a local operating system account that does not already exist, it will be created for you.
    • If you enter a domain account, it must already exist on the domain and must be entered using the following format: mydomain\domainaccount.
    • Creating a local account during the installation is primarily for the convenience of quickly installing your base deployment.
    • The account will be shared across all components.
    • The password policy for this account is determined by your operating system and organization's security policy. If you receive an error message indicating that the password provided does not meet the length and complexity requirements defined for your machine, go to Local security policy. Choose Security Settings and click Account Policies > Password Policy to view the requirements.

  9. Click Next.

    Next, you'll define names for the two ArcGIS Web Adaptor that are installed as a part of the base deployment.

    The ArcGIS Enterprise setup will create an ArcGIS Web Adaptor (IIS) for your hosting server and ArcGIS Enterprise portal.

  10. Accept the default names for the ArcGIS Web Adaptor, or provide different ones. Click Next.

    Web Adaptor Configuration

    An installation of ArcGIS Enterprise Builder requires a valid authorization file (.ecp or .prvc) for ArcGIS Server Standard or Advanced and a valid license file (.json) for Portal for ArcGIS. You need to have both of these files before installing.

  11. Click Browse. Browse to and select your ArcGIS Server authorization file. Click Open.

    Software Authorization

    Note:

    See Obtain an authorization file for more information.

    After the setup completes, Portal for ArcGIS will be authorized. During the ArcGIS Enterprise Configuration Wizard, you will provide your license file (.json) to authorize Portal for ArcGIS.

  12. Click Next.
  13. Click Install.

    Install Enterprise

    The builder takes some time to run.

    While ArcGIS Enterprise Builder creates your deployment, it logs DEBUG messages to your local drives. These messages provide more details when troubleshooting any configuration failure. From the start of the deployment until the server site is created, logs are generated in the folder <Install location>\Server\usr\logs. Once the server site has been created, existing logs are moved and new logs generated in the folder <Content directory location>\arcgisserver\server\logs\server. When the deployment is successful, the logging level is set to WARNING.

    Note:

    If unexpected issues occur during the installation of the ArcGIS Enterprise Builder, log files of the installation are automatically created under C:\ProgramData\ArcGISBuilder<VersionNumber> and can be shared with Esri Technical Support.

  14. Click Finish.

    Complete the installation

    If all the components installed correctly, the configuration wizard automatically opens in your default web browser.

    Before configuring your ArcGIS Enterprise deployment in your browser, you'll ensure that your computer's web hosting environment uses HTTPS.

Create and bind a domain certificate in IIS

Internet Information Services (IIS) is a web server that can host websites, applications, and services. For the purposes of setting up a secure deployment of ArcGIS Enterprise, you'll need IIS to set up a secure HTTPS server. When using HTTPS, incoming and outgoing data communications are encrypted, which makes them safer.

Note:

The ArcGIS Enterprise Builder automatically enables the required IIS components.

For users to securely access your portal, you need to have a domain certificate on your machine that's bound to HTTPS port 443. In most cases, your IT administrator will give you certificates and bind them to HTTPS port 443. If not, you need to create and bind your own certificates. You can do this using the IIS Manager application on your Windows computer.

  1. If necessary, in the Windows Start menu, type IIS and open the Internet Information Services Manager application.
  2. If necessary, allow the program to make changes to your machine.
  3. In the Connections pane, click your server machine name. Under IIS, double-click Server Certificates.

    Internet Information Services Manager application

  4. In the Actions pane, click Create Domain Certificate.

    The Actions pane

    The Create Certificate window appears.

  5. For Common name, enter the fully qualified domain name of the machine (such as portal.domain.com) and enter other information as specific to your organization and location.

    Specify Distinguished Name Properties

  6. Click Next.
  7. In the Online Certification Authority box, click Select and choose the certificate authority within your domain that will sign the certificate and click OK.

    If the authority does not appear, consult your system administrator.

  8. Type a user-friendly name for the domain certificate and click Finish.

    Next, you'll bind your new certificate to HTTPS.

  9. In the Connections pane, click your machine name. Expand Sites. Click Default Web Site.

    The Connections pane

  10. In the Actions pane, click Bindings.

    Edit Site Bindings

    The Site Bindings window appears.

  11. In the Site Bindings window, from the Bindings list, click Port 443 and click Edit.
  12. If port 443 is not available in the list, click Add. In the Add Site Binding window, from the Type menu, choose https. Ensure the port is set to 443.

    Add Site Binding window

  13. From the SSL certificate drop-down list, choose your certificate name. Click OK and then click Close.

    Choose your certificate.

    After binding your certificate, you'll restart your website that is hosting ArcGIS Enterprise.

  14. In the Actions pane, under Manage Website, click Restart.

    Click Restart.

  15. Close the Internet Information Services (IIS) Manager window.

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

You've downloaded ArcGIS Enterprise using ArcGIS Enterprise Builder and installed the four components of ArcGIS Enterprise on your machine. Next, you'll use the configuration wizard to finish setting up your university's base deployment.


Configure a base deployment

Previously, you used ArcGIS Enterprise Builder to install the software. Next, you'll open the configuration wizard, which allows you to configure your base deployment. This wizard requires HTTPS to be enabled on your computer.

Use the configuration wizard

Now that you've installed the software with ArcGIS Enterprise Builder, you'll complete your base deployment using the wizard.

  1. If necessary, in your web browser, browse to the configuration wizard's URL (http://mymachine.mydomain.com:6080/arcgis/enterprise or https://localhost:6443/arcgis/enterprise).

    Note:

    You can also search your machine for ArcGIS Enterprise Configuration Wizard and open it using the shortcut.

    A landing page explains that the wizard needs a secure connection.

  2. Click Next.

    Welcome page

    You're redirected to secure port 6443. Your browser shows a security warning; this is expected the first time you access the secure wizard.

  3. Continue past the warning (this varies by browser). For example, in Chrome, click Advanced and click Continue to localhost.
  4. In the License File pane, click Choose File and browse to and select your portal's license .json file. Click Open.

    Click Choose File.

    This license .json file contains your portal's user type, app and app bundle license information and is obtained from My Esri.

  5. Click Next.

    License File to authorize ArcGIS Enterprise Portal

    Next, you'll configure the administrator account for your organization. This includes the username, password, and user type. This account will be used to sign in to your ArcGIS Enterprise deployment for the first time and for initial administrative tasks such as creating additional accounts. This account applies to both the ArcGIS Server and Portal components.

  6. In the Initial Administrator Account pane, specify credentials for the initial administrator's account. Select a user type from the drop-down list, which lists the user types that are compatible with the Initial Administrator account that are included in your license file.

    Initial Administrator Account

  7. Click Next.
  8. In the Additional Account Information pane, enter your account's information.

    Additional Account Information

  9. Click Next.
  10. In the Root Content Directory pane, specify a location for the content directory to store logs and configuration files. Your deployment is going to grow, so you should specify a directory location with at least 10 GB of free space to start with.
    Note:

    The default location is c:\arcgis. Additional system directories will be created outside of the root content directory you specify.

  11. Click Next.
  12. In the Configuration Summary pane, verify the initial administrator account and content directory location. Click Finish.

    Finish configuration

    Once configuration begins, the Configuration Deployment pane appears. You'll see a set of configuration steps accompanied by a progress indicator that shows a green check mark upon completion. This may take several minutes.

    Configuring Deployment progress

    Note:

    If you receive an error message indicating the ArcGIS Server site creation has failed, refer to the logs in the C:\<ArcGIS Server installation directory>\ArcGIS\Server\usr\logs folder for more details.

    If you receive an error message on the Data Stores registered with GIS Server site step, reinstall the Microsoft Web Deploy and ASP.NET Core Runtime - Windows Hosting Bundle installers. For each of them, choose the Repair option. Then, restart your website in IIS.

    When the components are fully configured, the ArcGIS Enterprise Configuration Status pane appears, indicating that all components have been successfully configured.

    Deployment finished configuring

    After completion of the configuration wizard, you have the following items:

    • An ArcGIS Enterprise portal and ArcGIS Server site configured with the same initial administrator's account.
    • An ArcGIS Server site licensed as a GIS Server. The GIS Server site is federated with the portal and is set as the Portal's hosting server.
    • Relational and tile cache data stores registered with the ArcGIS Server site.
    • A web adaptor named portal for the Portal.
    • A web adaptor named server for the ArcGIS Server site. Administrative access to the ArcGIS Server site through the web adaptor has been enabled. You can view the status of your server and its services by accessing ArcGIS Server Manager, using the URL formatted https://gisserver.domain.com:6443/arcgis/manager/.

    To configure the Portal, click the hyperlink next to Portal Website.

In this tutorial, you used ArcGIS Enterprise Builder to install and configure the four components of ArcGIS Enterprise. To start using ArcGIS Enterprise, try one of the following tutorials:

You can find more tutorials in the tutorial gallery.