X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL.txt;h=fd27916050390f6272c73178f92ecd6e67bd4392;hb=22ce5b071e9c536a03f298138f201b442cdbc92f;hp=c305e217a5159bfdeabdd5791434f794e5aa5923;hpb=50b606454a09e9f7ed7017144984d6000d92649f;p=kivitendo-erp.git diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt index c305e217a..fd2791605 100644 --- a/doc/INSTALL.txt +++ b/doc/INSTALL.txt @@ -4,7 +4,9 @@ Table of Contents Inhalt der Anleitung 1 Aktuelle Hinweise 2 Benötigte Software und Pakete -3 Installation des Programmpaketes + 2.1 Betriebssystem + 2.2 Pakete +3 Manuelle Installation des Programmpaketes 4 Anpassung der PostgreSQL-Konfiguration 4.1 Zeichensätze/die Verwendung von UTF-8 4.2 Änderungen an Konfigurationsdateien @@ -48,6 +50,70 @@ Aktuelle Installations- und Konfigurationshinweise gibt es: 2 Benötigte Software und Pakete ******************************** +2.1 Betriebssystem +================== + +Lx-Office ist für Linux konzipiert, und sollte auf jedem unixoiden +Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im +speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl +der Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme +auf den derzeit aktuellen verbreiteten Distributionen läuft. + + Anfang 2011 sind das folgende Systeme: + + * Ubuntu 8.04 LTS Hardy Heron + + * Ubuntu 9.10 Karmic Koala + + * Ubuntu 10.04 Lucid Lynx + + * Ubuntu 10.10 Maverick Meerkat + + * Debian 5.0 Lenny + + * Debian 6.0 Squeeze + + * openSUSE 11.2 + + * openSUSE 11.3 + + * SuSE Linux Enterprice Server 11 + + * Fedora 13 + + * Fedora 14 + + Für die debianoiden Betriebssysteme existiert ein .deb, das deutlich +einfacher zu installieren ist. + + Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die Module im +Archiv recht alt sind, und das viele der benötigten Module nicht +einfach zu installieren sind. Dafür sollte es kurz nach dem Release ein +eigenes .deb geben. + + Alternativ dazu kann die normale Installation durchgeführt werden +(*note Manuelle Installation des Programmpaketes::), wenn vorher ein +Kompatibilitätspaket installiert wird, das die fehlenden Pakete +bereitstellt. Das Paket ist auf Sourceforge +(https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/) +unter dem Namen `lx-erp-perl-libs-compat-v2.tar.gz' hinterlegt. + + Zur Installation das Paket in das entpackte Lx-Office Verzeichnis +entpacken: + + `tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/' + + Zusätzlich müssen dann noch die folgenden Pakete installiert weerden + + `libbit-vector-perl libsub-exporter-perl libclone-perl +libclass-factory-util-perl' + + Danach sollte der Installationscheck (*note Pakete::) die +enthaltenen Pakete erkennen. + +2.2 Pakete +========== + Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.2) benötigt. @@ -62,6 +128,8 @@ Bestandteil einer Standard-Perl-Installation sind: * CGI::Ajax + * Config::Std + * DateTime * DBI @@ -72,6 +140,8 @@ Bestandteil einer Standard-Perl-Installation sind: * List::MoreUtils + * Params::Validate + * PDF::API2 * Rose::Object @@ -119,7 +189,8 @@ libclass-accessor-perl libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl libemail-address-perl liblist-moreutils-perl libpdf-api2-perl librose-object-perl librose-db-perl librose-db-object-perl libtemplate-perl libtext-csv-xs-perl -libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl' +libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl +libconfig-std-perl libparams-validate-perl' Für Fedora Core benötigen Sie diese Pakete: @@ -145,8 +216,8 @@ benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: `./scripts/installation_check.pl' -3 Installation des Programmpaketes -********************************** +3 Manuelle Installation des Programmpaketes +******************************************* Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.2.tgz) wird im Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/', @@ -342,10 +413,10 @@ LDAP-Server überprüft werden. Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der -Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss -bei der Installation und bei einem Upgrade von einer Version vor v2.6.0 +Konfigurationsdatei `config/lx_office.conf' festgelegt. Diese muss bei +der Installation und bei einem Upgrade von einer Version vor v2.6.0 angelegt werden. Eine Beispielkonfigurationsdatei -`config/authentication.pl.default' existiert, die als Vorlage benutzt +`config/lx_office.conf.default' existiert, die als Vorlage benutzt werden kann. 6.2 Administratorpasswort @@ -440,7 +511,7 @@ existiert. 6.6 Anlegen der Authentifizierungsdatenbank =========================================== -Nachdem alle Einstellungen in `config/authentication.pl' vorgenommen +Nachdem alle Einstellungen in `config/lx_office.conf' vorgenommen wurden, muss Lx-Office die Authentifizierungsdatenbank anlegen. Dieses geschieht automatisch, wenn Sie sich im Administrationsmodul anmelden, das unter der folgenden URL erreichbar sein sollte: @@ -457,7 +528,7 @@ folgender URL finden: `http://localhost/lx-erp/admin.pl' Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei -`config/authentication.pl' eingetragen haben. +`config/lx_office.conf' eingetragen haben. 7.1 Zusammenhänge ================== @@ -511,9 +582,9 @@ ist dies `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 -`config/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. +`config/lx_office.conf' die Variable `dbcharset' im Abschnitt `system' +auf den Wert `UTF-8' setzen. Zusätzlich muss beim Anlegen der Datenbank +`UTF-8 Unicode' als Schriftsatz ausgewählt werden. Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz verwenden müssen, da diese Einstellungen momentan global in Lx-Office @@ -592,13 +663,13 @@ 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 -`config/lx-erp.conf' die Variable `$opendocument_templates' auf `1' -stehen. Dieses ist die Standardeinstellung. +`config/lx_office.conf' die Variable `opendocument' im Abschnitt +`print_templates' auf `1' stehen. Dieses ist die Standardeinstellung. - Weiterhin muss in der Datei `config/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 "UTF-8". + Weiterhin muss in der Datei `config/lx_office.conf' die Variable +`dbcharset' im Abschnitt `system' auf die Zeichenkodierung gesetzt +werden, die auch bei der Speicherung der Daten in der Datenbank +verwendet wird. Diese ist in den meisten Fällen "UTF-8". Während die Erzeugung von reinen OpenDocument-Dateien keinerlei weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF @@ -607,10 +678,11 @@ 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 `config/lx-erp.conf' zwei -weitere Variablen angepasst werden: `$openofficeorg_writer_bin' muss + Nach der Installation müssen in der Datei `config/lx_config.conf' +zwei weitere Variablen angepasst werden: `openofficeorg_writer' muss den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten. -`$xvfb_bin' muss den Pfad zum "X virtual frame buffer" enthalten. +`xvfb' muss den Pfad zum "X virtual frame buffer" enthalten. Beide +stehen im Abschnitt `applications'. Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die @@ -640,8 +712,8 @@ 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 +vom Webserver beschreibbar sein. Dieses wurde bereits erledigt (*note +Manuelle Installation des Programmpaketes::), kann aber erneut überprüft werden, wenn die Konvertierung nach PDF fehlschlägt. 9 Lx-Office ERP verwenden