Installing ArcIMS custom Application Server Connectors

In this installation scenario, you select an ArcIMS Application Server Connector depending on the development environment you plan to use for creating Web pages. The available Application Server Connectors are ArcIMS Servlet Connector, ActiveX Connector, ColdFusion Connector, Java Connector and .NET Link Runtime and Developer Help.

The Application Server Connectors reside on the Web server computer. Each Web server can have more than one Application Server Connector, as long as they are of different types.

 

 

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 Java Connector, ColdFuson Connector and ActiveX Connector include an AXL Object library. ArcIMS Servlet Connector and .NET Link do not include an AXL Object library.

 

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 WMS connector for ArcIMS is installed with the Servlet connector see the WMS connector section for steps to enable ArcIMS to work within the OCG WMS 1.1.1 specification.

Use the ColdFusion Connector if you plan to embed ColdFusion applications in your Web pages. The Java Connector communicates with the ArcIMS Application Server and a JSP client. The ActiveX Connector permits you to customize the ArcIMS Viewers with embedded ActiveX applications. The .NET Link Runtime and Developer Help allows you to integrate ArcIMS functionality within a .NET application.

 

See System requirements for requirements for the ColdFusion connector, ActiveX connector, Java connector and .NET Link Runtime and Developer Help.

 

Tip

  • These instructions describe an ArcIMS Application Server and custom connector installation only. To install the ArcIMS Host (ArcIMS Manager, Application Server Connectors and ArcIMS Application Server), refer to Performing a typical installation.

 

 

How to prepare to install ArcIMS custom Application Server Connectors

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

  2. Log in as a user with administrative privileges.

  3. Ensure that a TEMP variable is set to a valid folder where you have write access and space available.

  4. Close all applications on your computer.

  5. Insert the ArcIMS CD into the CD drive to automatically launch the setup program.

 

Tips

  • 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 install will optionally let you install MDAC 2.5. You must obtain and install Internet Explorer 6 or higher. Internet Explorer 6 or higher and MDAC 2.5 is required for ArcIMS ArcMap Server. Internet Explorer 6 or higher is also required for the ActiveX connector.

  • The .NET Link Runtime and Developer Help requires .NET Framework SDK 1.1.

  • Integration of the .NET help files with Visual Studio .NET 2003 requires Visual Studio .NET 2003 to be installed prior to installing the .NET Link feature. If you do not have Visual Studio .NET 2003 installed, the equivalent help (NetLink.chm) can be obtained from Customizing ArcIMS—Using .NET Link located on the ESRI Software Documentation Library CD.

 

 

How to install ArcIMS custom Application Server Connectors

 

  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.

 

  1. At the Select Features dialog box, expand the Application Server Connectors feature by clicking on the + sign to view the sub-features. The Application Server Connector feature contains the ActiveX Connector, ColdFusion Connector, Java Connector, Servlet Connector and .NET Link Runtime & Developer Help sub-features. Click the dropdown arrow to the left of the Application Server Connector that you would like to install. From the list, select Will be installed on local hard drive to install the selected Application Server Connector.

 

 

  1. There are also Application Server Connector Documentation and Samples available to install. 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. Documentation is available from the ESRI Software Documentation Library CD.

 

Tip

    • The .NET Link Runtime and Developer Help installation features will be unavailable if the setup program does not detect Microsoft .NET Framework SDK 1.1.

    • Integration of the .NET help files with Visual Studio .NET 2003 requires Visual Studio .NET 2003 to be installed prior to installing the .NET Link feature. If you do not have Visual Studio .NET 2003 installed, the equivalent help (NetLink.chm) can be obtained from Customizing ArcIMS—Using .NET Link located on the ESRI Software Documentation Library CD.

    • The ESRI Software Documentation CD includes Using_NetLink.html, a introductory text to the .NET Link, and a short tutorial on how to use it.

 

 

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

 

Tips

  • The ArcIMS Servlet Connector is already installed if you previously performed a typical ArcIMS installation.

  • When choosing to install ArcIMS Metadata Explorer or ArcIMS Manager, you do not have to install the Java connector because the files are included with these installation features.

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

  • The Java Archive (JAR) files required to use the Java Connector are installed at <ArcIMS Installation Directory>\ArcIMS\Connectors\Java_Connector. They are arcims_jconnect.jar, jcert.jar, jnet.jar, and jsse.jar.

  • The OGC WMS Connector can also be downloaded from: http://www.esri.com/software/opengis/interopdownload.html

  • Not all the Web servers supported by ArcIMS are supported by ColdFusion. See Step 1: Verify system requirements for more information.

 

 

  1. Complete the post installation setup

The following ArcIMS post installation options are required to successfully install custom Application Server Connectors:

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

Web Server-Servlet Engine Configuration

 

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 custom Application Server Connectors

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

ArcIMS ActiveX Connector

ArcIMS ColdFusion Connector

ArcIMS Java Connector

ArcIMS Servlet Connector

WMS connector

 

Tips

  • To install the Z39.50 Connector see Installing Metadata Explorer.

  • 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; For Windows NT C:\WINNT\Profiles\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.