r4609 - trunk/docs/user

[daigle at ecoinformatics.org]

Author: daigle
Date: 2008-11-21 10:32:59 -0800 (Fri, 21 Nov 2008)
New Revision: 4609

Modified:
   trunk/docs/user/troubleshooting.html
Log:
Add Tomcat ubuntu apt-get error to troubleshooting guide.

Modified: trunk/docs/user/troubleshooting.html
===================================================================
--- trunk/docs/user/troubleshooting.html	2008-11-21 18:32:18 UTC (rev 4608)
+++ trunk/docs/user/troubleshooting.html	2008-11-21 18:32:59 UTC (rev 4609)
@@ -44,9 +44,10 @@
 <div class="header1">Table of Contents</div>
 <div class="toc">
   <div class="toc1"><a href="#InstallationIssues">Installation Issues</a></div>
-      <div class="toc2"><a href="#Issue1">Issue 1</a></div> 
-      <div class="toc2"><a href="#Issue2">Issue 2</a></div>
+    <div class="toc2"><a href="#Issue1">Issue 1</a></div> 
+    <div class="toc2"><a href="#Issue2">Issue 2</a></div>
   <div class="toc1"><a href="#StartupIssues">Startup Issues</a></div>
+    <div class="toc2"><a href="#Jdk14Logger">Metacat doesn't start and Jdk14Logger exception</a></div> 
   <div class="toc1"><a href="#ConfigurationIssues">Configuration Issues</a></div>
   <div class="toc1"><a href="#GeneralApplicationIssues">General Application Issues</a></div>
   <div class="toc1"><a href="#UnitTestingIssues">Unit Testing Issues</a></div>
@@ -59,7 +60,30 @@
   <p>Issue 2 here</p>
  
 <a name="StartupIssues"></a><div class="header1">Startup Issues</div> 
-
+	<a name="Jdk14Logger"></a><div class="header2">Metacat doesn't start and Jdk14Logger exception</div>
+	<p>The symptoms are that the metacat service will not show up at all, even though Tomcat 
+      is serving, and the following error shows up in the tomcat log (catalina.log):</p>
+      
+      <div class="code">org.apache.commons.logging.LogConfigurationException: User-specified log
+      class 'org.apache.commons.logging.impl.Jdk14Logger' cannot be found or is
+      not useable </div>
+      
+      <p>This message typically occurs in the tomcat log (catalina.log) 
+      when Tomcat has been installed on an Ubuntu/Debian system using apt-get install.  
+      And the application is started using:
+        
+        <div class="code">/etc/init.d/tomcat5.5 start</div>  
+        
+      <p>The problem is that the standard startup scripts reference the 
+      common java service, jsvc.  Metacat will not run under jsvc.  The solutions are:
+      <ul>
+      <li>Download the <a href="http://knb.ecoinformatics.org/software/download.html">Metacat binary install package</a>
+       and replace your /etc/init.d/tomcat5.5 startup script with the one provided in the
+       package.</li>
+      <li>Run Tomcat from the Tomcat binary directory: <tomcat_home>/bin/startup.sh and 
+      <tomcat_home>/bin/shutdown.sh</li>
+      </ul>
+      </p>
 <a name="ConfigurationIssues"></a><div class="header1">Configuration Issues</div>
 
 <a name="GeneralApplicationIssues"></a><div class="header1">General Application Issues</div>