X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL.txt;h=1fd08c8bdb0ece580257b8ce413ea98d27d8ed0f;hb=7b4699d8d0b507359910ab47d91d5e3ab2c0b99a;hp=ec1e615e1602c571ed2a686a3af32c7e01d1e0b0;hpb=4c24a5f44bf065a820ec1a540334ebd48446ac04;p=kivitendo-erp.git diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt index ec1e615e1..1fd08c8bd 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,77 +50,181 @@ 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) benötigt. +und ein Datenbankserver (PostgreSQL, mindestens v8.2) benötigt. Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind: + * parent + + * Archive::Zip + + * Class::Accessor + + * CGI::Ajax + + * Config::Std + + * DateTime + * DBI * DBD::Pg - * CGI::Ajax + * Email::Address - * Class::Accessor + * List::MoreUtils - * Archive::Zip + * Params::Validate - * Text::Iconv + * PDF::API2 + + * Rose::Object + + * Rose::DB + + * Rose::DB::Object + + * Template * Text::CSV_XS - * IO::Wrap (aus dem Paket IO::Stringy) + * Text::Iconv + + * URI - * PDF::API2 + * XML::Writer * YAML - * Template + Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete hinzugekommen, +`URI' und `XML::Writer' sind notwendig. Ohne startet Lx-Office nicht. - * List::MoreUtils + Gegenüber Version 2.6.1 sind `parent', `DateTime', `Rose::Object', +`Rose::DB' und `Rose::DB::Object' neu hinzugekommen. `IO::Wrap' wurde +entfernt. - * Email::Address + `Email::Address' und `List::MoreUtils' sind schon länger feste +Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert. Beide +sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer +zukünftigen Version aber aus dem Paket entfernt werden. Es wird +empfohlen diese Module zusammen mit den anderen als Bibliotheken zu +installieren. - Diese Pakete können bei den unterschiedlichen Distributionen anders -heißen. + `CGI::Ajax' ist nach wie vor in einer modifizierten Version +mitgeliefert und braucht nicht nachinstalliert werden. + + Die zu installierenden Pakete können in den verschiedenen +Distributionen unterschiedlich heißen. Für Debian oder Ubuntu benötigen Sie diese Pakete: - `apache postgresql libdbi-perl libdbd-pg-perl libpg-perl -libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl -libtext-iconv-perl libyaml-perl libtext-csv-xs-perl libio-stringy-perl -libtemplate-perl lib-uriperl libxml-simple-perl' + `apache2 postgresql libparent-perl libarchive-zip-perl +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 +libconfig-std-perl libparams-validate-perl' - Für Fedora Core benötigen Sie unter anderem diese Pakete: + Für Fedora Core benötigen Sie diese Pakete: - `httpd postgresql-server perl-DBI perl-DBD-Pg' + `httpd postgresql-server perl-parent perl-Class-Accessor +perl-DateTime perl-DBI perl-DBD-Pg perl-Email-Address +perl-List-MoreUtils perl-PDF-API2 perl-Rose-Object perl-Rose-DB +perl-Rose-DB-Object perl-Template-Toolkit perl-Text-CSV_XS +perl-Text-Iconv perl-URI perl-XML-Writer perl-YAML' Für OpenSuSE benö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-IO-stringy -perl-Template-Toolkit perl-URI perl-XML-Writer' + `apache2 postgresql-server perl-Archive-Zip perl-Class-Accessor +perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-List-MoreUtils +perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv +perl-URI perl-XML-Writer perl-YAML' - Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht -als Distributionspakete vorhanden, und/oder nicht praktikabel zu -installieren. In diesen Fällen liefert Lx-Office das Paket mit, und -lädt es als Fallback. + Bei openSuSE 11 ist `parent' bereits enthalten, und braucht nicht +nachinstalliert werden. Die `Rose::*' Pakete sind derzeit nicht für +SuSE gepackt, und müssen anderweitig nachinstalliert werden. Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle 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.1beta1.tgz) wird -im Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/', +Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.2.tgz) wird im +Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/', `/srv/www/htdocs' oder `/var/www/') entpackt: `cd /var/www -tar xvzf lxoffice-erp-2.6.1beta1.tgz' +tar xvzf lxoffice-erp-2.6.2.tgz' Verändern Sie evtl. noch den Namen des Verzeichnisses mit @@ -186,16 +292,11 @@ mit ISO-8859-15 als Encoding betrieben werden. In der Datei `postgresql.conf', die je nach Distribution in verschiedenen Verzeichnissen liegen kann (z.B. `/var/lib/pgsql/data/' oder `/etc/postgresql/', muss sichergestellt werden, dass -TCP/IP-Verbindungen aktiviert sind. Für PostgreSQL vor Version v8.0 -lautete dieser Parameter - - `TCPIP_SOCKET = 1' - - Ab v8.0 wird das Verhalten hingegen über den neuen Parameter -`listen_address' gesteuert. Laufen PostgreSQL und Lx-Office auf -demselben Rechner, so kann dort der Wert `localhost' verwendet werden. -Andernfalls müssen Datenbankverbindungen auch von anderen Rechnern aus -zugelassen werden, was mit dem Wert \`*' geschieht. +TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den +Parameter `listen_address' gesteuert. Laufen PostgreSQL und Lx-Office +auf demselben Rechner, so kann dort der Wert `localhost' verwendet +werden. Andernfalls müssen Datenbankverbindungen auch von anderen +Rechnern aus zugelassen werden, was mit dem Wert \`*' geschieht. In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die `postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für @@ -221,6 +322,13 @@ servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür als Benutzer "postgres" an der Datenbank an, und führen Sie die folgenden Kommandos aus: + `create language 'plpgsql';' + + Achtung: In älteren Postgresversionen (vor 8.0) muss der Handler für +die Sprache manuell anlelegt werden, diese Versionen werden aber nicht +mehr offiziell von Lx-Office unterstützt. Dafür dann die folgenden +Kommandos: + `create function plpgsql_call_handler () returns opaque as '/usr/lib/pgsql/plpgsql.so' language 'c'; create language 'plpgsql' handler plpgsql_call_handler lancompiler @@ -228,8 +336,7 @@ create language 'plpgsql' handler plpgsql_call_handler lancompiler Bitte beachten Sie, dass der Pfad zur Datei `plpgsql.so' von Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu -befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so', bei -Ubuntu 9.10 unter `/usr/lib/postgresql/8.4/lib/plpgsql.so'. +befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so'. 4.4 Datenbankbenutzer anlegen ============================= @@ -248,7 +355,11 @@ hier gewählten Benutzernamen. 5 Apache-Konfiguration ********************** -Der Zugriff auf das Programmverzeichnis muss in der Apache +Hinweis: Für einen deutlichen Performanceschub sorgt die Ausführung +mittels FCGI. Die Einrichtung wird ausführlich in der Datei +`INSTALL.fcgi' beschrieben. + + Der Zugriff auf das Programmverzeichnis muss in der Apache Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu, die beim Starten des Webservers eingelesen wird: @@ -471,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 @@ -527,14 +638,13 @@ zugewiesen werden. Dazu gibt es zwei Möglichkeiten: 7.6 Migration alter Installationen ================================== -Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, -in der die Benutzerdaten noch im Dateisystem im Verzeichnis `users' -verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese -Benutzerdaten automatisch in die Authentifizierungsdatenbank zu -übernehmen. Dies geschieht, wenn man sich nach dem Update der -Installation das erste Mal im Administrationsbereich anmeldet. Findet -Lx-Office die Datei `users/members', so wird der Migrationsprozess -gestartet. +Wenn Lx-Office 2.6.2 über eine ältere Version installiert wird, in der +die Benutzerdaten noch im Dateisystem im Verzeichnis `users' verwaltet +wurden, so bietet Lx-Office die Möglichkeit, diese Benutzerdaten +automatisch in die Authentifizierungsdatenbank zu übernehmen. Dies +geschieht, wenn man sich nach dem Update der Installation das erste Mal +im Administrationsbereich anmeldet. Findet Lx-Office die Datei +`users/members', so wird der Migrationsprozess gestartet. Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch @@ -553,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 "ISO-8859-15". + 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 @@ -568,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 @@ -601,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 @@ -617,3 +728,8 @@ URL erreichbar: `http://localhost/lx-office-erp/admin.pl' + + +Local Variables: +coding: utf-8 +End: