Issue
Unable to access DocuShare using Web User Interface (UI) and/or HTTP 500 Error is displayed when trying to access DocuShare via the DocuShare Windows Client.
The following error is displayed in the \logs\tomcat.stdOut log file.
ERROR org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/].[dsweb] : Servlet.service() for servlet dsweb threw exception java.lang.OutOfMemoryError: Java heap space
Possible Cause / Reason
Tomcat runs out of memory when third party software like ScanFlowStore or the DocuShare Windows Client (DSClient) application is trying to access a collection with large amount of documents in it. The third party application software and\or the DSClient cannot utilize “paging†therefore needs to load all the property data for the collection and its content into the JVM memory. On extremely large collections, this memory allocation will be exceeded resulting in the out of memory error.
Workaround
Restarting DocuShare will fix the out of memory error and you will be able to access it again until the third party application and\or DSClient is accessing the large collection again. Another workaround is to scanning to a different collection that contains less than 1000 objects.
Solution
Note: Increasing the amount of RAM will not correct this issue.
We recommend no more than 1,000 objects per immediate collection (not including sub-collections) to avoid this problem. Collection(s) with large amount of objects will have to be split into smaller amount by moving the objects into other collections.
As a workaround you can restart DocuShare to fix the out of memory error. This will allow you to access DocuShare again until the third party application and/or DocuShare Client is accessing the large collection again.
Solution Updated: January 28th, 2015
Solution ID: 920