Installation requirements

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

ArcGIS Web Adaptor can be installed side by side with other versions. You are not required to uninstall ArcGIS Web Adaptor to install ArcGIS Web Adaptor, and ArcGIS Web Adaptor is not an upgrade of previous releases.

Each ArcGIS 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 must uninstall the earlier version with the same name to resolve the conflict. Alternatively, you can change the name of one of the Web Adaptors to proceed with the installation.

ArcGIS Web Adaptor and Tomcat do not need to be installed on the same machine if you will configure the Web Adaptor with the portal through your browser. However, if you will configure the Web Adaptor using the configurewebadaptor.exe tool, the Web Adaptor and Tomcat must be installed on the same machine.

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.8, you must uninstall the earlier version, and install the 10.8 setup. During the 10.8 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.8 installation, a warning message is displayed. You must uninstall the earlier version with the same name to perform the upgrade.

After installing 10.8, you must configure ArcGIS Web Adaptor with Portal for ArcGIS.

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.

• CONFIGUREIIS=TRUE

  This optional parameter will allow the setup program to silently configure and install all missing Microsoft IIS components required by ArcGIS Web Adaptor.

Installing ArcGIS Web Adaptor silently

The following are the Windows Installer command line parameters to be used when installing ArcGIS Web Adaptor silently:

• INSTALLDIR=<installation location>

  This property allows you to specify the installation location of ArcGIS Web Adaptor from the command line. If you do not set this property, the default installation location of C:\Program Files\ArcGIS\WebAdaptor10.8\java\ is used.

  For example:

  <path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe INSTALLDIR="C:\NewInstallDir" /qb

• Use the following command to install ArcGIS Web Adaptor silently without specifying the installation location:

  <path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe /qb

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