Knowledge Base - Technical Articles


Technical Article   HowTo:  Configure a reverse proxy system architecture for ArcGIS Server with an Apache Web Server

Article ID: 39568
Software:  ArcGIS Server (10.0 and prior) 10
Platforms:  Windows XP, Server 2003, Vista, Server 2008

Summary

Instructions provided describe the procedure for configuring a reverse proxy for ArcGIS Server using an Apache Web Server. For a complete description of and reasons to use the reverse proxy architecture, see How to: Configure a reverse proxy system architecture with ArcGIS Server.

Procedure

Reverse proxies and load balancers are servers that act as 'front-end' web servers through which all clients connect to 'back-end' servers. A reverse proxy system refers to a single back-end server, unlike a load balancing system which refers to many back-end servers.


[O-Image] Reverse Proxy Implementation

  1. Download and Instal Apache HTTP Server
    A. Navigate to the Apache HTTP Server Project Download page.
    B. Select the appropriate link based on platform and version (32-bit or 64-bit) and save the file.
    C. Run the installation process.
  2. Edit httpd.conf
    On the Apache Server installation, replace the highlighted values in the file below with the ArcGIS Server machine name.



    [O-Image] Edit httpd.conf for RP
  3. Restart Apache
    • For Windows: Start > Run > Services.msc > Apache Server > Restart

    • For Linux: Run the following command

    apache@reverseproxy$ /apache/bin/httpd restart

  4. Test the connection to ArcServer(s)
    Test the following connections to ensure the endpoints respond accordingly:
    • http://reverseproxy/arcgis/services?wsdl
    • http://reverseproxy/arcgis/rest/services
    • http://reverseproxy/arcgis/tokens
    • http://reverseproxy/arcgis/manager
    • http://reverseproxy/arcgisoutput
    • http://reverseproxy/arcgisjobs
    • http://reverseproxy/arcgiscache
    • http://reverseproxy/arcgisinput
  5. Stop ArcGIS Server
    • For Windows: Start > Run > services.msc > ArcGIS Server Object Manager > Stop

    • For Linux: Run the following command

    arcgis@som1$ /arcgis/server10.0/scripts/stopserver

  6. Edit Server.dat file
    On all ArcGIS Servers in the system, replace the highlighted fields in the code below with the hostname of the reverse proxy.



    [O-Image] Edit Server.dat file
  7. Edit Service.cfg files
    Replace all the URLs within all *.cfg files found under '\ArcGIS\Server10.0\server\user\cfg\*.cfg'.

    See the screenshot below for an example.



    [O-Image] Edit Service.cfg files example
  8. Edit rest.config
    On all ArcGIS Servers in the system, edit all the URLs within the following file by replacing the local SOM with the reverse proxy's hostname.

      The rest.config file is hosted in IIS. The image below is not intended to show the Apache HTTP configuration.

    See the screenshot below for an example.



    [O-Image] Edit rest.config file example
  9. Start ArcGIS Server
    • For Windows: Start > Run > services.msc > ArcGIS Server Object Manager > Start

    • For Linux: Run the following command

    arcgis@som1$ /arcgis/server10.0/scripts/startserver
    


Related Information


Created: 11/14/2011
Last Modified: 3/12/2014

Article Rating: (3)
If you would like to post a comment, please login

Comments

By kolster - 02/15/2013 9:15 AM

I would like to see a new article that discusses the topic outlined below.

Hello, does it work with 10.1? I don't want use the Web Adaptor.

Rating:

By kchesla - 12/18/2012 8:18 AM

The article needs to be updated.

Step 8 shows the IIS root directly not the Apache http configuration. Pleaes update Step 8 for Apache configuration.

Rating:

By adams_c84 - 05/30/2012 3:13 AM

Other - See details below.

Please can you clarify step 2. The text cannot be copied and pasted as mentioned in the step.

Rating: