Configuring the Web Adaptor after installation

After you install the 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 the Web Adaptor.

As a security measure, you can only access the configuration page and command line utility from the machine hosting the Web Adaptor. For full instructions on how to configure the Web Adaptor, see one of the sections below.

Configuring the Web Adaptor from the configuration web page

To configure the Web Adaptor from the configuration web page that was installed with the software, follow the steps below.

Steps:

1. Open a web browser to the address http://<hostname>:<port (if not port 80)>/<Web Adaptor name>/webadaptor, for example, http://wahost/arcgis/webadaptor.
2. For GIS Server URL, type the URL to one of the GIS servers in your ArcGIS Server site. This URL will be used to discover all of the machines participating in your site and register them with the Web Adaptor. For example, the URL will take the form http://<GIS server>:6080.
3. 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.
4. Choose whether users can administer the site through the Web Adaptor. By default, administration of the site through the Web Adaptor is disabled. Here 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 the Web Adaptor. Also, ArcGIS for 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 for Desktop to ArcGIS Server whether this option is enabled or disabled.
   • When administrative access through the Web Adaptor is disabled, you can access Manager, the Administrator Directory, and connect to the server in ArcGIS for Desktop by using a direct URL to one of the GIS servers in your site. For example:
     • To access Manager, use the URL format http://<GIS server>:6080/arcgis/manager.
     • To access the Administrator Directory, use the URL format http://<GIS server>:6080/arcgis/admin.
     • To create a server connection in ArcGIS for Desktop, use the URL format http://<GIS server>:6080/arcgis.
5. Click Configure to apply your settings to the Web Adaptor.

When the configuration is successful, you will see a list of GIS server machines recognized by the 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 the Web Adaptor's settings.

Configuring the Web Adaptor from the command line

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

The available parameters are as follows:

ConfigureWebAdaptor.sh -w <WebAdaptorURL> -g <GISServerURL> -u <Username> -p <Password> -a <AdminAccessEnabled>

• <WebAdaptorURL>–The URL of the 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 Web Adaptor's configuration page in a web browser. If the Web Adaptor was installed on a port other than the default of 80, you'll need to specify the port in the URL.

• <GISServerURL>–The URL to one of the GIS server 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 the 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 the Web Adaptor. As a security measure, this parameter is set to false by default. To enable administrative access, set this parameter to true.

Example: ConfigureWebAdaptor.sh -w http://webserver:7001/arcgis/webadaptor -g http://GISserver:6080 -u siteadmin -p secret -a false

Note:

In order to execute the command line utility, the Java Runtime Environment (JRE) must be present on the machine hosting the 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 configuring the Web Adaptor

Now that your Web Adaptor has been configured for use, there are a few important items you should consider below:

Adding or removing GIS servers

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

Legacy:

Prior to ArcGIS 10.1 Web Adaptor Service Pack 1, it took, by default, 60 minutes for the Web Adaptor to recognize GIS server machines that have been added or removed from the site.

Installing multiple Web Adaptors

You can provide different web entry points into your ArcGIS Server site by installing multiple Web Adaptors. You may be motivated 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 web site (port), they need to use different names. For example, two Web Adaptors named arcgis cannot exist on the same web site. If you want multiple Web Adaptors with the same name, you'll need to install them on separate web sites (ports).

For full instructions on how to install multiple Web Adaptors, see Installing the ArcGIS Web Adaptor (Java Platform) on Linux.

Enabling SSL on ArcGIS Server

By default, ArcGIS Server uses HTTP protocol for all communication. If you update ArcGIS Server's communication protocol to HTTP/HTTPS or HTTPS-only, you'll need to reconfigure the Web Adaptor with your server. This will update the Web Adaptor's configuration to reflect the changes you made to the server's communication protocol. Follow the steps above to reconfigure the Web Adaptor with ArcGIS Server.

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