kivitendo/doc/INSTALL @ 32d33e11
| 1840d235 | Moritz Bunkus | Aktuelle Installations- und Konfigurationshinweise:
|
||
===================================================
|
||||
gibt es:
|
||||
-auf der Lx-Office Homepage unter
|
||||
http://lx-office.org/index.php?id=dokumentation
|
||||
-im Lx-Office-Wiki unter Dokumentation
|
||||
http://wiki.lx-office.org/index.php/Lx-Office_ERP
|
||||
-im Lx-Office-Forum:
|
||||
http://www.lx-office.org/forum/
|
||||
=======================================
|
||||
| 4dbb0995 | Moritz Bunkus | |||
Lx-Office ERP
|
||||
Installationsanleitung
|
||||
Folgende Pakete m?ssen installiert sein:
|
||||
========================================
|
||||
Webserver (Apache)
|
||||
PostgreSQL - Datenbank
|
||||
| 3c2b2392 | Holger Lindemann | Perl-DBI, Perl-DBD, Perl-HTML-Template, Perl-CGI-Ajax, Perl-Class-Accessor
|
||
| 4dbb0995 | Moritz Bunkus | Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders hei?en.
|
||
| 3c2b2392 | Holger Lindemann | (Debian: apache, postgresql, libdbi-perl, libdbd-pg-perl, libpgperl, libhtml-template-perl, libclass-accessor-perl)
|
||
| 4dbb0995 | Moritz Bunkus | (Fedora: httpd, postgresql-server, perl-DBI, perl-DBD-Pg)
|
||
(SuSE: apache2, postgresql-server, perl-DBI, perl-DBD-Pg)
|
||||
| 3c2b2392 | Holger Lindemann | Da Perl-CGI-Ajax nicht als Paket f?r Distributionen bereit steht, mu? es mit der CPAN-Shell installiert werden.
|
||
Leider ist dazu nicht jeder in der Lage. LxO liefert daher das Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen.
|
||||
| 4dbb0995 | Moritz Bunkus | Die PostgreSQL Konfiguration mu? angepasst werden.
|
||
==================================================
|
||||
In der Datei postgresql.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) mu? folgender Wert ver?ndert werden:
|
||||
| 3c2b2392 | Holger Lindemann | TCPIP_SOCKET = 1 # Nur PostgreSQL < 8.0
|
||
default_with_oids = on # Nur PostgreSQL >= 8.0
|
||||
| 4dbb0995 | Moritz Bunkus | |||
In der Datei pg_hba.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) m?ssen die Berichtigungen f?r den
|
||||
Zugriff ge?ndert werden:
|
||||
alte Eintragung:
|
||||
----------------
|
||||
local all all ident sameuser
|
||||
host all all 127.0.0.1 255.0.0.0 ident sameuser
|
||||
?nderung:
|
||||
---------
|
||||
local all all trust
|
||||
host all all 127.0.0.1 255.0.0.0 trust
|
||||
| 3c2b2392 | Holger Lindemann | Besser:
|
||
-------
|
||||
local all lxoffice password
|
||||
host all lxoffice 127.0.0.1 255.255.255.255 password
|
||||
| 4dbb0995 | Moritz Bunkus | |||
Installation des Programmpaketes
|
||||
================================
|
||||
| 3c2b2392 | Holger Lindemann | Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) in den DocumentRoot des Webservers
|
||
| 4dbb0995 | Moritz Bunkus | (/var/www/html/ oder /srv/www/htdocs oder /var/www/) entpacken.
|
||
| 3c2b2392 | Holger Lindemann | tar xvzf lxoffice-erp-2.4.x.tgz
|
||
| 4dbb0995 | Moritz Bunkus | |||
Ver?ndern Sie evtl. noch den Namen des Verzeichnisses
|
||||
mv lxoffice-erp/ lx-erp/
|
||||
| 3c2b2392 | Holger Lindemann | oder noch besser, Sie verwenden einen Alias in der Webserverkonfiguration.
|
||
| 4dbb0995 | Moritz Bunkus | Das Verzeichnis mu? dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) ?bergeben werden:
|
||
| 3c2b2392 | Holger Lindemann | chown apache: -R lx-office-erp/
|
||
| 4dbb0995 | Moritz Bunkus | |||
Datenbankbenutzer anlegen
|
||||
=========================
|
||||
Es sollte zum Zugriff auf die PostgreSQL Datenbank ein Datenbankbenutzer angelegt werden. F?hren Sie dazu
|
||||
folgende Befehle nacheinander aus.
|
||||
su - postgres
|
||||
createuser -d lxoffice (ohne Passwort)
|
||||
| 3c2b2392 | Holger Lindemann | oder besser
|
||
createuser -d -P lxoffice (mit Passwort)
|
||||
| 4dbb0995 | Moritz Bunkus | |||
Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern Sie den evtl. voreingestellten Benutzer
|
||||
"postgres" auf "lxoffice".
|
||||
PostgreSQL - Datenbank erweitern
|
||||
================================
|
||||
In der Datenbank "template1" sollte bevor die restliche Konfiguration von LxOffice ERP erfolgt noch folgende
|
||||
Funktion hinzugef?gt werden:
|
||||
| 3c2b2392 | Holger Lindemann | su postgres
|
||
psql template1 (Zugriff ?ber Admintool auf die Datenbank)
|
||||
| 4dbb0995 | Moritz Bunkus | create function plpgsql_call_handler ()
|
||
returns opaque
|
||||
| 3c2b2392 | Holger Lindemann | as '/usr/lib/pgsql/plpgsql.so'
|
||
| 4dbb0995 | Moritz Bunkus | language 'c';
|
||
create language 'plpgsql' handler plpgsql_call_handler
|
||||
lancompiler 'pl/pgsql';
|
||||
| 3c2b2392 | Holger Lindemann | !!!! Bitte beachten Sie, das der Pfad zur Datei plpgsql.so und der Name von Distribution zu Distribution verschieden sein kann.
|
||
| 4dbb0995 | Moritz Bunkus | Bei z.B. Debian befindet sie sich unter '/usr/lib/postgresql/lib/plpgsql.so'.
|
||
Apache Konfiguration
|
||||
====================
|
||||
Der Zugriff auf das Programmverzeichnis mu? in der Apache Webserver- konfiguration httpd.conf
|
||||
(/etc/httpd/conf/) [bei SuSE evtl. httpd2.conf] konfiguriert werden:
|
||||
AddHandler cgi-script .pl
|
||||
Alias /lx-erp/ /var/www/lx-erp/
|
||||
<Directory /var/www/lx-erp>
|
||||
Options ExecCGI Includes FollowSymlinks
|
||||
| 3c2b2392 | Holger Lindemann | DirectoryIndex login.pl # nicht mehr unbedingt n?tig, da eine index.html mitgeliefert wird
|
||
| 4dbb0995 | Moritz Bunkus | </Directory>
|
||
<Directory /var/www/lx-erp/users>
|
||||
Order Deny,Allow
|
||||
Deny from All
|
||||
</Directory>
|
||||
| 3c2b2392 | Holger Lindemann | !!!Vor den einzelnen Optionen mu? bei einigen Distributionen ein Plus "+" gesetzt werden.
|
||
Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets nicht ausgeliefert. Daher die Apache-Konfig um diese Zeile erweitern:
|
||||
EnableSendfile Off
|
||||
| 4dbb0995 | Moritz Bunkus | |||
Datenbank anlegen
|
||||
=================
|
||||
Das Administrationsmen? finden Sie unter:
|
||||
http://localhost/lx-erp/admin.pl
|
||||
Zuerst mu? eine Datenbank angelegt werden. Anschlie?end ein Benutzer. Verwenden Sie f?r den
|
||||
Datenbankzugriff den eben angelegten Benutzer lxoffice.
|
||||
| 54e4131e | Moritz Bunkus | OpenDocument-Vorlagen
|
||
=====================
|
||||
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
|
||||
OpenDocument-Vorlagen zu aktivieren muss in der Datei "lx-erp.conf"
|
||||
die Variable "$opendocument_templates" auf "1" stehen. Dieses ist die
|
||||
Standardeinstellung.
|
||||
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".
|
||||
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.
|
||||
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.
|
||||
"$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".
|
||||
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:
|
||||
mv users/.openoffice.org2 users/.openoffice
|
||||
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.
|
||||
| 4dbb0995 | Moritz Bunkus | Lx-Office ERP verwenden
|
||
=======================
|
||||
Einloggen k?nnen Sie sich unter:
|
||||
| 3c2b2392 | Holger Lindemann | http://localhost/lx-office-erp/login.pl
|