Note: This solution applies to DocuShare 6.5.x.
Note: This solution applies to 32 & 64 bit Operating Systems.
Prerequisites:
· Install Internet Information Server (IIS) 6 (if not previously installed)
Solution
Note: You must the a Windows Administrator to perform this solution.
1. Modify the workers.properties file (If Required)
Note: Most installations do not require that this file be modified.
The <DSHOME>\tomcat\conf\ntiis\workers.properties file will need to be modified if one of the following conditions exists:
· If the DocuShare server is located on a different server than the IIS Server (the host information would need to be changed)
· The Port number used for tomcat is not the default 8009.
To modify the worker.properties file (if required):
a. Open Windows Explorer
b. Browse to the <DSHOME>\tomcat\conf\ntiis\workers.properties file.
c. Open the workers.properties file in a text editor such as Notepad.
d. Search for the following entries:
worker.ajp13.port=8009
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
e. Verify the values listed for port, and host display the correct information for your installation environment.
f. Save the file.
2. Modify the uriworkermap.properties file
To modify the uriworkmap.properties file:
a. Open Windows Explorer
b. Browse to the <DSHOME>\tomcat\conf\ntiis\uriworkermap.properties file.
c. Open the uriworkermap.properties file in a text editor such as Notepad.
d. Add any web sites that IIS needs to serve to Tomcat:
Note: All entries that are added to the uriworkermap.properties file must be in lowercase even if your installation environment uses uppercase. For example the fully qualified host name DocuShare.Xerox.com must be added as docushare.xerox.com
Example:
Lines listed in red in the example below were added to the file via copy and paste of the example that exists in the file and then modifying them to suite your installation information.
Note: All examples listed (server.domain.com, hostname, IPAddress and localhost) are not necessary, add lines appropriate for your installation environment. (Each new entry has 2 lines)
#
# Default worker to be used through our mappings
#
default.worker=ajp13
#
# Sites to be redirected to Tomcat
#
/examples=$(default.worker)
/examples/*=$(default.worker)
/docushare=$(default.worker)
/docushare/*=$(default.worker)
/server.domain.com/docushare=$(default.worker)
/server.domain.com/docushare/*=$(default.worker)
/hostname/docushare=$(default.worker)
/hostname/docushare/*=$(default.worker)
/IPAddress/docushare=$(default.worker)
/IPAddress/docushare/*=$(default.worker)
/localhost/ds652=$(default.worker)
/localhost/ds652/*=$(default.worker)
Where
· docushare is the root of your DocuShare website
· server is replaced with your server name
· domain.com is replaced with your domain information
· hostname is replaced with your DocuShare server’s hostname.
· IPAddress is replaced with the DocuShare server’s IPAddress.
e. Save the file.
3. Modify and Run the iis_redirect.reg file
To modify and run the iisredirect.reg:
a. Open Windows Explorer
b. Browse to the <DSHOME>\tomcat\conf\ntiis\iis_redirect.reg registry file.
c. Open the iis_redirect.reg file in a text editor such as Notepad.
d. Modify the paths to suit your environment.
Example:
Note: The lines listed in red below should point to the path for your DocuShare installation.
REGEDIT4
[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0]
"extension_uri"="/jakarta/isapi_redirect.dll"
"log_file"="C:\\Xerox\\Docushare\\tomcat\\logs\\iis_redirect.log"
"log_level"="emerg"
"worker_file"="C:\\Xerox\\Docushare\\tomcat\\conf\\ntiis\\workers.properties"
"worker_mount_file"="C:\\Xerox\\Docushare\\tomcat\\conf\\ntiis\\uriworkermap.properties"
e. Save file.
f. Run the iis_redirect.reg file by double-clicking on iis_redirect.reg or right-clicking and selecting Merge.
Note: If needed45, you can verify that the registry was successful, by clicking Start | Run | typing regedit and pressing Enter. Then view the contents of the [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0].
Example:
(Default) (value not set)
extension_uri /jakarta/isapi_redirect.dll
log_file C:\Xerox\Docushare\tomcat\logs\isapi.log
log_level emerg
worker_file C:\Xerox\Docushare\tomcat\conf\ntiis\workers.properties
worker_mount_file C:\Xerox\Docushare\tomcat\conf\ntiis\uriworkermap.properties
Note: If the iistool was used to install the bridge then the path will point to C:\Program Files\Xerox\Docushare…. by default.
4. Add the jakarta Virtual Directory to IIS
To add jakarta:
a. Start the Internet Information Services (IIS) Manager.
b. Click the [+] sign next to (local computer) to expand the option.
c. Click the [+] sign next to Web Sites to expand the option.
d. Right-click the Default Web Site and select New Virtual Directory. The Virtual Directory Creation Wizard displays. Click Next.
e. In the Alias: field type jakarta and click Next.
f. In the Path: field, click the browse button and point to the <DSHOME>\tomcat\bin\native\ click the OK button to accept the path then click the Next button.
Where <DSHOME>\tomcat\bin\native is your actual tomcat directory path typed out. For example, C:\DocuShare\tomcat\bin\native
Warning: If you are running a 64-bit server environment you will need to point to the <DSHOME>\tomcat\bin\nativeiis64intel or <DSHOME>\tomcat\bin\native\iis64amd depending on your environment.
g. Verify that Read and Execute (such as ISAPI applications or CGI) checkboxes are selected then click Next.
h. Click Finish.
i. The Jakarta Virtual directory should now be listed under the Default Web Site.
5. Add the ISAPI filter (isapi_redirect.dll) to the IIS server
To add the ISAPI filter:
a. Using Internet Information Services (IIS) Manager, Right-click Web Sites (not the default web site) and select Properties.
b. Select the ISAPI Filters tab.
c. Click the Add button. The Add/Edit Filter Properties window displays.
d. In the Filter name: field type Jakarta Redirector
e. In the Executable: field click the browse button and browse to <DS3_Home>\tomcat\bin\native\isapi_redirect.dll and click the OK button.
Warning: If you are running a 64-bit server environment you will need to point to the <DSHOME>\tomcat\bin\native\iis64intel\isapi_redirect.dll or <DSHOME>\tomcat\bin\native\iis64amd\isapi_redirect.dll depending on your environment.
f. Click OK to accept the Filter name and Executable path you entered.
g. The status will show a Green Arrow.
Note: For Windows 2000 Server you need to stop the IIS server and restart the IIS server for the ISAPI status to turn green.
h. Click the Move up button (if applicable) to move the ISAPI filter up the to the top of the list then click the OK button.
Note: If the ISAPI filter will not load after a restart of IIS, follow the related solution Jakarta Redirector ISAPI Filter is not loading in IIS link listed at the bottom of this page.
6. Verify that the Web Service Extensions are set to Allow for the Jakarta Redirector
a. Open the Internet Information Service (IIS) Manager
b. Select Web Service Extensions
c. Verify that the All Unknown ISAPI Extensions have a status of Allowed and/or the Jakarta Redirector has a status of Allowed
Note: If the Jakarta Redirector is not and you do not allow all Unknown ISAPI Extensions then you can manually add the Jakarta Redirector in as allowed by right clicking on Web Service Extensions and selecting add a new Web service extension…
d. Restart the IIS ServiceCheck to see if the Jakarta Redirector loads by, Opening Internet Information Service (IIS) Manager.
e. Right Click on Web Sites and select properties
f. Click the ISAPI Filters tab
g. The Status of the Jakarta Redirector should be a Green Arrow pointing up.
Note: If none of the solutions listed above allow you to load the Jakarta Redirector successfully, then you may have to refer to Microsoft for additional information.
Note: If you believe that IIS may not be installed correctly or corrupt on the DocuShare server, IIS can be uninstalled and installed again without affecting DocuShare. After a reinstall of IIS you will need to run the iistool.exe again. For detailed instruction on how to install the iistool click the How To Install the Install the IIS Bridge Management tool (iistool.exe) listed at the bottom of the page.
Solution Updated: June 24th, 2014
Solution ID: 539