How To: Configure the Data Delivery extension for IIS and Tomcat 4.1.xx with ArcIMS 9.0 on Windows


***These steps do not apply for DDE 9.1!***

This article describes step by step instructions for the configuration of the Data Delivery extension (DDE) with IIS and Tomcat 4.1.xx for ArcIMS 9.0 on a 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. and C.
ArcIMS 9.0 must be available for use and configured with a supported Web server and Servlet Engine, and the Data Delivery Extension (DDE) installed, before continuing.

Before beginning, verify that the ArcIMS Tutorial Data has been installed on the ArcIMS machine at <ArcIMS Installation directory>\ArcIMS\Samples\TutorialData.


After the Data Delivery extension is installed as described in How To: Install the Data Delivery Extension for ArcIMS 9.0 on Windows, DDE must be configured with ArcIMS, the Web server and servlet engine. This is described in the following steps.

  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 Tomcat for DDE.
    1. Copy the DDE.war file from the temporary location in Step 1, to the directory <Tomcat installation directory>\webapps, where other .war files related to ArcIMS should be present.
    2. Restart Tomcat.
      This re-initializes Tomcat and auto-deploys the DDE Web application. A new folder called DDE should be present in the webapps directory. This makes the Translation Servlet available to DDE.
    3. In a text editor, open <Tomcat installation directory>\webapps\DDE\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. Edit the paths listed correspondingly if DDE was installed to a location other than the default of C:\Program Files\DDE.
      4. Save and close the file.
    4. In Notepad, as other editors are not recommended in this case, open the file <Tomcat installation directory>\conf\uriworkermap.properties and add these lines to the bottom of the file:
      # Mount the DDE context to the ajp13 worker
      Save and close the file.
    5. In a text editor, open the file <drive>:\Inetpub\scripts\DDE\spatialdirect.pl to change it to forward any translation request to the deployed DDE servlet. Find line 81:
      my $forwardingURL = URI->new('http://:8194/servlet/translationServlet');
      and edit it to appear as:
      my $forwardingURL = URI->new('http://<serverURL>/DDE/translationServlet');
    6. Restart the services for Tomcat and IIS (IIS Admin and WWW Pulishing Service).
  4. Give the IUSR_<machinename> read/write permissions to the directory <drive>:\Program Files\DDE\safeViewerHTML.
    The IUSR_<machinename> needs these privileges in order to access and write session specific information.
  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.
    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 Information section.

Related Information