How To: Configure the Data Delivery extension for IIS and ServletExec ISAPI on Windows


This article describes step by step instructions for the configuration of the Data Delivery extension (DDE) with IIS and ServletExec ISAPI for ArcIMS 9.0 on Windows (single-machine configuration).

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.
This article includes instructions for: 
B. Configuring DDE with the Web Server only. 

See the Related Information section for articles regarding:
A. Installing the DDE software.
C. Integrating DDE with the ArcIMS sites.
ArcIMS 9.0 needs to be available for use and configured with a supported Web server and Servlet Engine, and the Data Delivery extension (DDE) installed, before configuring DDE with the Web server and Servlet Engine.
The following steps do not apply to DDE 9.1
Follow the steps below.


After the Data Delivery extension is installed as described in the article: Install the Data Delivery Extension for ArcIMS 9.0 on Windows, available by way of the Related Information section below, configure DDE with ArcIMS, Web server and the Servlet Engine.

Before beginning, verify that the ESRI Tutorial Data has been installed on the ArcIMS machine.

  1. Download the configuration files and extract DDE_ArcIMS.zip into a temporary location. This includes the folders 'DDE_Sample', 'DDE_ArcIMS' and the DDE.war file that are used to configure DDE with ArcIMS.
  2. Configure IIS for DDE.
    1. Copy the folders 'DDE_ArcIMS' and 'DDE_Sample' to C:\ArcIMS\Website or to the location where your ArcIMS Website directory is located.
    2. Verify that the folder 'results' exists in the IIS root directory at C:\Inetpub\wwwroot.
      This directory should have been created during the DDE installation.
    3. Navigate to <drive>:\ArcIMS\Website\DDE_Sample\javascript and open the file fme_export.js in a text editor; for example, Notepad.
    4. Replace MYHOSTNAME to reflect the Web server host name.
    5. Save and close the file.
  3. Configure ServletExec for DDE.
    1. Copy the DDE.war file from the temporary location in step 1, to the directory <drive>:\Program Files\NewAtlanta\ServletExec ISAPI\webapps\default.
    2. Restart the IIS Admin and WWW Publishing services.
      This re-initializes ServletExec and auto-deploys the DDE web application. You will see it created a new folder called DDE. This incorporate the Translation Servlet used with DDE
    3. In a text editor, open
      C:\Program Files\New Atlanta\ServletExec ISAPI\ServletExec Data\default\DDE\WAR\WEB-INF\web.xml
      1. Replace all instances of MYHOSTNAME with the host name of the Web server.
      2. Edit MYEMAIL@MAIL.COM if an according mail server is configured.
      3. Check the paths listed and edit them accordingly if DDE was installed in a location other than the default of C:\Progam Files\DDE.
      4. Save and close the file.
    4. Restart IIS Admin and WWW Publishing services for the changes to take effect.
  4. Give the IUSR_<machinename> read/write permissions to the directories
    <drive>:\Program Files\DDE\safeViewerHTML
    to <drive>:\Inetpub\wwwroot\results.
    The IUSR_<machinename> needs these privileges in order to access and write session specific information an the results files.
  5. Define the Source Data for the DDE_Sample.
    1. Navigate to Start > Programs > DDE > Define Source Data. Press any key to continue when prompted.
    2. Fill out the fields in the DDE Config dialog as the following and leave the rest blank:
      Web Server Root Directory: C:\Inetpub\wwwroot
      Source Coordinate System:LL27
      Query Coordinate System:LL27
      Search Limit Min X: -122.5
      Search Limit Min Y: 37.7
      Search Limit Max X: -122.3
      Search Limit Max Y: 37.8
      Reader Type: SHAPE
      Dataset: C:\Program Files\ArcGIS\ArcIMS\Samples\TutorialData\SanFrancisco
    3. Click OK.
    4. Press Enter when prompted to launch the Spatial Assistant.
    5. Select File > New.
    6. Click "..." and select all the shapefiles in <drive>:\Program Files\ArcGIS\ArcIMS\Samples\TutorialData\SanFrancisco as the Input Data Source. Click OK.
    7. Select File > Exit.
    8. Click Yes when prompted to save the file.
    9. Type Y when prompted on the DDEConfig.bat process window. This should confirm with the text 'Configuration Complete.Done'.
    10. Press any key to close the process window.
  6. Edit the DDE ProcessMonitor configuration, now that ServletExec is configured for DDE.
    1. In a text editor; for example, Notepad, open <drive>:\Program Files\DDE\ProcessMonitorconfig.txt
    2. At the end of the file, comment out the line by placing a # at the beginning so that it appears as:
      # CMDStartTomcat="c:\\program files\\arcgis\\DDE\\tomcat\\bin\\startup.bat"|log
    3. Save and close the file.
    4. Navigate to Start > Programs > DDE and click Stop DDE to shutdown the Tomcat process that is integrated with DDE, if it is not already stopped.
      Do not stop DDE by closing the console window. This does not stop all the services. To recover, the computer may have to be restarted.
  7. Verify that DDE was installed and configured correctly using the DDE_Sample.
    1. In ArcIMS Administrator, create a new image service 'SanFrancisco' (case sensitive). For the map configuration file, navigate to C:\Program Files\ArcGIS\ArcIMS\Samples\TutorialData\AXL\SanFrancisco.axl
      If ArcIMS was installed to a non-default location, first edit the .axl in a text editor to correct the SHAPEWORKSPACE path.
    2. Close Administrator and click Save when prompted.
    3. Go to Start > Programs > DDE and click Start DDE if it is not already started. If it is started correctly the appearing console window stops scrolling after 30 seconds.
      Do not close the console window. This does not stop all DDE processes. To stop, use Stop DDE in the Start Menu. To recover from closing the console window, restart the computer.
    4. Open Internet Explorer and navigate to http://<hostname>/website/DDE_Sample. This should successfully launch an ArcIMS HTML Viewer with a city map of San Francisco. If not, verify that ArcIMS and the San Francisco image service are running properly.
    5. Click the button on the lower left of the toolbar to use DDE. A new window appears. If a new window does not appear, check if it was launched in the background on the desktop.
    6. Change the download format to PNG (Downloadable).
    7. Click the Translate Request button on the bottom right of this Web site to translate the data into the .png format.
    8. If DDE translates the request successfully, a new window with a link to download a zip file should appear.

      If an error appears, retrace the steps and check the translationServlet.log file located in C:\Program Files\DDE\logs for further information. Also, look for any differences in capitalization in the properties edited.
  8. Continue with integrating the Data Delivery functionality with the ArcIMS Web sites that are based on the HTML Viewer, see the Related section: HowTo: Integrate the Data Delivery functionality with ArcIMS Web sites based on the HTML Viewer.

Related Information