Portal for ArcGIS Installation Guide - Configuring ArcGIS Web Adaptor

After you install ArcGIS Web Adaptor, you must configure it to work with Portal for ArcGIS. You'll do this from a configuration web page or from a command line utility that was installed with the Web Adaptor. As a security measure, you can only access the configuration page from the machine hosting the Web Adaptor.

When you open the configuration page, the current status of the Web Adaptor is displayed. This indicates if the Web Adaptor has been previously configured. To view the platform type and version number of the Web Adaptor, click About on the configuration page.

If you've already configured a Web Adaptor with Portal for ArcGIS and want to update your portal to use a different Web Adaptor, you'll first need to unregister the current Web Adaptor. You can only do this through the ArcGIS Portal Directory; the unregister functionality is not available from the Web Adaptor configuration page or the portal website. For full instructions, see Unregistering ArcGIS Web Adaptor with Portal for ArcGIS.

For full instructions on how to configure the Web Adaptor, follow the steps below.

Note:

Before proceeding, ensure the Web Adaptor is installed on a website running on port 80. The Web Adaptor cannot be configured with Portal for ArcGIS if it is installed on website running on a port other than 80.

Configuring the Web Adaptor from the configuration web page

To configure the Web Adaptor from the configuration web page that was installed with the software, follow the steps below.

Legacy:

In 10.2, you were required to edit a properties file on disk to configure the Web Adaptor with your portal. This is no longer required at 10.2.1 and later versions. The following instructions only apply to 10.2.1 and later versions. For help with these instructions at 10.2, see the 10.2 documentation.

Steps:

If you haven't done so already, enable SSL on port 443 of your web server. To learn more, see Enabling SSL on your web server.
Open the Web Adaptor configuration page in a web browser using an HTTPS URL such as https://webadaptor.domain.com/arcgis/webadaptor.
Select Portal for ArcGIS and click Next.
For Portal URL, type the URL to the machine hosting Portal for ArcGIS. Include the fully qualified domain name of the machine in the URL, for example, https://portal.domain.com:7443.
Supply a user name and password for an account that has administrative privileges to Portal for ArcGIS. Typically, you'll use the initial administrator account user name and password you defined when you first set up your portal. If you demoted or deleted the initial administrator account, you'll need to specify an account with administrative access to the portal website.
Click Configure. Portal for ArcGIS is restarted and will take a few minutes to complete.

After your portal restarts, the Web Adaptor is configured for use with the machine hosting Portal for ArcGIS. Now, you'll access your portal through the Web Adaptor URL, instead of port 7443. The URL is in the following format: https://webadaptor.domain.com/arcgis/home.

If you have configured your portal to use SSL for all communication, you should update the installed portal website and help shortcut URLs to use https instead of http; otherwise, you will see failures in your browser when attempting to access the original shortcut URLs.

If you'll be configuring Portal for ArcGIS with your organization's reverse proxy server, you'll need to provide some information to your portal about the proxy server. For full instructions, see Configuring a reverse proxy server with your portal.

Configuring the Web Adaptor from the command line

Legacy:

In 10.2, configuring the Web Adaptor from the command line was not supported. The following instructions only apply to 10.2.1 and later versions. For help with configuring the Web Adaptor at 10.2, see the 10.2 documentation.

You can configure the Web Adaptor using the command line utility (configurewebadaptor.sh) in <ArcGIS Web Adaptor installation directory>/webadaptor10.2.2/java/tools. This is particularly advantageous if the machine hosting the Web Adaptor does not have a graphical user interface (GUI).

The available parameters are as follows:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <URL> -u <Username> -p <Password>

Note:

In order to execute the command line utility, Java Runtime Environment (JRE) must be present on the machine hosting the Web Adaptor. If the JRE is not present on your machine, you'll experience an error when executing the utility. See the Java SE Downloads site for instructions on how to download and install the JRE on your machine.

<Mode>—The product mode in which the Web Adaptor will be configured. By default, this parameter is set to server, meaning that the Web Adaptor will be configured for use with ArcGIS Server. Since you're configuring the Web Adaptor for use with Portal for ArcGIS, specify this parameter as portal.
<WebAdaptorURL>—The URL of the Web Adaptor that you want to configure from the command line. This is the same URL that would be used if you were accessing the Web Adaptor's configuration page in a web browser. You're required to specify the HTTPS URL of the Web Adaptor, for example, https://webadaptor.domain.com/arcgis/webadaptor.
<URL>—The URL of the machine hosting Portal for ArcGIS. Include the fully qualified domain name of the machine in the URL, for example, https://portal.domain.com:7443.
<Username>—The user name of an account that has administrative privileges to Portal for ArcGIS. Typically, you'll use the initial administrator account you defined when you first set up your portal.
<Password>—The password of an account that has administrative privileges to Portal for ArcGIS. Typically, you'll use the initial administrator account you defined when you first set up your portal.

Example: $ ./configurewebadaptor.sh -m portal -w https://webadaptor.domain.com/arcgis/webadaptor -g https://portal.domain.com:7443 -u initialadmin -p secret

After executing the command, Portal for ArcGIS is restarted and will take a few minutes to complete. After your portal restarts, the Web Adaptor is configured for use with the machine hosting Portal for ArcGIS. Now, you'll access your portal through the Web Adaptor URL, instead of port 7443. The URL is in the following format: https://webadaptor.domain.com/arcgis/home.

If you'll be configuring Portal for ArcGIS with your organization's proxy server, you'll need to provide some information to your portal about the proxy server. For full instructions, see Configuring a proxy server with your portal.

12/18/2014