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.

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. Click Next in the initial panel of the configuration wizard.
  4. In the Initial Administrator Account panel, specify credentials for the initial administrator's account. 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. 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.
  8. In the Configuration Summary panel, verify the initial administrator account, 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>

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

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:

    WEBGIS_ADMIN_FIRSTNAME =
    WEBGIS_ADMIN_LASTNAME =
    WEBGIS_ADMIN_USERNAME =
    WEBGIS_ADMIN_PASSWORD =
    WEBGIS_ADMIN_PASSWORD_ENCRYPTED = false
    WEBGIS_ADMIN_EMAIL =
    # This is the index of the secret question 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 =
    WEBGIS_ADMIN_SECURITY_QUESTION_ANSWER =
    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 =

  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.

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

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.