Waiting for DSWebServlet

Issue

DocuShare will not start

The following message is displayed in the <dshome>\logs\Monitor.log file.

Waiting for DSWebServlet

The following message is displayed in the <dshome>\logs\Tomcat.log file.

ERROR org.apache.catalina.core.ContainerBase.[Catalina] - Exception looking up UserDatabase under key UserDatabase

javax.naming.NamingException: Content is not allowed in prolog.

Reason/Cause

The <dshome>\tomcat\conf\tomcat-users.xml file has been corrupted or is empty.

Solution

Modify the <dshome>\tomcat-user.xml file.

To modify the tomcat-user.xml file:

1.     Stop DocuShare.

2.     Open Windows Explorer and browse to the <dshome>\tomcat\conf directory.

Where <dshome> is the installation directory for DocuShare.  The default installation path during install is C:\Xerox\Docushare.  Depending on your installation environment the path may vary.

3.     Make a copy of the tomcat-user.xml file and rename it tomcat-user.xml.orig.

4.     Open the tomcat-user.xml file in a text editor.

5.     Verify the following entries are listed in the file.  If they are not then add them.

<?xml version='1.0' encoding='utf-8'?>

<tomcat-users>

</tomcat-users>

Example of the entire contents of the file:

<?xml version='1.0' encoding='utf-8'?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->
<tomcat-users>
<!--
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="role1" password="tomcat" roles="role1"/>
-->
</tomcat-users>

6.     Save the file.

7.     Start DocuShare.

Solution Published:  February 26^th, 2014

Solution ID:   808