comparison src/site/markdown/java-settings.md @ 8:de31af0ad401

more doc for the website.
author casties
date Wed, 04 Sep 2013 09:08:17 +0200
parents cf3abd6ff312
children
comparison
equal deleted inserted replaced
7:cf3abd6ff312 8:de31af0ad401
7 digilib can need a lot of memory depending on the size and type of images. 7 digilib can need a lot of memory depending on the size and type of images.
8 Since digilib runs as a servlet under Tomcat its in the same VM as the Tomcat 8 Since digilib runs as a servlet under Tomcat its in the same VM as the Tomcat
9 server. 9 server.
10 10
11 The amount of memory Tomcat (version 5.0) uses is configured by creating a 11 The amount of memory Tomcat (version 5.0) uses is configured by creating a
12 "setenv.sh" script with a line 12 `setenv.sh` (or `setenbv.bat`) script with a line
13 13
14 CATALINA_OPTS="-Xmx512m" 14 CATALINA_OPTS="-Xmx512m"
15 15
16 in Tomcat's `bin` directory (giving 512MB in this case). 16 in Tomcat's `bin` directory (giving 512MB RAM in this case).
17 17
18 You can check the amount of memory your digilib instance has available on the 18 You can check the amount of memory your digilib instance has available on the
19 bottom of the web page `/server/dlConfig.jsp` in your digilib instance (e.g. 19 bottom of the web page `/server/dlConfig.jsp` in your digilib instance (e.g.
20 [http://digilib.mpiwg-berlin.mpg.de/digitallibrary/server/dlConfig.jsp](http://digilib.mpiwg-berlin.mpg.de/digitallibrary/server/dlConfig.jsp)). 20 <http://localhost:8080/digilib/server/dlConfig.jsp>
21 21
22 # Installing JAI ImageIO 22 # Installing JAI ImageIO
23 23
24 In principle you should be able to install the 24 In principle you should be able to install the
25 [Java Advanced Imaging](http://java.sun.com/javase/technologies/desktop/media/jai/) JAI-ImageIO 25 [Java Advanced Imaging](http://java.sun.com/javase/technologies/desktop/media/jai/) JAI-ImageIO
27 library files if available) in the `/WEB-INF/lib/` directory of the 27 library files if available) in the `/WEB-INF/lib/` directory of the
28 digilib web application as part of the default installation. 28 digilib web application as part of the default installation.
29 29
30 You can see if the Jai-ImageIO plugin is active by checking for the 30 You can see if the Jai-ImageIO plugin is active by checking for the
31 availability of the TIFF image format under "Supported image types" on the 31 availability of the TIFF image format under "Supported image types" on the
32 [`/server/dlConfig.jsp`](http://digilib.mpiwg-berlin.mpg.de/digitallibrary/server/dlConfig.jsp) 32 [`/server/dlConfig.jsp`](http://localhost:8080/digilib/server/dlConfig.jsp)
33 status page. 33 status page.
34 34
35 But sometimes there are classloader issues. Newer versions of Tomcat refuse to load 35 Sometimes there are memory issues. Newer versions of Tomcat refuse to load
36 the libraries and I found that in some cases digilib stopped reading TIFF files 36 the libraries and I found that in some cases digilib stopped reading TIFF files
37 after a period of running. 37 after a period of running. In these cases it helped to install the JAI files in
38 38 Tomcats `lib/` directory or globally in the local Java JDK
39 In these cases it helped to install the JAI files in Tomcats `lib/`
40 directory or globally in the local Java JDK
41 installation (i.e. in the Java's 'jre/lib/ext/' directory on linux). 39 installation (i.e. in the Java's 'jre/lib/ext/' directory on linux).
42 40
43 # Sample setup 41 # Sample setup
44 42
45 The current digilib setup at the MPIWG (as of December 2010): 43 The current digilib setup at the MPIWG (as of December 2010):
46 44
47 * One frontend server running the lightweight web-multiplexer [pound](http://www.apsis.ch/pound/) 45 * One frontend server running the lightweight web-multiplexer [pound](http://www.apsis.ch/pound/)
48 on port 80 that distributes requests to three servers runnning digilib 46 on port 80 that distributes requests to three servers runnning digilib
49 * the three servers run digilib under [Jetty](http://www.eclipse.org/jetty/) on port 8080 without Apache 47 * the three servers run digilib under [Jetty](http://www.eclipse.org/jetty/) on port 8080 without Apache
50 48 * one server is the frontend server (Linux 32bit, Dual 2.4GHz Xeon, 2GB RAM)
51 * one server is the frontend server (Linux 32bit, Dual 49 * the other server is a separate, newer machine (Linux 64bit, Dual 1.8GHz Opteron, 2GB RAM)
52 2.4GHz Xeon, 2GB RAM) 50 * the third server is a separate, newer machine (Linux 32bit, Dual 2.8GHz Xeon, 4GB RAM)
53 * the other server is a separate, newer machine (Linux 64bit, Dual 1.8GHz 51 * the digilib instances (digilib 2.0b1 as of 12.12.2011) run on Jetty 8.0.4 on Java
54 Opteron, 2GB RAM) 52 1.6.0_26 with 1GB of Java VM memory for digilib (-Xmx1024m) with JAI (1.1.3) and JAI-ImageIO (1.1)
55 * the third server is a separate, newer machine (Linux 32bit, Dual 2.8GHz 53 installed in `Jetty/lib/ext`
56 Xeon, 4GB RAM) 54 * both digilib servers access all image files over NFS (over GBit Ethernet) from a central file server
57 * the digilib instances (digilib 2.0b1 as of 12.12.2011) run on Jetty 8.0.4 on Java 55 (Solaris 10, Sun Fire 240, multiple RAIDs on Fibrechannel)
58 1.6.0_26 with 1GB of [Java VM memory
59 for digilib](#vm_settings) (-Xmx1024m) with JAI (1.1.3) and JAI-ImageIO (1.1) [installed in the Jetty/lib/ext](#installing_jai)(!)
60 * both digilib servers access all image files over NFS (over GBit
61 Ethernet) from a central file server (Solaris 10, Sun Fire 240, multiple RAIDs
62 on Fibrechannel)