English

How To: Install the Data Delivery Extension for ArcIMS 9.0 on Windows

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:
  1. Installing the DDE software.
  2. Configuring DDE with the Web server.
  3. 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.
  1. Install the Data Delivery extension.
    1. 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.
    2. Navigate to <extracted directory>/Windows and double-click on the file DDE.exe to launch the setup program.
    3. Click Next on the Welcome screen.
    4. Read the License Agreement and click Yes to accept it.
    5. Click Next to install all the available components on the Select Components dialog.
    6. 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
    7. Enter the listening port used by the Web server. By default, this is 80. Click Next.
    8. Leave the listening port for the Translation Servlet as the default port of 8194 click Next.
    9. Accept the default of 8195 for the connector port of the servlet engine. Click Next.
    10. 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
    11. 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.
    12. Accept the name of the machine to reflect where the Translation Servlet is installed. Click Next.
    13. Accept the name of the machine for the host name to reflect where the QServer is installed. Click Next.
    14. 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.
    15. Accept the default protocol of http to be used for the translation results. Click Next.
    16. 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.
    17. 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.
    18. 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.
    19. Click OK on the Configuration Complete message.
    20. 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.
    21. On the DDE CD, find the DDEIntegration.zip and extract it to a temporary location.
    22. Rename the created folder "ArcIMS" to "DDE_ArcIMS".
    23. 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.
  2. Additional configuration steps for the IIS Web server.
    • WINDOWS 2000, 2003 and XP
      1. Open Internet Services Manager.
      2. Right-click Default Website and select Properties.
      3. Select the Home directory tab and then select the 'Configuration...' button.
      4. Hit the 'Add..' button.
      5. As the Executable path enter:
        "C:\Program Files\DDE\Perl\nsperl.exe" %s %s
        As Extension Type, enter:
        .pl
      6. Click OK to close all the dialogs.
      7. Reboot the server.
    • ADDITIONAL STEPS FOR WINDOWS 2003
      1. Open Internet Services Manager.
      2. Click Web Services Extension in the left panel.
      3. Click 'Add a new Web Service Extension' in the right panel.
      4. Set the Extension Name to 'Perl' without the quotes.
      5. Set the Required Files filed to point to the path of the nsperl.exe. For example, C:\Program Files\DDE\Perl\nsperl.exe
      6. Check the option to 'Set extension status to allowed'.
      7. Click OK to close all the dialogs.
      8. Reboot the server.
  3. Authorize the Data Delivery extension for use.
    1. Navigate to Start > Programs > ArcGIS > ArcIMS > Post Installation.
    2. Select Custom.
    3. Select the Authorize ArcIMS option - uncheck everything else.
    4. Navigate to the authorization file (.ecp) when prompted.
    5. Click Next. The feature 'delivery' should be listed.
    6. Click Next and finish the Post Installation.
    7. 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.
  4. To configure the data source and integrate DDE with ArcIMS, see the according article listed in the Related Information section.

Related Information