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 requirements

The Web Adaptor's version must always match the version of Portal for ArcGIS.

You can have a 10.2.1 and later version of the Web Adaptor installed alongside one other earlier version 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 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 will display. You will need to uninstall the earlier version with the same name in order to resolve the conflict. Alternatively, you can change the name of the 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 Modify option on the existing installation.

Upgrading a previous version of the Web Adaptor

If you want to upgrade a previous version of the Web Adaptor to 10.2.2, you'll need to uninstall the earlier 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.

If a naming conflict is detected during the 10.2.2 installation, a warning message will display. You will need to uninstall the earlier version with the same name in order to perform the upgrade.

After installing 10.2.2, you'll need to configure the Web Adaptor with Portal for ArcGIS.

Legacy:

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

Before installing the Web Adaptor

Steps:

1. Verify that your system meets all system requirements. You can only configure one Web Adaptor with Portal for ArcGIS.
2. Log in as a user with administrative privileges.
3. Verify that you have a website running on port 80 and SSL is enabled on port 443. This is to accommodate the variety of encrypted and unencrypted calls made to Portal for ArcGIS. The Web Adaptor cannot be configured with Portal for ArcGIS if it is installed on a website running on ports other than 80 and 443. For instructions on how to create a website, consult the IIS product documentation. For more information about setting up and using SSL, see Enabling SSL on your web server.
4. Close all applications.
5. Browse to the downloaded folder containing the Web Adaptor setup. You can also insert the Portal for ArcGIS media into the appropriate drive to automatically launch the setup.

You are now ready to proceed with the installation.

Note:

Attempting to configure the Web Adaptor so the URL includes additional levels is not supported and may cause problems with client applications.

How to install the Web Adaptor

Steps:

1. The Web Adaptor setup program should launch automatically after the download has been completed. If the setup does not launch automatically, browse to the location of the downloaded setup files and double-click Setup.exe.
2. Review the terms and conditions of the license agreement. You must agree to the terms in order to proceed.
3. Review the features on the Select Features dialog box. Optionally, if you want to install the Cross-domain Policy Files, click the drop-down menu next to the feature and select This feature will be installed on the local hard drive. To learn more about this feature, see About cross-domain policy files. Click Next.
4. Choose a website running on port 80 for the Web Adaptor. Available websites are listed as <website name (port)>. If you don't see the Select website dialog box, this means you only have one website. If only one website is found on your machine, the Web Adaptor is automatically placed on that website without displaying the Select website dialog box.
5. Enter the name of the Web Adaptor. The default value is arcgis.
   Note:

   A message will display if a virtual directory with the same name as the Web Adaptor already exists in the selected website. Click OK to close the message and enter a different name for the Web Adaptor.

6. To complete the installation, follow the directions on the screen.

The Web Adaptor configuration page is launched after the installation has completed. You are now ready to Configure the Web Adaptor for use with your portal.