Installing ArcIMS Developer Solutions

In this installation scenario, you install the ArcIMS Developer Solutions feature depending on the development environment you plan to use for creating Web pages. This feature includes Developer Resources help and documentation, the ActiveX Connector, and the ColdFusion Connector.

 

A connector consists of an I/O Communication library and an optional AXL Object library. The AXL Object library is exposed through the connector API and enables the connector to create and parse ArcXML requests and responses to the developer. Without the AXL Object library, all ArcXML requests and responses must be created and parsed manually. The ColdFuson Connector and ActiveX Connector include an AXL Object library. ArcIMS Servlet Connector does not include an AXL Object library. The Connectors reside on the Web server computer. Each Web server can have more than one Connector, as long as they are of different types.

 

The Servlet Connector is the standard ArcIMS connector. The typical installation installs this connector. You need this connector if you plan to administer Web pages or use the Web design tools in ArcIMS (Author and Designer). The Servlet Connector also provides MapService-level user password authentication.

 

The ColdFusion Connector is used if you plan to embed ColdFusion applications in your Web pages.

 

The ActiveX Connector permits you to customize the ArcIMS Viewers with embedded ActiveX applications.

 

 

Tip

  • These instructions describe the Developer Solutions installation only. To install the ArcIMS Host (Map Creation and Administration, Connectors and ArcIMS Application Server), refer to Performing a typical installation.

 

The following are required to successfully install ArcIMS Developer Solutions

  1. If you will be installing the ActiveX Connector, you must obtain and install Internet Explorer 6 or higher. Internet Explorer 6 or higher is required for the ActiveX Connector.

  2. If you will be installing the ColdFusion Connector, visit the ESRI Support site for supported ColdFusion versions and requirements, at http://support.esri.com and select software > ArcIMS > System Requirements.

 

How to prepare to install ArcIMS Developer Solutions

  1. Verify your site meets system requirements. For system requirement information see Step 1: Verify system requirements

  2. Log in as a user with administrator privileges.

  3. Close all applications on your computer.

  4. Insert the ArcIMS media into the appropriate drive to automatically launch the setup program.

 

How to install ArcIMS Developer Solutions

  1. 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.

  2. At the Select Features dialog box, expand the Developer Solutions feature by clicking on the + sign to view the sub-features. The Developer Solutions feature contains the ActiveX Connector and ColdFusion Connector sub-features.  Click the dropdown arrow to the left of the Developer Solutions sub-feature that you would like to install. From the list, select Will be installed on local hard drive to install the selected Developer Solutions feature.

 

 

 

  1. To complete the installation, follow the directions on your machine.

 

There are also ActiveX Application, and ColdFusion Application samples available to install. Samples are available from the Samples installation feature of this setup. Expand the Samples features by clicking on the + sign to view the sub-features. Select Samples sub-features you would like to install, click on the dropdown arrow to the left of each feature. From the list, select Will be installed on local hard drive to install the selected Samples sub-features.

 

Tips

  • ColdFusion MX extension DLLs are installed at <ColdFusion Server Installation Directory>\runtime\bin.

  • The ArcIMS custom tag files are installed at <ColdFusion Server Installation Directory>\CustomTags.

  • The ArcIMS ColdFusion Studio Custom Toolbar files are installed in the following locations:

VTML files are installed at <ColdFusion Studio Installation Directory>\Extensions\TagDefs\VTML

Image files are installed at <ColdFusion Studio Installation Directory>\Wizards\Images

Toolbar file is installed at <ColdFusion Studio Installation Directory>\UserData\Toolbars

  • The ArcIMS ActiveX libraries are installed at <ArcIMS Installation Directory>\ArcIMS\Connectors\ActiveX.

  • Not all the Web servers supported by ArcIMS are supported by ColdFusion. See ESRI's support site for system requirements http://support.esri.com.

 

  1. Complete the post installation setup - If you installed the ColdFusion Connector

The following ArcIMS post installation options are required to successfully install the ColdFusion Connector:

ArcIMS Configuration (includes ColdFusion Connector configuration if the ColdFusion Connector was installed)

 

If you select a typical post installation setup these post installation options are automatically selected. See The Post Installation topic for information on the post installation setup options.

 

  1. Additional configuration steps for Connectors

Before the installation is complete, configure the connector you installed:

ArcIMS ActiveX Connector

ArcIMS ColdFusion Connector

 

 

 

 

 

Tip

  • The setup stores the necessary configuration information to use the applications in the \profiles\username location of the user that installed ArcIMS (for Windows 2000, 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 will have been 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 will not work.