Xerox DocuShare Support & Software Installation Guide

Create a bridge to an IIS web server

6–2  

DocuShare Installation Guide

If, during DocuShare installation, you choose Tomcat only but later decided to use IIS as your web server, 
you can run the DocuShare IIS Software Bridge Management Tool to create a bridge to IIS.

The IIS Software Bridge Management Tool installs the bridge dll and plugs it into the IIS software. When IIS 
restarts, the bridge dll loads into IIS memory. As the dll loads into memory, it accesses registry key 
(HKEY_LOCAL_MACHINE\Software\Apache Software Foundation) to configure runtime settings. 

The settings include the logging level, log file locations, the workers.properties file, and the 
uriworkermap.properties file.

The workers.properties file defines the location of the ajp13 protocol, which in this case would be Tomcat. 
The uriworkermap.properties file defines the URLs that IIS delegates to the bridge. The install Wizard 
updates these files to allow the dll to function. Information about more extensive URL mapping or more 
complicated IIS settings, such as configuring for multiple DocuShare sites, is available on the Apache web 
site.

There is no need to uninstall your current IIS bridge setup; the Wizard overwrites current settings at http://
tomcat.apache.org/connectors-doc/.

To use the IIS Tool to create a bridge to an IIS web server:

1. Navigate to the location of the DocuShare installation files.

2. Navigate to the \Windows\IIS directory and double-click iistool.exe.

This starts the DocuShare IIS Bridge Management Tool Wizard.

3. In the next displayed window, select a location for the bridge installation; then click Next.

4. Enter the appropriate IIS bridge values in the displayed fields.

This includes the Tomcat Bridge Port Number. the IIS Port Number, the DocuShare Root, and the 
Host DNS Name. Generally, you do not need to change the default values.

5. Click Next.

The tool installs the bridge to the IIS web server.

6. When the Wizard completes installation, click Finished to close the window.

The Wizard restarts IIS.

7. If necessary, remove the media from the server drive.