ArcGIS Web Adaptor can be installed silently using command line parameters as described below. Alternatively, you can install from the user interface.
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.sh tool, the Web Adaptor and Tomcat must be installed on the same machine.
Legacy:
In earlier versions, ArcGIS Web Adaptor required Microsoft .NET Framework 3.5 Service Pack 1 (SP1), 4.0, or 4.5 to be installed.
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.
Legacy:
At 10.2 and earlier versions, running the setup upgraded all existing Web Adaptors to the latest version.
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.
Install ArcGIS Web Adaptor silently
- Before beginning the installation, read the master agreement located at <CD_ROOT or untar directory>/Documentation/EULA.pdf, and accept the terms.
- Run the setup silently at the prompt. Sample syntax:
<CD_ROOT or untar directory>/Setup -m silent -l yes
Usage: Setup [Options]
Option Description -m; --mode MODE
Optional. Defaults to GUI.
MODE is either silent or gui.
-l; --license-agreement CHOICE
Required for silent mode. CHOICE is either Yes or No. Yes indicates that you have read and agreed to the Esri Master Agreement (E204, E300). See https://www.esri.com/legal/licensing-translations to read the agreement.
-d; --directory DIRECTORY
Optional. By default, ArcGIS Web Adaptor is installed to your $HOME directory. DIRECTORY specifies a different installation directory.
The path /arcgis/webadaptor10.8/ is appended to the installation directory.
The name of the installation directory should be lowercase. The samples and data installed require the data path to be lowercase.
It is recommended that you do not install ArcGIS Web Adaptor to a remote network drive. If the remote drive is not accessible at uninstallation time, the uninstallation could fail and leave files behind.
-v; --verbose
Installer runs in verbose mode.
-h; --help
Displays command line help and exits.
-e; --examples
Displays usage examples of these options and exits.
- Browse to the ArcGIS Web Adaptor installation folder. Deploy the arcgis.war file to your Java application server. For instructions on how to deploy a .war file, refer to the documentation for your Java application server.
- Connect ArcGIS Web Adaptor to Portal for ArcGIS by completing the steps in the configuration topic for Configuring ArcGIS Web Adaptor.
After installation, ArcGIS Web Adaptor will display in the language specified by your Java application server. To change the language, consult the product documentation for your Java application server.