doc/installation-erp_01.txt

   1 Aktuelle Installations- und Konfigurationshinweise:
   2
   3 gibt es:
   4 -auf der Lx-Office Homepage unter
   5         http://lx-office.org/index.php?id=dokumentation
   6 -im Lx-Office-Wiki unter Dokumentation
   7         http://wiki.lx-office.org/index.php/Lx-Office_ERP
   8 -im Lx-Office-Forum:
   9         http://www.lx-office.org/forum/
  10
  11 Installationsanleitung:
  12
  13 Folgende Pakete müssen installiert sein:
  14 - Webserver (Apache)
  15 - PostgreSQL - Datenbank
  16 - Perl-DBI, Perl-DBD, Perl-HTML-Template, Perl-CGI-Ajax, Perl-Class-Accessor
  17 Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
  18 (Debian: apache, postgresql, libdbi-perl, libdbd-pg-perl,  libpgperl, libhtml-template-perl, libclass-accessor-perl)
  19 (Fedora: httpd, postgresql-server, perl-DBI, perl-DBD-Pg)
  20 (SuSE: apache2, postgresql-server,  perl-DBI, perl-DBD-Pg)
  21
  22 Da Perl-CGI-Ajax nicht als Paket für Distributionen bereit steht, muß es mit der CPAN-Shell installiert werden.
  23 Leider ist dazu nicht jeder in der Lage. LxO liefert daher das Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen.
  24
  25
  26
  27 Die PostgreSQL Konfiguration muß angepasst werden.
  28 In der Datei postgresql.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) muß folgender Wert verändert werden:
  29
  30 TCPIP_SOCKET = 1 #  Nur PostgreSQL < 8.0
  31
  32 default_with_oids = on # Nur PostgreSQL >= 8.0
  33
  34 In der Datei pg_hba.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) müssen die Berichtigungen für den Zugriff geändert werden:
  35
  36 alte Eintragung:
  37 local   all all                         ident sameuser
  38 host    all all 127.0.0.1 255.0.0.0     ident sameuser
  39
  40 Änderung:
  41 local   all     all                             trust
  42 host    all     all 127.0.0.1 255.0.0.0 trust
  43
  44 Besser:
  45 local   all         lxoffice                                                      password
  46 host    all         lxoffice      127.0.0.1         255.255.255.255    password
  47
  48
  49 Installation des Programmpaketes
  50 Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) in den DocumentRoot des Webservers (/var/www/html/ oder /srv/www/htdocs oder /var/www/) entpacken.
  51
  52 tar xvzf lxoffice-erp-2.4.x.tgz
  53
  54 Verändern Sie evtl. noch den Namen des Verzeichnisses
  55
  56 mv lxoffice-erp/ lx-erp/
  57
  58 oder noch besser, Sie verwenden einen Alias in der Webserverkonfiguration.
  59
  60 Das Verzeichnis muß dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) übergeben werden:
  61
  62 chown -R www-data: lx-office-erp/
  63
  64 Datenbankbenutzer anlegen
  65
  66 Es sollte zum Zugriff auf die PostgreSQL Datenbank ein Datenbankbenutzer angelegt werden. Führen Sie dazu folgende Befehle nacheinander aus.
  67
  68 su - postgres
  69 createuser -d lxoffice (ohne Passwort)
  70 oder besser
  71 createuser -d -P lxoffice (mit Passwort)
  72
  73 Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie den evtl. voreingestellten Benutzer "postgres" auf "lxoffice".
  74
  75 PostgreSQL - Datenbank erweitern
  76 In der Datenbank "template1" sollte bevor die restliche Konfiguration von LxOffice ERP erfolgt noch folgende Funktion hinzugefügt werden:
  77
  78 su postgres
  79 psql template1  (Zugriff über Admintool auf die Datenbank)
  80 create function plpgsql_call_handler ()
  81 returns opaque
  82 as '/usr/lib/pgsql/plpgsql.so'
  83 language 'c';
  84
  85 create language 'plpgsql' handler plpgsql_call_handler
  86 lancompiler 'pl/pgsql';
  87
  88 !!!! Bitte beachten Sie, das der Pfad zur Datei plpgsql.so und der Name von Distribution zu Distribution verschieden sein kann.
  89 Bei z.B. Debian befindet sie sich unter '/usr/lib/postgresql/lib/plpgsql.so'.
  90
  91 Apache Konfiguration
  92 Der Zugriff auf das Programmverzeichnis muß in der Apache Webserver- konfiguration httpd.conf (/etc/httpd/conf/)
  93 [bei SuSE evtl. httpd2.conf, Debian: /etc/apache2/apache2.conf] konfiguriert werden:
  94
  95 AddHandler cgi-script .pl
  96 Alias /lx-erp/ /var/www/lx-erp/
  97 <Directory /var/www/lx-erp>
  98   Options ExecCGI Includes FollowSymlinks
  99   DirectoryIndex login.pl       # nicht mehr unbedingt nötig, da eine index.html mitgeliefert wird
 100 </Directory>
 101 <Directory /var/www/lx-erp/users>
 102   Order Deny,Allow
 103   Deny from All
 104 </Directory>
 105 !!!Vor den einzelnen Optionen muß bei einigen Distributionen ein Plus "+" gesetzt werden.
 106
 107 Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets nicht ausgeliefert. Daher die Apache-Konfig um diese Zeile erweitern:
 108 EnableSendfile Off
 109
 110 Datenbank anlegen
 111 Das Administrationsmenü finden Sie unter:
 112
 113 http://localhost/lx-erp/admin.pl
 114
 115 Zuerst muß eine Datenbank angelegt werden. Anschließend ein Benutzer. Verwenden Sie für den Datenbankzugriff den eben angelegten Benutzer lxoffice.
 116
 117 OpenDocument-Vorlagen
 118 Lx-Office unterstützt die Verwendung von Vorlagen im OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt. Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
 119 OpenDocument-Vorlagen zu aktivieren muss in der Datei "lx-erp.conf" die Variable "$opendocument_templates" auf "1" stehen.  Dieses ist die Standardeinstellung.
 120
 121 Weiterhin muss in der Datei "lx-erp.conf" die Variable "$dbcharset" auf die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den meisten Fällen "ISO-8859-15".
 122
 123 Während die Erzeugung von reinen OpenDocument-Dateien keinerlei weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss neben OpenOffice.org ab Version 2 auch der "X virtual frame buffer" (xvfb) installiert werden.  Bei Debian ist er im Paket "xvfb" enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
 124
 125 Nach der Installation müssen in der Datei "lx-erp.conf" zwei weitere Variablen angepasst werden: "$openofficeorg_writer_bin" muss den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
 126 "$xvfb_run_bin" muss den Pfad zu einem Script enthalten, dass den "X virtual frame buffer" startet und direkt danach ein Programm in ihm startet, das dem Script als Parameter übergeben wird. Lx-Office enthält bereits ein solches Script namens "xvfb-run", das standardmäßig verwendet wird. Es handelt sich dabei um eine gestutzte Version des Scripts "xvfb-run" aus dem Debian-Paket "xvfb".
 127
 128 Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter Debian ist dies momentan "~/.openoffice.org2". Sollte der Name bei Ihrer OpenOffice.org-Installation anders sein, so muss das Verzeichnis "users/.openoffice.org2" entsprechend umbenannt werden. Ist der Name z.B. einfach nur ".openoffice", so wäre folgender Befehl auszuführen:
 129
 130 mv users/.openoffice.org2 users/.openoffice
 131
 132 Dieses Verzeichnis, wie auch das komplette "users"-Verzeichnis, muss vom Webserver beschreibbar sein. Dieses wurde in Schritt "Installation des Programmpakets" oben bereits erledigt, kann aber erneut überprüft werden, wenn die Konvertierung nach PDF fehlschlägt.
 133
 134 Lx-Office ERP verwenden
 135 Einloggen können Sie sich unter:
 136         http://localhost/lx-office-erp/login.pl
 137 Die Adminseite erreichen Sie unter:
 138         http://localhost/lx-office-erp/admin.pl