Installing the ArcGIS Web Adaptor

The ArcGIS Web Adaptor is provided as a setup program and is executed through a utility named Setup.exe. You'll install the ArcGIS Web Adaptor on its own using the steps below, or you can install silently using Windows Installer command line parameters.

Installation behavior and requirements

The Web Adaptor version must always match the version of its registered ArcGIS Server site.

You can have a 10.2.1 and later version of the Web Adaptor installed alongside other earlier versions of the Web Adaptor on the same machine. For example, you can have a 10.1 SP1 version and a 10.2.2 version of the Web Adaptor deployed 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.

Upgrading an earlier version of the Web Adaptor

If you want to upgrade an earlier version of the Web Adaptor to 10.2.2, you'll need to uninstall the old version and install the 10.2.2 setup. During the 10.2.2 installation, you'll specify the same name as your earlier Web Adaptor. This will guarantee your Web Adaptor URL will remain identical to the earlier version.

After installing 10.2.2, you'll need to configure the Web Adaptor with its corresponding ArcGIS Server site.


In versions earlier than 10.2.1, running the setup upgraded all existing Web Adaptor versions to the latest version.

Before installing the Web Adaptor

  1. Verify that your system meets all system requirements.
  2. Log in as a user with administrative privileges.
  3. Close all applications.
  4. Browse to the folder containing the Web Adaptor setup. You can also insert the ArcGIS for Server media into the appropriate drive to launch the setup.

You are now ready to proceed with the Web Adaptor installation.

How to install the Web Adaptor

  1. Start the Web Adaptor installation program, Setup.exe, and read the welcome screen and terms of use. Click Next when you are ready to proceed.
  2. Review the license agreement and accept if you agree. Click Next to continue with the installation.
  3. Click Change to specify the installation folder or Next to accept the default location.
  4. Click Install to begin the installation.
  5. Click Finish to close the wizard.
  6. Browse to the 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.
  7. Optionally, if you want to deploy multiple Web Adaptors on the host machine, redeploy the arcgis.war file as necessary. Keep in mind that if you're deploying 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).
  8. Connect the Web Adaptor with ArcGIS Server by completing the steps in Configuring the ArcGIS Web Adaptor. If you upgraded the Web Adaptor, you'll need to complete this step to reregister the Web Adaptor with your server.

After installation, the 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.