X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FUPGRADE;h=8f4d9c9679807bec6c24fdad00c2825753dbc358;hb=59c0bed1bb64e6c0c82e844b288037802a6651a9;hp=c0c53cb1b99e7c6accdbb79af4b75bf1455ac075;hpb=a939b72794643b5ad273886ff6d66b782eecb601;p=kivitendo-erp.git diff --git a/doc/UPGRADE b/doc/UPGRADE index c0c53cb1b..8f4d9c967 100644 --- a/doc/UPGRADE +++ b/doc/UPGRADE @@ -4,18 +4,108 @@ Wichtige Hinweise zum Upgrade von ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! ** +Upgrade auf v2.6.0 +================== -Upgrade von v2.4.0 und neuer auf v2.6.0 +Mit Version 2.6.0 wurde der Code zur Benutzerauthentifizierung neu +geschrieben. Die Umstellung erfordert eine manuelle +Konfiguration. Bestehende Benutzeraccounts können aber von Lx-Office +automatisch übernommen werden. + + Bevor Sie sich das erste mal einloggen + -------------------------------------- + +Kopieren Sie bitte die Datei "lx-erp.conf" und +ggfs. "lx-erp-local.conf" in das neue Unterverzeichnis "config/". Die +alte Datei im Lx-Office-Stammverzeichnis kann daraufhin gelöscht +werdern. + +Als nächstes muss die neue datenbankgestützte Benutzerverwaltung +konfiguriert werden. Die dafür notwendigen Einstellungen werden in der +Datei "config/authentification.pl" vorgenommen, für die eine +kommentierte Vorlage in "config/authentication.pl.default" +bereitliegt. + +Weitere Informationen zu dieser Datei finden Sie in der Dokumentation +"doc/INSTALL/index.html" und dort in den Kapiteln +"Benutzerauthentifizierung und Administratorpasswort" sowie "Benutzer- +und Gruppenverwaltung". + +Nach der Einrichtung der Datei "config/authentication.pl" muss im +Webbrowser das Administrationsinterface aufgerufen werden. Nach +erfolgter Anmeldung werden Sie durch den Upgradeprozess geleitet. + +Die weiteren erforderlichen Datenbankupgrades werden erst vorgenommen, +wenn sich ein Benutzer erfolgreich anmeldet. + + Neue Perl-Module + ---------------- + +Mit Version 2.6.0 werden zusätzlich die folgenden Perl-Module benötigt, +die bis Version 2.4.3 inklusive noch keine Voraussetzung waren: + +* Digest::MD5 +* PDF::API2 + + +Upgrade von v2.4.0 und neuer auf v2.4.3 ======================================= -Ein Upgrade von v2.4.0 oder neuer auf v2.6.0 aus zwei Teilen: den +Ein Upgrade von v2.4.0 oder neuer auf v2.4.3 aus zwei Teilen: den Dateien (einfaches Entpacken und Kopieren in das +Installationsverzeichnis genügen) sowie dem Datenbankupgrade. + + Neue Variablen in der Datei lx-erp.conf + --------------------------------------- + +Wenn Sie eine eigene Version der Konfigurationsdatei "lx-erp.conf" +einsetzen und diese nicht mit der Standardkonfigurationsdatei +überschreiben, so beachten Sie bitte, dass die folgenden neuen +Variablen hinzugekommen sind und von Ihnen manuell ergänzt werden +sollten: $html2ps_bin, $ghostscript_bin, $pg_dump_exe und +$pg_restore_exe. Die Variable '$jscalendar' kann hingegen entfernt +werden, da sie nicht mehr benötigt wird. + +Die Standardwerte für diese Variablen finden Sie in der Datei +"lx-erp.conf.default". + + Neue Abhängigkeiten von Perl-Modulen + ------------------------------------ + +Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang +der Datei "doc/INSTALL". Seit Version 2.4.0 sind die folgenden Module +neu hinzugekommen: + +- Achive::Zip +- IO::Wrap (aus dem Paket "IO::Stringy") +- Template +- Text::CSV_XS +- Text::Iconv +- Time::HiRes +- YAML + +Nach Möglichkeit sollten auch die aktuellen Versionen der +Datenbankpakete "DBI" und "DBD::Pg" installiert werden. + + Datenbankupgrade + ---------------- + +Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste +Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet. + +** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! ** + + +Upgrade von v2.4.0 auf 2.4.1 sowie von 2.4.1 auf 2.4.2 +====================================================== + +Ein Upgrade von v2.4.0 auf v2.4.1 oder von v2.4.1 auf v2.4.2 besteht +aus zwei Teilen: den Dateien (einfaches Entpacken und Kopieren in das Installationsverzeichnis genügen) sowie dem Datenbankupgrade. Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss -sichergestellt werden, dass das Modul "YAML" installiert ist. v2.6.0 -benötigt zusätzlich die Module "Text::CSV_XS" und "IO::Wrap". +sichergestellt werden, dass das Modul "YAML" installiert ist. Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet. @@ -23,8 +113,8 @@ Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet. ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! ** Anders als beim Upgrade auf 2.4.0 handelt es bei den Datenbankupgrades -auf Versionen nach 2.4.0 nur um automatisch ablaufende Scripte, die -keine Benutzereingaben erfordern. +auf 2.4.1 und 2.4.2 nur um automatisch ablaufende Scripte, die keine +Benutzereingaben erfordern. Upgrade von v2.2.0 bis 2.2.2 auf 2.4.0