Issue
DocuShare will not start (most likely after install).
The <dshome>\logs\monitor.log displays a message stating “Waiting for DSWebServlet".
Example:
09 May 2012 11:45:56 [main] INFO - MonitorServerImpl.exportInf: about to create MonitorIConfigurableImpl
09 May 2012 11:45:58 [main] ERROR - MonitorServerImpl.exportInf: failed to init configurable data interface via MonitorServiceControlImpl java.rmi.UnknownHostException: Unknown host: server.domain.com; nested exception is: java.net.UnknownHostException: server.domain.com
09 May 2012 11:45:58 [main] INFO - MonitorServerImpl.connectToPrimary: do we need to look for a primary monitor?
09 May 2012 11:45:58 [main] INFO - MonitorServerImpl.startupSystem: monitor interface exported
09 May 2012 11:45:58 [main] INFO - MonitorServerImpl.startupSystem: run the template service loop
09 May 2012 11:45:58 [main] INFO - MonitorServerImpl.templateServiceLoop: waiting for DSWebServlet
09 May 2012 11:46:03 [main] INFO - MonitorServerImpl.templateServiceLoop: waiting for DSWebServlet
09 May 2012 11:46:08 [main] INFO - MonitorServerImpl.templateServiceLoop: waiting for DSWebServlet
Solutions
1. Possible issue is that DocuShare doesn't recognize the RMI host.
a. Stop Docushare
b. Open a Command Prompt window and change into the <dshome>\bin directory.
Where <dshome> is replaced with the installation directory for DocuShare. Depending on your installation environment the installation path may vary. The default installation path is C:\Xerox\DocuShare.
c. Type dssetup and press Enter.
d. When prompted with the following questiond “Would you want to update the configuration? [yes] ?” type y and press Enter.
e. When prompted with “Host DNS name [docushare.solutions.com] ?” press Enter to accept the value in square brackets.
f. When prompted with “RMI port number [1099] ?”Press Enter to accept the value listed in square brackets.
g. When prompted with “RMI host [docushare.solutions.com] ?” type localhost and press Enter to change the value to localhost.
h. Press Enter to accept the value listed in square brackets for all other settings.
i. Once dssetup completes you will be prompted with the following question “Are you happy with your configuration [yes] ?” press Enter to save your configuration changes.
j. Start DocuShare.
2. Possible issue is that the config files have been renamed to .bak
a. Stop DocuShare
b. Open Windows Explorer and navigate the folder structure into the <dshome>\config directory.
Where <dshome> is replaced with the installation directory for DocuShare. Depending on your installation environment the installation path may vary. The default installation path is C:\Xerox\DocuShare.
c. Look in the config directory for any files with .bak extension.
d. Rename them to .xml or .properties by removing the .bak extension.
Note: Depending on the original type of file the extension will be listed as .properties or .xml.
Example: Amber.properties.bak would be renamed to Amber.properties or ClassIcons.xml.bak would be renamed to ClassIcons.xml.
Warning: Do not overwrite an existing file when renaming. If original filenames already exist then contact support for assistance with this.
e. Start DocuShare.
Solution ID: 746
Keywords: dswebservlet