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.

Set up 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:

If IIS is already enabled on your computer, skip to the next section.

  1. In the Start menu, type IIS and open the Internet Information Services Manager application.
  2. From the Start menu, open Control Panel. Make sure you're signed in to the computer as an administrator.
  3. Click Administrative Tools. Double-click Internet Information Services (IIS) Manager.

    Install Internet Information Services Manager

  4. If necessary, click Allow to let the program to make changes to your computer.

Create and bind a domain certificate in IIS

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.

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. Browse to the location of the downloaded setup files and double-click Builder.exe.
  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 accept the master agreement.
  4. Specify the destination folder for installing the base ArcGIS Enterprise components.
    Note:

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

    Next, you'll specify the account to be used as the owner. 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.

  5. Specify the account to be used as the owner.
  6. Specify the location where the authorization files for both Portal for ArcGIS and ArcGIS Server reside. Click Next.

    These files can be in either PRVC or ECP format.

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

  8. Click Finish.

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

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

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 (https://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 Initial Administrator Account pane, specify credentials for the initial administrator's account. Click Next.

    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 server and portal components.

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

    Additional Account Information

  7. In the Root Content Directory pane, specify a location for the content directory to store logs and configuration files.
    Note:

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

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