Summary
***For DDE 9.1 see the DDE Reference Guide instead!***
This article describes step by step instructions for installing the Data Delivery extension with ArcIMS 9.0 on Windows (single-machine configuration).
The following is required:
- a Web server
- a Servlet Engine
- ArcIMS 9.0
- Data Delivery extension (DDE)
- Authorization file for DDE
Warning:
ArcIMS 9.0 needs to be ready to use and configured with a supported Web server and Servlet Engine before installing and configuring the Data Delivery extension.
For more information about the components of the Data Delivery extension; for example, What is a QServer and so forth, consult Part 1 of the DDE Reference Manual. The latest version of the DDE Reference Manual is available for download in the Product Documentation section of the ESRI Support site:
Download the ArcIMS DDE Reference Manual
Before Beginning
To use the Data Delivery Extension (DDE), there are several steps involved:
- Installing the DDE software.
- Configuring DDE with the Web server.
- Integrating DDE with the ArcIMS sites.
Note:
This article includes instructions for:
a. Installing the DDE software only.
See the Related Information section for articles regarding:
b. Configuring DDE with the Web server.
c. Integrating DDE with the ArcIMS sites.
Procedure
Note:
If using IIS as the Web server, it may be necessary to create a Scripts directory for IIS; for example, create a folder Scripts at C:\Inetpub\Scripts. Then launch the IIS Management Console and create a virtual directory 'Scripts' and navigate to the created directory. Give it Execute permissions.
- Install the Data Delivery extension.
- Extract the file DDE_Windows_2004_V2.5_B148.zip located on the Data Delivery CD to a temporary location on the hard drive. For example, C:\temp\DDE.
- Navigate to <extracted directory>/Windows and double-click on the file DDE.exe to launch the setup program.
- Click Next on the Welcome screen.
- Read the License Agreement and click Yes to accept it.
- Click Next to install all the available components on the Select Components dialog.
- Enter the root directory of the Web server.
- For IIS navigate to C:\Inetpub\wwwroot.
- If using Apache Web server, navigate to <Apache Installation directory>\htdocs. Click Next
- Enter the listening port used by the Web server. By default, this is 80. Click Next.
- Leave the listening port for the Translation Servlet as the default port of 8194 click Next.
- Accept the default of 8195 for the connector port of the servlet engine. Click Next.
- Enter the path to the CGI Root Directory of the Web server.
- For IIS navigate to C:\inetpub\scripts.
- For Apache navigate to <APACHE installation directory>\cgi-bin. Click Next
- Enter the virtual directory name for the CGI Script Location Name. This is usually the name of the folder previously navigated to.
- For IIS enter 'scripts'
- For Apache enter 'cgi-bin'
- Accept the directory name of DDE. Click Next.
- Accept the name of the machine to reflect where the Translation Servlet is installed. Click Next.
- Accept the name of the machine for the host name to reflect where the QServer is installed. Click Next.
- Enter the host name of the mail server and the e-mail address to be used for notifications, or just enter mail.domain.com and myname@domain.com for now. Click Next.
Note:
This setting may be changed later in a configuration file.
- Accept the default protocol of http to be used for the translation results. Click Next.
- Edit the host name for the machine where the translation results should be stored. This should be the Web server hostname; for example, server alias, public IP address or fully qualified machine name. The machine name should only be employed for development purposes. Click Next.
- Accept the default name 'results' for the virtual directory used to store the translation results. Click Next.
Note:
The results folder is created in the Web server root directory.
- Accept the settings for the DDE Administration. Leave the password as the default random number, since this is not going to be used directly. Click Next to launch the installation.
- Click OK on the Configuration Complete message.
- If the Web server is IIS, do NOT reboot the server and proceed to Step 2. If not, select yes to reboot the computer and click Finish.
- On the DDE CD, find the DDEIntegration.zip and extract it to a temporary location.
- Rename the created folder "ArcIMS" to "DDE_ArcIMS".
- Copy the folder "DDE_ArcIMS" and place it in your ArcIMS website directory, for example C:\ArcIMS\website. This will make the htmltemplate files available for use when integrating your site with DDE in a future step.
- Additional configuration steps for the IIS Web server.
- WINDOWS 2000, 2003 and XP
- Open Internet Services Manager.
- Right-click Default Website and select Properties.
- Select the Home directory tab and then select the 'Configuration...' button.
- Hit the 'Add..' button.
- As the Executable path enter:
"C:\Program Files\DDE\Perl\nsperl.exe" %s %s
As Extension Type, enter:
.pl
- Click OK to close all the dialogs.
- Reboot the server.
- ADDITIONAL STEPS FOR WINDOWS 2003
- Open Internet Services Manager.
- Click Web Services Extension in the left panel.
- Click 'Add a new Web Service Extension' in the right panel.
- Set the Extension Name to 'Perl' without the quotes.
- Set the Required Files filed to point to the path of the nsperl.exe. For example, C:\Program Files\DDE\Perl\nsperl.exe
- Check the option to 'Set extension status to allowed'.
- Click OK to close all the dialogs.
- Reboot the server.
- Authorize the Data Delivery extension for use.
- Navigate to Start > Programs > ArcGIS > ArcIMS > Post Installation.
- Select Custom.
- Select the Authorize ArcIMS option - uncheck everything else.
- Navigate to the authorization file (.ecp) when prompted.
- Click Next. The feature 'delivery' should be listed.
- Click Next and finish the Post Installation.
- Start DDE by going to Start > Programs > DDE > Start DDE. The according console window should launch.
Note:
If the authorization was successful and the necessary port is available for running DDE, the text should stop scrolling after about 30 seconds.
Warning:
Do not close the DDE console window since this corrupts the DDE processes. Stop DDE by navigating to Start > Programs > DDE > Stop DDE. If the console was closed accidentally, a reboot of the machine solves the issue.
- To configure the data source and integrate DDE with ArcIMS, see the according article listed in the Related Information section.