Mercurial > hg > digilib

comparison docu/installation.html @ 159:ef7ffa6853a8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
New version with Windows installation from Martin.
author robcast
date Tue, 16 Sep 2003 21:02:48 +0200
parents 92ddc7d1581d
children
comparison
equal deleted inserted replaced
158:6a8e23273220 159:ef7ffa6853a8
6 6
7 <body> 7 <body>
8 <h1>What you need to install digilib</h1> 8 <h1>What you need to install digilib</h1>
9 9
10 <ul> 10 <ul>
11 <li>Java JDK &gt;1.2 (preferred 1.4 and up)</li> 11 <li><a href="http://java.sun.com/downloads/index.html" >Java JDK</a> &gt;1.2 (preferred 1.4 and up)</li>
12 12
13 <li><a href="http://jakarta.apache.org/tomcat/index.html" >Jakarta 13 <li><a href="http://jakarta.apache.org/tomcat/index.html" >Jakarta
14 Tomcat</a> version 4 or later (preferred 4.1 and up) from 14 Tomcat</a> version 4 or later (preferred 4.1 and up) from
15 <a href="http://jakarta.apache.org<" >http://jakarta.apache.org</a></li> 15 <a href="http://jakarta.apache.org<" >http://jakarta.apache.org</a></li>
16 16
17 <li>The digilib distribution packages (from 17 <li>The digilib distribution packages (from
18 <a href="http://developer.berlios.de" >http://developer.berlios.de</a>) 18 <a href="http://developer.berlios.de" >http://developer.berlios.de</a>)
19 <ul> 19 <ul>
20 <li>alcatraz/digilib scripts and servlets package 20 <li>alcatraz/digilib scripts and servlets package
21 <a href="http://download.berlios.de/digilib/alcatraz-core-0.3.zip"><code>alcatraz-core.zip</code></a></li> 21 <a href="http://download.berlios.de/digilib/alcatraz-core-0.3.zip"><code>alcatraz-core.zip</code></a></li>
22 <li>digilib configuration files for tomcat 4 package 22 <li>digilib configuration files for tomcat 4 package on Linux/Unix
23 <a href="http://download.berlios.de/digilib/alcatraz-tomconf-0.1.zip"><code>alcatraz-tomconf.zip</code></a> (Not essential)</li> 23 <a href="http://download.berlios.de/digilib/digilib-tomconf-1.0.zip"><code>digilib-tomconf.zip</code></a> (Not essential)</li>
24 <li>digilib configuration files for tomcat 4 package on Windows
25 <a href="http://download.berlios.de/digilib/digilib-win-conf-1.0.zip"><code>digilib-win-conf.zip</code></a> (Not essential)</li>
24 </ul> 26 </ul>
25 </li> 27 </li>
26 </ul> 28 </ul>
27 29
28 <h1>Installation</h1> 30 <h1>Installation</h1>
29 31
30 <h2>On Linux</h2> 32 <h2>On Linux/Unix</h2>
31 33
32 <ol> 34 <ol>
33 <li>Make shure the Java JDK is installed (a JRE won't do).</li> 35 <li>Make shure the Java JDK is installed (a JRE won't do).</li>
34 36
35 <li>Create a base directory for docuserver (the default used here is 37 <li>Create a base directory for docuserver (the default used here is
87 <ol> 89 <ol>
88 <li>Get the sources for <code>mod_webapp</code></li> 90 <li>Get the sources for <code>mod_webapp</code></li>
89 </ol> 91 </ol>
90 --> 92 -->
91 93
94 <h2>On Windows (quick install)</h2>
95
96 <p>Set the following Environment Variables:<br />
97 <code>CATALINA_HOME = C:\jakarta-tomcat-4.1.24</code> (or similar)<br />
98 <code>JAVA_HOME = C:\j2sdk</code> (or similar)
99 </p>
100
101 <p>
102 Start Tomcat server: Open a console window (start <code>cmd.exe</code>).<br />
103 Type: <code>%CATALINA_HOME%\bin\startup</code>
104 </p>
105
106 <p>
107 Try the following URL in your browser:
108 <code>http://localhost:8080</code> or
109 <code>http://127.0.0.1:8080</code>
110 </p>
111
112 <p>
113 You should now be able to see the Tomcat opening screen: <em>If you're seeing this page via a web browser, it means you've setup Tomcat successfully. Congratulations!</em>
114 </p>
115
116 <p>
117 Shut it down again: In the console window type <code>%CATALINA_HOME%\bin\shutdown</code>.
118
119 <p>
120 Extract the &quot;Alcatraz&quot; distribution, possibly to <code>C:\docuserver</code>. Modify the following configuration files according to your paths (as in the &quot;On Linux&quot; section):
121 </p>
122
123 <p>For tomcat</p>
124 <ul>
125 <li><code>C:\jakarta-tomcat-4.1.24\conf\server.xml</code></li>
126 <li><code>C:\jakarta-tomcat-4.1.24\conf\tomcat-users.xml</code></li>
127 </ul>
128
129
130 <p>For digilib</p>
131 <ul>
132 <li><code>C:\docuserver\digitallibrary\WEB-INF\web.xml</code></li>
133 <li><code>C:\docuserver\digitallibrary\WEB-INF\digilib-config.xml</code></li>
134 <li><code>C:\docuserver\digitallibrary\WEB-INF\digilib-auth.xml</code></li>
135 </ul>
136
137 <p>In the <code>alcatraz-win-conf.zip</code> package you can find
138 prepared configuration files with the following default values:
139
140 <ul>
141 <li>The image file directory is <code>C:\bilder</code>. </li>
142 <li>The username for viewing image files is <code>digilib</code>.</li>
143 <li>The password for viewing image files is <code>digilib</code>.</li>
144 <li>The digilib server runs on Port <code>9090</code>.</li>
145 </ul>
146
147 <p>
148 Now you can restart the Tomcat server: <code>http://localhost:9090</code> or
149 <code>http://127.0.0.1:9090</code>.</p>
150
151 <p>
152 Watch the images:
153 <code>http://localhost:9090/docuserver/digitallibrary/digilib.jsp?&lv=2</code>
154 </p>
155
156
92 <h1>Configuration</h1> 157 <h1>Configuration</h1>
93 158
94 <h2>Tomcat</h2> 159 <h2>Tomcat</h2>
95 160
96 <h3>catalina.sh</h3> 161 <h3>catalina.sh / catalina.bat</h3>
97 162
98 <p>The file <code>catalina.sh</code> (in <code>/docuserver/tomcat/bin</code> 163 <p>The file <code>catalina.sh</code> (in <code>/docuserver/tomcat/bin</code>
99 can be modified to provide the path to the JDK and runtime options 164 can be modified to provide the path to the JDK and runtime options
100 for the Java VM. Somewhere at the beginning of the file you can put two lines 165 for the Java VM. Somewhere at the beginning of the file you can put two lines
101 like this:</p> 166 like this:</p>
102 167
103 <pre> 168 <pre>
104 export JAVA_HOME=/usr/local/lib/IBMJava2-14 169 export JAVA_HOME=/usr/local/lib/IBMJava2-14
105 export CATALINA_OPTS="-mx512m" 170 export CATALINA_OPTS="-mx512m"
171 </pre>
172
173 <p>or, on Windows<p>
174
175 <pre>
176 set CATALINA_HOME=C:\jakarta-tomcat-4.1.24
177 set JAVA_HOME=C:\j2sdk
106 </pre> 178 </pre>
107 179
108 <p>Adjust the <code>JAVA_HOME</code> path to point to your Java JDK 180 <p>Adjust the <code>JAVA_HOME</code> path to point to your Java JDK
109 installation directory. You can adjust the memory used by the Java VM 181 installation directory. You can adjust the memory used by the Java VM
110 with the <code>-mx</code> option.</p> 182 with the <code>-mx</code> option.</p>
293 and password.</p> 365 and password.</p>
294 366
295 367
296 368
297 <hr> 369 <hr>
298 <address>casties@mpiwg-berlin.mpg.de</address> 370 <address>robert.casties@philo.unibe.ch</address>
299 <!-- hhmts start -->Last modified: Wed May 14 12:49:14 CEST 2003 <!-- hhmts end --> 371 <!-- hhmts start -->Last modified: Tue Sep 16 20:37:12 CEST 2003 <!-- hhmts end -->
300 </body> </html> 372 </body> </html>