Merge branch 'master' of github.com:kivitendo/kivitendo-erp
[kivitendo-erp.git] / doc / UPGRADE
index 2082788..afdd930 100644 (file)
@@ -4,36 +4,163 @@ Wichtige Hinweise zum Upgrade von älteren Versionen
 
 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 
-Upgrade auf v2.7.0
+
+Upgrade auf v3.x.0
 ==================
 
-1. Templateumstellungen
+* Neue Softwarevoraussetzungen: Perl v5.10.1 oder neuer sowie
+  PostgreSQL 8.4 oder neuer werden zwingend vorausgesetzt. Ein Betrieb
+  mit älteren Versionen ist nicht mehr möglich.
 
-Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
-Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
-benennen Sie ihn um bevor Sie das Update starten.
+* Neue Perl-Modul-Abhängigkeiten:
 
-2. Neue Abhängigkeiten
+  * File::Copy::Recursive
+  * Rose::DB::Object muss v0.788 oder neuer sein (aufgrund eines Bugs
+    in besagtem Modul im Zusammenspiel mit PostgreSQL)
 
-Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
+  Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
 
-$ scripts/installation_check.pl
+  $ scripts/installation_check.pl -ro
 
-Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
-der Installationsanweisung.
+* Die Datenbank muss zwingend Unicode als Encoding nutzen. Daher wird
+  auch die Konfigurationsvariable "system.dbcharset" nicht mehr
+  unterstützt.
+
+* Einführung von Mandanten. Früher war die Konfiguration der
+  Datenbanken für jeden Benutzer getrennt vorzunehmen. Mit diesem
+  Release wurden Mandanten eingeführt: ein Mandant bekommt einen Namen
+  sowie die Datenbankkonfiguration, und Benutzer bekommen
+  Zugriffsrechte auf einen oder mehrere Mandanten.
+
+  Um dieses Update durchzuführen, müssen Sie sich einmal im
+  Administrationsbereich anmelden. Vorher ist kein Login im
+  Benutzerbereich möglich.
+
+  Die neue Struktur bedingt, dass viele Scripte, die bisher zur
+  Konfiguration nur einen Benutzer verlangt haben, jetzt auch einen
+  Mandanten verlangen. Die Konfiguration dieser Scripte ist deshalb
+  manuell anzupassen. Dazu gehören:
+
+  - der Task-Server (config/kivitendo.conf)
+  - CSV-Import von der Shell aus (scripts/csv-import-from-shell.sh)
+
+  Die folgenden Scripte sind ebenfalls betroffen, allerdings nur für
+  Entwickler interessant:
+
+  - scripts/dbupgrade2_tool.pl
+  - scripts/rose_auto_create_model.pl
+
+* Neue Benutzerrechte
+  Diese muessen bei vorhandenen Gruppen eventuell nachgepfl;egt werden. Z.B. bei der Gruppe Vollzugriff
+
+  - Stammdaten -> Kunden und Lieferanten erfassen. Alle Lieferanten bearbeiten. Alle Kunden bearbeiten
+  - Konfiguration -> Verändern der kivitendo-Installationseinstellungen (die meisten Menüpunkte unterhalb von 'System')
+
+* Die alten ungepflegten Druckvorlagenvarianten French und Service
+  wurden entfernt.
 
-Es sind zwei neue Abhängigkeiten dazugekommen.
 
-* JSON
-* String::ShellQuote
 
-3. CSV-Import wurde neu in Perl implementiert
+Upgrade auf v3.0.0
+==================
+
+* Neue Abhängigkeiten
+
+  * Clone 1.16
+  * Email::MIME
+  * FCGI jetzt min Version 0.72
+  * Test::Harness 3.00
+  * IO::Socket::SSL
+  * Net::LDAP
+  * Net::SMTP::SSL
+  * Net::SSLGlue
+
+  Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
+
+  $ scripts/installation_check.pl -ro
+
+* Neue Entwicklerabhängigkeiten
+
+  * Test::Deep
+  * GD 2.00
+
+* Diverse umstrittene Features zum nicht standardkonformen Umgang mit gebuchten
+  Rechnungen sind jetzt standardmässig deaktiviert und müssen unter "System"
+  -> "Mandantenkonfiguration" aktiviert werden.
+
+* Die Übersetzungen "de_DE" und "fr" für die alternative deutsche Version und
+  französische Version respektive wurden entfernt. Es bleiben offiziell
+  unterstützte Übersetzungen in Deutsch ("de") und English ("en").
+
+* Dieses ist die letzte Version, die Perl-Versionen vor 5.10.1
+  unterstützen wird.  Ab dem nächsten Release werden Sprachkonstrukte
+  verwendet werden, die nicht mehr in 5.8 kompilieren, und Module, die
+  seit v5.10.1 zu den Coremodulen gehören, werden ab dann nicht mehr
+  als explizite Abhängigkeiten gelistet.
+
+
+Upgrade auf v2.7.0
+==================
 
-Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
-lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
-funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
-benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
-nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
+* In der Version 2.7.0 wird das XUL Menü entfernt. Alle Benutzer die das XUL
+  Menü noch eingestellt haben, werden beim ersten Einloggen auf ein
+  Kompatibilitätsmenü gesetzt. Das Javascriptmenü wurde entsprechend erweitert
+  um der Funktionalität nahe zu kommen.
+
+* Das Lizenzenfeature wurde ersatzlos entfernt.
+
+* In den LaTeX Vorlagen gilt der Befehl "pagebreak" und die dazugehörigen
+  "sumcarriedforward" und "lastpage" als deprecated und werden in einer
+  kommenden Version komplett entfernt. Die Mechanik ist anfällig gegenüber
+  subtilen Formatierungsfehlern bei bestimmten Zahlenformaten und ist
+  grundsätzlich fehlerhaft in den gemachten Annahmen über den verfügbaren Platz
+  auf einer Seite. Die Standardvorlagen sind entsprechend angepasst worden
+  und müssen in der Administration neu angelegt werden.
+
+* Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
+  Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
+  benennen Sie ihn um bevor Sie das Update starten.
+
+* Die Druckvorlagen für USTVA vor 2012 wurden entfernt und das Ausdrucken von
+  USTVA als PDF ist deprecated. Da die Eingabe von Erklärungen als PDF nicht
+  mehr gestattet ist, sollten Archivkopien der USTVA direkt bei Elster bezogen
+  werden, oder auf anderem Wege erstellt werden. Der Prozess dazu wird sich in
+  einer kommenden Version ändern.
+
+* Die Namen der von LaTeX generierten PDF-Dateien sind jetzt in der
+  eingestellten Dokumentensprache, nicht mehr in der Oberflächensprache des
+  Bearbeiters.
+
+* Neue Abhängigkeiten
+
+  * JSON
+  * String::ShellQuote
+  * Digest::SHA (optional, empfohlen)
+
+  Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
+
+  $ scripts/installation_check.pl -ro
+
+* CSV-Import wurde neu in Perl implementiert
+
+  Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
+  lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
+  funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
+  benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
+  nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
+
+* Rechteverwaltung
+
+  * Das Recht "Kunden und Lieferanten bearbeiten" wurde aufgespalten in zwei
+    einzelne Rechte. Ein Updatescript passt bestehende Gruppenaentsprechend an.
+  * Das Recht "Preise nd Rabatte bearbeiten" wurde neu eingeführt und ist
+    notwendig um in Belegen Preise ändern zu können. Es wird beim Upgrade
+    automatisch allen Benutzern erteilt.
+  * Das Recht "Administration" wurde neu eingeführt, und ist dazu da
+    administrative Tätigkeiten an der Mandantendatenbank aus einm Benutzerlogin
+    heraus durchzuführen. Es ist standardmäßig NICHT vergeben.
+  * Der Vorlageneditor wurde unter das Recht Administration gestellt, war
+    vorher Konfiguration.
 
 
 Upgrade auf v2.6.3