English

How To: Use the AddInstance utility to create a new instance of ArcGIS Server Manager

Summary

Instructions provided describe how to create and configure a new instance of ArcGIS Server Manager using the AddInstance utility. The AddInstance utility is included with the ArcGIS Server product in <ArcGIS Install>\DotNet.

Procedure

Warning:
The following instructions involve modifying a registry value. It is recommended that you backup your operating system and files, including the registry, before proceeding. Consult with a qualified computer systems professional, if necessary. ESRI cannot guarantee results from incorrect modifications while following these instructions. Therefore, use caution and proceed at your own risk.
  1. IIS stores the physical location of the default IIS Web site in the following registry key:
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\InetStp\PathWWWRoot

    The default value is usually c:\Inetpub\wwwroot. Before starting the ArcGIS Server installation, change this registry key value to the root folder for the Web site on which an ArcGIS Server Manager instance is being created.
  2. Start the AddInstance utility (<ArcGIS Install>\DotNet\AddInstance.exe) and enter the instance name, name of the server object manager (SOM) machine, and an identity that can connect to the SOM. Click the Add button. The utility takes a moment to complete the task. When finished, the ArcGIS instance folders and virtual directories are created.
  3. In IIS Manager, verify that the Keyhole Markup Language (KML), Manager, Services and Web Map Service (WMS) directories contained within the new instance are configured as applications.
In IIS Manager, configure the KML, Manager, Services and WMS sub-directories contained within the new instance as applications.
  1. In IIS Manager, under the ArcGIS instance folder, open the Manager directory.
  2. Select Properties.
  3. Under Application Settings, click the Create button.
  4. Confirm that Execute Permissions are set to Scripts Only.
  5. Click Apply and OK.
Repeat this process for all 4 directories: Manager, Services, WMS, KML.
 
[O-Image]
  1. In IIS Manager, verify that the .AGSX and .* extension mappings have been added to the Services folder or virtual directory.
Add the .AGSX and .* extension mappings to the Services folder or virtual directory.
 
Use the following steps to navigate to the correct dialog box:
  1. Open IIS Manager.
  2. Open Default Web site.
  3. Open ArcGIS instance directory.
  4. Right-click the Services directory and select Properties.
  5. Click the Virtual Directory tab.
  6. Click the Configuration button.
  7. Click the Mappings tab.
On Windows 2003, .AGSX is added to the top in the Application extensions section, and * is added on the bottom in the Wildcard application maps section. On other operating systems, they are both added in the Application Mappings section.
Note:
Use the screen shots below as a guide.
 
[O-Image] Windows 2003
 
[O-Image] Windows XP

When manually adding the mappings, confirm the following:
  1. Both extensions point to the following DLL:
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll
  1. Set the Verbs option to 'Limit to' and enter the following in the following values:
GET,HEAD,POST,TRACE,DEBUG
  1. Make sure the 'Verify that file exists' option is unchecked.
The dialog should be configured as follows:
 
[O-Image] dialog box from article 32546
  1. If necessary, reset the value of the PathWWWRoot registry key back to the value it contained prior to performing step 1.
  2. Restart IIS.
Use one of the following options to restart IIS:
  • Open a command prompt and enter 'iisreset'.
  • Open the Services explorer dialog box (Start > Control Panel > Administrative Tools > Services). Stop the 'IIS Admin' and 'World Wide Web Publishing' services. Start both services.

Related Information