comparison website/tips.html @ 3:9a472dab7e09

more new documentation
author robcast
date Mon, 12 Dec 2011 20:37:53 +0100
parents 8abbc40d0df5
children
comparison
equal deleted inserted replaced
2:8abbc40d0df5 3:9a472dab7e09
10 <tr> 10 <tr>
11 <td bgcolor="#a0a0a0">&nbsp;</td> 11 <td bgcolor="#a0a0a0">&nbsp;</td>
12 <td> 12 <td>
13 <img src="images/digilib-logo-big.png" align="left" /> 13 <img src="images/digilib-logo-big.png" align="left" />
14 <h1> 14 <h1>
15 <tt>digilib</tt> 15 <tt>digilib</tt> -- a versatile image viewing environment for the internet
16 -- a versatile image viewing environment for the internet
17 </h1> 16 </h1>
18 </td> 17 </td>
19 </tr> 18 </tr>
20 <tr> 19 <tr>
21 <td bgcolor="#a0a0a0" valign="top" align="right"> 20 <td bgcolor="#a0a0a0" valign="top" align="right">
22 <p> 21 <p>
23 <b><a href="index.html">Info</a> 22 <b><a href="index.html">Info</a> </b>
24 </b> 23 </p>
25 </p> 24 <p>
26 <p> 25 <b><a href="http://developer.berlios.de/projects/digilib/">Project</a> </b>
27 <b><a href="http://developer.berlios.de/projects/digilib/">Project</a>
28 </b>
29 </p> 26 </p>
30 <p> 27 <p>
31 <b><a href="http://developer.berlios.de/project/showfiles.php?group_id=251">Download</a> 28 <b><a href="http://developer.berlios.de/project/showfiles.php?group_id=251">Download</a>
32 </b> 29 </b>
33 </p> 30 </p>
34 <p> 31 <p>
35 <b><a href="http://developer.berlios.de/docman/?group_id=251">Docs</a> 32 <b><a href="docs.html">Docs</a></b>
36 </b> 33 <br />
37 </p> 34 <a href="build-maven.html">Building</a>
38 <p> 35 <br />
39 <b><a href="tips.html">Tips</a> 36 <a href="digilib-config.html">Configuring</a>
40 </b> 37 <br />
41 </p> 38 <a href="http://developer.berlios.de/docman/?group_id=251">...more</a>
42 <p> 39 </p>
43 <b><a href="http://hg.berlios.de/repos/digilib">Source</a> 40 <p>
44 </b> 41 <b><a href="tips.html">Tips</a> </b>
42 </p>
43 <p>
44 <b><a href="http://hg.berlios.de/repos/digilib">Source</a> </b>
45 </p> 45 </p>
46 </td> 46 </td>
47 <td> 47 <td>
48 48
49 49
54 </li> 54 </li>
55 <li> 55 <li>
56 <a href="#prescaled_images">Prescaled images</a> 56 <a href="#prescaled_images">Prescaled images</a>
57 </li> 57 </li>
58 <li> 58 <li>
59 <a href="installing_jai">Installing JAI</a> 59 <a href="#installing_jai">Installing JAI</a>
60 </li> 60 </li>
61 </ul> 61 </ul>
62 62
63 <h1 id="vm_settings">Java VM settings for digilib</h1> 63 <h1 id="vm_settings">Java VM settings for digilib</h1>
64 64
132 132
133 133
134 <h1 id="installing_jai">Installing JAI</h1> 134 <h1 id="installing_jai">Installing JAI</h1>
135 135
136 <p> 136 <p>
137 In principle you can install the <a 137 In theory you can install the <a
138 href="http://java.sun.com/javase/technologies/desktop/media/jai/" 138 href="http://java.sun.com/javase/technologies/desktop/media/jai/"
139 class="external text" rel="nofollow">Java Advanced Imaging</a> JAR files (and 139 class="external text" rel="nofollow">Java Advanced Imaging</a> and JAI-ImageIO
140 native library files if available) in the /WEB-INF/lib/ directory of the digilib 140 JAR files <code>jai_core.jar, jai_codec.jar, jai_imageio.jar</code> (and native
141 web application. 141 library files if available) in the <code>/WEB-INF/lib/</code> directory of the
142 142 digilib web application.
143 </p> 143 </p>
144 <p>I found that in some cases digilib stopped reading TIFF files after a 144 <p>But there are classloader issues. Newer versions of Tomcat refuse to load
145 period of running. In these cases it helped to install the JAI files directly in 145 the libraries and I found that in some cases digilib stopped reading TIFF files
146 the local Java installation (i.e. in the Java's /jre/lib/ext/ directory on 146 after a period of running.</p>
147 linux).</p> 147 <p>
148 In these cases it helped to install the JAI files in Tomcats <code>lib/</code>
149 directory or Jettys <code>lib/ext/</code> or globally in the local Java JDK
150 installation (i.e. in the Java's /jre/lib/ext/ directory on linux).
151 </p>
148 152
149 153
150 <h1 id="mpiwg_setup">Sample setup</h1> 154 <h1 id="mpiwg_setup">Sample setup</h1>
151 155
152 <p>The current digilib setup at the MPIWG (as of November 2005):</p> 156 <p>The current digilib setup at the MPIWG (as of December 2010):</p>
153 <ul> 157 <ul>
154 <li> 158 <li>
155 One frontend server running the lightweight web-multiplexer <a 159 One frontend server running the lightweight web-multiplexer <a
156 href="http://www.apsis.ch/pound/" class="external text" rel="nofollow">pound</a> 160 href="http://www.apsis.ch/pound/" class="external text" rel="nofollow">pound</a>
157 on port 80 that distributes requests to two servers runnning digilib 161 on port 80 that distributes requests to three servers runnning digilib
158 </li> 162 </li>
159 <li> 163 <li>
160 the two servers run digilib under <a 164 the three servers run digilib under <a
161 href="http://tomcat.apache.org/index.html" class="external text" 165 href="http://www.eclipse.org/jetty/" class="external text"
162 rel="nofollow">Tomcat</a> on port 8080 without Apache 166 rel="nofollow">Jetty</a> on port 8080 without Apache
163 <ul> 167 <ul>
164 <li>one server is the same machine as the frontend server (Linux, Dual 168 <li>one server is the frontend server (Linux 32bit, Dual
165 2.4GHz Xeon, 2GB RAM)</li> 169 2.4GHz Xeon, 2GB RAM)</li>
166 <li>the other server is a separate, newer machine (Linux, Dual 1.8GHz 170 <li>the other server is a separate, newer machine (Linux 64bit, Dual 1.8GHz
167 Opteron, 2GB RAM)</li> 171 Opteron, 2GB RAM)</li>
172 <li>the third server is a separate, newer machine (Linux 32bit, Dual 2.8GHz
173 Xeon, 4GB RAM)</li>
168 </ul> 174 </ul>
169 </li> 175 </li>
170 <li> 176 <li>
171 the digilib instances (digilib 1.5.9c as of 22.11.2005) run on Tomcat on Java 177 the digilib instances (digilib 2.0b1 as of 12.12.2011) run on Jetty 8.0.4 on Java
172 1.5.0_05 (or 1.4.2_06) with 1GB of <a href="#vm_settings">Java VM memory 178 1.6.0_26 with 1GB of <a href="#vm_settings">Java VM memory
173 for digilib</a> (-Xmx1024m) with JAI (1.1.2_01) and JAI-ImageIO (1.0_01) <a 179 for digilib</a> (-Xmx1024m) with JAI (1.1.3) and JAI-ImageIO (1.1) <a
174 href="#installing_jai">installed in the JRE</a>(!) 180 href="#installing_jai">installed in the Jetty/lib/ext</a>(!)
175 </li> 181 </li>
176 <li>both digilib servers access all image files over NFS (over GBit 182 <li>both digilib servers access all image files over NFS (over GBit
177 Ethernet) from a central file server (Solaris 8, Sun Fire 480, multiple RAIDs 183 Ethernet) from a central file server (Solaris 10, Sun Fire 240, multiple RAIDs
178 on Fibrechannel)</li> 184 on Fibrechannel)</li>
179 </ul> 185 </ul>
180 186
181 </td> 187 </td>
182 </tr> 188 </tr>
183 <tr> 189 <tr>
184 <td style="padding: 0px" align="left"> 190 <td style="padding: 0px" align="left">
185 <a href="http://developer.berlios.de"> <img 191 <a href="http://developer.berlios.de"> <img
186 src="http://developer.berlios.de/bslogo.php?group_id=0&type=1" width="124" 192 src="http://developer.berlios.de/bslogo.php?group_id=0&type=1" width="124"
187 height="32" border="0" alt="BerliOS Logo" /> </a> 193 height="32" border="0" alt="BerliOS Logo" />
194 </a>
188 </td> 195 </td>
189 <td></td> 196 <td></td>
190 </tr> 197 </tr>
191 </table> 198 </table>
192 199