-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathinstall_instructions_german.html
executable file
·336 lines (318 loc) · 16.4 KB
/
install_instructions_german.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
<html lang="de">
<head>
<meta charset="UTF-8">
<title>OpenBiblio Installationsanleitung</title>
<style type="text/css">
body {
margin: 0;
background-color: white;
}
.notice {
margin-left: 50px;
margin-right: 50px;
border: solid black 1px;
background: #ffaaaa;
padding: 4px;
}
.new {
margin-left: 50px;
margin-right: 50px;
border: solid black 1px;
background: #ffffaa;
padding: 4px;
}
h1 {
border-bottom: solid black 1px
}
th {
text-align: right
}
</style>
</head>
<body>
<div style="background: #bebdbe"><img src="images/obiblio_logo.gif" width="170" height="35" border="0"></div>
<div style="padding: 8px">
<h1>Index:</h1>
<ul>
<li><a href="#sysReq">Systemvoraussetzungen</a></li>
<li><a href="#install">OpenBiblio 0.7.2.x-g Installationsanleitung (Neues System)</a></li>
<li><a href="#userlogin">Einrichten des Userlogin</a></li>
<li><a href="#update">Update einer früheren Version</a></li>
</ul>
<a name="sysReq">
<h1>Systemvoraussetzungen</h1>
</a>
<ul>
<li>PHP Version 5.5 oder höher und ein Webserver, der dies unterstützt.</li>
<li>MySQL Version 5 oder höher.</li>
<li>Ein moderner Webbrowser.</li>
</ul>
<div class="notice">
Diese Version wird nicht mehr mit älteren Version von PHP und MySQL getestet.
</div>
<br>
<div class="new">
<strong>Oft genutzte Szenarien um ihr System den Anforderungen gerecht zu machen</strong>
<ul>
<li>Linux: Fügen Sie die Software über ihren "Paketmanager" hinzu.</li>
<li>Windows: für eine Einzelplatzlösung oder zu Testzwecken sollte man ein "WAMP"-Paket wie
<a href="http://www.apachefriends.org/de/xampp.html">XAMPP</a> nutzen.
</li>
<li>Download und Installation der benötigten Software: siehe unten.</li>
</ul>
</div>
<a name="install">
<h1>Installationsanleitung</h1>
</a>
<div class="new">
Wenn ihr System schon den Anforderungen entspricht: machen sie weiter bei <a href="#step9">Schritt 9 und
weiter.</a>
</div>
<br>
<div class="new">
Wenn Sie <i>phpMyAdmin</i> zum Einstellen ihrer Datenbank nutzen:
<ul>
<li>Öffnen Sie das SQL-Query Fenster.</li>
<li>Führen Sie dort die SQL-Kommandos aus <a href="#step9">Schritt 9</a> und Schritt 10, die unten
beschrieben sind, aus.
Das Kommando ist der <b>dickgeschriebene</b> Teil direkt hinter
<pre>mysql></pre>
</li>
<li>Springen Sie zu <a href="#step12">Schritt 12</a> und beenden Sie die Prozedur.</li>
</ul>
</div>
<h3>Prozedur</h3>
<div class="notice">Schritte 1-8: Die Details sind eventuell etwas veraltet, aber die Grundlagen sind trotzdem
gültig.
</div>
<ol>
<li>Um ihr System für OpenBiblio zu nutzen müssen Sie einen WebServer, PHP und MySQL installiert haben. Wenn Sie
dieses nicht schon haben wird empfohlen für diese Installation <a
href="http://www.apachefriends.org/de/xampp.html">XAMPP</a> zu nutzen, dieses bietet Ihnen mit einer
Installation alle benötigten Programme (außer Openbiblio selber natürlich). XAMPP gibt es für <a
href="http://www.apachefriends.org/de/xampp-windows.html">Windows</a>, <a
href="http://www.apachefriends.org/de/xampp-linux.html">Linux</a>, <a
href="http://www.apachefriends.org/de/xampp-macosx.html">MacOS X</a> und <a
href="http://www.apachefriends.org/de/xampp-solaris.html">Solaris</a>.
</li>
<li>Laden Sie die für ihr System benötigte Version von <a href="http://www.apachefriends.org/de/xampp.html">XAMPP</a>
herunter. Installieren Sie anschließend das heruntergeladene XAMPP (die
Installation wird auf der Seite der entsprechenden XAMPP-Version auf deutsch genau beschrieben und daher
hier nicht weiter erklärt, aber lesen Sie bitte am besten alles dort durch. Starten sie nun XAMPP, nach
der dort beschriebenen Methode und schon haben Sie Apache, PHP, MySQL und phpMyAdmin laufen. Fahren Sie nun
mit der
Einrichtung von OpenBiblio unter Punkt 7 fort!
</li>
<li>Die folgenden Punkte 4-6 müssen Sie nur durchführen, falls Sie XAMPP nicht installiert haben bzw. nicht
konnten (oder es aus welchen Gründen auch immer nicht lief):
</li>
<li>Die folgenden Punkte beschreiben das Einrichten von OpenBiblio und müssen von allen ausgeführt werden, die
OpenBiblio das erste Mal installieren (egal ob sie XAMPP nutzen oder Apache, PHP, MySQL anders installiert
haben):
</li>
<li>Machen Sie sich vertraut mit dem einloggen unter MySQL aus dem DOS Promt heraus (oder vom Linuxprompt). Am
besten nutzen Sie folgende Befehlsequenz.
<blockquote>
<pre>
C:\><b>c:\mysql\bin\mysql -u root -p</b>
Enter password: <b>*********</b>
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 8 to server version: 3.23.26-beta
Type 'help;' or '\h' for help. Type '\c' to clear the buffer
mysql> <b>show databases;</b>
+--------------+
| Database |
+--------------+
| mysql |
+--------------+
6 rows in set (0.00 sec)
mysql> <b>exit</b>
Bye
C:\>
</pre>
</blockquote>
</li>
<a name="step9">
<li>Erstellen Sie die OpenBiblio Datenbank. Um dies zu tun, loggen Sie sich in MySQL mit dem AdminAccount
ein (wie oben beschrieben) und führen sie folgendes SQL Kommando aus.
<blockquote><pre>
mysql> <b>create database OpenBiblio /*!40100 default character set latin1 */;</b>
</pre>
<div class="new">
<strong>Neu:</strong> Der bedingte Kommentar <b><tt>/* ... */ </tt></b>wird in MySQL 4.1.0 oder
höher ausgeführt und spezifiziert <tt>latin1</tt> als Standard-Datenbank Zeichensatz für die
Datenbank, die erstellt wird.
</div>
<br>
<div class="notice">
Sie könnten eventuell Probleme bekommen, wenn der Datenbank Zeichensatz nicht auf
<tt>latin1</tt> gestellt wird.
<table border="1">
<th>Datenbank Zeichensatz</th>
<th>Registerkarte Admin: Bibliothekseinstellunegn, Feld <i>HTML Zeichensatz</i></th>
<th>Kommentar</th>
<tr>
<td>latin1<br><i>(empfohlen)</i></td>
<td>iso-8859-1<br><i>(Initialwert, von der Installation gesetzt)</i></td>
<td>Keine Probleme.</i></td>
</tr>
<tr>
<td>utf8</td>
<td>UTF-8</td>
<td>Probleme bei Multibyte Zeichen
<ul>
<li>Suche?</li>
<li>PDF Layouts</li>
</ul>
</td>
</tr>
</table>
</div>
<br>
<div class="new">
<strong>Neu:</strong> Wenn der OpenBiblio HTML Zeichensatz auf UTF-8 gestellt ist, können PDF
Layouts einige Multibyte Zeichen korrekt anzeigen, indem diese in Single Byte konvertiert
werden.
</div>
<br>
Um zu überprüfen, ob die Datenbank wirklich angelegt wurde führen Sie folgendes Kommando aus.
<pre>
mysql> <b>show databases;</b>
+--------------+
| Database |
+--------------+
| mysql |
| OpenBiblio |
+--------------+
</pre>
</blockquote>
</li>
</a>
<a name="step10">
<li>Erstellen Sie den OpenBiblio Datenbank-Benutzer. Um dies zu tun loggen sie sich in MySQL mit dem
adminAccount ein und führen Sie folgendes Kommando aus, wobei Sie <i>obiblio_user</i> und <i>obiblio_password</i>
mit einem Usernamen und einem Passwort ihrer Wahl ersetzen.
<blockquote>
<table>
<tr>
<td><pre>mysql>
-> </pre>
</td>
<td><pre><b>grant all privileges on OpenBiblio.* to <i>obiblio_user</i>@localhost</b></b>
<b>identified by '<i>obiblio_password</i>';</pre>
</td>
</tr>
</table>
</blockquote>
</li>
</a>
<li>Prüfen Sie ihre Datenbank und den Benutzer, indem Sie sich als Benutzer einloggen.
<blockquote><pre>
<b>C:\mysql\bin\mysql -u<i>obiblio_user</i> -p<i>obiblio_password</i> OpenBiblio</b>
</pre>
</blockquote>
</li>
<a name="step11">
<li>Kopieren Sie das openbiblio-Verzeichnis und seinen gesamten Inhalt in das htdocs-Verzeichnis oder einen
Unterordner ihres htdocs-Verzeichnis ihres Webservers.
</li>
</a>
<a name="step12">
<li>Bearbeiten sie die Datei database_constants.php (befindet sich im Hauptverzeichniss von openbiblio) mit
einem Texteditor ihrer Wahl.
Ändern sie den Username und das Passwort auf den neu erstellten MySQL-Benutzer und dessen Passwort (den
sie im vorigen Schritt erstellt haben).
</li>
</a>
<li>Erstellen sie die OpenBiblio Tabellen. Um dies zu machen führen Sie das Install-Skript aus, welches Sie mit
<a href="http://localhost/openbiblio/install/index.php">http://localhost/openbiblio/install/index.php</a>
aufrufen können, wobei ich davon ausgehe, daß sie das openbiblio-Verzeichniss in das htdocs-Verzeichniss
ihres Webservers kopiert haben.
</li>
<li><strong>Für die Sicherheit:</strong> Entfernen Sie das Verzeichniss openbiblio/install komplett um
unbefugten Zugriff auf die install- oder update-Tools zu verhindern.
</li>
<li><strong>Für die Sicherheit:</strong> Prüfen Sie, dass die <tt>display_errors</tt> Einstellung in der php.ini
ist 'Off' um zu verhindern, dass ungeprüfte Informationen angezeigt werden.
</li>
<li>Greifen Sie auf ihre neue Bibliothekssoftware unter <a href="http://localhost/openbiblio/index.html">http://localhost/openbiblio/index.html</a>
zu, wobei ich davon ausgehe, daß sie das openbiblio-Verzeichniss in das htdocs-Verzeichniss ihres Webservers
kopiert haben.
Geben Sie zum einloggen "admin" als Username und als Passwort ein, sobald sie sich einloggen müssen. Sie
können das Admin-Passwort ändern in der "Admin"-Registerkarte unter Mitarbeiter, wo Sie auch neue
Mitarbeiter hinzufügen können.
</li>
</ol>
<br>
<a name="userlogin">
<h1>Einrichten des Userlogin:</h1>
<p>Beim Userlogin habe ich versucht eine Version zu programmieren, die nicht die bisherige Datenbankstruktur
anfässt oder erweitert, damit auch weiterhin Updates der deutschen Version zur englischen Originalversion
möglich sind und die Datenbankeinträge die gleichen bleiben. Daher habe ich einige Funktionen, die
openbiblio schon hat für diese neue Funktionalität benutzt. Aus diesem Grund war es mir aber auch nicht
möglich eine echte Passwortfunktion zu verwenden, sondern nur ein Geheimwort (welches aber im Klartext in
der Datenbank gespeichert wird und vom Bibliothekar auch im Klartext lesbar ist).</p>
<p>Im folgenden wird erklärt, wie man das Userlogin (ab Version 0.7.2g) einrichtet, da es ohne diese zusätzliche
Einrichtung nicht funktioniert</p>
<ol>
<li>In Openbiblio unter <a href="http://localhost/openbiblio/index.html">http://localhost/openbiblio/index.html</a>
einloggen und dort in den Admin-Bereich wechseln.
</li>
<li>Hier in den Bereich Mitgliederfelder wechseln und dort ein neues spezifisches Feld hinzufügen.
</li>
<li>Das neue Feld muss unbedingt als Kennzeichen "secret" benannt werden. In der Beschreibung können Sie die
Bezeichnung selber wählen, ich selber verwende hier "Geheimes Wort". Das Ganze anschliessend
übermitteln.
</li>
<li>Ab jetzt ist unter <a href="http://localhost/openbiblio/opac/index.html">http://localhost/openbiblio/opac/index.html</a>
das Benutzerlogin freigeschaltet.
</li>
<li>In den Benutzerinfos eines Mitglieds kann man ab nun das Geheime Wort hinterlegen. Sobald dies
hinterlegt ist kann sich dieses Mitglied unter <a href="http://localhost/openbiblio/opac/loginform.php">http://localhost/openbiblio/opac/loginform.php</a>
unter Angabe der Benutzernummer und des Geheimwort einloggen und seine Medien verlängern bzw.
Vorbestellungen vornehmen. Wenn ein Mitglied kein Geheimwort hinterlegt hat erscheint hier die Info,
dass er ein Geheimes Wort hinterlegen lassen muss.
</li>
</ol>
</a>
<br>
<a name="update">
<h1>Update einer früheren Version:</h1>
<ol>
<li>Benennen Sie ihr altes openbiblio-Verzeichniss um, so dass der Inhalt nicht verloren geht. Wir nennen
hier das alte Verzeichnis openbiblio-old.
</li>
<li>Kopieren Sie das neue openbiblio-Verzeichnis und seinen Inhalt in ein Verzeichnis, das benannt werden
sollte, wie das alte vorher hieß.
</li>
<li>Kopieren Sie die Datei database_constants.php aus dem openbiblio-old Verzeichnis in das neue
openbiblio-Verzeichnis, indem Sie die Datei database_constants.php darin ersetzen.
</li>
<li>Erstellen sie unbedingt ein Backup ihrer Datenbank. Lesen Sie dazu die MySQL Dokumentation für eine
Anleitung. (mysqldump benutzen)
</li>
<li>Updaten Sie die OpenBiblio-Datenbank-Tabellen, indem Sie das Konversions-Tool nutzen, welches sie unter
<a href="http://localhost/openbiblio/install/index.php">http://localhost/openbiblio/install/index.php</a>
finden, wobei ich davon ausgehe, daß sie das openbiblio-Verzeichniss in das htdocs-Verzeichniss ihres
Webservers kopiert haben. Wenn es auf einem entfernten Server installiert ist, ist auch der erste Teil
der Adresse unterschiedlich. Wenn die Tabellen schon OK sind dann sagt das Tool: nein
</li>
<li><strong>Für die Sicherheit:</strong> Entfernen Sie das Verzeichniss openbiblio/install komplett um
unbefugten Zugriff auf die install- oder update-Tools zu verhindern. Falls vorhanden entfernen Sie auch
das openbiblio/tests-Verzeichniss
</li>
<li><strong>Für die Sicherheit:</strong> Prüfen Sie, dass die <tt>display_errors</tt> Einstellung in der
php.ini ist 'Off' um zu verhindern, dass ungeprüfte Informationen angezeigt werden.
</li>
</ol>
<div class="notice">
<strong>Updates von 0.7.0:</strong> 0.7.2.2g ist ein Bugfix für 0.7.x: es funktioniert ohne, dass sie die
Datenbank upgraden. Trotz alledem wird Schritt 5 empfohlen. Dieses bereinigt ungenutzte Einträge aus der
Datenbank und entfernt einige Restriktionen.
<strong>Updates von 0.7.1:</strong> 0.7.2.2g ist ein Bugfix für 0.7.x: es funktioniert ohne, dass sie die
Datenbank upgraden.
</div>
</a>
</div>
</body>
</html>