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