doc/INSTALL

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