Retaining underscore characters in the Web server name

If the machine name of the Web server contains an underscore or underscore characters in its name, such as MY_WEB_SERVER, you may experience unexpected behavior when attempting to log in to Manager, create services, or manage Web applications using Microsoft Internet Explorer. If you or your organization have conventions in place that do not allow the removal of underscore characters, the following steps provide a workaround that will allow you to retain underscore characters in your Web server name.

Note: If you have not completed the GIS Server Post Install or Web Services Post Install, proceed to the topic Configuring a one-machine deployment and finish the postinstallation before beginning this workaround.

Modify the services.config file

Steps:
  1. From the C: drive, choose inetpub > wwwroot > ArcGIS > Services.

    Note: The file path of this directory may vary depending on your installation configuration. The default is listed above.

  2. Open the services.config file with Notepad or another editor of your choice.
  3. Locate the <ServerName> tag and replace the current server name with the IP address of your Web server. Ensure that there are no extra spaces or characters here; otherwise, the server will fail.
  4. Screen shot of the services.config file
  5. Save and close the services.config file.

Reset Internet Information Services

In the following steps, the iisreset command is utilized to temporarily take the Web server offline and recycle any services. Once the command completes, the changes made to the services.config file will immediately be taken into effect on the Web server. This is a quick alternative to rebooting the Web server.

Note: Before beginning these steps, ensure that you are logged out of Manager.

Steps:
  1. From the start menu, choose All Programs > Accessories > Command Prompt.
  2. In the command prompt window, type iisreset. Press ENTER to initiate the command.
  3. When the command completes, close the command prompt window.

Modify the Manager shortcut

Steps:
  1. From the Start Menu, choose All Programs > ArcGIS > ArcGIS Server for the Microsoft .NET Framework, then right-click ArcGIS Server Manager and choose Properties.
  2. Under the Shortcut tab, change the Target from your Web server name to your Web server IP address. For instance:

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

    should change to

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

  3. Screen shot of the ArcGIS Server Manager shortcut
  4. Click OK to accept the changes.
  5. Note: If you have previously bookmarked the Manager shortcut in any Web browser, ensure that the URL of this shortcut contains the IP address of the Web server, instead of the Web server name. Otherwise, an attempt to log in to Manager will fail.

Modify settings in Manager

Steps:
  1. Open ArcGIS Server Manager and log in.
  2. Click the Applications module and select Settings.
  3. In the resulting window, replace the Host and URL of Host fields to match the IP address of your Web server.
  4. Screen shot of the Web Applications Settings module in Manager
  5. Click Save.

    Note: A warning dialog box will display, indicating that defining an IP address as the value for Host will require you to enable remote access of the Web server's ASP.NET configuration files. Since you are specifying the IP address of the Web server as the Host and URL of Host, you can ignore this warning and select Save Changes.


8/22/2012