diff website/tips.html @ 3:9a472dab7e09

more new documentation
author robcast
date Mon, 12 Dec 2011 20:37:53 +0100
parents 8abbc40d0df5
children
line wrap: on
line diff
--- a/website/tips.html	Fri Dec 09 20:33:24 2011 +0100
+++ b/website/tips.html	Mon Dec 12 20:37:53 2011 +0100
@@ -12,36 +12,36 @@
       <td>
         <img src="images/digilib-logo-big.png" align="left" />
         <h1>
-          <tt>digilib</tt>
-          -- a versatile image viewing environment for the internet
+          <tt>digilib</tt> -- a versatile image viewing environment for the internet
         </h1>
       </td>
     </tr>
     <tr>
       <td bgcolor="#a0a0a0" valign="top" align="right">
         <p>
-          <b><a href="index.html">Info</a>
-          </b>
+          <b><a href="index.html">Info</a> </b>
         </p>
         <p>
-          <b><a href="http://developer.berlios.de/projects/digilib/">Project</a>
-          </b>
+          <b><a href="http://developer.berlios.de/projects/digilib/">Project</a> </b>
         </p>
         <p>
           <b><a href="http://developer.berlios.de/project/showfiles.php?group_id=251">Download</a>
           </b>
         </p>
         <p>
-          <b><a href="http://developer.berlios.de/docman/?group_id=251">Docs</a>
-          </b>
+          <b><a href="docs.html">Docs</a></b>
+          <br />
+          <a href="build-maven.html">Building</a>
+          <br />
+          <a href="digilib-config.html">Configuring</a>
+          <br />
+          <a href="http://developer.berlios.de/docman/?group_id=251">...more</a>
         </p>
         <p>
-          <b><a href="tips.html">Tips</a>
-          </b>
+          <b><a href="tips.html">Tips</a> </b>
         </p>
         <p>
-          <b><a href="http://hg.berlios.de/repos/digilib">Source</a>
-          </b>
+          <b><a href="http://hg.berlios.de/repos/digilib">Source</a> </b>
         </p>
       </td>
       <td>
@@ -56,7 +56,7 @@
             <a href="#prescaled_images">Prescaled images</a>
           </li>
           <li>
-            <a href="installing_jai">Installing JAI</a>
+            <a href="#installing_jai">Installing JAI</a>
           </li>
         </ul>
 
@@ -134,47 +134,53 @@
         <h1 id="installing_jai">Installing JAI</h1>
 
         <p>
-          In principle you can install the <a
+          In theory you can install the <a
             href="http://java.sun.com/javase/technologies/desktop/media/jai/"
-            class="external text" rel="nofollow">Java Advanced Imaging</a> JAR files (and
-          native library files if available) in the /WEB-INF/lib/ directory of the digilib
-          web application.
-
+            class="external text" rel="nofollow">Java Advanced Imaging</a> and JAI-ImageIO
+          JAR files <code>jai_core.jar, jai_codec.jar, jai_imageio.jar</code> (and native
+          library files if available) in the <code>/WEB-INF/lib/</code> directory of the
+          digilib web application.
         </p>
-        <p>I found that in some cases digilib stopped reading TIFF files after a
-          period of running. In these cases it helped to install the JAI files directly in
-          the local Java installation (i.e. in the Java's /jre/lib/ext/ directory on
-          linux).</p>
+        <p>But there are classloader issues. Newer versions of Tomcat refuse to load
+          the libraries and I found that in some cases digilib stopped reading TIFF files
+          after a period of running.</p>
+        <p>
+          In these cases it helped to install the JAI files in Tomcats <code>lib/</code>
+          directory or Jettys <code>lib/ext/</code> or globally in the local Java JDK
+          installation (i.e. in the Java's /jre/lib/ext/ directory on linux).
+        </p>
 
 
         <h1 id="mpiwg_setup">Sample setup</h1>
 
-        <p>The current digilib setup at the MPIWG (as of November 2005):</p>
+        <p>The current digilib setup at the MPIWG (as of December 2010):</p>
         <ul>
           <li>
             One frontend server running the lightweight web-multiplexer <a
               href="http://www.apsis.ch/pound/" class="external text" rel="nofollow">pound</a>
-            on port 80 that distributes requests to two servers runnning digilib
+            on port 80 that distributes requests to three servers runnning digilib
           </li>
           <li>
-            the two servers run digilib under <a
-              href="http://tomcat.apache.org/index.html" class="external text"
-              rel="nofollow">Tomcat</a> on port 8080 without Apache
+            the three servers run digilib under <a
+              href="http://www.eclipse.org/jetty/" class="external text"
+              rel="nofollow">Jetty</a> on port 8080 without Apache
             <ul>
-              <li>one server is the same machine as the frontend server (Linux, Dual
+              <li>one server is the frontend server (Linux 32bit, Dual
                 2.4GHz Xeon, 2GB RAM)</li>
-              <li>the other server is a separate, newer machine (Linux, Dual 1.8GHz
+              <li>the other server is a separate, newer machine (Linux 64bit, Dual 1.8GHz
                 Opteron, 2GB RAM)</li>
+              <li>the third server is a separate, newer machine (Linux 32bit, Dual 2.8GHz
+                Xeon, 4GB RAM)</li>
             </ul>
           </li>
           <li>
-            the digilib instances (digilib 1.5.9c as of 22.11.2005) run on Tomcat on Java
-            1.5.0_05 (or 1.4.2_06) with 1GB of <a href="#vm_settings">Java VM memory
-              for digilib</a> (-Xmx1024m) with JAI (1.1.2_01) and JAI-ImageIO (1.0_01) <a
-              href="#installing_jai">installed in the JRE</a>(!)
+            the digilib instances (digilib 2.0b1 as of 12.12.2011) run on Jetty 8.0.4 on Java
+            1.6.0_26 with 1GB of <a href="#vm_settings">Java VM memory
+              for digilib</a> (-Xmx1024m) with JAI (1.1.3) and JAI-ImageIO (1.1) <a
+              href="#installing_jai">installed in the Jetty/lib/ext</a>(!)
           </li>
           <li>both digilib servers access all image files over NFS (over GBit
-            Ethernet) from a central file server (Solaris 8, Sun Fire 480, multiple RAIDs
+            Ethernet) from a central file server (Solaris 10, Sun Fire 240, multiple RAIDs
             on Fibrechannel)</li>
         </ul>
 
@@ -184,7 +190,8 @@
       <td style="padding: 0px" align="left">
         <a href="http://developer.berlios.de"> <img
           src="http://developer.berlios.de/bslogo.php?group_id=0&type=1" width="124"
-          height="32" border="0" alt="BerliOS Logo" /> </a>
+          height="32" border="0" alt="BerliOS Logo" />
+        </a>
       </td>
       <td></td>
     </tr>