1 Aktuelle Installations- und Konfigurationshinweise:
2 ===================================================
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
11 http://www.lx-office.org/forum/
13 =======================================
16 Installationsanleitung
19 Folgende Pakete müssen installiert sein:
20 ========================================
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)
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.
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:
38 TCPIP_SOCKET = 1 # Nur PostgreSQL < 8.0
40 default_with_oids = on # Nur PostgreSQL >= 8.0
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:
48 local all all ident sameuser
49 host all all 127.0.0.1 255.0.0.0 ident sameuser
54 host all all 127.0.0.1 255.0.0.0 trust
58 local all lxoffice password
59 host all lxoffice 127.0.0.1 255.255.255.255 password
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.
67 tar xvzf lxoffice-erp-2.4.x.tgz
69 Verändern Sie evtl. noch den Namen des Verzeichnisses
71 mv lxoffice-erp/ lx-erp/
73 oder noch besser, Sie verwenden einen Alias in der Webserverkonfiguration.
75 Das Verzeichnis muß dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) übergeben werden:
77 chown apache: -R lx-office-erp/
80 Datenbankbenutzer anlegen
81 =========================
83 Es sollte zum Zugriff auf die PostgreSQL Datenbank ein Datenbankbenutzer angelegt werden. Führen Sie dazu
84 folgende Befehle nacheinander aus.
87 createuser -d lxoffice (ohne Passwort)
89 createuser -d -P lxoffice (mit Passwort)
91 Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie den evtl. voreingestellten Benutzer
92 "postgres" auf "lxoffice".
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:
101 psql template1 (Zugriff über Admintool auf die Datenbank)
102 create function plpgsql_call_handler ()
104 as '/usr/lib/pgsql/plpgsql.so'
107 create language 'plpgsql' handler plpgsql_call_handler
108 lancompiler 'pl/pgsql';
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'.
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:
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
126 <Directory /var/www/lx-erp/users>
131 !!!Vor den einzelnen Optionen muß bei einigen Distributionen ein Plus "+" gesetzt werden.
133 Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets nicht ausgeliefert. Daher die Apache-Konfig um diese Zeile erweitern:
139 Das Administrationsmenü finden Sie unter:
141 http://localhost/lx-erp/admin.pl
143 Zuerst muß eine Datenbank angelegt werden. Anschließend ein Benutzer. Verwenden Sie für den
144 Datenbankzugriff den eben angelegten Benutzer lxoffice.
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
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".
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.
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_bin" muss den Pfad zum "X virtual frame buffer" enthalten.
174 Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
175 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn
176 die Variable "$openofficeorg_daemon" gesetzt ist, startet ein
177 OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
178 bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
179 benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
180 reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
181 werden muss. Der Nachteil ist, dass diese Methode Python und die
182 Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind.
184 Ist "$openofficeorg_daemon" nicht gesetzt, so wird für jedes Dokument
185 OpenOffice neu gestartet und die Konvertierung mit Hilfe eines Makros
186 durchgeführt. Dieses Makro muss in der Dokumentenvorlage enthalten
187 sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die
188 Beispielvorlage templates/German-invoice.odt enthält ein solches
189 Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein
192 Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org
193 Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter
194 Debian ist dies momentan "~/.openoffice.org2". Sollte der Name bei
195 Ihrer OpenOffice.org-Installation anders sein, so muss das Verzeichnis
196 "users/.openoffice.org2" entsprechend umbenannt werden. Ist der Name
197 z.B. einfach nur ".openoffice", so wäre folgender Befehl auszuführen:
199 mv users/.openoffice.org2 users/.openoffice
201 Dieses Verzeichnis, wie auch das komplette "users"-Verzeichnis, muss
202 vom Webserver beschreibbar sein. Dieses wurde in Schritt "Installation
203 des Programmpakets" oben bereits erledigt, kann aber erneut überprüft
204 werden, wenn die Konvertierung nach PDF fehlschlägt.
207 Lx-Office ERP verwenden
208 =======================
209 Einloggen können Sie sich unter:
211 http://localhost/lx-office-erp/login.pl