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.

  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 Allow to let the builder make changes to your computer.

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

    Welcome to the ArcGIS Enterprise Builder window

  3. Click Next and read the master agreement and accept it.
  4. 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.

  5. Next, you'll specify the account name and password to run yourArcGIS 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.

  6. Click Next.
  7. The Enterprise Builder setup will create an ArcGIS Web Adaptor (IIS) for your hosting server and ArcGIS Enterprise portal. Accept the default names for these ArcGIS Web Adaptor, or provide different ones. Click Next.

    Web Adaptor Configuration

  8. Authorize the software for use. 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.

    Software Authorization

    Provide the location of your ArcGIS Server authorization file that you received from Customer Service. This can be an .ecp or .prvc file. See Obtain an authorization file for more information. Portal for ArcGIS will be authorized after the setup completes. During the ArcGIS Enterprise Configuration Wizard, you will provide your license file (.json) to authorize Portal for ArcGIS. Click Next.

  9. 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.

  10. Click Finish.

    If all the components installed correctly, the configuration wizard automatically opens.

  11. If necessary, click Default Browser to open the wizard online.

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 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 tree view of the Connections pane, click your server machine name. Double-click the Server Certificates button in the central pane.

    Internet Information Services Manager application

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

    The Distinguished Name Properties window opens.

  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.

    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 and expand Sites. Click Default Web Site.
  10. In the Actions pane, click Bindings.

    Edit Site Bindings

  11. In the Bindings list, click Port 443 and click Edit.
  12. If Port 443 is not available in the list, click Add. From the Type menu, choose https and ensure the port is set to 443.
  13. From the certificate drop-down list, choose your certificate name. Click OK and then click Close.

    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, 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 past warning.
  4. If necessary, on the landing page, click Next.
  5. In the License File panel, navigate to your portal's license file (.json). This file contains your portal's user type, app and app bundle license information and is obtained from My Esri. Click Next.

    License File to authorize ArcGIS Enterprise Portal

  6. In the Initial Administrator Account pane, specify credentials for the initial administrator's account. Select a user type from the dropdown list, which lists the user types that are compatible with the Initial Administrator account that are included in your license file. This account will be used to sign in to your ArcGIS Enterprisedeployment for the first time and for initial administrative tasks such as creating additional accounts. This account applies to both the server and portal components. Click Next.

    Initial Administrator Account

  7. In the Additional Account Information pane, enter your information and click Next.

    Additional Account Information

  8. 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.

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

    Finish configuration

    Once configuration begins, you'll see a set of configuration steps accompanied by a progress indicator that shows a green check mark upon completion. 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.

    When the components are fully configured, the ArcGIS Enterprise Configuration Status pane opens, 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/.

In these lessons, 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 lessons:

You can find more lessons in the Learn ArcGIS Lesson Gallery.