How To: Configure the Data Delivery extension for Apache and Tomcat on Windows


**These steps do not apply for DDE 9.1! Please see the DDE Reference Guide instead.**

This article describes step by step instructions for the configuration of the Data Delivery extension (DDE) with Apache 2.0.4x and Tomcat 4.1.xx for ArcIMS 9.0 on Windows (single-machine configuration).

To use the Data Delivery Extension (DDE), several steps are involved:
  1. Installing the DDE software.
  2. Configuring DDE with the Web Server.
  3. Integrating DDE with the ArcIMS sites.
This article only includes instructions for: 
B. Configuring DDE with the Web Server

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.


After the Data Delivery extension is installed, configure DDE with ArcIMS, Web server and the Servlet Engine. For more information on installing the Data Delivery extension, see the link in the Related Information section below.

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 Apache for DDE.
    1. In the \Apache\cgi-bin directory, create a folder called Scripts and move the spatialdirect.pl file from the cgi-bin directory to this folder.
    2. Edit the Apache httpd.conf file and find the ScriptsAlias section. Add the following lines:
      ##Add for DDE:
      ScriptAlias /scripts/ "C:/Program Files/Apache Group/Apache2/cgi-bin/scripts/"
      AllowOverride None
      Options None
      Order allow,deny
      Allow from all
      ##Above added for DDE
      Save and close the file.
    3. Navigate to the <Apache installation>\conf directory and open the file workers2.properties in Notepad. Add the following two lines to the end of the file:
      info=DDE connector
      Save and close the file.
    4. Browse to the directory Apache\htdocs and verify there is a folder 'results' (empty) and a folder 'safeViewerHTML'.
    5. Restart the Tomcat and Apache services.
  3. Configure Tomcat for DDE.
    1. Copy the DDE.war file from the temporary location in Step 2, 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
    4. Replace all instances of MYHOSTNAME with the host name of the Web server.
    5. Edit MYEMAIL@mail.com if an according mail server is configured.
    6. Edit the paths listed correspondingly if DDE was installed to a location other than the default of C:\Program Files\DDE.
    7. Save and close the file.
    8. Restart Tomcat.
  4. 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.
  5. 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.
  6. 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.
  7. Continue with integrating the Data Delivery functionality with the ArcIMS Web sites that are based on the HTML Viewer.

    For more information, see the links in the Related Information section below.

Related Information