Skip To Content

Configure ArcGIS Web Adaptor after installation

After you install ArcGIS Web Adaptor, you must configure it to work with an ArcGIS Server site. You'll do this from a configuration web page or from a command line utility that was installed with ArcGIS Web Adaptor. As a security measure, you can only access the configuration page and command line utility from the machine hosting ArcGIS Web Adaptor.

When you open the configuration page, the current status of ArcGIS Web Adaptor is displayed. This indicates if ArcGIS Web Adaptor has been previously configured. To view the platform type and version number of ArcGIS Web Adaptor, click About on the configuration page.

For full instructions on how to configure ArcGIS Web Adaptor, see one of the sections below.

Configure ArcGIS Web Adaptor from the configuration web page

To configure ArcGIS Web Adaptor from the configuration web page that was installed with the software, complete the following steps:

  1. Open ArcGIS Web Adaptor configuration page in a web browser.

    The URL is in the following format: http://webadaptorhost.domain.com/webadaptorname/webadaptor, where webadaptor at the end is a constant.

  2. Choose ArcGIS Server and click Next.
  3. For ArcGIS Server URL, type the URL to one of the machines in your ArcGIS Server site. This URL will be used to discover all of the machines participating in your site and register them with ArcGIS Web Adaptor. For example, the URL should take the form http://gisserver.domain.com:6080.
  4. Supply a user name and password for an account that has administrative privileges to the ArcGIS Server site. Typically, you'll use the primary site administrator account user name and password you defined when you created the site. If you disabled the primary site administrator account, you'll need to specify an account with administrative access to the site.
  5. Choose whether users can administer the site through ArcGIS Web Adaptor. By default, administration of the site through ArcGIS Web Adaptor is enabled. The following are some considerations for this option:
    • When administration is disabled, external users are blocked from accessing ArcGIS Server Manager and the ArcGIS Server Administrator Directory through ArcGIS Web Adaptor. Also, ArcGIS Desktop users are blocked from establishing administrative or publisher connections to ArcGIS Server. Keep in mind that you can still make user connections from ArcGIS Desktop to ArcGIS Server whether this option is enabled or disabled.
    • When administrative access through ArcGIS Web Adaptor is disabled, you can access Manager, the Administrator Directory, and connect to the server in ArcGIS Desktop by using a direct URL to one of the ArcGIS Servers in your site:
      • To access Manager, use the URL format http://gisserver.domain.com:6080/arcgis/manager.
      • To access the Administrator Directory, use the URL format http://gisserver.domain.com:6080/arcgis/admin.
      • To create a server connection in ArcGIS Desktop, use the URL format http://gisserver.domain.com:6080/arcgis.
    • If ArcGIS Server is configured with web-tier authentication, you must keep administration enabled through ArcGIS Web Adaptor. This allows users in your enterprise identity store with publisher and administrator privileges to publish services from ArcGIS Desktop. When the users in these roles connect to the server in ArcGIS Desktop, they must specify the ArcGIS Web Adaptor URL.
  6. Click Configure to apply your settings to ArcGIS Web Adaptor.

When the configuration is successful, you will see a list of machines recognized by ArcGIS Web Adaptor at the bottom of the configuration page (highlighted in green). You can return to this page at any time to see the list of recognized machines and adjust ArcGIS Web Adaptor settings.

Configure ArcGIS Web Adaptor (IIS) from the command line

You can configure ArcGIS Web Adaptor (IIS) using the command line utility (ConfigureWebAdaptor.exe) in C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptor\IIS\Tools.

The available parameters are as follows:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <URL> /u <Username> /p <Password> /a <AdminAccessEnabled>

  • <Mode>—The product mode in which ArcGIS Web Adaptor will be configured. By default, this parameter is set to server, meaning that ArcGIS Web Adaptor will be configured for use with ArcGIS Server. If you were configuring ArcGIS Web Adaptor for use with Portal for ArcGIS, you would specify this parameter as portal.

  • <WebAdaptorURL>—The URL of ArcGIS Web Adaptor that you want to configure from the command line. This is the same URL that would be used if you were accessing the configuration page in a web browser. If ArcGIS Web Adaptor was installed on a port other than the default of 80, you'll need to specify the port in the URL.

  • <URL>—The URL to one of the machines in your ArcGIS Server site. This URL will be used to discover all of the machines participating in your site and register them with ArcGIS Web Adaptor.

  • <Username>—The user name of an account that has administrative privileges to the ArcGIS Server site. Typically, you'll use the primary site administrator account you defined when you created the site.

  • <Password>—The password of an account that has administrative privileges to the ArcGIS Server site. Typically, you'll use the primary site administrator account you defined when you created the site.

  • <AdminAccessEnabled>—Indicates if ArcGIS Server Manager and the ArcGIS Server Administrator Directory will be available through ArcGIS Web Adaptor. This parameter is set to true by default. To disable administrative access, set this parameter to false.

Example: ConfigureWebAdaptor.exe /m server /w http://webadaptorhost.domain.com/webadaptorname/webadaptor /g http://gisserver.domain.com:6080 /u siteadmin /p secret /a true

Legacy:

At version 10.2 and earlier, you were required to append /server to the end of the URL parameter, for example, /w http://webadaptorhost.domain.com/webadaptorname/webadaptor/server. At 10.2.1 and later versions, this is no longer required.

Configure ArcGIS Web Adaptor (Java Platform) from the command line

You can configure the ArcGIS Web Adaptor (Java Platform) using the command line utility (ConfigureWebAdaptor.bat) in <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor10.6\java\tools.

The available parameters are as follows:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <URL> -u <Username> -p <Password> -a <AdminAccessEnabled>

  • <Mode>—The product mode in which ArcGIS Web Adaptor will be configured. By default, this parameter is set to server, meaning that ArcGIS Web Adaptor will be configured for use with ArcGIS Server. If you were configuring ArcGIS Web Adaptor for use with Portal for ArcGIS, you would specify this parameter as portal.

  • <WebAdaptorURL>—The URL of ArcGIS Web Adaptor that you want to configure from the command line. This is the same URL that would be used if you were accessing the configuration page in a web browser. If ArcGIS Web Adaptor was installed on a port other than the default of 80, you'll need to specify the port in the URL.

  • <URL>—The URL to one of the machines in your ArcGIS Server site. This URL will be used to discover all of the machines participating in your site and register them with ArcGIS Web Adaptor.

  • <Username>—The user name of an account that has administrative privileges to the ArcGIS Server site. Typically, you'll use the primary site administrator account you defined when you created the site.

  • <Password>—The password of an account that has administrative privileges to the ArcGIS Server site. Typically, you'll use the primary site administrator account you defined when you created the site.

  • <AdminAccessEnabled>—Indicates if ArcGIS Server Manager and the ArcGIS Server Administrator Directory will be available through ArcGIS Web Adaptor. This parameter is set to true by default. To disable administrative access, set this parameter to false.

Example: ConfigureWebAdaptor.bat -m server -w http://webadaptorhost.domain.com/webadaptorname/webadaptor -g http://gisserver.domain.com:6080 -u siteadmin -p secret -a true

Legacy:

At version 10.2 and earlier, you were required to append /server to the end of the URL parameter, for example, -w http://webadaptorhost.domain.com/webadaptorname/webadaptor/server. At 10.2.1 and later versions, this is no longer required.

Configure ArcGIS Web Adaptor (Java Platform) on Linux from the command line

You can configure ArcGIS Web Adaptor using the command line utility (configurewebadaptor.sh) in <ArcGIS Web Adaptor installation directory>/webadaptor10.6/java/tools. This is particularly advantageous if the machine hosting ArcGIS Web Adaptor does not have a graphical user interface (GUI).

The available parameters are as follows:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <URL> -u <Username> -p <Password> -a <AdminAccessEnabled>

  • <Mode>—The product mode in which ArcGIS Web Adaptor will be configured. By default, this parameter is set to server, meaning that ArcGIS Web Adaptor will be configured for use with ArcGIS Server. If you were configuring ArcGIS Web Adaptor for use with Portal for ArcGIS, you would specify this parameter as portal.

  • <WebAdaptorURL>—The URL of ArcGIS Web Adaptor that you want to configure from the command line. This is the same URL that would be used if you were accessing the configuration page in a web browser. If ArcGIS Web Adaptor was installed on a port other than the default of 80, you'll need to specify the port in the URL.

  • <URL>—The URL to one of the machines in your ArcGIS Server site. This URL will be used to discover all of the machines participating in your site and register them with ArcGIS Web Adaptor.

  • <Username>—The user name of an account that has administrative privileges to the ArcGIS Server site. Typically, you'll use the primary site administrator account you defined when you created the site.

  • <Password>—The password of an account that has administrative privileges to the ArcGIS Server site. Typically, you'll use the primary site administrator account you defined when you created the site.

  • <AdminAccessEnabled>—Indicates if ArcGIS Server Manager and the ArcGIS Server Administrator Directory will be available through ArcGIS Web Adaptor. This parameter is set to true by default. To disable administrative access, set this parameter to false.

Example: $ ./configurewebadaptor.sh -m server -w http://webadaptorhost.domain.com/webadaptorname/webadaptor -g http://gisserver.domain.com:6080 -u siteadmin -p secret -a true

Legacy:

At version 10.2 and earlier, you were required to append /server to the end of the URL parameter, for example, -w http://webadaptorhost.domain.com/webadaptorname/webadaptor/server. At 10.2.1 and later versions, this is no longer required.

Caution:

To execute the command line utility, the Java Runtime Environment (JRE) must be present on the machine hosting ArcGIS Web Adaptor. If the JRE is not present on your machine, you'll experience an error when executing the utility. See the Java SE Downloads site for instructions on how to download and install the JRE on your machine.

After you configure ArcGIS Web Adaptor

Now that your Web Adaptor has been configured for use, consider the following:

Add or remove ArcGIS Server machines

If you add or remove ArcGIS Server machines from your site, it takes ArcGIS Web Adaptor one minute to recognize the changes to your site. If you want ArcGIS Web Adaptor to immediately recognize the added or removed machines, you can reconfigure it by following the instructions above.

Install multiple ArcGIS Web Adaptors

You can provide different web entry points into your ArcGIS Server site by installing multiple Web Adaptors. You may want to do this to make your site more highly available to clients, provide support for legacy applications, or allow publishing and administrative access to specific users in a highly secure environment. For more information, see Deployment scenarios.

Multiple Web Adaptors can be installed on the same machine at the same time, or the installation can be spread across separate machines. If you want to install multiple Web Adaptors on the same website (port), they need to use different names. For example, two Web Adaptors named arcgis cannot exist on the same website. If you want multiple Web Adaptors with the same name, you'll need to install them on separate websites (ports).

For full instructions on how to install multiple Web Adaptors, see the following topics:

Enable HTTPS on ArcGIS Server

By default, ArcGIS Server uses HTTP and HTTPS protocol for all communication. If you update ArcGIS Server's communication protocol to HTTP or HTTPS only, it takes ArcGIS Web Adaptor one minute to recognize the changes to your site.

Legacy:

At version 10.2.1 and earlier, you were required to reconfigure ArcGIS Web Adaptor after updating the communication protocol of ArcGIS Server. At 10.2.2 and later versions, this is no longer necessary.

To learn more about ArcGIS Server's communication protocol, see Securing ArcGIS Server communication.