DocuShare 3.1 was released with Apache 2.0.40 compiled for Windows. This version of Apache is an optional replacement for the version shipped with DocuShare.
Download and extract Apache 2.0.48 for Windows files
To use DocuShare with Apache 2.0.48 for Windows download the Apache_2_0_48+OpenSSL.zip file from the DocuShare File Downloads page. This Zip file contains Apache web server with OpenSSL and the Apache to Tomcat Bridge configured for DocuShare.
Extract the contents of the Zip file to a temporary directory. Copy the extracted files and directories to the C:\apache2 directory.
NOTE: This version of Apache was compiled to use the C:\apache2 directory. The Apache Web server will not work if the files are located on a different directory path.
Edit the httpd.conf File
You must edit the httpd.conf file to fit your environment. Search for the text “@@“to find what you must edit. The following lines in the httpd.conf file are specific to DocuShare and must be edited to fit your environment. Be sure to remove the @@ characters.
For the Apache to Tomcat Bridge the following three lines must have the correct file path to the Tomcat files. Include @@"C:/Xerox/Docushare/tomcat/conf/auto/mod_jk.conf"@@ JkWorkersFile @@"C:/Xerox/Docushare/tomcat/conf/ntiis/workers.properties"@@ JkLogFile @@"C:/Xerox/DocuShare/tomcat/logs/mod_jk.log"@@ For SSL you must supply the fully qualified DNS name to your server. Port 443 is the default SSL port. Change the port number only if you have configured SSL to use a different port.
NOTE: Use the forward slash “/†character where filenames are specified. You must use forward slash instead of the backslash character.
NOTE: You should consult with your network or Web administrator about any configurations necessary for Apache Web server to work in you environment.
NOTE: By default this httpd.conf file configures the Apache Web server to use port 80 (search for “Listen 80â€). If Microsoft Internet Information Server (IIS) is installed on the same machine, disable the web server or configure IIS to use a different port.
Install Your SSL Digital Certificate and Key
The extracted files included a temporary self-signed Digital Certificate and Key. When someone connects to the site via HTTPS they will receive a certificate warning message. You must replace the certificate and encryption key files with your own.
Copy your server.crt and server.key files into the C:\apache2\conf\ssl directory.
Install Apache 2.0.48 for Windows
Open a command prompt window. Change the current directory to c:\apache2\bin. Run the following command to install Apache as a Windows Service. Apache –k install
Note: Apache will not start unless it is installed as a Windows Service In the command prompt window run the following command to start the Apache Web server. Apache –k start
Verify the Installation and Configuration
Follow your standard procedure for starting DocuShare. Direct your web browser to the DocuShare server. The DocuShare homepage should display without using port 8080. For example: http://your.docushare.server.com/docushare. Change the URL to use SSL by using https://. For example: https://your.docushare.server.com/docushare.
Turn off Tomcat HTTP (optional)
After you have configured and verified the server’s operation, consider turning the Tomcat HTTP port off. This will block users from accessing the Tomcat web servlet. With Tomcat HTTP disabled all requests must go through the Apache Web server to connect to DocuShare. Open a command prompt window. Use the following command to start DocuShare and turn off Tomcat HTTP. “C:\Xerox\DocuShare\bin\start_docushare tomcat http off update-onlyâ€
Download and extract Apache 2.0.48 for Windows files
To use DocuShare with Apache 2.0.48 for Windows download the Apache_2_0_48+OpenSSL.zip file from the DocuShare File Downloads page. This Zip file contains Apache web server with OpenSSL and the Apache to Tomcat Bridge configured for DocuShare.
Extract the contents of the Zip file to a temporary directory. Copy the extracted files and directories to the C:\apache2 directory.
NOTE: This version of Apache was compiled to use the C:\apache2 directory. The Apache Web server will not work if the files are located on a different directory path.
Edit the httpd.conf File
You must edit the httpd.conf file to fit your environment. Search for the text “@@“to find what you must edit. The following lines in the httpd.conf file are specific to DocuShare and must be edited to fit your environment. Be sure to remove the @@ characters.
For the Apache to Tomcat Bridge the following three lines must have the correct file path to the Tomcat files. Include @@"C:/Xerox/Docushare/tomcat/conf/auto/mod_jk.conf"@@ JkWorkersFile @@"C:/Xerox/Docushare/tomcat/conf/ntiis/workers.properties"@@ JkLogFile @@"C:/Xerox/DocuShare/tomcat/logs/mod_jk.log"@@ For SSL you must supply the fully qualified DNS name to your server. Port 443 is the default SSL port. Change the port number only if you have configured SSL to use a different port.
NOTE: Use the forward slash “/†character where filenames are specified. You must use forward slash instead of the backslash character.
NOTE: You should consult with your network or Web administrator about any configurations necessary for Apache Web server to work in you environment.
NOTE: By default this httpd.conf file configures the Apache Web server to use port 80 (search for “Listen 80â€). If Microsoft Internet Information Server (IIS) is installed on the same machine, disable the web server or configure IIS to use a different port.
Install Your SSL Digital Certificate and Key
The extracted files included a temporary self-signed Digital Certificate and Key. When someone connects to the site via HTTPS they will receive a certificate warning message. You must replace the certificate and encryption key files with your own.
Copy your server.crt and server.key files into the C:\apache2\conf\ssl directory.
Install Apache 2.0.48 for Windows
Open a command prompt window. Change the current directory to c:\apache2\bin. Run the following command to install Apache as a Windows Service. Apache –k install
Note: Apache will not start unless it is installed as a Windows Service In the command prompt window run the following command to start the Apache Web server. Apache –k start
Verify the Installation and Configuration
Follow your standard procedure for starting DocuShare. Direct your web browser to the DocuShare server. The DocuShare homepage should display without using port 8080. For example: http://your.docushare.server.com/docushare. Change the URL to use SSL by using https://. For example: https://your.docushare.server.com/docushare.
Turn off Tomcat HTTP (optional)
After you have configured and verified the server’s operation, consider turning the Tomcat HTTP port off. This will block users from accessing the Tomcat web servlet. With Tomcat HTTP disabled all requests must go through the Apache Web server to connect to DocuShare. Open a command prompt window. Use the following command to start DocuShare and turn off Tomcat HTTP. “C:\Xerox\DocuShare\bin\start_docushare tomcat http off update-onlyâ€