1. Introduction

  2.  Welcome to the ArcGIS Web Adaptor (Java Platform) on Linux installation guide
  3.  Getting started with ArcGIS Web Adaptor
  4. Install and configure ArcGIS Web Adaptor with ArcGIS Server

  5.  About the ArcGIS Web Adaptor
  6.  An overview of implementing ArcGIS Web Adaptor with ArcGIS Server
    1. Step 1: Plan your ArcGIS Server site configuration

    2.  Inside an ArcGIS Server site
    3.  Deployment scenarios
      1. Single machine site configurations

      2.  Single-machine deployment
      3.  Single-machine deployment with reverse proxy server
      4.  Single-machine high-availability (active-passive) deployment
      5.  Single-machine high-availability (active-active) deployment
      1. Multiple machine site configurations

      2.  Multiple-machine deployment with ArcGIS Web Adaptor
      3.  Multiple-machine deployment with third party load balancer
    1. Step 2: Install ArcGIS Web Adaptor

    2.  Installing ArcGIS Web Adaptor
    3.  Silently installing ArcGIS Web Adaptor
    4.  Installing multiple ArcGIS Web Adaptors
    1. Step 3: Configure ArcGIS Web Adaptor

    2.  Configure ArcGIS Web Adaptor
    3.  Unregister ArcGIS Web Adaptor with ArcGIS Server
    1. Uninstall ArcGIS Web Adaptor

    2.  Uninstalling ArcGIS Web Adaptor
  7. Install and configure ArcGIS Web Adaptor with Portal for ArcGIS

  8.  About ArcGIS Web Adaptor
  9.  An overview of implementing ArcGIS Web Adaptor with Portal for ArcGIS
    1. Step 1: Plan your Portal for ArcGIS configuration

    2.  The portal's role in ArcGIS
    1. Step 2: Enable HTTPS on your web server

    2.  Enable HTTPS on your web server
    1. Step 3: Install ArcGIS Web Adaptor

    2.  Install ArcGIS Web Adaptor
    3.  Silently installing ArcGIS Web Adaptor
    1. Step 4: Configure ArcGIS Web Adaptor

    2.  Configure ArcGIS Web Adaptor
    3.  Configure multiple ArcGIS Web Adaptors
    4.  Unregistering ArcGIS Web Adaptor with Portal for ArcGIS
    1. Uninstall ArcGIS Web Adaptor

    2.  Uninstalling ArcGIS Web Adaptor
  10. Reference

  11.  ArcGIS Web Adaptor 10.7.x system requirements
  12.  Configure your portal to use a reverse proxy server
  13.  Questions, feedback, and information
  14.  Copyright information

About the ArcGIS Web Adaptor

ArcGIS Web Adaptor (Java Platform) on Linux allows ArcGIS Server to integrate with your existing web server. The Java Platform setup is compatible with Java EE servers such as WebSphere and WebLogic.

ArcGIS Web Adaptor is an application that runs in your existing website and forwards requests to your ArcGIS Server machines. It polls your site at a regular interval to learn which machines have been added or removed. It then forwards traffic to only the currently participating machines. When you prepare to expose your ArcGIS Server site to an external audience, you should install the Web Adaptor or implement comparable request forwarding and security technology.

Benefits of the Web Adaptor

The Web Adaptor provides the following benefits:

  • Allows you to integrate ArcGIS Server with your organization's existing web server. By including a web server in your site, you gain the ability to host web applications that use your GIS services.

  • Allows you to provide a single endpoint that distributes incoming requests to the ArcGIS Servers in your site.

  • Allows you to expose your ArcGIS Server through your organization's standard website and port. Use the Web Adaptor if you don't want users to see the default port 6080 or the default site name arcgis.

  • Allows you to block the ArcGIS Server Administrator Directory and ArcGIS Server Manager from the view of external users.

  • Allows you to block ArcGIS Desktop users from establishing administrative or publisher connections to ArcGIS Server.

  • Allows you to use your organization's identity store and security policies at the web-tier level. You can also use a Public Key Infrastructure (PKI) if the web server has built-in or extensible support. This allows you to provide a single sign-on or other custom authentication experience when logging in to use services, web applications, and ArcGIS Server.

Web Adaptor deployment scenarios

The Web Adaptor can be used in various ArcGIS Server site configurations. For example, in a site with a single ArcGIS Server machine, you can install the Web Adaptor on the same machine as the ArcGIS Server machine, or offload it to a dedicated web server. In a multiple-machine deployment, you can have one entry point into your site by installing the Web Adaptor on a single web server, or you can establish redundancy at the web server tier by installing the Web Adaptor on multiple web servers.

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

The Web Adaptor is platform independent of ArcGIS Server; therefore, the Web Adaptor you deploy does not have to match the operating system platform of your ArcGIS Server site. For example, if you have a site comprised of Windows machines, you can deploy ArcGIS Web Adaptor (Java Platform) on Linux to work with ArcGIS Server.

For a detailed description of the different ways you can integrate the Web Adaptor into your existing site architecture, see Deployment scenarios.

Accessing your services with the Web Adaptor installed

After installing and configuring the Web Adaptor, the URLs that you use to access your services will change. Below are some examples of URLs that would change after installing a Web Adaptor to use port 443:

Services Directory (REST web services)

  • Without the Web Adaptor: https://gisserver.domain.com:6443/arcgis/rest/services.

  • With the Web Adaptor: https://webadaptorhost.domain.com/webadaptorname/rest/services. For example, if the machine hosting your Web Adaptor is named wa with the domain myorg.net and your Web Adaptor is named arcgis, you'll access the Services Directory using the URL https://wa.myorg.net/arcgis/rest/services.

SOAP web services

  • Without the Web Adaptor: https://gisserver.domain.com:6443/arcgis/services.

  • With the Web Adaptor: https://webadaptorhost.domain.com/webadaptorname/services. For example, if the machine hosting your Web Adaptor is named wa with the domain myorg.net and your Web Adaptor is named arcgis, you'll access SOAP web services using the URL https://wa.myorg.net/arcgis/services.

The Web Adaptor setup experience

The Web Adaptor has its own setup and installation guide which is separate from the ArcGIS Server installation. You must install the Web Adaptor on a machine running a web server. This can be a machine already running an ArcGIS Server site or a separate machine.

To learn more about the setup experience, see An overview of implementing the Web Adaptor with ArcGIS Server.