Note: This applies to DocuShare 6.5.x ONLY
Issue
Note: This issue only applies to sites that have the Tomcat port turned OFF.
If the Tomcat Port is OFF and the dssetup command is run (even if you do not change anything. For example just hit Enter after each question to accept the default) and then start DocuShare and attempt to access DocuShare via IIS and the WEB UI will display the following message:
Example of the error displayed in the web browser if using Internet Information Services (IIS) 7 as the Web Server
The Service is Unavailable
Example of the error displayed in the web browser if using Internet Information Services (IIS) 6 as the Web Server
Service Temporary Unavailable!
The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later.
Note: The message that is displayed may vary slightly depending on the Web Server front end such as Apache (versions) and or SunOne (versions). The errors listed above were only for IIS 6 and IIS 7.
The \Logs\Tomcat.stdOut file displays the following:
Note: is the install directory, depending on your installation environment the path may vary. The default installation path is C:\Xerox\DocuShare
main]] - *** WebDAV status thread set up ***
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - ERROR org.apache.coyote.http11.Http11Protocol : Error starting endpoint
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - java.net.BindException: Cannot assign requested address: JVM_Bind:8080
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.tomcat.util.net.JIoEndpoint.init(JIoEndpoint.java:501)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.tomcat.util.net.JIoEndpoint.start(JIoEndpoint.java:515)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.coyote.http11.Http11Protocol.start(Http11Protocol.java:204)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.connector.Connector.start(Connector.java:1132)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.core.StandardService.start(StandardService.java:531)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.core.StandardServer.start(StandardServer.java:710)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.startup.Catalina.start(Catalina.java:566)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at java.lang.reflect.Method.invoke(Method.java:585)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:288)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:413)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - ERROR org.apache.catalina.startup.Catalina : Catalina.start:
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - LifecycleException: service.getName(): "Catalina"; Protocol handler start failed: java.net.BindException: Cannot assign requested address: JVM_Bind:8080
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.connector.Connector.start(Connector.java:1139)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.core.StandardService.start(StandardService.java:531)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.core.StandardServer.start(StandardServer.java:710)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.startup.Catalina.start(Catalina.java:566)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at java.lang.reflect.Method.invoke(Method.java:585)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:288)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:413)
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - INFO com.xerox.docushare.connect.DSConnectEngine : DSConnectEngine.run: need to inform the monitor for >webdav< >config<
05 Feb 2010 10:25:40 - [Thread[Thread-31,5,main]] - INFO
Reason
After running the dssetup command if any value other than Tomcat bridge port is changed or if no values are changed then DocuShare will update the \ tomcat\conf\Server.xml file with the following invalid entry. See examples below.
Example of the Server.xml file after turning off the Tomcat port via dssetup:
Note: This example is what the file should look like.
<Connector port="8080" protocol="HTTP/1.1" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="50" redirectPort="8443" useBodyEncodingForURI="true" URIEncoding="UTF-8" address="127.0.0.1" />
Example of the Server.xml file after running dssetup again and changing no values or modifying a value other than the tomcat bridge port:
Note: The address=8080 value is incorrect.
<Connector port="8080" protocol="HTTP/1.1" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="50" redirectPort="8443" useBodyEncodingForURI="true" URIEncoding="UTF-8" address="8080" />
Solution
Run dssetup again and turn the tomcat port on then run dssetup again and turn the port off again.
Steps to turn the tomcat port on then off:
1. Stop DocuShare
2. Open a Command prompt window
3. Change into the \bin directory
Note: is the install directory, depending on your installation environment the path may vary. The default installation path is C:\Xerox\DocuShare
4. Type dssetup and press Enter
5. Press Enter until the following question is displayed. Tomcat bridge port [off] ? type on and press Enter
6. Press Enter to accept all other values displayed. The following message will be displayed after the configuration has been updated. DocuShare command line configuration tool -- success!
7. Type dssetup again and press Enter
8. Press Enter until the following question is displayed. Tomcat bridge port [on] ? type off and press Enter
9. Press Enter to accept all other values displayed. The following message will be displayed after the configuration has been updated. DocuShare command line configuration tool -