English

How To: Modifying configuration files on ArcGIS Server for the Microsoft .NET Framework to use host header names

Summary

After configuring a Web server to use a host header name, several configuration files installed with ArcGIS Server for the Microsoft .NET Framework need to be modified to include the host header string.

Procedure

The text below assumes that ArcGIS Server is installed for the Microsoft .NET Framework with the default instance name of 'ArcGIS'. If an instance name has been specified, replace ArcGIS with the instance name.

  • Fix the shortcuts to Manager and the Services Directory.

    The shortcuts that appear on the Start menu for Manager and the Services Directory need to be edited to use the host header name instead of the machine name. For example, the Target property for the Manager shortcut would look like the following, substituting myHostHeaderName with the host header name:

    "C:\Program Files\Internet Explorer\iexplore.exe" http://myHostHeaderName:80/ArcGIS/Manager/default.aspx

    It is necessary to make a similar change to the Services Directory shortcut.

  • Add an Internet connection to the GIS server in Manager.

    When building Web applications in Manager, the default ArcGIS Server Internet connection that appears in the Add Layer dialog box needs to be removed and a new GIS Server connection added that uses the host header name. For example, use the host header name when specifying the URL to the GIS server:

    http://myHostHeaderName/ArcGIS/services

  • Configure the REST endpoint with the host header name.

    Navigate to:

    C:\Inetpub\wwwroot\ArcGIS\rest

    and open rest.config in a text editor and edit the following attributes to contain the host header name:

    <SoapUrl>http://myHostHeaderName:80/ArcGIS/services</SoapUrl>
    <SoapSslUrl>https://myHostHeaderName:443/ArcGIS/services</SoapSslUrl>
    <ServicesExplorerHelpUrl>http://myHostHeaderName:80/ArcGIS/SDK/REST/servicesexplorer.html</ServicesExplorerHelpUrl>
    <ApiHelp baseUrl="http://myHostHeaderName:80/ArcGIS/SDK/REST/index.html?">