X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL;h=b259ce0dd20eff958f3840ec4ca3331a99a3e442;hb=6d1df9ca24bbb8c03e10812ce4cf1b889d947470;hp=0248a6b64609ccccbe802bad2db9aa20f99c3f89;hpb=d319704a66e9be64da837ccea10af6774c2b0838;p=kivitendo-erp.git
diff --git a/doc/INSTALL b/doc/INSTALL
index 0248a6b64..b259ce0dd 100644
--- a/doc/INSTALL
+++ b/doc/INSTALL
@@ -1,3 +1,18 @@
+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/
+
+=======================================
Lx-Office ERP
Installationsanleitung
@@ -5,71 +20,128 @@ Installationsanleitung
Folgende Pakete müssen installiert sein:
========================================
+
Webserver (Apache)
-PostgreSQL - Datenbank
-Perl - DBI und Perl - DBD
-Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
-(Debian: apache, postgresql, libdbi-perl, libdbd-pg-perl, libpgperl)
-(Fedora: httpd, postgresql-server, perl-DBI, perl-DBD-Pg)
-(SuSE: apache2, postgresql-server, perl-DBI, perl-DBD-Pg)
+PostgreSQL - Datenbank
+
+Benötigte Perl-Pakete, die nicht Bestandteil einer
+Standard-Perl-Installation sind:
+
+* DBI
+* DBD::Pg
+* HTML::Template
+* CGI::Ajax
+* Class::Accessor
+* Archive::Zip
+* Text::Iconv
+* Text::CSV_XS
+* IO::Wrap (aus dem Paket IO::Stringy)
+* YAML
+* Template
+
+Diese Pakete können bei den unterschiedlichen Distributionen anders
+heißen.
+
+Für Debian beötigen Sie diese Pakete:
+
+ apache, postgresql, libdbi-perl, libdbd-pg-perl, libpgperl,
+ libhtml-template-perl, libclass-accessor-perl, libarchive-zip-perl,
+ libtext-iconv-perl, libyaml-perl, libtext-csv-perl,
+ libio-stringy-perl, libtemplate-perl
+
+Für Fedora Core beötigen Sie unter anderem diese Pakete:
+
+ httpd, postgresql-server, perl-DBI, perl-DBD-Pg
+
+Für OpenSuSE beötigen Sie diese Pakete:
+
+ apache2, postgresql-server, perl-DBI, perl-DBD-Pg, perl-Archive-Zip,
+ perl-Class-Accessor, perl-Text-Iconv, perl-Text-CSV_XS,
+ perl-HTML-Template, perl-IO-stringy, perl-Template-Toolkit
+
+
+Da Perl-CGI-Ajax nicht als Paket für Distributionen bereit steht, muß
+es mit der CPAN-Shell installiert werden. Leider gibt es Fälle, in
+denen das nicht möglich oder praktikabel ist. LxO liefert daher das
+Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen.
Die PostgreSQL Konfiguration muß angepasst werden.
==================================================
-In der Datei postgresql.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) muß folgender Wert verändert werden:
-TCPIP_SOCKET = 1
+In der Datei postgresql.conf (/var/lib/pgsql/data/ oder
+/etc/postgresql/) muß folgender Wert verändert werden:
+
+TCPIP_SOCKET = 1 # Nur PostgreSQL < 8.0
+
+default_with_oids = on # Nur PostgreSQL >= 8.0
-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:
+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:
+Änderung:
---------
local all all trust
host all all 127.0.0.1 255.0.0.0 trust
+Besser:
+-------
+local all lxoffice password
+host all lxoffice 127.0.0.1 255.255.255.255 password
+
-Installation des Programmpaketes
+Installation des Programmpaketes
================================
-Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.0.0.tgz) in den DocumentRoot des Webservers
-(/var/www/html/ oder /srv/www/htdocs oder /var/www/) entpacken.
-tar xvzf lxoffice-erp-2.0.0.tgz
+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.
+
+tar xvzf lxoffice-erp-2.4.x.tgz
Verändern Sie evtl. noch den Namen des Verzeichnisses
mv lxoffice-erp/ lx-erp/
-Das Verzeichnis muß dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) übergeben werden:
+oder noch besser, Sie verwenden einen Alias in der
+Webserverkonfiguration.
+
+Das Verzeichnis muß dem Webserverbenutzer (Debian: www-data, Fedora:
+apache, SuSE: wwwrun) übergeben werden:
-chown apache: -R lx-erp/
+chown apache: -R lx-office-erp/
Datenbankbenutzer anlegen
=========================
-Es sollte zum Zugriff auf die PostgreSQL Datenbank ein Datenbankbenutzer angelegt werden. Führen Sie dazu
-folgende Befehle nacheinander aus.
+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)
-oder createuser -d -P lxoffice (mit Passwort)
+createuser -d lxoffice (ohne Passwort)
+oder besser
+createuser -d -P lxoffice (mit Passwort)
-Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie den evtl. voreingestellten Benutzer
-"postgres" auf "lxoffice".
+Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie
+den evtl. voreingestellten Benutzer "postgres" auf "lxoffice".
-PostgreSQL - Datenbank erweitern
+PostgreSQL - Datenbank erweitern
================================
-In der Datenbank "template1" sollte bevor die restliche Konfiguration von LxOffice ERP erfolgt noch folgende
-Funktion hinzugefügt werden:
-psql template1 postgres (Zugriff über Admintool auf die Datenbank)
+In der Datenbank "template1" sollte bevor die restliche Konfiguration
+von LxOffice ERP erfolgt noch folgende Funktion hinzugefügt werden:
+
+su postgres
+psql template1 (Zugriff über Admintool auf die Datenbank)
create function plpgsql_call_handler ()
returns opaque
as '/usr/lib/pgsql/plpgsql.so'
@@ -78,19 +150,24 @@ language 'c';
create language 'plpgsql' handler plpgsql_call_handler
lancompiler 'pl/pgsql';
-Bitte beachten Sie, das der Pfad zur Datei plpgsql.so von Distribution zu Distribution verschieden sein kann.
-Bei z.B. Debian befindet sie sich unter '/usr/lib/postgresql/lib/plpgsql.so'.
+!!!! Bitte beachten Sie, das der Pfad zur Datei plpgsql.so und der
+Name von Distribution zu Distribution verschieden sein kann. Bei
+z.B. Debian befindet sie sich unter
+'/usr/lib/postgresql/lib/plpgsql.so'.
-Apache Konfiguration
+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:
+
+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/
Options ExecCGI Includes FollowSymlinks
+ DirectoryIndex login.pl # nicht mehr unbedingt nötig, da eine index.html mitgeliefert wird
@@ -98,19 +175,101 @@ Alias /lx-erp/ /var/www/lx-erp/
Deny from All
+!!!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
-Datenbank anlegen
+Datenbank anlegen
=================
-Das Administrationsmenü finden Sie unter:
+
+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.
+Zuerst muß eine Datenbank angelegt werden. Anschließend ein
+Benutzer. Verwenden Sie für den Datenbankzugriff den eben angelegten
+Benutzer lxoffice.
+
+Wenn Sie für die Lx-Office-Installation nicht den europäischen
+Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
+müssen Sie vor dem Anlegen der Datenbank in der Datei 'lx-erp.conf'
+die Variable '$dbcharset' auf den Wert 'UTF-8' setzen. Zusätzlich muss
+beim Anlegen der Datenbank 'UTF-8 Unicode' als Schriftsatz ausgewählt
+werden.
+
+
+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_bin" muss den Pfad zum "X virtual frame buffer" enthalten.
+
+Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
+OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn
+die Variable "$openofficeorg_daemon" gesetzt ist, startet ein
+OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
+bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
+benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
+reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
+werden muss. Der Nachteil ist, dass diese Methode Python und die
+Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind.
+
+Ist "$openofficeorg_daemon" nicht gesetzt, so wird für jedes Dokument
+OpenOffice neu gestartet und die Konvertierung mit Hilfe eines Makros
+durchgeführt. Dieses Makro muss in der Dokumentenvorlage enthalten
+sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die
+Beispielvorlage templates/German-invoice.odt enthält ein solches
+Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein
+muss.
+
+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.
+
+
+Lx-Office ERP verwenden
+=======================
+
+Einloggen können Sie sich unter:
+http://localhost/lx-office-erp/login.pl
-Lx-Office ERP verwenden
-=======================
-Einloggen können Sie sich unter:
+Die Administrationsseite erreichen Sie unter:
-http://localhost/lx-erp/login.pl
+http://localhost/lx-office-erp/admin.pl