How To: Configure Tomcat with IIS and the ArcIMS AppServerLink and JSP Samples on Windows


Instructions provided describe the steps to configure Tomcat for the ArcIMS AppServerLink and copy the JSP website directories to the correct location.


  1. Create a directory structure in your Tomcat installation directory.
    a. Under <Tomcat_home>, create a new directory with the name of your choice, such as “jsp”, under the Webapps directory.
    b. Under this new directory create another directory called WEB-INF.
    c. Under the WEB-INF directory create two directories: lib and classes.
    When creating your applications, all JAR files should go in the lib directory and all expanded JAR files or class files should go in the classes directory.
    Each application, such as a JSP Web site, should be included in a folder at the same level as the WEB-INF directory. A sample directory structure looks like the following:
              |_JAR files
              |_class files
  2. Open <Tomcat_home>\conf\uriworkermap.properties in a text editor and add the following line (anywhere):
  3. Create a virtual directory for the directory created in Step 1a:
    a. Open IIS Manager.
    On Windows NT, choose Start > Programs > Windows NT 4.0 Option Pack > Microsoft Internet Information Server > Internet Service Manager; on Windows 2000, choose Start > Settings > Control Panel > Administrative Tools > Internet Services Manager.
    b. Under your localhost name, find Default Web Site. Click to highlight it.
    c. Click Action in the toolbar.
    d. From the dropdown menu, point to New and click Virtual Directory. The New Virtual Directory Wizard displays.
    e. Type the name of the directory you created in Step 1a for the alias, for example, jsp, and click Next.
    f. Click Browse to select the directory created in Step 1a, for example, <Tomcat_Home>\Webapps\jsp. Click OK and click Next.
    g. For IIS 4.0, check Allow Directory Browsing and click Finish; for IIS 4.0, check Browse and click Next. The directory appears in the virtual directory list.
  4. Set default.jsp as a default page:
    a. In IIS Manager, right-click on Default Web Site on the left, and select Properties.
    b. Click the Home Directory Tab. On the right toward the bottom, click Configuration.
    c. In the Application Configuration dialog, click Add.
    d. In the Add/Edit dialog click Browse. Under Files of Type, select *.dll. Select isapi_redirect.dll from the list and click Open. The Executable Path should be similar to <Tomcat_home>\bin\iis\i386\isapi_redirect.dll.
    e. In the Extension Type box, type .jsp. Click OK. Click OK in the Application Configuration dialog.
    f. In the Default Web Site Properties dialog, click the Documents tab. Click Add.
    g. In the Add Default Document dialog, type default.jsp (all lower case). Click the up arrow to move default.jsp to the top of the list. Click OK.
    h. Click OK in the Default Web Site Properties dialog.
  5. Stop and Start IIS and Jakarta.
    -On Windows NT: Click Start > Settings > Control Panel > Services;
    -On Windows 2000: Click Start > Settings > Control Panel > Administrative Tools > Component Services.
  6. Copy the following JAR files to the lib directory located under directory created in Step 1a, for example, jsp:
    <ArcIMS Installation Directory>\Connectors\AppServerLink\arcims_appserverlink.jar
    <ArcIMS Installation Directory>\Samples\Java_JSP\Classes\arcims_jspbeans.jar
  7. Copy the sample ArcIMS JSP Web sites into the directory created in Step 1a, for example, jsp:
    a. <ArcIMS Installation Directory>\Samples\Java_JSP\AdvancedViewer to <Tomcat_home>\webapps\jsp\AdvancedViewer
    b. <ArcIMS Installation Directory>\Samples\Java_JSP\Extractor to <Tomcat_home>\webapps\jsp\Extractor.
    c. <ArcIMS Installation Directory>\Samples\Java_JSP\Geocoder to <Tomcat_home>\webapps\jsp\Geocoder
    When all the files and directories are copied, the Tomcat directory should look something like the following:

Related Information