English

Problem: ArcGIS Server 9.3.1 upgrade may reset Rest Services Directory and prevent reverse proxy server connections

Description

Upgrading ArcGIS Server from 9.3 or 9.3 Service Pack 1 to 9.3.1 may set custom values within the Rest Services Directory back to their default values. This may affect customers that make use of reverse proxy server environments.

Cause

The GIS Server Post-Install and/or the Web Applications Post-Install will reset non-standard values within the 'rest.config' file. It is common for these values to be 'customized' to permit the Rest Services directory to properly render URLs through reverse proxy connections.

Solution or Workaround

To resolve this issue, it will be necessary to re-configure the '\Inetpub\wwwroot\ArcGIS\Rest\rest.config' to reference the reverse proxy URLs instead of the default internal server URLs.

  • Copy/Paste (backup) the existing '\Inetpub\wwwroot\ArcGIS\rest\rest.config' file before editing.
  • Open '\Inetpub\wwwroot\ArcGIS\Rest\rest.config' with any text editor.
  • Change the following tags from:
    ...
    <SoapUrl>http://<internal server>/arcgis/services</SoapUrl>
    <SoapSslUrl>https://<internal server>:443/arcgis/services</SoapSslUrl>
    ...
    <ServicesDirectoryHelpUrl>http://<internal server>/arcgis/SDK/REST/servicesdirectory.html</ServicesDirectoryHelpUrl>
    ...
    <ApiHelp baseUrl="http://<internal server>/arcgis/SDK/REST/index.html?">
    ...

    To:
    ...
    <SoapUrl>http://<reverse proxy>/arcgis/services</SoapUrl>
    <SoapSslUrl>https://<reverse proxy>:443/arcgis/services</SoapSslUrl>
    ...
    <ServicesDirectoryHelpUrl>http://<reverse proxy>/arcgis/SDK/REST/servicesdirectory.html</ServicesDirectoryHelpUrl>
    ...
    <ApiHelp baseUrl="http://<reverse proxy>/arcgis/SDK/REST/index.html?">
    ...

  • EXAMPLE:

    Current Config:
    ...
    <SoapUrl>http://server1/arcgis/services</SoapUrl>
    <SoapSslUrl>https://server1:443/arcgis/services</SoapSslUrl>
    ...
    <ServicesDirectoryHelpUrl>http://server1/arcgis/SDK/REST/servicesdirectory.html</ServicesDirectoryHelpUrl>
    ...
    <ApiHelp baseUrl="http://server1/arcgis/SDK/REST/index.html?">
    ...

    Becomes:
    ...
    <SoapUrl>http://reverseproxy.domain.com/arcgis/services</SoapUrl>
    <SoapSslUrl>https://reverseproxy.domain.com:443/arcgis/services</SoapSslUrl>
    ...
    <ServicesDirectoryHelpUrl>http://reverseproxy.domain.com/arcgis/SDK/REST/servicesdirectory.html</ServicesDirectoryHelpUrl>
    ...
    <ApiHelp baseUrl="http://reverseproxy.domain.com/arcgis/SDK/REST/index.html?">
    ...

  • Save '\Inetpub\wwwroot\ArcGIS\Rest\rest.config' and restart Internet Information Services.

Related Information