ArcIMS 10 for Windows Install Guide - Installing multiple Spatial Servers on additional machines

In this installation scenario, several computers run ArcIMS Spatial Server and communicate with the ArcIMS Host. One computer, the ArcIMS Host, runs Web server software with Map Creation and Administration, ArcIMS Application Server, and Connectors, while on other computers ArcIMS Spatial Servers run. All ArcIMS Spatial Servers must point back to the ArcIMS Host, and the ArcIMS Host must be able to communicate with the ArcIMS Spatial Servers.

To install additional ArcIMS Monitors on the same machine, see the topic Installing additional ArcIMS Monitors.

There are four parts to setting up a multiple ArcIMS Spatial Server configuration (each is discussed below):

Obtain your Authorization files for each machine where Spatial Server will be installed.
Install and configure the ArcIMS host machine.
Additional configuration of the ArcIMS host machine.
Installing ArcIMS Spatial Servers on additional machines (includes preparing to install, installation, and post installation).

All the necessary steps are described within this topic.

ArcIMS Authorization file

Spatial Server requires an Authorization File. Each machine installing this feature requires a unique authorization file. For information on obtaining an authorization file, see the topic How to obtain an authorization file.

If you installed ArcIMS Spatial Server, the post installation option ArcIMS Authorization will configure your machine using the authorization file you received from Customer Service.

How to install and configure your ArcIMS Host machine

To install and configure the ArcIMS Host (Map Creation and Administration, Connectors, and ArcIMS Application Server), refer to Performing a typical installation. To install the ArcIMS Host on a separate machine from ArcIMS Spatial Server, during the typical installation, be sure to uncheck the Spatial Server feature so it will not be installed on your ArcIMS host machine. After successfully configuring your Web server (either during the post installation setup or manually), identify the following locations:

Output directory for Image Services: You need to share the ArcIMS directory where the Output directory was created (for example, C:\ArcIMS) so that ArcIMS Spatial Servers can access this directory. This can automatically be done during the post installation setup on your host machine. See setting up the Website and Output directories in the ArcIMS Configuration post installation for details.
Data directory: Each ArcIMS Spatial Server must have access to all data. If the data is not stored in ArcSDE, you should put data on a common drive.
AXL directory: You need to edit your map configuration files and ArcMap documents to reflect the common data drive.

How to additionally configure the ArcIMS Host machine

Share the Output directory so the ArcIMS Spatial Servers can access it. To allow the ArcIMS post installation setup to automatically share your ArcIMS Output directory for you, check the box to support multiple spatial servers on the ArcIMS Web sites and temporary output file dialog box.
To manually share the directory, go to Start > All Programs > Accessories > Windows Explorer, navigate to your output directory, right-click the directory, click Sharing, click Shared As, then click OK to share the directory.
Edit the Output directory location in your aimsdefaults.properties file. The aimsdefaults.properties file is stored in the \profiles\username location of the user that installed ArcIMS (C:\Documents and Settings\username). If you requested multiple Spatial Server support in the post installation setup (as outlined in step 1 above), this is done for you. You can edit this file by opening the file directly in a text editor or through ArcIMS Administrator.
- To Edit the aimsdefaults.properties file using ArcIMS Administrator
Open ArcIMS Administrator, click View, then click Site Properties.
In the Site Properties dialog box, click the Server Output tab and edit the output Directory Location. A UNC path is needed to specify the output directory (note: ArcIMS Administrator needs forward slashes in the UNC path):
```
//<ArcIMS Host>/output
```
- Click OK to save the modified properties in the aimsdefaults.properties file.
- To Edit the aimsdefaults.properties file using a text editor
If necessary, edit the following property to reflect the universal naming convention (UNC) path (note the direction of the slashes):
```
ImagePath=//<ArcIMS Host>/output
```
If you will be using the ArcIMS Service Administrator, you must configure your Output directory location in your sitePreferences.properties file. The sitePreferences.properties file is located on your Application Server machine stored in the <ArcIMS Installation Directory>\ArcIMS\AppServer directory. You can edit this file by opening the file directly in a text editor or through the Service Administrator.
- To edit the sitePreferences.properties file using the Services Administrator
Open the Service Administrator in your Web browser by typing http://<ArcIMS Host>/esriadmin. Click Configure Site.
In the Output Directory field, use the correct UNC path to specify the Output directory (note: Service Administrator needs forward slashes in the UNC path):
```
//<ArcIMS Host>/output
```
- To edit the sitePreferences.properties file using a text editor
Edit the following property to reflect the UNC path (note the direction of the slashes):
```
OutputDir=//<ArcIMS Host>/output
```
Edit your Web server Startup parameters:
Note:

If you are using Microsoft IIS Web server, perform the steps provided at this link, instead of the steps below. Change the Web server service Startup parameters. Choose Start > Control Panel > Performance and Maintenance > Administrative Tools > Component Services and click Services on the Tree tab. Highlight your Web server and click Properties. Select log on. Click This Account and choose a network account. You cannot use a system account. Stop and Start your Web server.
Share the data directory so the ArcIMS Spatial Servers can access the data referenced in the map configuration files. When determining the location to store your data, each ArcIMS Spatial Server must be able to access all data displayed in all ArcIMS Services; thus, it is recommended that you locate your data in a common data directory if it is not already stored in ArcSDE. This directory must be accessible from all Spatial Servers.
Note:

In general, access to shapefiles is much faster if the shapefiles reside on the same computer as the ArcIMS Spatial Server. To share the data directory, go to Start > All Programs > Accessories > Windows Explorer, navigate to your data directory, right-click the directory, click Sharing, click Shared As, then click OK to share the directory.
Edit your map configuration files. The map configuration file stores the location of the data layers. This file must be edited to reflect the common data drive. Open the file in a text editor and edit the directory in the following lines to reflect the UNC path:
```
<WORKSPACES><SHAPEWORKSPACE name="shp_ws-8" directory="\\<ArcIMS Host>.<domain>.com\ GISData" /></WORKSPACES>For ArcMap Server, use UNC paths to data in the ArcMap document.
```

How to prepare to install ArcIMS Spatial Server

Obtain an authorization file for each machine you will install ArcIMS Spatial Server on.
Verify that your site meets system requirements. For system requirement information, see Step 1: Verify system requirements.
Log in as a user with administrator privileges.
Close all applications on your computer.
Insert the ArcIMS media into the appropriate drive to automatically launch the setup program.

Note:

You may be prompted to install the Microsoft Windows Installer.
If you do not have Internet Explorer 6 or higher and Microsoft Data Access Components (MDAC) 2.5 or higher, the installation optionally lets you install MDAC 2.5. You must obtain and install Internet Explorer 6 or higher. Internet Explorer 6 or higher is also required for the ActiveX connector.

How to install ArcIMS Spatial Server

During the installation, you will be asked to read the license agreement and accept it, or exit if you don't agree with the terms.
On the Select Features dialog box, expand the Spatial Server feature by clicking the + sign to view the subfeatures. Click the drop-down arrow to the left of the Spatial Server feature. From the list, select Will be installed on local hard drive to install the ArcIMS Spatial Server.
To complete the installation, follow the directions on your machine.
Complete the post installation setup.
The following ArcIMS post installation options are required to successfully install ArcIMS Spatial Server:
ArcIMS Authorization Configuration
ArcIMS Configuration
If you select a typical post installation setup, this post installation option is automatically selected. See Post installation overview topic for information on the post installation setup options.
There is no need to configure your Web server. These steps are not necessary when installing only ArcIMS Spatial Server.

After installing ArcIMS Spatial Server, see ArcIMS Help for details on how to administer the ArcIMS Spatial Server.

See ArcIMS Help for more information on configuring your Web site.

Note:

When you install ArcIMS Spatial Servers on a system where you already have an existing ArcIMS site configuration, you need to manually add a Metadata Server virtual server. See ArcIMS Help for details on configuring virtual servers for ArcIMS.
The setup stores the necessary configuration information to use the applications in the \profiles\username location of the user that installed ArcIMS (for Windows Server 2003 or Windows XP C:\Documents and Settings\username). If you need alternate login accounts to use ArcIMS applications, copy the aimsdefault.properties file from the profiles\username folder of the account that installed ArcIMS to the \profiles\username folder of the alternate users. It is important to copy the file (which is updated during the initial installation) that resides in the installer's profile folder. The aimsdefault.properties file located in the ArcIMS\Common installation location contains default values and does not work.

Published 6/24/2010