Skip To Content

ArcGIS Enterprise Builder configuration after installation

Once ArcGIS Enterprise Builder completes the installation of the software, a browser opens and presents the ArcGIS Enterprise configuration wizard. You can use the configuration wizard to deploy ArcGIS Enterprise, or close the browser and use the configurebasedeployment command line utility to complete your base deployment.

If you have not yet installed the software using the ArcGIS Enterprise Builder, see Installing with ArcGIS Enterprise Builder for detailed steps before proceeding.

Note:

ArcGIS Enterprise configurations require HTTPS to be enabled on the machine where the base deployment is installed. Prior to completing configuration steps, you must create a domain certificate and enable HTTPS.

Use the configuration wizard

Once you've installed the software with ArcGIS Enterprise Builder, perform the following steps with the configuration wizard to complete your base deployment:

  1. If it's not already open, browse to the configuration wizard's URL (http://mymachine.mydomain.com:6080/arcgis/enterprise). You can also search your machine for the ArcGIS Enterprise Configuration Wizard and launch it using the shortcut.
  2. A landing page will explain that the wizard needs to use a secure connection. Click Next, and you are redirected to secure port 6443. Your browser will show a security warning; this is expected the first time you access the secure wizard. Continue past the warning (this varies by browser).
  3. In the License File panel, navigate to your portal's license file (.json). This file contains your portal's user type and app license information and is obtained from My Esri. Click Next.

  4. In the Initial Administrator Account panel, 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 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. Click Next.
  5. In the Additional Account Information panel, enter additional initial administrator account information, and click Next.
  6. In the Root Content Directory panel, 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. The default location is /home/linux/arcgis.

    Note:

    Additional system directories will be created outside of the Root Content Directory you specify.

  7. In the Web Adaptor URLs panel, enter the URLs for the Web Adaptors (https://webadaptorhost.domain.com/webadaptorname) that will be configured with the portal and server components of your deployment. These Web Adaptors must already be installed and located on the same machine where you ran the ArcGIS Enterprise Builder so they can be referenced in the configuration steps after installation. For complete instructions on installing your Web Adaptor, please see your Web Adaptor installation guide that comes with your Web Adaptor. A brief summary of the steps to install the Web Adaptor is provided below as a convenience.
    1. Run the Web Adaptor Setup
    2. Deploy the arcgis.war file from the newly installed Web Adaptor installation location into your java web application server. You must deploy one WAR file for ArcGIS Server, and one for Portal for ArcGIS. For example, if using Tomcat, you would place your WAR files into the ./webapps folder as server.war and portal.war.

      The name of the WAR file copied into the webapps folder will be the name of the webapp and the corresponding URL path it is accessible from. For example server.war will have a path of ,https://webadaptorhost.domain.com/server. The portal.war file will be accessible as https://webadaptorhost.domain.com/portalConsult your Java Application server for your server's specific deployment details.

  8. In the Configuration Summary panel, verify the initial administrator account, user type, content directory location, and Web Adaptor URLs. Click Finish.

Once configuration begins, you will see a set of configuration steps accompanied by a progress indicator that shows a green check mark upon completion.

Note:

During Step 3 of the configuration wizard to Create the GIS Server site, if you receive an error message indicating the ArcGIS Server site creation has failed, refer to the logs in the /home/linux/arcgis/server/usr folder for more details.

When the components are fully configured, you will see an ArcGIS Enterprise Configuration Status panel indicating that all components have been successfully configured.

Use the command line utility

Once you've installed the software with ArcGIS Enterprise Builder, complete the configuration of your base deployment using the command line utility. In order to run the command line utility, you must choose to run it as administrator.

When using the utility to configure your ArcGIS Enterprise portal site, you have the option to specify parameters and values in two distinct ways:

  • Specifying parameters directly within the command line: <location of utility>\configurebasedeployment -fn <first name> -ln <last name> -u <user name> -p <password> -e <email> -qi <question> -qa <answer> -ws <server web adaptor> -wp <portal web adaptor> -d <directory> -lf <license file> -ut <user type ID>

  • Specifying parameters from a properties file: <location of utility>\configurebasedeployment -f <properties file>
The configurebasedeployment command line utility is located in <ArcGIS Server installation directory>/tools/configurebasedeployment. By default, that location is /home/linux/arcgis/server/tools/configurebasedeployment.

The following describes the parameters used in the command line utility:

  • -fn —Your first name.
  • -ln —Your last name.
  • -u —The user name of your account with administrative rights to the ArcGIS Enterprise portal. Normally, you will use the primary site administrator account for creating the site.
  • -p —The password of the account you specified for the user name parameter. Normally, you will use the primary site administrator account to create the portal.
  • -e —This is the email for your account with administrative privileges to the ArcGIS Enterprise portal.
  • -qi —This specifies the index number for the question you want to use. This question is used to retrieve a forgotten password. Each question is paired with an index number. For example, the list below specifies the index number followed by its respective question:
    • 1 - What city were you born in?
    • 2 - What was your high school mascot?
    • 3 - What is your mother's maiden name?
    • 4 - What was the make of your first car?
    • 5 - What high school did you go to?
    • 6 - What is the last name of your best friend?
    • 7 - What is the middle name of your youngest sibling?
    • 8 - What is the name of the street on which you grew up?
    • 9 - What is the name of your favorite fictional character?
    • 10 - What is the name of your favorite pet?
    • 11 - What is the name of your favorite restaurant?
    • 12 - What is the title of your favorite book?
    • 13 - What is your dream job?
    • 14 - Where did you go on your first date?

  • -qa —This is the answer to the secret question that you chose for the parameter qi.
  • -ws —This is your Web Adaptor URL to configure with the Server.
    • Example: https://webadaptorhost.domain.com/<webadaptorname>
  • -wp —This is your Web Adaptor URL to configure with the Portal.
    • Example: https://webadaptorhost.domain.com/<webadaptorname>
  • -d —This is the absolute path and the name of your Content Directory for storing data and configuration files.
  • -lf —The path to the portal license file.
  • -ut —The user type ID for the Initial Administrator. This parameter is optional. To generate a list of compatible user types available to your organization for the -ut parameter, run the listadministratorusertypes utility. If a user type ID is not specified, and the portal license file contains a single compatible user type, that user type will be assigned. If the license file contains multiple compatible user types, a temporary user type will be assigned, and the Initial Administrator will have to select a user type after logging in.
  • -f —The properties file for the configurebasedeployment utility.
    Note:

    By default, the configurebasedeployment.propertiesfile can be found at /home/linux/arcgis/server/tools/configurebasedeployment

  • -h—Display this tool help message and exit.

Example using parameters

  1. Open a command prompt.
  2. In the command prompt, change the working directory to the location of the configurebasedeployment utility.

    For example: <ArcGIS Server installation directory>\tools\configurebasedeployment.

  3. Type the configurebasedeployment command, parameters and their values directly within the command prompt.
configurebasedeployment -fn jane -ln smith -u jsmith -p mIpassword -e jsmith@myemail.com -qi 1 -qa Redlands -ws https://jsmith.myemail.com/server -wp https://jsmith.myemail.com/portal -d home/linux/arcgis/usr -lf home/linux/arcgis/usr -ut

Example using a file

Rather than typing parameters and values at the command prompt, you can alter the contents of the configurebasedeployment.properties file and specify the file when you run the configurebasedeployment utility.

  1. Navigate to the location of the configurebasedeployment.properties file. By default, the configurebasedeployment.properties file is installed at /home/linux/arcgis/server/tools/configurebasedeployment.
  2. Open the configurebasedeployment.properties file in a text editor and provide values for each parameter:

    Deployment properties to configure a base deployment

    
    # First name for initial administrator account
    WEBGIS_ADMIN_FIRSTNAME = 
    # Last name for initial administrator account
    WEBGIS_ADMIN_LASTNAME =
    # User name for initial administrator account
    # Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
    WEBGIS_ADMIN_USERNAME = 
    # Password for primary site administrator
    # Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
    WEBGIS_ADMIN_PASSWORD = 
    # Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
    # When you run the tool the first time, the password will be
    # encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true.
    WEBGIS_ADMIN_PASSWORD_ENCRYPTED = false
    # E-mail address for initial administrator account
    # e.g username@domain.com
    WEBGIS_ADMIN_EMAIL =
    # This is the index of the secret questions to retrieve a forgotten password. 
    # The list of questions with their respective index numbers is as follows:
    # 1, What city were you born in?
    # 2, What was your high school mascot?
    # 3, What is your mother's maiden name?
    # 4, What was the make of your first car?
    # 5, What high school did you go to?
    # 6, What is the last name of your best friend?
    # 7, What is the middle name of your youngest sibling?
    # 8, What is the name of the street on which you grew up?
    # 9, What is the name of your favorite fictional character?
    # 10, What is the name of your favorite pet?
    # 11, What is the name of your favorite restaurant?
    # 12, What is the title of your favorite book?
    # 13, What is your dream job?
    # 14, Where did you go on your first date?
    WEBGIS_ADMIN_SECURITY_QUESTION_INDEX = 
    # Answer to the secret question
    # e.g \"My Answer\"
    WEBGIS_ADMIN_SECURITY_QUESTION_ANSWER = 
    # AcGIS Enterprise content directory for storing data and configuration files.
    # By default, the content directory will be created locally.
    # e.g./<ArcGIS Enterprise Builder installation directory>/usr
    WEBGIS_CONTENT_DIRECTORY =
    # Specify the Portal Web Adaptor URL on Linux only.
    # Example: https://webadaptorhost.domain.com/<webadaptorname>
    WEBGIS_PORTAL_WEBADAPTOR_URL =
    # Specify the Server Web Adaptor URL on Linux only.
    # Example: https://webadaptorhost.domain.com/<webadaptorname>
    WEBGIS_SERVER_WEBADAPTOR_URL = 
    # The path to the Portal license file
    PORTAL_LICENSE_FILE =
    # The id of the user type for the Initial Administrator
    PORTAL_USER_TYPE_ID =

  3. Save the configurebasedeployment.properties file.
  4. Open a command prompt.
  5. In the command prompt, change the working directory to the location of the configurebasedeployment utility.

    For example: /home/linux/arcgis/server/tools/configurebasedeployment.

  6. Type the configurebasedeployment command and specify the configurebasedeployment.properties file.

    configurebasedeployment -f configurebasedeployment.properties

Note:

Some parameters take multiple word answers such as -fn, -ln, or –qa. In such cases, put parameters in quotes.

For password value, avoid using any special characters, such as “&”, “\” and so on, which can have special meaning to the command prompt.

When the components are fully configured, you will see a message that the ArcGIS Enterprise Builder Site has been successfully created.

Using the listadministratorusertypes command line utility to identify compatible user types

To identify a list of user type IDs licensed for your organization that are compatible with the Administrator role, run the listadministratorusertypes command line utility, located in the same location as the configurebasedeployment utility. This will provide a list of inputs for the -ut parameter in the configurebasedeployment tool. Run the listadministratorusertypes tool using -la with the portal license file as the input.

Configured components

After completion of the ArcGIS Enterprise configuration wizard, you have the following:

  • A portal and ArcGIS Server site configured with the same initial administrator's account
  • An ArcGIS Server site licensed as a GIS Server
  • Relational and tile cache data stores registered with the ArcGIS Server site
Note:

The builder will install two Web Adaptors with default names of portal and server. During installation, if you chose to specify alternate Web Adaptor names, they will be used instead for the configured components.

The GIS Server site is federated with the portal and the GIS Server site is set as the portal's hosting server.

Example portal and Server Manager URLs post configuration

Using the links provided in the configuration summary, you can begin to customize your portal, add members and content, and configure security. Additionally, use Server Manager to manage published services. To access ArcGIS Server Manager after the builder is complete, use the full URL, which is formatted https://gisserver.domain.com:6443/arcgis/manager/.

Tip:

Esri recommends using the serverScan.py and portalScan.py scripts to check for security best practices with your new ArcGIS Server and ArcGIS Enterprise portal.