Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 4c24a5f4

Von Sven Schöling vor mehr als 14 Jahren hinzugefügt

  • ID 4c24a5f44bf065a820ec1a540334ebd48446ac04
  • Vorgänger 32afa3f4
  • Nachfolger 238d4f5f

Dokumentation komplett nach utf8 konvertiert.

Unterschiede anzeigen:

doc/INSTALL.texi
1 1
\input texinfo   @c -*-texinfo-*-
2 2
@c %**start of header
3
@documentencoding ISO-8859-15
3
@documentencoding UTF-8
4 4
@setfilename INSTALL.info
5 5
@settitle Lx-Office Installationsanleitung
6 6
@c %**end of header
......
23 23

  
24 24
@menu
25 25
* Aktuelle Hinweise:: Andere Informationsquellen als diese Anleitung
26
* Ben?tigte Software und Pakete:: Vorraussetzungen zum Betrieb von Lx-Office
26
* Benötigte Software und Pakete:: Vorraussetzungen zum Betrieb von Lx-Office
27 27
* Installation des Programmpaketes:: Installationsort, Berechtigungen
28 28
* Anpassung der PostgreSQL-Konfiguration:: Verschiedene Aspekte der Datenbankkonfiguration
29
* Apache-Konfiguration:: Einrichtung eines Aliases und Optionen f?r das Ausf?hren von CGI-Scripten
30
* Benutzerauthentifizierung und Administratorpasswort:: Einrichtung der Authentifizierungsdatenbank und der Passwort?berpr?fung
29
* Apache-Konfiguration:: Einrichtung eines Aliases und Optionen für das Ausführen von CGI-Scripten
30
* Benutzerauthentifizierung und Administratorpasswort:: Einrichtung der Authentifizierungsdatenbank und der Passwortüberprüfung
31 31
* Benutzer- und Gruppenverwaltung:: Einrichten von Benutzern, Gruppen und Datenbanken
32 32
* OpenDocument-Vorlagen:: Wichtige Hinweise zum Erstellen und zur Verwendung von Dokumentenvorlagen
33 33
* Lx-Office ERP verwenden:: Die URLs zur Anmeldung und Administration
......
53 53

  
54 54
@c ---------------------------------------------------------------
55 55

  
56
@node Ben?tigte Software und Pakete
57
@chapter Ben?tigte Software und Pakete
56
@node Benötigte Software und Pakete
57
@chapter Benötigte Software und Pakete
58 58

  
59
Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) ben?tigt.
59
Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) benötigt.
60 60

  
61
Zus?tzlich ben?tigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind:
61
Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind:
62 62

  
63 63
@itemize
64 64
@item
......
89 89
Email::Address
90 90
@end itemize
91 91

  
92
Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders hei?en.
92
Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
93 93

  
94
F?r Debian oder Ubuntu ben?tigen Sie diese Pakete:
94
Für Debian oder Ubuntu benötigen Sie diese Pakete:
95 95

  
96 96
@code{apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl libyaml-perl libtext-csv-xs-perl libio-stringy-perl libtemplate-perl lib-uriperl libxml-simple-perl}
97 97

  
98
F?r Fedora Core ben?tigen Sie unter anderem diese Pakete:
98
Für Fedora Core benötigen Sie unter anderem diese Pakete:
99 99

  
100 100
@code{httpd postgresql-server perl-DBI perl-DBD-Pg}
101 101

  
102
F?r OpenSuSE ben?tigen Sie diese Pakete:
102
Für OpenSuSE benötigen Sie diese Pakete:
103 103

  
104 104
@code{apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy perl-Template-Toolkit perl-URI perl-XML-Writer}
105 105

  
106
Einige Module werden von Lx-Office ben?tigt, sind aber evtl. nicht als
106
Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als
107 107
Distributionspakete vorhanden, und/oder nicht praktikabel zu installieren.
108
In diesen F?llen liefert Lx-Office das Paket mit, und l?dt es als Fallback.
108
In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback.
109 109

  
110
Lx-Office enth?lt ein Script, mit dem ?berpr?ft werden kann, ob alle
111
ben?tigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:
110
Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle
111
benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:
112 112

  
113 113
@code{./scripts/installation_check.pl}
114 114

  
......
125 125
@*
126 126
tar xvzf lxoffice-erp-2.6.1beta1.tgz}
127 127

  
128
Ver?ndern Sie evtl. noch den Namen des Verzeichnisses mit
128
Verändern Sie evtl. noch den Namen des Verzeichnisses mit
129 129

  
130 130
@code{mv lxoffice-erp/ lx-erp/}
131 131

  
132
Alternativ k?nnen Sie auch einen Alias in der Webserverkonfiguration
133
benutzen, um auf das tats?chliche Installationsverzeichnis zu
132
Alternativ können Sie auch einen Alias in der Webserverkonfiguration
133
benutzen, um auf das tatsächliche Installationsverzeichnis zu
134 134
verweisen.
135 135

  
136
Die Verzeichnisse @code{users}, @code{spool} und @code{webdav} m?ssen
137
f?r den Benutzer beschreibbar sein, unter dem der Webserver l?uft. Die
138
restlichen Dateien m?ssen f?r diesen Benutzer lesbar sein. Der
136
Die Verzeichnisse @code{users}, @code{spool} und @code{webdav} müssen
137
für den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
138
restlichen Dateien müssen für diesen Benutzer lesbar sein. Der
139 139
Benutzername ist bei verschiedenen Distributionen unterschiedlich
140 140
(z.B. bei Debian/Ubuntu @code{www-data}, bei Fedora core @code{apache}
141 141
oder bei OpenSuSE @code{wwwrun}).
142 142

  
143
Der folgende Befehl ?ndert den Besitzer f?r die oben genannten
143
Der folgende Befehl ändert den Besitzer für die oben genannten
144 144
Verzeichnisse auf einem Debian/Ubuntu-System:
145 145

  
146 146
@code{chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav}
147 147

  
148
Weiterhin muss der Webserver-Benutzer im Verzeichnis @code{templates} Verzeichnisse f?r
149
jeden neuen Benutzer, der in lx-office angelegt wird, anlegen d?rfen:
148
Weiterhin muss der Webserver-Benutzer im Verzeichnis @code{templates} Verzeichnisse für
149
jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen:
150 150

  
151 151
@code{chgrp www-data lx-office-erp/templates; chmod g+w lx-office-erp/templates}
152 152

  
......
159 159
PostgreSQL muss auf verschiedene Weisen angepasst werden.
160 160

  
161 161
@menu
162
* Zeichens?tze/die Verwendung von UTF-8:: Was bei der Verwendung von UTF-8 zu beachten ist
163
* ?nderungen an Konfigurationsdateien:: Anpassungen f?r Anmeldung am Server und Featureunterst?tzung
164
* Erweiterung f?r servergespeicherte Prozeduren:: Lx-Office benutzt servergespeicherte Prozeduren
162
* Zeichensätze/die Verwendung von UTF-8:: Was bei der Verwendung von UTF-8 zu beachten ist
163
* Änderungen an Konfigurationsdateien:: Anpassungen für Anmeldung am Server und Featureunterstützung
164
* Erweiterung für servergespeicherte Prozeduren:: Lx-Office benutzt servergespeicherte Prozeduren
165 165
* Datenbankbenutzer anlegen:: Um den Zugriff besser zu reglementieren
166 166
@end menu
167 167

  
168
@node Zeichens?tze/die Verwendung von UTF-8
169
@section Zeichens?tze/die Verwendung von UTF-8
168
@node Zeichensätze/die Verwendung von UTF-8
169
@section Zeichensätze/die Verwendung von UTF-8
170 170

  
171 171
Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet
172 172
werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in
......
174 174
PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale
175 175
angelegt worden sein.
176 176

  
177
Dieses ist kann ?berpr?ft werden: ist das Encoding der Datenbank
177
Dieses ist kann überprüft werden: ist das Encoding der Datenbank
178 178
``template1'' ``UTF8'', so kann auch Lx-Office mit UTF-8 betrieben
179 179
werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit
180 180
UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und
......
182 182

  
183 183
@code{pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername}
184 184

  
185
Die Datenbankversionsnummer muss an die tats?chlich verwendete
185
Die Datenbankversionsnummer muss an die tatsächlich verwendete
186 186
Versionsnummer angepasst werden.
187 187

  
188
Unter anderen Distributionen gibt es ?hnliche Methoden.
188
Unter anderen Distributionen gibt es ähnliche Methoden.
189 189

  
190 190
Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist
191
ein Neuanlegen eines weiteren Clusters nicht m?glich, so kann
191
ein Neuanlegen eines weiteren Clusters nicht möglich, so kann
192 192
Lx-Office mit ISO-8859-15 als Encoding betrieben werden.
193 193

  
194
Das Encoding einer Datenbank kann in @code{psql} mit @code{\l} gepr?ft werden.
194
Das Encoding einer Datenbank kann in @code{psql} mit @code{\l} geprüft werden.
195 195

  
196
@node ?nderungen an Konfigurationsdateien
197
@section ?nderungen an Konfigurationsdateien
196
@node Änderungen an Konfigurationsdateien
197
@section Änderungen an Konfigurationsdateien
198 198

  
199 199
In der Datei @code{postgresql.conf}, die je nach Distribution in
200 200
verschiedenen Verzeichnissen liegen kann
201 201
(z.B. @code{/var/lib/pgsql/data/} oder @code{/etc/postgresql/}, muss
202
sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. F?r
202
sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Für
203 203
PostgreSQL vor Version v8.0 lautete dieser Parameter
204 204

  
205 205
@code{TCPIP_SOCKET = 1}
206 206

  
207
Ab v8.0 wird das Verhalten hingegen ?ber den neuen Parameter
207
Ab v8.0 wird das Verhalten hingegen über den neuen Parameter
208 208
@code{listen_address} gesteuert. Laufen PostgreSQL und Lx-Office auf
209 209
demselben Rechner, so kann dort der Wert @code{localhost} verwendet
210
werden. Andernfalls m?ssen Datenbankverbindungen auch von anderen
210
werden. Andernfalls müssen Datenbankverbindungen auch von anderen
211 211
Rechnern aus zugelassen werden, was mit dem Wert \@code{*} geschieht.
212 212

  
213 213
In der Datei @code{pg_hba.conf}, die im gleichen Verzeichnis wie die
214
@code{postgresql.conf} zu finden sein sollte, m?ssen die
215
Berichtigungen f?r den Zugriff ge?ndert werden. Hier gibt es mehrere
216
M?glichkeiten. Eine besteht darin, lokale Verbindungen immer
214
@code{postgresql.conf} zu finden sein sollte, müssen die
215
Berichtigungen für den Zugriff geändert werden. Hier gibt es mehrere
216
Möglichkeiten. Eine besteht darin, lokale Verbindungen immer
217 217
zuzulassen
218 218

  
219 219
@code{local all all trust
220 220
@*
221 221
host all all 127.0.0.1 255.0.0.0 trust}
222 222

  
223
Besser ist es, f?r eine bestimmte Datenbank Zugriff nur per Passwort
223
Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort
224 224
zuzulassen. Beispielsweise:
225 225

  
226 226
@code{local   all         lxoffice                                           password
......
229 229

  
230 230
@c ---------------------------------------------------------------
231 231

  
232
@node Erweiterung f?r servergespeicherte Prozeduren
233
@section Erweiterung f?r servergespeicherte Prozeduren
232
@node Erweiterung für servergespeicherte Prozeduren
233
@section Erweiterung für servergespeicherte Prozeduren
234 234

  
235
In der Datenbank @code{template1} muss die Unterst?tzung f?r
235
In der Datenbank @code{template1} muss die Unterstützung für
236 236
servergespeicherte Prozeduren eingerichet werden. Melden Sie sich
237
daf?r als Benutzer ``postgres'' an der Datenbank an, und f?hren Sie
237
dafür als Benutzer ``postgres'' an der Datenbank an, und führen Sie
238 238
die folgenden Kommandos aus:
239 239

  
240 240
@code{create function plpgsql_call_handler () returns opaque as '/usr/lib/pgsql/plpgsql.so' language 'c';
......
255 255

  
256 256
Wenn Sie nicht den Datenbanksuperuser ``postgres'' zum Zugriff
257 257
benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer
258
anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen k?nnen:
258
anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen können:
259 259

  
260 260
@code{su - postgres
261 261
@*
262 262
createuser -d -P lxoffice}
263 263

  
264
Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern Sie
264
Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie
265 265
den evtl. voreingestellten Benutzer ``postgres'' auf ``lxoffice''
266
bzw. den hier gew?hlten Benutzernamen.
266
bzw. den hier gewählten Benutzernamen.
267 267

  
268 268
@c ---------------------------------------------------------------
269 269

  
......
272 272

  
273 273
Der Zugriff auf das Programmverzeichnis muss in der Apache
274 274
Webserverkonfigurationsdatei @code{httpd.conf} eingestellt
275
werden. F?gen Sie den folgenden Abschnitt dieser Datei oder einer
275
werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer
276 276
anderen Datei hinzu, die beim Starten des Webservers eingelesen wird:
277 277

  
278 278
@code{@*
......
304 304
Plus @samp{+} gesetzt werden.
305 305

  
306 306
Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets
307
nicht ausgeliefert. In solchen F?llen hat es oft geholfen, die
307
nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die
308 308
folgende Option in die Konfiguration aufzunehmen:
309 309

  
310 310
@code{EnableSendfile Off}
......
314 314
@node Benutzerauthentifizierung und Administratorpasswort
315 315
@chapter Benutzerauthentifizierung und Administratorpasswort
316 316

  
317
Informationen ?ber die Einrichtung der Benutzerauthentifizierung, ?ber
317
Informationen über die Einrichtung der Benutzerauthentifizierung, über
318 318
die Verwaltung von Gruppen und weitere Einstellungen
319 319

  
320 320
@menu
321
* Grundlagen zur Benutzerauthentifizierung:: Verf?gbare Methoden, Name der Konfigurationsdatei
321
* Grundlagen zur Benutzerauthentifizierung:: Verfügbare Methoden, Name der Konfigurationsdatei
322 322
* Administratorpasswort:: Wo das Administratorpasswort gesetzt werden kann
323 323
* Authentifizierungsdatenbank:: Verbindungseinstellungen zur Authentifizierungsdatenbank
324
* Passwort?berpr?fung:: Einstellungen zur ?berpr?fung der Benutzerpassw?rter
325
* Name des Session-Cookies:: ?ndern des Cookie-Namens bei Verwendung mehrerer Lx-Office-Installationen auf einem Server
324
* Passwortüberprüfung:: Einstellungen zur Überprüfung der Benutzerpasswörter
325
* Name des Session-Cookies:: Ändern des Cookie-Namens bei Verwendung mehrerer Lx-Office-Installationen auf einem Server
326 326
* Anlegen der Authentifizierungsdatenbank:: Wie die Authentifizierungsdatenbank angelegt wird
327 327
@end menu
328 328

  
......
332 332
@section Grundlagen zur Benutzerauthentifizierung
333 333

  
334 334
Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die
335
im folgenden ``Authentifizierungsdatenbank'' genannt wird. F?r jeden
336
Benutzer kann dort eine eigene Datenbank f?r die eigentlichen
337
Finanzdaten hinterlegt sein. Diese beiden Datenbanken k?nnen, m?ssen
335
im folgenden ``Authentifizierungsdatenbank'' genannt wird. Für jeden
336
Benutzer kann dort eine eigene Datenbank für die eigentlichen
337
Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen
338 338
aber nicht unterschiedlich sein.
339 339

  
340
Im einfachsten Fall gibt es f?r Lx-Office nur eine einzige Datenbank,
340
Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank,
341 341
in der sowohl die Benutzerinformationen als auch die Daten abgelegt
342 342
werden.
343 343

  
344
Zus?tzlich erm?glicht es Lx-Office, dass die Benutzerpassw?rter
344
Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter
345 345
entweder gegen die Authentifizierungsdatenbank oder gegen einen
346
LDAP-Server ?berpr?ft werden.
346
LDAP-Server überprüft werden.
347 347

  
348
Welche Art der Passwort?berpr?fung Lx-Office benutzt und wie Lx-Office
348
Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office
349 349
die Authentifizierungsdatenbank erreichen kann, wird in der
350 350
Konfigurationsdatei @code{config/authentication.pl} festgelegt. Diese
351 351
muss bei der Installation und bei einem Upgrade von einer Version vor
......
358 358

  
359 359
Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt wird,
360 360
wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort und nicht
361
mehr im Administrationsinterface selber ge?ndert werden. Der Parameter dazu
362
hei?t @code{$self->@{admin_password@}}.
361
mehr im Administrationsinterface selber geändert werden. Der Parameter dazu
362
heißt @code{$self->@{admin_password@}}.
363 363

  
364 364
@node Authentifizierungsdatenbank
365 365
@section Authentifizierungsdatenbank
......
378 378
@item
379 379
@samp{user} -- Der Benutzername, mit dem sich Lx-Office beim Datenbankserver anmeldet (z.B. ``postgres'')
380 380
@item
381
@samp{password} -- Das Passwort f?r den Datenbankbenutzer
381
@samp{password} -- Das Passwort für den Datenbankbenutzer
382 382
@end itemize
383 383

  
384 384
Die Datenbank muss noch nicht existieren. Lx-Office kann sie
385 385
automatisch anlegen (mehr dazu siehe unten).
386 386

  
387
@node Passwort?berpr?fung
388
@section Passwort?berpr?fung
387
@node Passwortüberprüfung
388
@section Passwortüberprüfung
389 389

  
390
Lx-Office unterst?tzt Passwort?berpr?fung auf zwei Arten: gegen die
390
Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die
391 391
Authentifizierungsdatenbank und gegen einen externen LDAP- oder
392 392
Active-Directory-Server. Welche davon benutzt wird, regelt der
393 393
Parameter @code{$self->@{module@}}.
394 394

  
395
Sollen die Benutzerpassw?rter in der Authentifizierungsdatenbank
395
Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank
396 396
gespeichert werden, so muss der Parameter @code{$self->@{module@}} den
397
Wert @samp{DB} enthalten. In diesem Fall k?nnen sowohl der
398
Administrator als auch die Benutzer selber ihre Psasw?rter in
399
Lx-Office ?ndern.
397
Wert @samp{DB} enthalten. In diesem Fall können sowohl der
398
Administrator als auch die Benutzer selber ihre Psaswörter in
399
Lx-Office ändern.
400 400

  
401 401
Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt
402 402
werden, so muss der Parameter @code{$self->@{module@}} auf @samp{LDAP}
403
gesetzt werden. In diesem Fall m?ssen zus?tzliche Informationen ?ber
403
gesetzt werden. In diesem Fall müssen zusätzliche Informationen über
404 404
den LDAP-Server in @code{$self->@{LDAP_config@}} angegeben werden:
405 405

  
406 406
@itemize
......
409 409
@item
410 410
@samp{port} -- Die Portnummer des LDAP-Servers; meist 389.
411 411
@item
412
@samp{tls} -- Wenn Verbindungsverschl?sselung gew?nscht ist, so diesen Wert auf @samp{1} setzen, andernfalls auf @samp{0} belassen
412
@samp{tls} -- Wenn Verbindungsverschlüsselung gewünscht ist, so diesen Wert auf @samp{1} setzen, andernfalls auf @samp{0} belassen
413 413
@item
414
@samp{attribute} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. F?r Active-Directory-Server
415
  ist dies meist @samp{sAMAccountName}, f?r andere LDAP-Server hingegen @samp{uid}. Diese Angabe ist zwingend erforderlich.
414
@samp{attribute} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. Für Active-Directory-Server
415
  ist dies meist @samp{sAMAccountName}, für andere LDAP-Server hingegen @samp{uid}. Diese Angabe ist zwingend erforderlich.
416 416
@item
417 417
@samp{base_dn} -- Der Abschnitt des LDAP-Baumes, der durchsucht werden soll. Diese Angabe ist zwingend erforderlich.
418 418
@item
419
@samp{filter} -- Ein optionaler LDAP-Filter. Enth?lt dieser Filter das Wort @code{<%login%>}, so wird dieses durch den vom Benutzer
419
@samp{filter} -- Ein optionaler LDAP-Filter. Enthält dieser Filter das Wort @code{<%login%>}, so wird dieses durch den vom Benutzer
420 420
  eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum nach einem Element durchsucht, bei dem das oben angegebene Attribut
421 421
  mit dem Benutzernamen identisch ist.
422 422
@item
423 423
@samp{bind_dn} und @samp{bind_password} -- Wenn der LDAP-Server eine Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist dies bei
424
  Active-Directory-Servern der Fall), so kann diese hier angegeben werden. F?r Active-Directory-Server kann als @samp{bind_dn} entweder eine
424
  Active-Directory-Servern der Fall), so kann diese hier angegeben werden. Für Active-Directory-Server kann als @samp{bind_dn} entweder eine
425 425
  komplette LDAP-DN wie z.B. @samp{cn=Martin Mustermann,cn=Users,dc=firmendomain} auch nur der volle Name des Benutzers
426 426
  eingegeben werden; in diesem Beispiel also @samp{Martin Mustermann}.
427 427
@end itemize
......
430 430
@section Name des Session-Cookies
431 431

  
432 432
Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt
433
werden, so m?ssen die Namen der Session-Cookies f?r alle
433
werden, so müssen die Namen der Session-Cookies für alle
434 434
Installationen unterschiedlich sein. Der Name des Cookies wird mit dem
435 435
Parameter @code{$self->@{cookie_name@}} gesetzt.
436 436

  
......
454 454
@node Benutzer- und Gruppenverwaltung
455 455
@chapter Benutzer- und Gruppenverwaltung
456 456

  
457
Nach der Installation m?ssen Benutzer, Gruppen und Datenbanken
458
angelegt werden.  Dieses geschieht im Administrationsmen?, das Sie
457
Nach der Installation müssen Benutzer, Gruppen und Datenbanken
458
angelegt werden.  Dieses geschieht im Administrationsmenü, das Sie
459 459
unter folgender URL finden:
460 460

  
461 461
@uref{http://localhost/lx-erp/admin.pl}
......
464 464
@code{config/authentication.pl} eingetragen haben.
465 465

  
466 466
@menu
467
* Zusammenh?nge:: ?bersicht ?ber Benutzer, Gruppen, Berechtigungen und Datenbanken
467
* Zusammenhänge:: Übersicht über Benutzer, Gruppen, Berechtigungen und Datenbanken
468 468
* Datenbanken anlegen:: Hinweise zum Anlegen von Datenbanken
469 469
* Gruppen anlegen:: Hinweise zum Anlegen von Gruppen
470 470
* Benutzer anlegen:: Hinweise zum Anlegen von Benutzern
471 471
* Gruppenmitgliedschaften verwalten:: Wie man Gruppen Benutzer zuordnet
472
* Migration alter Installationen:: Automatische ?bernahme bei Update von einer ?lteren Version
472
* Migration alter Installationen:: Automatische Übernahme bei Update von einer älteren Version
473 473
@end menu
474 474

  
475
@node Zusammenh?nge
476
@section Zusammenh?nge
475
@node Zusammenhänge
476
@section Zusammenhänge
477 477

  
478 478
Lx-Office verwendet eine Datenbank zum Speichern all seiner
479 479
Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um
480
mit Lx-Office arbeiten zu k?nnen, muss eine Person einen
480
mit Lx-Office arbeiten zu können, muss eine Person einen
481 481
Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine
482 482
Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist
483
m?glich und normal, dass mehreren Benutzern die selbe Datenbank
484
zugewiesen wird, sodass sie alle mit den selben Daten arbeiten k?nnen.
483
möglich und normal, dass mehreren Benutzern die selbe Datenbank
484
zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können.
485 485

  
486 486
Die Basisdaten der Benutzer, die in der Administration eingegeben
487
werden k?nnen, werden in einer zweiten Datenbank gespeichert, der
488
bereits erw?hnten Authentifizierungsdatenbank. Diese ist also den
487
werden können, werden in einer zweiten Datenbank gespeichert, der
488
bereits erwähnten Authentifizierungsdatenbank. Diese ist also den
489 489
Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro
490 490
Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,
491 491
aber beliebig viele Datenbanken mit Firmendaten.
492 492

  
493 493
Lx-Office kann seinen Benutzern Zugriff auf bestimmte
494 494
Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
495
gestattet, so werden der entsprechenden Men?punkte auch nicht
495
gestattet, so werden der entsprechenden Menüpunkte auch nicht
496 496
angezeigt. Diese Rechte werden ebenfalls in der
497 497
Authentifizierungsdatenbank gespeichert.
498 498

  
499
Um Rechte verteilen zu k?nnen, verwendet Lx-Office ein
499
Um Rechte verteilen zu können, verwendet Lx-Office ein
500 500
Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche
501 501
erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder
502 502
mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen
......
520 520
@node Datenbanken anlegen
521 521
@section Datenbanken anlegen
522 522

  
523
Zuerst muss eine Datenbank angelegt werden. Verwenden Sie f?r den
523
Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den
524 524
Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen
525 525
ist dies @samp{lxoffice}).
526 526

  
527
Wenn Sie f?r die Lx-Office-Installation nicht den europ?ischen
527
Wenn Sie für die Lx-Office-Installation nicht den europäischen
528 528
Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
529
m?ssen Sie vor dem Anlegen der Datenbank in der Datei
529
müssen Sie vor dem Anlegen der Datenbank in der Datei
530 530
@code{config/lx-erp.conf} die Variable @code{$dbcharset} auf den Wert
531
@samp{UTF-8} setzen. Zus?tzlich muss beim Anlegen der Datenbank
532
@samp{UTF-8 Unicode} als Schriftsatz ausgew?hlt werden.
531
@samp{UTF-8} setzen. Zusätzlich muss beim Anlegen der Datenbank
532
@samp{UTF-8 Unicode} als Schriftsatz ausgewählt werden.
533 533

  
534 534
Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
535
verwenden m?ssen, da diese Einstellungen momentan global in Lx-Office
535
verwenden müssen, da diese Einstellungen momentan global in Lx-Office
536 536
vorgenommen wird und nicht nach Datenbank unterschieden werden
537 537
kann. Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz
538 538
angelegt worden sein.
......
542 542

  
543 543
Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name
544 544
gegeben werden, eine Beschreibung ist hingegen optional. Nach dem
545
Anlegen k?nnen Sie die verschiedenen Bereiche w?hlen, auf die
545
Anlegen können Sie die verschiedenen Bereiche wählen, auf die
546 546
Mitglieder dieser Gruppe Zugriff haben sollen.
547 547

  
548
Benutzergruppen sind unabh?ngig von Datenbanken, da sie in der
549
Authentifizierungsdatenbank gespeichert werden. Sie gelten f?r alle
548
Benutzergruppen sind unabhängig von Datenbanken, da sie in der
549
Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle
550 550
Datenbanken, die in dieser Installation verwaltet werden.
551 551

  
552 552
@node Benutzer anlegen
553 553
@section Benutzer anlegen
554 554

  
555
Beim Anlegen von Benutzern werden f?r viele Parameter
555
Beim Anlegen von Benutzern werden für viele Parameter
556 556
Standardeinstellungen vorgenommen, die den Gepflogenheiten des
557 557
deutschen Raumes entsprechen.
558 558

  
559 559
Zwingend anzugeben sind der Loginname sowie die komplette
560
Datenbankkonfiguration. Wenn die Passwortauthentifizierung ?ber die
560
Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die
561 561
Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort
562
gesetzt bzw. ge?ndert werden. Ist hingegen die LDAP-Authentifizierung
562
gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung
563 563
aktiv, so ist das Passwort-Feld deaktiviert.
564 564

  
565
In der Datenbankkonfiguration m?ssen die Zugriffsdaten einer der eben
565
In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben
566 566
angelegten Datenbanken eingetragen werden.
567 567

  
568 568
@node Gruppenmitgliedschaften verwalten
569 569
@section Gruppenmitgliedschaften verwalten
570 570

  
571
Nach dem Anlegen von Benutzern und Gruppen m?ssen Benutzer den Gruppen
572
zugewiesen werden. Dazu gibt es zwei M?glichkeiten:
571
Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen
572
zugewiesen werden. Dazu gibt es zwei Möglichkeiten:
573 573

  
574 574
@enumerate
575 575
@item
576
In der Gruppenverwaltung w?hlt man eine Gruppe aus. Im folgenden
577
Dialog kann man dann einzeln die Benutzer der Gruppe hinzuf?gen.
576
In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden
577
Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen.
578 578
@item
579
In der Gruppenverwaltung w?hlt man das Tool zur Verwaltung der
579
In der Gruppenverwaltung wählt man das Tool zur Verwaltung der
580 580
Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im
581
System angelegten Gruppen und Benutzer enth?lt. Durch Setzen der
582
H?kchen wird der Benutzer in der ausgew?hlten Zeile der Gruppe in der
583
ausgew?hlten Spalte hinzugef?gt.
581
System angelegten Gruppen und Benutzer enthält. Durch Setzen der
582
Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in der
583
ausgewählten Spalte hinzugefügt.
584 584
@end enumerate
585 585

  
586 586
@node Migration alter Installationen
587 587
@section Migration alter Installationen
588 588

  
589
Wenn Lx-Office 2.6.1 Beta 1 ?ber eine ?ltere Version installiert wird, in der
589
Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, in der
590 590
die Benutzerdaten noch im Dateisystem im Verzeichnis @code{users}
591
verwaltet wurden, so bietet Lx-Office die M?glichkeit, diese
591
verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese
592 592
Benutzerdaten automatisch in die Authentifizierungsdatenbank zu
593
?bernehmen. Dies geschieht, wenn man sich nach dem Update der
593
übernehmen. Dies geschieht, wenn man sich nach dem Update der
594 594
Installation das erste Mal im Administrationsbereich anmeldet. Findet
595 595
Lx-Office die Datei @code{users/members}, so wird der
596 596
Migrationsprozess gestartet.
597 597

  
598 598
Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten
599
k?nnen ?bernommen werden. Nach den Benutzerdaten bietet Lx-Office noch
600
die M?glichkeit an, dass automatisch eine Benutzergruppe angelegt
599
können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch
600
die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt
601 601
wird. Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office
602
gew?hrt. Alle migrierten Benutzern werden Mitglied in dieser
602
gewährt. Alle migrierten Benutzern werden Mitglied in dieser
603 603
Gruppe. Damit wird das Verhalten von Lx-Office bis Version 2.4.3
604
inklusive wiederhergestellt, und die Benutzer k?nnen sich sofort
604
inklusive wiederhergestellt, und die Benutzer können sich sofort
605 605
wieder anmelden und mit dem System arbeiten.
606 606

  
607 607
@c ---------------------------------------------------------------
......
609 609
@node OpenDocument-Vorlagen
610 610
@chapter OpenDocument-Vorlagen
611 611

  
612
Lx-Office unterst?tzt die Verwendung von Vorlagen im
612
Lx-Office unterstützt die Verwendung von Vorlagen im
613 613
OpenDocument-Format, wie es OpenOffice.org ab Version 2
614 614
erzeugt. Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als
615
auch aus diesen direkt PDF-Dateien erzeugen.  Um die Unterst?tzung von
615
auch aus diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
616 616
OpenDocument-Vorlagen zu aktivieren muss in der Datei
617 617
@code{config/lx-erp.conf} die Variable @code{$opendocument_templates}
618 618
auf @samp{1} stehen.  Dieses ist die Standardeinstellung.
......
620 620
Weiterhin muss in der Datei @code{config/lx-erp.conf} die Variable
621 621
@code{$dbcharset} auf die Zeichenkodierung gesetzt werden, die auch
622 622
bei der Speicherung der Daten in der Datenbank verwendet wird. Diese
623
ist in den meisten F?llen "ISO-8859-15".
623
ist in den meisten Fällen "ISO-8859-15".
624 624

  
625
W?hrend die Erzeugung von reinen OpenDocument-Dateien keinerlei
626
weitere Software ben?tigt, wird zur Umwandlung dieser Dateien in PDF
627
OpenOffice.org ben?tigt. Soll dieses Feature genutzt werden, so muss
625
Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
626
weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
627
OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
628 628
neben OpenOffice.org ab Version 2 auch der ``X virtual frame buffer''
629 629
(xvfb) installiert werden.  Bei Debian ist er im Paket ``xvfb''
630 630
enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
631 631

  
632
Nach der Installation m?ssen in der Datei @code{config/lx-erp.conf}
632
Nach der Installation müssen in der Datei @code{config/lx-erp.conf}
633 633
zwei weitere Variablen angepasst werden:
634
@code{$openofficeorg_writer_bin} muss den vollst?ndigen Pfad zur
634
@code{$openofficeorg_writer_bin} muss den vollständigen Pfad zur
635 635
OpenOffice.org Writer-Anwendung enthalten.  @code{$xvfb_bin} muss den
636 636
Pfad zum ``X virtual frame buffer'' enthalten.
637 637

  
638
Zus?tzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
638
Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
639 639
OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn
640 640
die Variable @code{$openofficeorg_daemon} gesetzt ist, startet ein
641 641
OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
642 642
bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
643 643
benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
644
reduziert wird, weil nicht f?r jedes Dokument ein OpenOffice gestartet
644
reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
645 645
werden muss. Der Nachteil ist, dass diese Methode Python und die
646
Python-UNO-Bindings ben?tigt, die Bestandteil von OpenOffice 2 sind.
646
Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind.
647 647

  
648
Ist @code{$openofficeorg_daemon} nicht gesetzt, so wird f?r jedes
648
Ist @code{$openofficeorg_daemon} nicht gesetzt, so wird für jedes
649 649
Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe
650
eines Makros durchgef?hrt. Dieses Makro muss in der Dokumentenvorlage
650
eines Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage
651 651
enthalten sein und ``Standard.Conversion.ConvertSelfToPDF()''
652
hei?en. Die Beispielvorlage @samp{templates/German-invoice.odt}
653
enth?lt ein solches Makro, das in jeder anderen Dokumentenvorlage
652
heißen. Die Beispielvorlage @samp{templates/German-invoice.odt}
653
enthält ein solches Makro, das in jeder anderen Dokumentenvorlage
654 654
ebenfalls enthalten sein muss.
655 655

  
656 656
Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org
......
658 658
Debian ist dies momentan @code{~/.openoffice.org2}. Sollte der Name
659 659
bei Ihrer OpenOffice.org-Installation anders sein, so muss das
660 660
Verzeichnis @code{users/.openoffice.org2} entsprechend umbenannt
661
werden. Ist der Name z.B. einfach nur @code{.openoffice}, so w?re
662
folgender Befehl auszuf?hren:
661
werden. Ist der Name z.B. einfach nur @code{.openoffice}, so wäre
662
folgender Befehl auszuführen:
663 663

  
664 664
@code{mv users/.openoffice.org2 users/.openoffice}
665 665

  
666 666
Dieses Verzeichnis, wie auch das komplette @code{users}-Verzeichnis,
667 667
muss vom Webserver beschreibbar sein. Dieses wurde in Schritt
668 668
@code{Installation des Programmpakets} oben bereits erledigt, kann
669
aber erneut ?berpr?ft werden, wenn die Konvertierung nach PDF
670
fehlschl?gt.
669
aber erneut überprüft werden, wenn die Konvertierung nach PDF
670
fehlschlägt.
671 671

  
672 672
@c ---------------------------------------------------------------
673 673

  
doc/INSTALL.txt
3 3

  
4 4
Inhalt der Anleitung
5 5
1 Aktuelle Hinweise
6
2 Ben?tigte Software und Pakete
6
2 Benötigte Software und Pakete
7 7
3 Installation des Programmpaketes
8 8
4 Anpassung der PostgreSQL-Konfiguration
9
  4.1 Zeichens?tze/die Verwendung von UTF-8
10
  4.2 ?nderungen an Konfigurationsdateien
11
  4.3 Erweiterung f?r servergespeicherte Prozeduren
9
  4.1 Zeichensätze/die Verwendung von UTF-8
10
  4.2 Änderungen an Konfigurationsdateien
11
  4.3 Erweiterung für servergespeicherte Prozeduren
12 12
  4.4 Datenbankbenutzer anlegen
13 13
5 Apache-Konfiguration
14 14
6 Benutzerauthentifizierung und Administratorpasswort
15 15
  6.1 Grundlagen zur Benutzerauthentifizierung
16 16
  6.2 Administratorpasswort
17 17
  6.3 Authentifizierungsdatenbank
18
  6.4 Passwort?berpr?fung
18
  6.4 Passwortüberprüfung
19 19
  6.5 Name des Session-Cookies
20 20
  6.6 Anlegen der Authentifizierungsdatenbank
21 21
7 Benutzer- und Gruppenverwaltung
22
  7.1 Zusammenh?nge
22
  7.1 Zusammenhänge
23 23
  7.2 Datenbanken anlegen
24 24
  7.3 Gruppen anlegen
25 25
  7.4 Benutzer anlegen
......
45 45

  
46 46
   * im Lx-Office-Forum: `http://www.lx-office.org/forum/'
47 47

  
48
2 Ben?tigte Software und Pakete
49
*******************************
48
2 Benötigte Software und Pakete
49
********************************
50 50

  
51 51
Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)
52
und ein Datenbankserver (PostgreSQL) ben?tigt.
52
und ein Datenbankserver (PostgreSQL) benötigt.
53 53

  
54
   Zus?tzlich ben?tigt Lx-Office die folgenden Perl-Pakete, die nicht
54
   Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht
55 55
Bestandteil einer Standard-Perl-Installation sind:
56 56

  
57 57
   * DBI
......
80 80

  
81 81
   * Email::Address
82 82

  
83
   Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders
84
hei?en.
83
   Diese Pakete können bei den unterschiedlichen Distributionen anders
84
heißen.
85 85

  
86
   F?r Debian oder Ubuntu ben?tigen Sie diese Pakete:
86
   Für Debian oder Ubuntu benötigen Sie diese Pakete:
87 87

  
88 88
   `apache postgresql libdbi-perl libdbd-pg-perl libpg-perl
89 89
libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl
90
libtext-iconv-perl libyaml-perl libtext-csv-perl libio-stringy-perl
91
libtemplate-perl'
90
libtext-iconv-perl libyaml-perl libtext-csv-xs-perl libio-stringy-perl
91
libtemplate-perl lib-uriperl libxml-simple-perl'
92 92

  
93
   F?r Fedora Core ben?tigen Sie unter anderem diese Pakete:
93
   Für Fedora Core benötigen Sie unter anderem diese Pakete:
94 94

  
95 95
   `httpd postgresql-server perl-DBI perl-DBD-Pg'
96 96

  
97
   F?r OpenSuSE ben?tigen Sie diese Pakete:
97
   Für OpenSuSE benötigen Sie diese Pakete:
98 98

  
99 99
   `apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip
100 100
perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy
101
perl-Template-Toolkit'
101
perl-Template-Toolkit perl-URI perl-XML-Writer'
102 102

  
103
   Einige Module werden von Lx-Office ben?tigt, sind aber evtl. nicht
103
   Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht
104 104
als Distributionspakete vorhanden, und/oder nicht praktikabel zu
105
installieren.  In diesen F?llen liefert Lx-Office das Paket mit, und
106
l?dt es als Fallback.
105
installieren.  In diesen Fällen liefert Lx-Office das Paket mit, und
106
lädt es als Fallback.
107 107

  
108
   Lx-Office enth?lt ein Script, mit dem ?berpr?ft werden kann, ob alle
109
ben?tigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:
108
   Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle
109
benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:
110 110

  
111 111
   `./scripts/installation_check.pl'
112 112

  
......
120 120
   `cd /var/www
121 121
tar xvzf lxoffice-erp-2.6.1beta1.tgz'
122 122

  
123
   Ver?ndern Sie evtl. noch den Namen des Verzeichnisses mit
123
   Verändern Sie evtl. noch den Namen des Verzeichnisses mit
124 124

  
125 125
   `mv lxoffice-erp/ lx-erp/'
126 126

  
127
   Alternativ k?nnen Sie auch einen Alias in der Webserverkonfiguration
128
benutzen, um auf das tats?chliche Installationsverzeichnis zu verweisen.
127
   Alternativ können Sie auch einen Alias in der Webserverkonfiguration
128
benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen.
129 129

  
130
   Die Verzeichnisse `users', `spool' und `webdav' m?ssen f?r den
131
Benutzer beschreibbar sein, unter dem der Webserver l?uft. Die
132
restlichen Dateien m?ssen f?r diesen Benutzer lesbar sein. Der
130
   Die Verzeichnisse `users', `spool' und `webdav' müssen für den
131
Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
132
restlichen Dateien müssen für diesen Benutzer lesbar sein. Der
133 133
Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B.
134 134
bei Debian/Ubuntu `www-data', bei Fedora core `apache' oder bei
135 135
OpenSuSE `wwwrun').
136 136

  
137
   Der folgende Befehl ?ndert den Besitzer f?r die oben genannten
137
   Der folgende Befehl ändert den Besitzer für die oben genannten
138 138
Verzeichnisse auf einem Debian/Ubuntu-System:
139 139

  
140 140
   `chown -R www-data lx-office-erp/users lx-office-erp/spool
141 141
lx-office-erp/webdav'
142 142

  
143 143
   Weiterhin muss der Webserver-Benutzer im Verzeichnis `templates'
144
Verzeichnisse f?r jeden neuen Benutzer, der in lx-office angelegt wird,
145
anlegen d?rfen:
144
Verzeichnisse für jeden neuen Benutzer, der in lx-office angelegt wird,
145
anlegen dürfen:
146 146

  
147 147
   `chgrp www-data lx-office-erp/templates; chmod g+w
148 148
lx-office-erp/templates'
......
152 152

  
153 153
PostgreSQL muss auf verschiedene Weisen angepasst werden.
154 154

  
155
4.1 Zeichens?tze/die Verwendung von UTF-8
156
=========================================
155
4.1 Zeichensätze/die Verwendung von UTF-8
156
==========================================
157 157

  
158 158
Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet werden.
159 159
Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in Version 8.0
160 160
oder neuer benutzt werden, und der PostgreSQL-Datenbankcluster muss
161 161
ebenfalls mit UTF-8 als Locale angelegt worden sein.
162 162

  
163
   Dieses ist kann ?berpr?ft werden: ist das Encoding der Datenbank
163
   Dieses ist kann überprüft werden: ist das Encoding der Datenbank
164 164
"template1" "UTF8", so kann auch Lx-Office mit UTF-8 betrieben werden.
165 165
Andernfalls ist es notwendig, einen neuen Datenbankcluster mit
166 166
UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und
......
169 169
   `pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2
170 170
clustername'
171 171

  
172
   Die Datenbankversionsnummer muss an die tats?chlich verwendete
172
   Die Datenbankversionsnummer muss an die tatsächlich verwendete
173 173
Versionsnummer angepasst werden.
174 174

  
175
   Unter anderen Distributionen gibt es ?hnliche Methoden.
175
   Unter anderen Distributionen gibt es ähnliche Methoden.
176 176

  
177 177
   Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist
178
ein Neuanlegen eines weiteren Clusters nicht m?glich, so kann Lx-Office
178
ein Neuanlegen eines weiteren Clusters nicht möglich, so kann Lx-Office
179 179
mit ISO-8859-15 als Encoding betrieben werden.
180 180

  
181
   Das Encoding einer Datenbank kann in `psql' mit `\l' gepr?ft werden.
181
   Das Encoding einer Datenbank kann in `psql' mit `\l' geprüft werden.
182 182

  
183
4.2 ?nderungen an Konfigurationsdateien
184
=======================================
183
4.2 Änderungen an Konfigurationsdateien
184
========================================
185 185

  
186 186
In der Datei `postgresql.conf', die je nach Distribution in
187 187
verschiedenen Verzeichnissen liegen kann (z.B. `/var/lib/pgsql/data/'
188 188
oder `/etc/postgresql/', muss sichergestellt werden, dass
189
TCP/IP-Verbindungen aktiviert sind. F?r PostgreSQL vor Version v8.0
189
TCP/IP-Verbindungen aktiviert sind. Für PostgreSQL vor Version v8.0
190 190
lautete dieser Parameter
191 191

  
192 192
   `TCPIP_SOCKET = 1'
193 193

  
194
   Ab v8.0 wird das Verhalten hingegen ?ber den neuen Parameter
194
   Ab v8.0 wird das Verhalten hingegen über den neuen Parameter
195 195
`listen_address' gesteuert. Laufen PostgreSQL und Lx-Office auf
196 196
demselben Rechner, so kann dort der Wert `localhost' verwendet werden.
197
Andernfalls m?ssen Datenbankverbindungen auch von anderen Rechnern aus
197
Andernfalls müssen Datenbankverbindungen auch von anderen Rechnern aus
198 198
zugelassen werden, was mit dem Wert \`*' geschieht.
199 199

  
200 200
   In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die
201
`postgresql.conf' zu finden sein sollte, m?ssen die Berichtigungen f?r
202
den Zugriff ge?ndert werden. Hier gibt es mehrere M?glichkeiten. Eine
201
`postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für
202
den Zugriff geändert werden. Hier gibt es mehrere Möglichkeiten. Eine
203 203
besteht darin, lokale Verbindungen immer zuzulassen
204 204

  
205 205
   `local all all trust
206 206
host all all 127.0.0.1 255.0.0.0 trust'
207 207

  
208
   Besser ist es, f?r eine bestimmte Datenbank Zugriff nur per Passwort
208
   Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort
209 209
zuzulassen. Beispielsweise:
210 210

  
211 211
   `local   all         lxoffice
......
213 213
host    all         lxoffice      127.0.0.1         255.255.255.255
214 214
password'
215 215

  
216
4.3 Erweiterung f?r servergespeicherte Prozeduren
217
=================================================
216
4.3 Erweiterung für servergespeicherte Prozeduren
217
==================================================
218 218

  
219
In der Datenbank `template1' muss die Unterst?tzung f?r
220
servergespeicherte Prozeduren eingerichet werden. Melden Sie sich daf?r
221
als Benutzer "postgres" an der Datenbank an, und f?hren Sie die
219
In der Datenbank `template1' muss die Unterstützung für
220
servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür
221
als Benutzer "postgres" an der Datenbank an, und führen Sie die
222 222
folgenden Kommandos aus:
223 223

  
224 224
   `create function plpgsql_call_handler () returns opaque as
......
236 236

  
237 237
Wenn Sie nicht den Datenbanksuperuser "postgres" zum Zugriff benutzen
238 238
wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer anlegen. Ein
239
Beispiel, wie Sie einen neuen Benutzer anlegen k?nnen:
239
Beispiel, wie Sie einen neuen Benutzer anlegen können:
240 240

  
241 241
   `su - postgres
242 242
createuser -d -P lxoffice'
243 243

  
244
   Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern Sie
244
   Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie
245 245
den evtl. voreingestellten Benutzer "postgres" auf "lxoffice" bzw. den
246
hier gew?hlten Benutzernamen.
246
hier gewählten Benutzernamen.
247 247

  
248 248
5 Apache-Konfiguration
249 249
**********************
250 250

  
251 251
Der Zugriff auf das Programmverzeichnis muss in der Apache
252
Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. F?gen Sie
252
Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie
253 253
den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu,
254 254
die beim Starten des Webservers eingelesen wird:
255 255

  
......
272 272
ein Plus `+' gesetzt werden.
273 273

  
274 274
   Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets
275
nicht ausgeliefert. In solchen F?llen hat es oft geholfen, die folgende
275
nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die folgende
276 276
Option in die Konfiguration aufzunehmen:
277 277

  
278 278
   `EnableSendfile Off'
......
280 280
6 Benutzerauthentifizierung und Administratorpasswort
281 281
*****************************************************
282 282

  
283
Informationen ?ber die Einrichtung der Benutzerauthentifizierung, ?ber
283
Informationen über die Einrichtung der Benutzerauthentifizierung, über
284 284
die Verwaltung von Gruppen und weitere Einstellungen
285 285

  
286 286
6.1 Grundlagen zur Benutzerauthentifizierung
287 287
============================================
288 288

  
289 289
Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die
290
im folgenden "Authentifizierungsdatenbank" genannt wird. F?r jeden
291
Benutzer kann dort eine eigene Datenbank f?r die eigentlichen
292
Finanzdaten hinterlegt sein. Diese beiden Datenbanken k?nnen, m?ssen
290
im folgenden "Authentifizierungsdatenbank" genannt wird. Für jeden
291
Benutzer kann dort eine eigene Datenbank für die eigentlichen
292
Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen
293 293
aber nicht unterschiedlich sein.
294 294

  
295
   Im einfachsten Fall gibt es f?r Lx-Office nur eine einzige Datenbank,
295
   Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank,
296 296
in der sowohl die Benutzerinformationen als auch die Daten abgelegt
297 297
werden.
298 298

  
299
   Zus?tzlich erm?glicht es Lx-Office, dass die Benutzerpassw?rter
299
   Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter
300 300
entweder gegen die Authentifizierungsdatenbank oder gegen einen
301
LDAP-Server ?berpr?ft werden.
301
LDAP-Server überprüft werden.
302 302

  
303
   Welche Art der Passwort?berpr?fung Lx-Office benutzt und wie
303
   Welche Art der Passwortüberprüfung Lx-Office benutzt und wie
304 304
Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der
305 305
Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss
306 306
bei der Installation und bei einem Upgrade von einer Version vor v2.6.0
......
313 313

  
314 314
Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt
315 315
wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort
316
und nicht mehr im Administrationsinterface selber ge?ndert werden. Der
317
Parameter dazu hei?t `$self->{admin_password}'.
316
und nicht mehr im Administrationsinterface selber geändert werden. Der
317
Parameter dazu heißt `$self->{admin_password}'.
318 318

  
319 319
6.3 Authentifizierungsdatenbank
320 320
===============================
......
332 332
   * `user' - Der Benutzername, mit dem sich Lx-Office beim
333 333
     Datenbankserver anmeldet (z.B. "postgres")
334 334

  
335
   * `password' - Das Passwort f?r den Datenbankbenutzer
335
   * `password' - Das Passwort für den Datenbankbenutzer
336 336

  
337 337
   Die Datenbank muss noch nicht existieren. Lx-Office kann sie
338 338
automatisch anlegen (mehr dazu siehe unten).
339 339

  
340
6.4 Passwort?berpr?fung
341
=======================
340
6.4 Passwortüberprüfung
341
=========================
342 342

  
343
Lx-Office unterst?tzt Passwort?berpr?fung auf zwei Arten: gegen die
343
Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die
344 344
Authentifizierungsdatenbank und gegen einen externen LDAP- oder
345 345
Active-Directory-Server. Welche davon benutzt wird, regelt der
346 346
Parameter `$self->{module}'.
347 347

  
348
   Sollen die Benutzerpassw?rter in der Authentifizierungsdatenbank
348
   Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank
349 349
gespeichert werden, so muss der Parameter `$self->{module}' den Wert
350
`DB' enthalten. In diesem Fall k?nnen sowohl der Administrator als auch
351
die Benutzer selber ihre Psasw?rter in Lx-Office ?ndern.
350
`DB' enthalten. In diesem Fall können sowohl der Administrator als auch
351
die Benutzer selber ihre Psaswörter in Lx-Office ändern.
352 352

  
353 353
   Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt
354 354
werden, so muss der Parameter `$self->{module}' auf `LDAP' gesetzt
355
werden. In diesem Fall m?ssen zus?tzliche Informationen ?ber den
355
werden. In diesem Fall müssen zusätzliche Informationen über den
356 356
LDAP-Server in `$self->{LDAP_config}' angegeben werden:
357 357

  
358 358
   * `host' - Der Rechnername oder die IP-Adresse des LDAP- oder
......
360 360

  
361 361
   * `port' - Die Portnummer des LDAP-Servers; meist 389.
362 362

  
363
   * `tls' - Wenn Verbindungsverschl?sselung gew?nscht ist, so diesen
363
   * `tls' - Wenn Verbindungsverschlüsselung gewünscht ist, so diesen
364 364
     Wert auf `1' setzen, andernfalls auf `0' belassen
365 365

  
366 366
   * `attribute' - Das LDAP-Attribut, in dem der Benutzername steht,
367
     den der Benutzer eingegeben hat. F?r Active-Directory-Server   ist
368
     dies meist `sAMAccountName', f?r andere LDAP-Server hingegen
367
     den der Benutzer eingegeben hat. Für Active-Directory-Server   ist
368
     dies meist `sAMAccountName', für andere LDAP-Server hingegen
369 369
     `uid'. Diese Angabe ist zwingend erforderlich.
370 370

  
371 371
   * `base_dn' - Der Abschnitt des LDAP-Baumes, der durchsucht werden
372 372
     soll. Diese Angabe ist zwingend erforderlich.
373 373

  
374
   * `filter' - Ein optionaler LDAP-Filter. Enth?lt dieser Filter das
374
   * `filter' - Ein optionaler LDAP-Filter. Enthält dieser Filter das
375 375
     Wort `<%login%>', so wird dieses durch den vom Benutzer
376 376
     eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum
377 377
     nach einem Element durchsucht, bei dem das oben angegebene Attribut
......
380 380
   * `bind_dn' und `bind_password' - Wenn der LDAP-Server eine
381 381
     Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist
382 382
     dies bei   Active-Directory-Servern der Fall), so kann diese hier
383
     angegeben werden. F?r Active-Directory-Server kann als `bind_dn'
383
     angegeben werden. Für Active-Directory-Server kann als `bind_dn'
384 384
     entweder eine   komplette LDAP-DN wie z.B. `cn=Martin
385 385
     Mustermann,cn=Users,dc=firmendomain' auch nur der volle Name des
386 386
     Benutzers   eingegeben werden; in diesem Beispiel also `Martin
......
390 390
============================
391 391

  
392 392
Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt
393
werden, so m?ssen die Namen der Session-Cookies f?r alle Installationen
393
werden, so müssen die Namen der Session-Cookies für alle Installationen
394 394
unterschiedlich sein. Der Name des Cookies wird mit dem Parameter
395 395
`$self->{cookie_name}' gesetzt.
396 396

  
......
410 410
7 Benutzer- und Gruppenverwaltung
411 411
*********************************
412 412

  
413
Nach der Installation m?ssen Benutzer, Gruppen und Datenbanken angelegt
414
werden.  Dieses geschieht im Administrationsmen?, das Sie unter
413
Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt
414
werden.  Dieses geschieht im Administrationsmenü, das Sie unter
415 415
folgender URL finden:
416 416

  
417 417
   `http://localhost/lx-erp/admin.pl'
......
419 419
   Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei
420 420
`config/authentication.pl' eingetragen haben.
421 421

  
422
7.1 Zusammenh?nge
423
=================
422
7.1 Zusammenhänge
423
==================
424 424

  
425 425
Lx-Office verwendet eine Datenbank zum Speichern all seiner
426 426
Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um
427
mit Lx-Office arbeiten zu k?nnen, muss eine Person einen
427
mit Lx-Office arbeiten zu können, muss eine Person einen
428 428
Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine
429 429
Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist
430
m?glich und normal, dass mehreren Benutzern die selbe Datenbank
431
zugewiesen wird, sodass sie alle mit den selben Daten arbeiten k?nnen.
430
möglich und normal, dass mehreren Benutzern die selbe Datenbank
431
zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können.
432 432

  
433 433
   Die Basisdaten der Benutzer, die in der Administration eingegeben
434
werden k?nnen, werden in einer zweiten Datenbank gespeichert, der
435
bereits erw?hnten Authentifizierungsdatenbank. Diese ist also den
434
werden können, werden in einer zweiten Datenbank gespeichert, der
435
bereits erwähnten Authentifizierungsdatenbank. Diese ist also den
436 436
Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro
437 437
Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,
438 438
aber beliebig viele Datenbanken mit Firmendaten.
439 439

  
440 440
   Lx-Office kann seinen Benutzern Zugriff auf bestimmte
441 441
Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
442
gestattet, so werden der entsprechenden Men?punkte auch nicht
442
gestattet, so werden der entsprechenden Menüpunkte auch nicht
443 443
angezeigt. Diese Rechte werden ebenfalls in der
444 444
Authentifizierungsdatenbank gespeichert.
445 445

  
446
   Um Rechte verteilen zu k?nnen, verwendet Lx-Office ein
446
   Um Rechte verteilen zu können, verwendet Lx-Office ein
447 447
Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche
448 448
erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder
449 449
mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen
......
464 464
7.2 Datenbanken anlegen
465 465
=======================
466 466

  
467
Zuerst muss eine Datenbank angelegt werden. Verwenden Sie f?r den
467
Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den
468 468
Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen
469 469
ist dies `lxoffice').
470 470

  
471
   Wenn Sie f?r die Lx-Office-Installation nicht den europ?ischen
471
   Wenn Sie für die Lx-Office-Installation nicht den europäischen
472 472
Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
473
m?ssen Sie vor dem Anlegen der Datenbank in der Datei
473
müssen Sie vor dem Anlegen der Datenbank in der Datei
474 474
`config/lx-erp.conf' die Variable `$dbcharset' auf den Wert `UTF-8'
475
setzen. Zus?tzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als
476
Schriftsatz ausgew?hlt werden.
475
setzen. Zusätzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als
476
Schriftsatz ausgewählt werden.
477 477

  
478 478
   Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
479
verwenden m?ssen, da diese Einstellungen momentan global in Lx-Office
479
verwenden müssen, da diese Einstellungen momentan global in Lx-Office
480 480
vorgenommen wird und nicht nach Datenbank unterschieden werden kann.
481 481
Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz
482 482
angelegt worden sein.
......
486 486

  
487 487
Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name
488 488
gegeben werden, eine Beschreibung ist hingegen optional. Nach dem
489
Anlegen k?nnen Sie die verschiedenen Bereiche w?hlen, auf die
489
Anlegen können Sie die verschiedenen Bereiche wählen, auf die
490 490
Mitglieder dieser Gruppe Zugriff haben sollen.
491 491

  
492
   Benutzergruppen sind unabh?ngig von Datenbanken, da sie in der
493
Authentifizierungsdatenbank gespeichert werden. Sie gelten f?r alle
492
   Benutzergruppen sind unabhängig von Datenbanken, da sie in der
493
Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle
494 494
Datenbanken, die in dieser Installation verwaltet werden.
495 495

  
496 496
7.4 Benutzer anlegen
497 497
====================
498 498

  
499
Beim Anlegen von Benutzern werden f?r viele Parameter
499
Beim Anlegen von Benutzern werden für viele Parameter
500 500
Standardeinstellungen vorgenommen, die den Gepflogenheiten des
501 501
deutschen Raumes entsprechen.
502 502

  
503 503
   Zwingend anzugeben sind der Loginname sowie die komplette
504
Datenbankkonfiguration. Wenn die Passwortauthentifizierung ?ber die
504
Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die
505 505
Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort
506
gesetzt bzw. ge?ndert werden. Ist hingegen die LDAP-Authentifizierung
506
gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung
507 507
aktiv, so ist das Passwort-Feld deaktiviert.
508 508

  
509
   In der Datenbankkonfiguration m?ssen die Zugriffsdaten einer der eben
509
   In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben
510 510
angelegten Datenbanken eingetragen werden.
511 511

  
512 512
7.5 Gruppenmitgliedschaften verwalten
513 513
=====================================
514 514

  
515
Nach dem Anlegen von Benutzern und Gruppen m?ssen Benutzer den Gruppen
516
zugewiesen werden. Dazu gibt es zwei M?glichkeiten:
515
Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen
516
zugewiesen werden. Dazu gibt es zwei Möglichkeiten:
517 517

  
518
  1. In der Gruppenverwaltung w?hlt man eine Gruppe aus. Im folgenden
519
     Dialog kann man dann einzeln die Benutzer der Gruppe hinzuf?gen.
518
  1. In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden
519
     Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen.
520 520

  
521
  2. In der Gruppenverwaltung w?hlt man das Tool zur Verwaltung der
521
  2. In der Gruppenverwaltung wählt man das Tool zur Verwaltung der
522 522
     Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im
523
     System angelegten Gruppen und Benutzer enth?lt. Durch Setzen der
524
     H?kchen wird der Benutzer in der ausgew?hlten Zeile der Gruppe in
525
     der ausgew?hlten Spalte hinzugef?gt.
523
     System angelegten Gruppen und Benutzer enthält. Durch Setzen der
524
     Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in
525
     der ausgewählten Spalte hinzugefügt.
526 526

  
527 527
7.6 Migration alter Installationen
528 528
==================================
529 529

  
530
Wenn Lx-Office 2.6.1 Beta 1 ?ber eine ?ltere Version installiert wird,
530
Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird,
531 531
in der die Benutzerdaten noch im Dateisystem im Verzeichnis `users'
532
verwaltet wurden, so bietet Lx-Office die M?glichkeit, diese
532
verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese
533 533
Benutzerdaten automatisch in die Authentifizierungsdatenbank zu
534
?bernehmen. Dies geschieht, wenn man sich nach dem Update der
534
übernehmen. Dies geschieht, wenn man sich nach dem Update der
535 535
Installation das erste Mal im Administrationsbereich anmeldet. Findet
536 536
Lx-Office die Datei `users/members', so wird der Migrationsprozess
537 537
gestartet.
538 538

  
539 539
   Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten
540
k?nnen ?bernommen werden. Nach den Benutzerdaten bietet Lx-Office noch
541
die M?glichkeit an, dass automatisch eine Benutzergruppe angelegt wird.
542
Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gew?hrt.
540
können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch
541
die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird.
542
Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gewährt.
543 543
Alle migrierten Benutzern werden Mitglied in dieser Gruppe. Damit wird
544 544
das Verhalten von Lx-Office bis Version 2.4.3 inklusive
545
wiederhergestellt, und die Benutzer k?nnen sich sofort wieder anmelden
545
wiederhergestellt, und die Benutzer können sich sofort wieder anmelden
546 546
und mit dem System arbeiten.
547 547

  
548 548
8 OpenDocument-Vorlagen
549 549
***********************
550 550

  
551
Lx-Office unterst?tzt die Verwendung von Vorlagen im
551
Lx-Office unterstützt die Verwendung von Vorlagen im
552 552
OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
553 553
Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus
554
diesen direkt PDF-Dateien erzeugen.  Um die Unterst?tzung von
554
diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
555 555
OpenDocument-Vorlagen zu aktivieren muss in der Datei
556 556
`config/lx-erp.conf' die Variable `$opendocument_templates' auf `1'
557 557
stehen.  Dieses ist die Standardeinstellung.
......
559 559
   Weiterhin muss in der Datei `config/lx-erp.conf' die Variable
560 560
`$dbcharset' auf die Zeichenkodierung gesetzt werden, die auch bei der
561 561
Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den
562
meisten F?llen "ISO-8859-15".
562
meisten Fällen "ISO-8859-15".
563 563

  
564
   W?hrend die Erzeugung von reinen OpenDocument-Dateien keinerlei
565
weitere Software ben?tigt, wird zur Umwandlung dieser Dateien in PDF
566
OpenOffice.org ben?tigt. Soll dieses Feature genutzt werden, so muss
564
   Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
565
weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
566
OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
567 567
neben OpenOffice.org ab Version 2 auch der "X virtual frame buffer"
568 568
(xvfb) installiert werden.  Bei Debian ist er im Paket "xvfb"
569 569
enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
570 570

  
571
   Nach der Installation m?ssen in der Datei `config/lx-erp.conf' zwei
571
   Nach der Installation müssen in der Datei `config/lx-erp.conf' zwei
572 572
weitere Variablen angepasst werden: `$openofficeorg_writer_bin' muss
573
den vollst?ndigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
573
den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
574 574
`$xvfb_bin' muss den Pfad zum "X virtual frame buffer" enthalten.
575 575

  
576
   Zus?tzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
576
   Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
577 577
OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
578 578
Variable `$openofficeorg_daemon' gesetzt ist, startet ein OpenOffice,
579 579
das auch nach der Umwandlung des Dokumentes gestartet bleibt. Bei
580 580
weiteren Umwandlungen wird dann diese laufende Instanz benutzt. Der
581 581
Vorteil ist, dass die Zeit zur Umwandlung deutlich reduziert wird, weil
582
nicht f?r jedes Dokument ein OpenOffice gestartet werden muss. Der
582
nicht für jedes Dokument ein OpenOffice gestartet werden muss. Der
583 583
Nachteil ist, dass diese Methode Python und die Python-UNO-Bindings
584
ben?tigt, die Bestandteil von OpenOffice 2 sind.
584
benötigt, die Bestandteil von OpenOffice 2 sind.
585 585

  
586
   Ist `$openofficeorg_daemon' nicht gesetzt, so wird f?r jedes
586
   Ist `$openofficeorg_daemon' nicht gesetzt, so wird für jedes
587 587
Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe eines
588
Makros durchgef?hrt. Dieses Makro muss in der Dokumentenvorlage
589
enthalten sein und "Standard.Conversion.ConvertSelfToPDF()" hei?en. Die
590
Beispielvorlage `templates/German-invoice.odt' enth?lt ein solches
588
Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage
589
enthalten sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die
590
Beispielvorlage `templates/German-invoice.odt' enthält ein solches
591 591
Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein
592 592
muss.
593 593

  
......
596 596
ist dies momentan `~/.openoffice.org2'. Sollte der Name bei Ihrer
597 597
OpenOffice.org-Installation anders sein, so muss das Verzeichnis
598 598
`users/.openoffice.org2' entsprechend umbenannt werden. Ist der Name
599
z.B. einfach nur `.openoffice', so w?re folgender Befehl auszuf?hren:
599
z.B. einfach nur `.openoffice', so wäre folgender Befehl auszuführen:
600 600

  
601 601
   `mv users/.openoffice.org2 users/.openoffice'
602 602

  
603 603
   Dieses Verzeichnis, wie auch das komplette `users'-Verzeichnis, muss
604 604
vom Webserver beschreibbar sein. Dieses wurde in Schritt `Installation
605
des Programmpakets' oben bereits erledigt, kann aber erneut ?berpr?ft
606
werden, wenn die Konvertierung nach PDF fehlschl?gt.
605
des Programmpakets' oben bereits erledigt, kann aber erneut überprüft
606
werden, wenn die Konvertierung nach PDF fehlschlägt.
607 607

  
608 608
9 Lx-Office ERP verwenden
609 609
*************************
doc/INSTALL/Administratorpasswort.html
36 36

  
37 37
<p>Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt wird,
38 38
wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort und nicht
39
mehr im Administrationsinterface selber ge?ndert werden. Der Parameter dazu
40
hei?t <code>$self-&gt;{admin_password}</code>.
39
mehr im Administrationsinterface selber geändert werden. Der Parameter dazu
40
heißt <code>$self-&gt;{admin_password}</code>.
41 41

  
42 42
   </body></html>
43 43

  
doc/INSTALL/Aktuelle-Hinweise.html
6 6
<meta name="generator" content="makeinfo 4.11">
7 7
<link title="Top" rel="start" href="index.html#Top">
8 8
<link rel="prev" href="index.html#Top" title="Top">
9
<link rel="next" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete" title="Ben?tigte Software und Pakete">
9
<link rel="next" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete" title="Benötigte Software und Pakete">
10 10
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
11 11
<meta http-equiv="Content-Style-Type" content="text/css">
12 12
<style type="text/css"><!--
......
25 25
<div class="node">
26 26
<p>
27 27
<a name="Aktuelle-Hinweise"></a>
28
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Ben?tigte Software und Pakete</a>,
28
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete">Benötigte Software und Pakete</a>,
29 29
voriges:&nbsp;<a rel="previous" accesskey="p" href="index.html#Top">Top</a>,
30 30
aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
31 31
<hr>
doc/INSTALL/Anpassung-der-PostgreSQL_002dKonfiguration.html
37 37
<p>PostgreSQL muss auf verschiedene Weisen angepasst werden.
38 38

  
39 39
<ul class="menu">
40
<li><a accesskey="1" href="Zeichens_00e4tze_002fdie-Verwendung-von-UTF_002d8.html#Zeichens_00e4tze_002fdie-Verwendung-von-UTF_002d8">Zeichens?tze/die Verwendung von UTF-8</a>:  Was bei der Verwendung von UTF-8 zu beachten ist
41
<li><a accesskey="2" href="_00c4nderungen-an-Konfigurationsdateien.html#g_t_00c4nderungen-an-Konfigurationsdateien">?nderungen an Konfigurationsdateien</a>:  Anpassungen f?r Anmeldung am Server und Featureunterst?tzung
42
<li><a accesskey="3" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">Erweiterung f?r servergespeicherte Prozeduren</a>:  Lx-Office benutzt servergespeicherte Prozeduren
40
<li><a accesskey="1" href="Zeichens_00c3_00a4tze_002fdie-Verwendung-von-UTF_002d8.html#Zeichens_00c3_00a4tze_002fdie-Verwendung-von-UTF_002d8">Zeichensätze/die Verwendung von UTF-8</a>:  Was bei der Verwendung von UTF-8 zu beachten ist
41
<li><a accesskey="2" href="_00c3_0084nderungen-an-Konfigurationsdateien.html#g_t_00c3_0084nderungen-an-Konfigurationsdateien">Änderungen an Konfigurationsdateien</a>:  Anpassungen für Anmeldung am Server und Featureunterstützung
42
<li><a accesskey="3" href="Erweiterung-f_00c3_00bcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00c3_00bcr-servergespeicherte-Prozeduren">Erweiterung für servergespeicherte Prozeduren</a>:  Lx-Office benutzt servergespeicherte Prozeduren
43 43
<li><a accesskey="4" href="Datenbankbenutzer-anlegen.html#Datenbankbenutzer-anlegen">Datenbankbenutzer anlegen</a>:  Um den Zugriff besser zu reglementieren
44 44
</ul>
45 45

  
doc/INSTALL/Apache_002dKonfiguration.html
36 36

  
37 37
<p>Der Zugriff auf das Programmverzeichnis muss in der Apache
38 38
Webserverkonfigurationsdatei <code>httpd.conf</code> eingestellt
39
werden. F?gen Sie den folgenden Abschnitt dieser Datei oder einer
39
werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer
40 40
anderen Datei hinzu, die beim Starten des Webservers eingelesen wird:
41 41

  
42 42
   <p><code><br>
......
68 68
Plus &lsquo;<samp><span class="samp">+</span></samp>&rsquo; gesetzt werden.
69 69

  
70 70
   <p>Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets
71
nicht ausgeliefert. In solchen F?llen hat es oft geholfen, die
71
nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die
72 72
folgende Option in die Konfiguration aufzunehmen:
73 73

  
74 74
   <p><code>EnableSendfile Off</code>
doc/INSTALL/Authentifizierungsdatenbank.html
7 7
<link title="Top" rel="start" href="index.html#Top">
8 8
<link rel="up" href="Benutzerauthentifizierung-und-Administratorpasswort.html#Benutzerauthentifizierung-und-Administratorpasswort" title="Benutzerauthentifizierung und Administratorpasswort">
9 9
<link rel="prev" href="Administratorpasswort.html#Administratorpasswort" title="Administratorpasswort">
10
<link rel="next" href="Passwort_00fcberpr_00fcfung.html#Passwort_00fcberpr_00fcfung" title="Passwort?berpr?fung">
10
<link rel="next" href="Passwort_00c3_00bcberpr_00c3_00bcfung.html#Passwort_00c3_00bcberpr_00c3_00bcfung" title="Passwortüberprüfung">
11 11
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
12 12
<meta http-equiv="Content-Style-Type" content="text/css">
13 13
<style type="text/css"><!--
......
26 26
<div class="node">
27 27
<p>
28 28
<a name="Authentifizierungsdatenbank"></a>
29
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Passwort_00fcberpr_00fcfung.html#Passwort_00fcberpr_00fcfung">Passwort?berpr?fung</a>,
29
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Passwort_00c3_00bcberpr_00c3_00bcfung.html#Passwort_00c3_00bcberpr_00c3_00bcfung">Passwortüberprüfung</a>,
30 30
voriges:&nbsp;<a rel="previous" accesskey="p" href="Administratorpasswort.html#Administratorpasswort">Administratorpasswort</a>,
31 31
aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="Benutzerauthentifizierung-und-Administratorpasswort.html#Benutzerauthentifizierung-und-Administratorpasswort">Benutzerauthentifizierung und Administratorpasswort</a>
32 32
<hr>
......
43 43
<li>&lsquo;<samp><span class="samp">port</span></samp>&rsquo; &ndash; Die Portnummer des Datenbankservers, meist 5432
44 44
<li>&lsquo;<samp><span class="samp">db</span></samp>&rsquo; &ndash; Der Name der Authentifizierungsdatenbank
45 45
<li>&lsquo;<samp><span class="samp">user</span></samp>&rsquo; &ndash; Der Benutzername, mit dem sich Lx-Office beim Datenbankserver anmeldet (z.B. &ldquo;postgres&rdquo;)
46
<li>&lsquo;<samp><span class="samp">password</span></samp>&rsquo; &ndash; Das Passwort f?r den Datenbankbenutzer
46
<li>&lsquo;<samp><span class="samp">password</span></samp>&rsquo; &ndash; Das Passwort für den Datenbankbenutzer
47 47
</ul>
48 48

  
49 49
   <p>Die Datenbank muss noch nicht existieren. Lx-Office kann sie
doc/INSTALL/Ben_00c3_00b6tigte-Software-und-Pakete.html
1
<html lang="en">
2
<head>
3
<title>Benötigte Software und Pakete - Lx-Office Installationsanleitung</title>
4
<meta http-equiv="Content-Type" content="text/html">
5
<meta name="description" content="Lx-Office Installationsanleitung">
6
<meta name="generator" content="makeinfo 4.11">
7
<link title="Top" rel="start" href="index.html#Top">
8
<link rel="prev" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise" title="Aktuelle Hinweise">
9
<link rel="next" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes" title="Installation des Programmpaketes">
10
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
11
<meta http-equiv="Content-Style-Type" content="text/css">
12
<style type="text/css"><!--
13
  pre.display { font-family:inherit }
14
  pre.format  { font-family:inherit }
15
  pre.smalldisplay { font-family:inherit; font-size:smaller }
16
  pre.smallformat  { font-family:inherit; font-size:smaller }
17
  pre.smallexample { font-size:smaller }
18
  pre.smalllisp    { font-size:smaller }
19
  span.sc    { font-variant:small-caps }
20
  span.roman { font-family:serif; font-weight:normal; } 
21
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
22
--></style>
23
</head>
24
<body>
25
<div class="node">
26
<p>
27
<a name="Ben%c3%b6tigte-Software-und-Pakete"></a>
28
<a name="Ben_00c3_00b6tigte-Software-und-Pakete"></a>
29
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>,
30
voriges:&nbsp;<a rel="previous" accesskey="p" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>,
31
aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
32
<hr>
33
</div>
34

  
35
<h2 class="chapter">2 Benötigte Software und Pakete</h2>
36

  
37
<p>Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) benötigt.
38

  
39
   <p>Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind:
40

  
41
     <ul>
42
<li>DBI
43
<li>DBD::Pg
44
<li>CGI::Ajax
45
<li>Class::Accessor
46
<li>Archive::Zip
47
<li>Text::Iconv
48
<li>Text::CSV_XS
49
<li>IO::Wrap (aus dem Paket IO::Stringy)
50
<li>PDF::API2
51
<li>YAML
52
<li>Template
53
<li>List::MoreUtils
54
<li>Email::Address
55
</ul>
56

  
57
   <p>Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
58

  
59
   <p>Für Debian oder Ubuntu benötigen Sie diese Pakete:
60

  
61
   <p><code>apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl libyaml-perl libtext-csv-xs-perl libio-stringy-perl libtemplate-perl lib-uriperl libxml-simple-perl</code>
62

  
63
   <p>Für Fedora Core benötigen Sie unter anderem diese Pakete:
64

  
65
   <p><code>httpd postgresql-server perl-DBI perl-DBD-Pg</code>
66

  
67
   <p>Für OpenSuSE benötigen Sie diese Pakete:
68

  
69
   <p><code>apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy perl-Template-Toolkit perl-URI perl-XML-Writer</code>
70

  
71
   <p>Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als
72
Distributionspakete vorhanden, und/oder nicht praktikabel zu installieren. 
73
In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback.
74

  
75
   <p>Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle
76
benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:
77

  
78
   <p><code>./scripts/installation_check.pl</code>
79

  
80
<!--  -->
81
   </body></html>
82

  
doc/INSTALL/Ben_00f6tigte-Software-und-Pakete.html
1
<html lang="en">
2
<head>
3
<title>Ben?tigte Software und Pakete - Lx-Office Installationsanleitung</title>
4
<meta http-equiv="Content-Type" content="text/html">
5
<meta name="description" content="Lx-Office Installationsanleitung">
6
<meta name="generator" content="makeinfo 4.11">
7
<link title="Top" rel="start" href="index.html#Top">
8
<link rel="prev" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise" title="Aktuelle Hinweise">
9
<link rel="next" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes" title="Installation des Programmpaketes">
10
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
... Dieser Diff wurde abgeschnitten, weil er die maximale Anzahl anzuzeigender Zeilen überschreitet.

Auch abrufbar als: Unified diff