doc/INSTALL.txt

   1 Table of Contents
   2 *****************
   3
   4 Inhalt der Anleitung
   5 1 Aktuelle Hinweise
   6 2 Benötigte Software und Pakete
   7 3 Installation des Programmpaketes
   8 4 Anpassung der PostgreSQL-Konfiguration
   9   4.1 Änderungen an Konfigurationsdateien
  10   4.2 Erweiterung für servergespeicherte Prozeduren
  11   4.3 Datenbankbenutzer anlegen
  12 5 Apache-Konfiguration
  13 6 Benutzerauthentifizierung und Administratorpasswort
  14   6.1 Grundlagen zur Benutzerauthentifizierung
  15   6.2 Administratorpasswort
  16   6.3 Authentifizierungsdatenbank
  17   6.4 Passwortüberprüfung
  18   6.5 Name des Session-Cookies
  19   6.6 Anlegen der Authentifizierungsdatenbank
  20 7 Benutzer- und Gruppenverwaltung
  21   7.1 Zusammenhänge
  22   7.2 Datenbanken anlegen
  23   7.3 Gruppen anlegen
  24   7.4 Benutzer anlegen
  25   7.5 Gruppenmitgliedschaften verwalten
  26   7.6 Migration alter Installationen
  27 8 OpenDocument-Vorlagen
  28 9 Lx-Office ERP verwenden
  29
  30
  31 Inhalt der Anleitung
  32 ********************
  33
  34 1 Aktuelle Hinweise
  35 *******************
  36
  37 Aktuelle Installations- und Konfigurationshinweise gibt es:
  38
  39    * auf der Lx-Office Homepage unter
  40      `http://lx-office.org/index.php?id=dokumentation'
  41
  42    * im Lx-Office-Wiki unter Dokumentation
  43      (`http://wiki.lx-office.org/index.php/Lx-Office_ERP')
  44
  45    * im Lx-Office-Forum: `http://www.lx-office.org/forum/'
  46
  47 2 Benötigte Software und Pakete
  48 *******************************
  49
  50 Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)
  51 und ein Datenbankserver (PostgreSQL) benötigt.
  52
  53    Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht
  54 Bestandteil einer Standard-Perl-Installation sind:
  55
  56    * DBI
  57
  58    * DBD::Pg
  59
  60    * CGI::Ajax
  61
  62    * Class::Accessor
  63
  64    * Archive::Zip
  65
  66    * Text::Iconv
  67
  68    * Text::CSV_XS
  69
  70    * IO::Wrap (aus dem Paket IO::Stringy)
  71
  72    * PDF::API2
  73
  74    * YAML
  75
  76    * Template
  77
  78    Diese Pakete können bei den unterschiedlichen Distributionen anders
  79 heißen.
  80
  81    Für Debian oder Ubuntu benötigen Sie diese Pakete:
  82
  83    `apache postgresql libdbi-perl libdbd-pg-perl libpgperl
  84 libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl
  85 libyaml-perl libtext-csv-perl libio-stringy-perl libtemplate-perl'
  86
  87    Für Fedora Core benötigen Sie unter anderem diese Pakete:
  88
  89    `httpd postgresql-server perl-DBI perl-DBD-Pg'
  90
  91    Für OpenSuSE benötigen Sie diese Pakete:
  92
  93    `apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip
  94 perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy
  95 perl-Template-Toolkit'
  96
  97    Da Perl-CGI-Ajax nicht als Paket für Distributionen bereit steht, muß
  98 es mit der CPAN-Shell installiert werden.  Leider gibt es Fälle, in
  99 denen das nicht möglich oder praktikabel ist. Lx-Office liefert daher
 100 das Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen.
 101
 102 3 Installation des Programmpaketes
 103 **********************************
 104
 105 Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) wird im
 106 Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/',
 107 `/srv/www/htdocs' oder `/var/www/') entpackt:
 108
 109    `cd /var/www
 110 tar xvzf lxoffice-erp-2.4.x.tgz'
 111
 112    Verändern Sie evtl. noch den Namen des Verzeichnisses mit
 113
 114    `mv lxoffice-erp/ lx-erp/'
 115
 116    Alternativ können Sie auch einen Alias in der Webserverkonfiguration
 117 benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen.
 118
 119    Das Verzeichnis muß für den Benutzer beschreibbar sein, unter dem der
 120 Webserver läuft. Dieser ist bei verschiedenen Distributionen
 121 unterschiedlich (z.B. bei Debian/Ubuntu `www-data', bei Fedora core
 122 `apache' oder bei OpenSuSE `wwwrun').
 123
 124    `chown -R www-data: lx-office-erp/'
 125
 126 4 Anpassung der PostgreSQL-Konfiguration
 127 ****************************************
 128
 129 PostgreSQL muss auf verschiedene Weisen angepasst werden.
 130
 131 4.1 Änderungen an Konfigurationsdateien
 132 =======================================
 133
 134 In der Datei `postgresql.conf', die je nach Distribution in
 135 verschiedenen Verzeichnissen liegen kann (z.B. `/var/lib/pgsql/data/'
 136 oder `/etc/postgresql/', muss sichergestellt werden, dass
 137 TCP/IP-Verbindungen aktiviert sind. Dieser Parameter lautet
 138
 139    `TCPIP_SOCKET = 1'
 140
 141    Bei PostgreSQL-Versionen ab v8.0 und neuer muss zusätzlich der
 142 folgende Parameter gesetzt werden:
 143
 144    `default_with_oids = on'
 145
 146    In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die
 147 `postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für
 148 den Zugriff geändert werden. Hier gibt es mehrere Möglichkeiten. Eine
 149 besteht darin, lokale Verbindungen immer zuzulassen
 150
 151    `local all all trust
 152 host all all 127.0.0.1 255.0.0.0 trust'
 153
 154    Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort
 155 zuzulassen. Beispielsweise:
 156
 157    `local   all         lxoffice
 158   password
 159 host    all         lxoffice      127.0.0.1         255.255.255.255
 160 password'
 161
 162 4.2 Erweiterung für servergespeicherte Prozeduren
 163 =================================================
 164
 165 In der Datenbank `template1' muss die Unterstützung für
 166 servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür
 167 als Benutzer "postgres" an der Datenbank an, und führen Sie die
 168 folgenden Kommandos aus:
 169
 170    `create function plpgsql_call_handler () returns opaque as
 171 '/usr/lib/pgsql/plpgsql.so' language 'c';
 172 create language 'plpgsql' handler plpgsql_call_handler lancompiler
 173 'pl/pgsql';'
 174
 175    Bitte beachten Sie, dass der Pfad zur Datei `plpgsql.so' von
 176 Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu
 177 befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so'.
 178
 179 4.3 Datenbankbenutzer anlegen
 180 =============================
 181
 182 Wenn Sie nicht den Datenbanksuperuser "postgres" zum Zugriff benutzen
 183 wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer anlegen. Ein
 184 Beispiel, wie Sie einen neuen Benutzer anlegen können:
 185
 186    `su - postgres
 187 createuser -d -P lxoffice'
 188
 189    Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie
 190 den evtl. voreingestellten Benutzer "postgres" auf "lxoffice" bzw. den
 191 hier gewählten Benutzernamen.
 192
 193 5 Apache-Konfiguration
 194 **********************
 195
 196 Der Zugriff auf das Programmverzeichnis muss in der Apache
 197 Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie
 198 den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu,
 199 die beim Starten des Webservers eingelesen wird:
 200
 201    `
 202 AddHandler cgi-script .pl
 203 Alias /lx-erp/ /var/www/lx-erp/
 204 <Directory /var/www/lx-erp>
 205 Options ExecCGI Includes FollowSymlinks
 206 </Directory>
 207 <Directory /var/www/lx-erp/users>
 208 Order Deny,Allow
 209 Deny from All
 210 </Directory>
 211 '
 212
 213    Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher das
 214 Lx-Office-Archiv entpacket haben.
 215
 216    Achtung: Vor den einzelnen Optionen muss bei einigen Distributionen
 217 ein Plus `+' gesetzt werden.
 218
 219    Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets
 220 nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die folgende
 221 Option in die Konfiguration aufzunehmen:
 222
 223    `EnableSendfile Off'
 224
 225 6 Benutzerauthentifizierung und Administratorpasswort
 226 *****************************************************
 227
 228 Informationen über die Einrichtung der Benutzerauthentifizierung, über
 229 die Verwaltung von Gruppen und weitere Einstellungen
 230
 231 6.1 Grundlagen zur Benutzerauthentifizierung
 232 ============================================
 233
 234 Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die
 235 im folgenden "Authentifizierungsdatenbank" genannt wird. Für jeden
 236 Benutzer kann dort eine eigene Datenbank für die eigentlichen
 237 Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen
 238 aber nicht unterschiedlich sein.
 239
 240    Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank,
 241 in der sowohl die Benutzerinformationen als auch die Daten abgelegt
 242 werden.
 243
 244    Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter
 245 entweder gegen die Authentifizierungsdatenbank oder gegen einen
 246 LDAP-Server überprüft werden.
 247
 248    Welche Art der Passwortüberprüfung Lx-Office benutzt und wie
 249 Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der
 250 Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss
 251 bei der Installation und bei einem Upgrade von einer Version vor v2.6.0
 252 angelegt werden. Eine Beispielkonfigurationsdatei
 253 `config/authentication.pl.default' existiert, die als Vorlage benutzt
 254 werden kann.
 255
 256 6.2 Administratorpasswort
 257 =========================
 258
 259 Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt
 260 wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort
 261 und nicht mehr im Administrationsinterface selber geändert werden. Der
 262 Parameter dazu heißt `$self->{admin_password}'.
 263
 264 6.3 Authentifizierungsdatenbank
 265 ===============================
 266
 267 Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern
 268 in `$self->{DB_config}' konfiguriert. Hier sind die folgenden Parameter
 269 anzugeben:
 270
 271    * `host' - Der Rechnername oder die IP-Adresse des Datenbankservers
 272
 273    * `port' - Die Portnummer des Datenbankservers, meist 5432
 274
 275    * `db' - Der Name der Authentifizierungsdatenbank
 276
 277    * `user' - Der Benutzername, mit dem sich Lx-Office beim
 278      Datenbankserver anmeldet (z.B. "postgres")
 279
 280    * `password' - Das Passwort für den Datenbankbenutzer
 281
 282    Die Datenbank muss noch nicht existieren. Lx-Office kann sie
 283 automatisch anlegen (mehr dazu siehe unten).
 284
 285 6.4 Passwortüberprüfung
 286 =======================
 287
 288 Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die
 289 Authentifizierungsdatenbank und gegen einen externen LDAP- oder
 290 Active-Directory-Server. Welche davon benutzt wird, regelt der
 291 Parameter `$self->{module}'.
 292
 293    Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank
 294 gespeichert werden, so muss der Parameter `$self->{module}' den Wert
 295 `DB' enthalten. In diesem Fall können sowohl der Administrator als auch
 296 die Benutzer selber ihre Psaswörter in Lx-Office ändern.
 297
 298    Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt
 299 werden, so muss der Parameter `$self->{module}' auf `LDAP' gesetzt
 300 werden. In diesem Fall müssen zusätzliche Informationen über den
 301 LDAP-Server in `$self->{LDAP_config}' angegeben werden:
 302
 303    * `host' - Der Rechnername oder die IP-Adresse des LDAP- oder
 304      Active-Directory-Servers. Diese Angabe ist zwingend erforderlich.
 305
 306    * `port' - Die Portnummer des LDAP-Servers; meist 389.
 307
 308    * `tls' - Wenn Verbindungsverschlüsselung gewünscht ist, so diesen
 309      Wert auf `1' setzen, andernfalls auf `0' belassen
 310
 311    * `attribute'' - Das LDAP-Attribut, in dem der Benutzername steht,
 312      den der Benutzer eingegeben hat. Für Active-Directory-Server   ist
 313      dies meist `sAMAccountName', für andere LDAP-Server hingegen
 314      `uid'. Diese Angabe ist zwingend erforderlich.
 315
 316    * `base_dn' - Der Abschnitt des LDAP-Baumes, der durchsucht werden
 317      soll. Diese Angabe ist zwingend erforderlich.
 318
 319    * `filter' - Ein optionaler LDAP-Filter. Enthält dieser Filter das
 320      Wort `<%login%>', so wird dieses durch den vom Benutzer
 321      eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum
 322      nach einem Element durchsucht, bei dem das oben angegebene Attribut
 323       mit dem Benutzernamen identisch ist.
 324
 325    * `bind_dn' und `bind_password' - Wenn der LDAP-Server eine
 326      Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist
 327      dies bei   Active-Directory-Servern der Fall), so kann diese hier
 328      angegeben werden. Für Active-Directory-Server kann als `bind_dn'
 329      entweder eine   komplette LDAP-DN wie z.B. `cn=Martin
 330      Mustermann,cn=Users,dc=firmendomain' auch nur der volle Name des
 331      Benutzers   eingegeben werden; in diesem Beispiel also `Martin
 332      Mustermann'.
 333
 334 6.5 Name des Session-Cookies
 335 ============================
 336
 337 Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt
 338 werden, so müssen die Namen der Session-Cookies für alle Installationen
 339 unterschiedlich sein. Der Name des Cookies wird mit dem Parameter
 340 `$self->{cookie_name}' gesetzt.
 341
 342    Diese Angabe ist optional, wenn nur eine Installation auf dem Server
 343 existiert.
 344
 345 6.6 Anlegen der Authentifizierungsdatenbank
 346 ===========================================
 347
 348 Nachdem alle Einstellungen in `config/authentication.pl' vorgenommen
 349 wurden, muss Lx-Office die Authentifizierungsdatenbank anlegen. Dieses
 350 geschieht automatisch, wenn Sie sich im Administrationsmodul anmelden,
 351 das unter der folgenden URL erreichbar sein sollte:
 352
 353    `http://localhost/lx-erp/admin.pl'
 354
 355 7 Benutzer- und Gruppenverwaltung
 356 *********************************
 357
 358 Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt
 359 werden.  Dieses geschieht im Administrationsmenü, dass Sie unter
 360 folgender URL finden:
 361
 362    `http://localhost/lx-erp/admin.pl'
 363
 364    Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei
 365 `config/authentication.pl' eingetragen haben.
 366
 367 7.1 Zusammenhänge
 368 =================
 369
 370 Lx-Office verwendet eine Datenbank zum Speichern all seiner
 371 Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um
 372 mit Lx-Office arbeiten zu können, muss eine Person einen
 373 Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine
 374 Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist
 375 möglich und normal, dass mehreren Benutzern die selbe Datenbank
 376 zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können.
 377
 378    Die Basisdaten der Benutzer, die in der Administration eingegeben
 379 werden können, werden in einer zweiten Datenbank gespeichert, der
 380 bereits erwähnten Authentifizierungsdatenbank. Diese ist also den
 381 Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro
 382 Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,
 383 aber beliebig viele Datenbanken mit Firmendaten.
 384
 385    Lx-Office lann seinen Benutzern Zugriff auf bestimmte
 386 Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
 387 gestattet, so werden der entsprechenden Menüpunkte auch nicht
 388 angezeigt. Diese Rechte werden ebenfalls in der
 389 Authentifizierungsdatenbank gespeichert.
 390
 391    Um Rechte verteilen zu können, verwendet Lx-Office ein
 392 Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche
 393 erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder
 394 mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen
 395 Funktionen, die mindestens einer Gruppe erlaubt sind, in der der
 396 Benutzer Mitglied ist.
 397
 398    Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und Benutzer
 399 angelegt werden sollten, lautet:
 400
 401   1. Datenbank anlegen
 402
 403   2. Gruppen anlegen
 404
 405   3. Benutzer anlegen
 406
 407   4. Benutzer den Gruppen zuordnen
 408
 409 7.2 Datenbanken anlegen
 410 =======================
 411
 412 Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den
 413 Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen
 414 ist dies `lxoffice').
 415
 416    Wenn Sie für die Lx-Office-Installation nicht den europäischen
 417 Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
 418 müssen Sie vor dem Anlegen der Datenbank in der Datei
 419 `config/lx-erp.conf' die Variable `$dbcharset' auf den Wert `UTF-8'
 420 setzen. Zusätzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als
 421 Schriftsatz ausgewählt werden.
 422
 423    Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
 424 verwenden müssen, da diese Einstellungen momentan global in Lx-Office
 425 vorgenommen wird und nicht nach Datenbank unterschieden werden kann.
 426 Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz
 427 angelegt worden sein.
 428
 429 7.3 Gruppen anlegen
 430 ===================
 431
 432 Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name
 433 gegeben werden, eine Beschreibung ist hingegen optional. Nach dem
 434 Anlegen können Sie die verschiedenen Bereiche wählen, auf die
 435 Mitglieder dieser Gruppe Zugriff haben sollen.
 436
 437    Benutzergruppen sind unabhängig von Datenbanken, da sie in der
 438 Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle
 439 Datenbanken, die in dieser Installation verwaltet werden.
 440
 441 7.4 Benutzer anlegen
 442 ====================
 443
 444 Beim Anlegen von Benutzern werden für viele Parameter
 445 Standardeinstellungen vorgenommen, die den Gepflogenheiten des
 446 deutschen Raumes entsprechen.
 447
 448    Zwingend anzugeben sind der Loginname sowie die komplette
 449 Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die
 450 Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort
 451 gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung
 452 aktiv, so ist das Passwort-Feld deaktiviert.
 453
 454    In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben
 455 angelegten Datenbanken eingetragen werden.
 456
 457 7.5 Gruppenmitgliedschaften verwalten
 458 =====================================
 459
 460 Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen
 461 zugewiesen werden. Dazu gibt es zwei Möglichkeiten:
 462
 463   1. In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden
 464      Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen.
 465
 466   2. In der Gruppenverwaltung wählt man das Tool zur Verwaltung der
 467      Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im
 468      System angelegten Gruppen und Benutzer enthält. Durch Setzen der
 469      Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in
 470      der ausgewählten Spalte hinzugefügt.
 471
 472 7.6 Migration alter Installationen
 473 ==================================
 474
 475 Wenn Lx-Office 2.6.0 über eine ältere Version installiert wird, in der
 476 die Benutzerdaten noch im Dateisystem im Verzeichnis `users' verwaltet
 477 wurden, so bietet Lx-Office die Möglichkeit, diese Benutzerdaten
 478 automatisch in die Authentifizierungsdatenbank zu übernehmen. Dies
 479 geschieht, wenn man sich nach dem Update der Installation das erste Mal
 480 im Administrationsbereich anmeldet. Findet Lx-Office die Datei
 481 `users/members', so wird der Migrationsprozess gestartet.
 482
 483    Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten
 484 können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch
 485 die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird.
 486 Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gewährt.
 487 Alle migrierten Benutzern werden Mitglied in dieser Gruppe. Damit wird
 488 das Verhalten von Lx-Office bis Version 2.4.3 inklusive
 489 wiederhergestellt, und die Benutzer können sich sofort wieder anmelden
 490 und mit dem System arbeiten.
 491
 492 8 OpenDocument-Vorlagen
 493 ***********************
 494
 495 Lx-Office unterstützt die Verwendung von Vorlagen im
 496 OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
 497 Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus
 498 diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
 499 OpenDocument-Vorlagen zu aktivieren muss in der Datei
 500 `config/lx-erp.conf' die Variable `$opendocument_templates' auf `1'
 501 stehen.  Dieses ist die Standardeinstellung.
 502
 503    Weiterhin muss in der Datei `config/lx-erp.conf' die Variable
 504 `$dbcharset' auf die Zeichenkodierung gesetzt werden, die auch bei der
 505 Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den
 506 meisten Fällen "ISO-8859-15".
 507
 508    Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
 509 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
 510 OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
 511 neben OpenOffice.org ab Version 2 auch der "X virtual frame buffer"
 512 (xvfb) installiert werden.  Bei Debian ist er im Paket "xvfb"
 513 enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
 514
 515    Nach der Installation müssen in der Datei `config/lx-erp.conf' zwei
 516 weitere Variablen angepasst werden: `$openofficeorg_writer_bin' muss
 517 den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
 518 `$xvfb_bin' muss den Pfad zum "X virtual frame buffer" enthalten.
 519
 520    Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
 521 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
 522 Variable `$openofficeorg_daemon' gesetzt ist, startet ein OpenOffice,
 523 das auch nach der Umwandlung des Dokumentes gestartet bleibt. Bei
 524 weiteren Umwandlungen wird dann diese laufende Instanz benutzt. Der
 525 Vorteil ist, dass die Zeit zur Umwandlung deutlich reduziert wird, weil
 526 nicht für jedes Dokument ein OpenOffice gestartet werden muss. Der
 527 Nachteil ist, dass diese Methode Python und die Python-UNO-Bindings
 528 benötigt, die Bestandteil von OpenOffice 2 sind.
 529
 530    Ist `$openofficeorg_daemon' nicht gesetzt, so wird für jedes
 531 Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe eines
 532 Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage
 533 enthalten sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die
 534 Beispielvorlage `templates/German-invoice.odt' enthält ein solches
 535 Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein
 536 muss.
 537
 538    Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org
 539 Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter Debian
 540 ist dies momentan `~/.openoffice.org2'. Sollte der Name bei Ihrer
 541 OpenOffice.org-Installation anders sein, so muss das Verzeichnis
 542 `users/.openoffice.org2' entsprechend umbenannt werden. Ist der Name
 543 z.B. einfach nur `.openoffice', so wäre folgender Befehl auszuführen:
 544
 545    `mv users/.openoffice.org2 users/.openoffice'
 546
 547    Dieses Verzeichnis, wie auch das komplette `users'-Verzeichnis, muss
 548 vom Webserver beschreibbar sein. Dieses wurde in Schritt `Installation
 549 des Programmpakets' oben bereits erledigt, kann aber erneut überprüft
 550 werden, wenn die Konvertierung nach PDF fehlschlägt.
 551
 552 9 Lx-Office ERP verwenden
 553 *************************
 554
 555 Nach erfolgreicher Installation ist der Loginbildschirm unter folgender
 556 URL erreichbar:
 557
 558    `http://localhost/lx-office-erp/login.pl'
 559
 560    Die Administrationsseite erreichen Sie unter:
 561
 562    `http://localhost/lx-office-erp/admin.pl'
 563