X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FUPGRADE;h=8f4d9c9679807bec6c24fdad00c2825753dbc358;hb=3ba00b1bf4651181d5c9fa38f8f963d10e22e102;hp=095c21386a96a1c3b7f35db1830d7a9d75bda001;hpb=a1880fd994fcc0bb1bc158b8e7a625eef76d0938;p=kivitendo-erp.git diff --git a/doc/UPGRADE b/doc/UPGRADE index 095c21386..8f4d9c967 100644 --- a/doc/UPGRADE +++ b/doc/UPGRADE @@ -2,6 +2,97 @@ Wichtige Hinweise zum Upgrade von =================================================== +** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! ** + +Upgrade 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.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! ** @@ -13,7 +104,8 @@ 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". +der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss +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.