Installation requirements

The version of ArcGIS Web Adaptor must always match the version of ArcGIS Server you're using.

You can have a 10.2.1 or later version of ArcGIS Web Adaptor installed alongside an earlier version of ArcGIS Web Adaptor on the same machine. For example, you can have a 10.1 SP1 version and a 10.3.1 version of ArcGIS Web Adaptor installed on the same web server.

Each Web Adaptor must have its own unique name; you cannot have two Web Adaptors with the same name on a single web server. If a naming conflict is detected during the installation, a warning message is displayed. You need to uninstall the earlier version with the same name to resolve the conflict. Alternatively, you can change the name of one Web Adaptor to proceed with the installation.

If you need to add the Cross-domain Policy File feature at any time, you can run the ADDLOCAL command on the existing installation.

Microsoft Internet Information Services (IIS) is required. For silent installations only, if IIS is not found, the ArcGIS Web Adaptor setup will not proceed. IIS and all necessary components must be installed before installing ArcGIS Web Adaptor silently.

Microsoft .NET Framework 3.5 Service Pack 1 (SP1), 4.0, or 4.5 is required. The ArcGIS Web Adaptor setup will not proceed if none of the supported .NET Framework versions are found.

After ArcGIS Web Adaptor is installed, it must be configured. For more information, see Configuring ArcGIS Web Adaptor.

Upgrade an earlier version of ArcGIS Web Adaptor

To upgrade an earlier version of ArcGIS Web Adaptor to 10.3.1, you need to uninstall the earlier version, and install the 10.3.1 setup. During the 10.3.1 installation, you'll specify the same name as your earlier Web Adaptor. This guarantees your Web Adaptor URL will remain identical to the earlier version.

If a naming conflict is detected during the 10.3.1 installation, a warning message is displayed. You need to uninstall the earlier version with the same name to perform the upgrade.

After installing 10.3.1, you need to configure ArcGIS Web Adaptor with its corresponding ArcGIS Server site.

Command line parameters for specifying the website and name for ArcGIS Web Adaptor

The following command lines are used for configuring IIS. If these command line parameters are not invoked during a silent installation, the ArcGIS Web Adaptor web application is created under the default website with the default name of arcgis.

• WEBSITE_ID=<numeric value of website>

  The WEBSITE_ID parameter is used to specify the website where the ArcGIS Web Adaptor web application will be created. The value for WEBSITE_ID is a number specific to each website on your server and assigned by IIS. The IDs for the websites on your server can be found in IIS Manager. The default website has a website ID of 1. By default, the WEBSITE_ID parameter is set to the default website (even if multiple websites exist). The parameter WEBSITE_ID is case sensitive.

  • PORT=<port number>

    Additionally, if you have a website with multiple ports, use the PORT parameter to install to the specified port of the WEBSITE_ID.

    For example, the path is <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb VDIRNAME=arcgis_external WEBSITE_ID=4059640 PORT=82.

• VDIRNAME=<name of ArcGIS Web Adaptor>

  This command line parameter is optional. By default, the VDIRNAME property is set to arcgis. If you do not invoke the VDIRNAME parameter in your command line, the Web Adaptor is created as arcgis. The VDIRNAME parameter is case sensitive. The Web Adaptor name cannot contain spaces.

  For example, the path is <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb VDIRNAME=arcgis_external WEBSITE_ID=4059640.

Other command line parameters

The cross-domain policy files feature is not installed by default. To install the feature, you must add an additional parameter to your installation command line. The following command line parameter installs the cross-domain policy files feature silently:

• ADDLOCAL=ALL

  For example, the path is <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb ADDLOCAL=ALL VDIRNAME=arcgis_external WEBSITE_ID=4059640.

  If the ADDLOCAL command line parameter is not invoked, the cross-domain policy files feature is not installed. The ADDLOCAL command line parameter is case sensitive.