Note: This solution applies to DocuShare servers that have the Tomcat port turned off
Note: This solution applies to DocuShare 6.x.
Note: In DocuShare 6.5.2 patch 5 and higher when disabling Tomcat via dssetup the server.xml automatically adds the line listed in this solution. Therefore the error should no longer occur.
Issue
This error occurs when the Tomcat Port in DocuShare is turned off via the dssetup command line utility. When you turn the Tomcat HTTP port off it causes Chiba errors and you will need to manually edit the server.xml file.
Note: It is not possible to completely turn off the Tomcat HTTP Port and still have the Chiba sub-system still operate. It requires the Tomcat HTTP port be open for internal communications to function. The solution provided below is a manual edit that you can make to the server.xml file that will cause Tomcat to only respond to requests from itself (127.0.0.1).
Example Error:
jp.co.fujixerox.docushare.amber.DSWebSystemException
java.lang.NullPointerException at
jp.co.fujixerox.docushare.amber.HTTPSURIResolver.resolve(HTTPSURIResolve
r.java:35) at
org.chiba.xml.xforms.core.Instance.getInitiallInstance(Instance.java:649
) at org.chiba.xml.xforms.core.Instance.init(Instance.java:156) at
org.chiba.xml.xforms.core.Model.createInstanceObject(Model.java:787) at
org.chiba.xml.xforms.core.Model.modelConstruct(Model.java:772) at
org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilt
erChain.java:188) …… etc.
Solution
Note: The solution provided below is a manual edit that you can make to the server.xml file that will cause Tomcat to only respond to requests from itself (127.0.0.1). All requests from other sources will be denied access.
Note: You must be an Windows Administrator to perform this solution.
Note: To perform this solution it requires that you stop DocuShare.
From the DocuShare Server,
1. Open Windows Explorer
2. Browse to the Xerox\Docushare\tomcat\conf directory
3. Make a copy of the server.xml file and name it server.xml.bak
4. Open the original server.xml file in a text editor such as NotePad
5. Search for the following line:
6. Look to see if the entry in blue below exists.
· If the entry exists then just add the area that is displayed in red to the existing entry (as seen below).
·
· If the entire entry does not exist then add the entire entry below (including the entry in red).
address="127.0.0.1" disableUploadTimeout=â€true†./>
Note: If you are adding the entire entry be sure that you add it between the line and the line.
Note: If you are adding the entire entry and not using the default tomcat port 8080 then you will need to modify your entry to reflect the proper port number for your environment (port=â€8080â€). To verify the port number you are using for Tomcat you can open the Xerox\Docushare\config\amber.properties file and look at the http_port= entry to see the port number tomcat is using.
7. Save the modified copy of the server.xml file.
8. Restart DocuShare.
9. Try using the glyphscan option that was giving the error initially again.
Solution Updated: March 25th, 2013
Solution ID: 415