]> wagnertech.de Git - mfinanz.git/blobdiff - doc/UPGRADE
date error in mapping
[mfinanz.git] / doc / UPGRADE
index 1f54386ec486abe223e0d075364d2f22665281c8..06810214e5587372af3e34051e73cec66a5769ab 100644 (file)
@@ -1,9 +1,226 @@
 Wichtige Hinweise zum Upgrade von älteren Versionen
 ===================================================
 
 Wichtige Hinweise zum Upgrade von älteren Versionen
 ===================================================
 
-
 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 
 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 
+Upgrade auf v3.9.2
+
+Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
+
+* Änderung bei Schweizer QR-Rechnung mit QR-IBAN/QR-Referenz
+
+  Bisher wurde für die QR-IBAN eine zusätzliche Zeile bei den Bankkonten
+  erfasst. Die QR-IBAN wird aber jeweils als zusätzliche IBAN für ein
+  existierendes Bankkonto vergeben. Daher wird diese neu als zusätzliche Spalte
+  beim entsprechenden Bankkonto eingetragen. Dies muss nach dem Upgrade unter
+  System -> Bankkonten angepasst werden.
+
+Upgrade auf v3.9.1
+
+Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
+
+Die Dateieendung für SEPA-XML wurde auf .xml geändert, die vorherigen Werte
+können aber über die Mandantenkonfiguration wieder aktiviert werden.
+
+Upgrade auf v3.9.0
+
+Einige neue Perl-Module sind hinzugekommen, Hilfe zum Installieren bietet wie
+immer das Skript 'scripts/installation_check.pl -v'.
+
+  * Neue Perl Abhängigkeiten:
+
+  * Encode::IMAPUTF7
+  * Mail::IMAPClient
+
+Wichtige Hinweise:
+
+- manuelle Zahlungen von Belegen mit Fremdwährungen verbuchen ist leider seit der Version 3.8 buggy!
+  Diese Version flickt das Verhalten notdürftig und das Problem liegt auf Wiedervorlage, wenn die
+  Rechnungsbelege prinzipiell modernisiert werden (aktuell sind die Belegtypen Aufträge und
+  Lieferschein mit modernen Code implementiert).
+
+  Es gibt drei + x Möglichkeiten:
+  - Zahlungen über das Format MT940 oder CSV importieren und dann über den Menüpunkt 'Kontoauszug
+    verbuchen' alle Zahlungen verbuchen.
+  - Zahlungsverkehr -> Zahlungseingang / Zahlungsausgang für die manuelle Zahlungsverbuchung verwenden
+  - Doch manuell über die Belege die Zahlungen verbuchen, dann aber zwingend die Änderbarkeit von
+    Zahlungen auf 'niemals' setzen
+  - Den kivitendo-Dienstleister seiner Wahl für weitere Optionen (Downgrade, Entwicklungsunterstützung
+    für schnellere Rechnungsüberarbeitung) kontaktieren und beauftragen
+  Weitere Details, https://kivitendo.de/redmine/issues/563
+
+- Diese Version benötigt zwingend PostgreSQL Version 12 oder höher!
+
+Wer es dennoch zwingend in einer älteren Version benötigt, kann diese beiden Skripte deaktivieren:
+
+Shell-Befehl zum Deaktivieren des Skripts:
+  sed -i 's/ignore: 0/ignore: 1/' sql/Pg-upgrade2/oe_purchase_order_confirmation_order_types.sql
+
+SQL-Kommando, das ausgeführt werden muss:
+  ALTER TYPE order_types ADD VALUE IF NOT EXISTS 'purchase_order_confirmation';
+
+
+Upgrade auf v3.8.0
+
+Buchungskonten die mit einem Bankkonto verknüpft sind, können nicht mehr
+manuell in den Belegen bebucht werden.
+
+LaTeX-Druckvorlagen werden nun standardmäßig nicht mehr zwei mal durch
+den LaTeX-Interpreter übersetzt. Statt dessen wird in der
+Standardkonfiguration das Programm »latexmk --pdflatex« aufgerufen,
+das selbständig feststellen kann, ob eine mehrfache Ausführung nötig
+ist, z.B. um Referenzen richtig auflösen zu können.
+
+Bei existierenden Installationen muss dafür in der Konfigurationsdatei
+»config/kivitendo.conf« der Pfad in der Einstellung »[applications]« →
+»latex« umgestellt werden, z.B. auf »latexmk --pdflatex«. Andere
+TeX-Interpreter wie luatex werden ebenfalls unterstützt; siehe Ausgabe
+von »latexmk --help«.
+
+Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
+
+
+Upgrade auf v3.7.0
+
+Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
+
+Upgrade auf v3.6.1
+
+Das manuelle Korrigieren der Steuer bei Skontoverbuchungen entfällt seit
+dieser Version, da die Steuerkorrektur automatisch gemacht wird.
+
+Ein neues Perl-Modul ist hinzugekommen, Hilfe zum Installieren bietet wie immer
+das Skript 'scripts/installation_check.pl -v'.
+
+  * IPC::Run
+
+
+Upgrade auf v3.6.0
+
+Der 'neue Auftrags-Controller' ist mittlerweile weder neu noch experimentell und
+die entsprechende Mandantenkonfiguration 'Experimentellen neuen Auftrags-Controller'
+verwenden wird bei diesem Upgrade hart auf 'Ja' gesetzt.
+Die alte, noch aktive Auftragsmaske wird in einer zukünftigen Version von kivitendo entfernt
+werden.
+
+Einige neue Perl-Module sind hinzugekommen, Hilfe zum Installieren bietet wie immer
+das Skript 'scripts/installation_check.pl -v'.
+
+  * Neue Perl Abhängigkeiten:
+
+  * Term::ReadLine::Gnu
+  * Imager::QRCode
+  * Imager
+  * REST::Client
+
+
+
+Upgrade auf v3.5.8
+
+Die API für 'Erzeugnis fertigen' wurde geändert:
+Die Einstellung der Mandantenkonfiguration für 'Zum Fertigen wird das Standardlager
+des Bestandteils verwendet, nicht das Ziellager' hat keine Auswirkung mehr.
+Falls dieser Wert auf 'Nein' steht funktioniert das Verfahren wie vorher auch.
+Falls dieser Wert auf 'Ja' steht, muss geprüft werden, ob das Verfahren noch so
+benötigt wird.
+Alternativ kann 'Erzeugnis fertigen' ab dieser Version auch Erzeugnisbestandteile aus
+fremden Lagern (nicht das Ziellager) nehmen. Dies sollte i.d.R. den Prozeß abbilden können.
+
+Die Mandantenkonfiguration 'Standard-Auslagern ohne Prüfung auf Bestand' wird bei diesem
+Versionsupgrade hart auf 'Nein' gesetzt und kann vom kivitendo Administrator selbständig
+wieder auf 'Ja' gesetzt werden. Das Verfahren wird aber prinzipiell in einer zukünftigen
+Version von kivitendo nicht mehr unterstützt werden.
+
+
+Upgrade auf v3.5.7
+  * Neue Perl Abhängigkeiten:
+
+  * Math::Round
+  * Try::Tiny
+
+
+Upgrade auf v3.5.6.1
+
+Die Abwärtskompatibilität zur Lagermengen-Berechnung in Lieferscheinen wurde
+aufgehoben. Wer nicht mit Workflows arbeitet (nicht empfohlen) muss diese
+explizit in der Mandantenkonfiguration wieder aktivieren.
+
+
+Upgrade auf v3.5.6
+
+In dieser Version sind die Mehrwertsteueranpassungen für den SKR03 und SKR04
+ab 1.7.2020 vorhanden. Wer diese Anpassungen schon manuell eingestellt hat, sollte
+die Upgrade-Skripte deaktivieren.
+Dies betrifft diese drei Skripte "sql/Pg-upgrade2/konjunkturpaket_2020*", sowie
+ferner das Entfernen der Release-Abhängigkeiten dieser Skripte:
+
+Folgende zwei Sed-Kommandos erledigen das:
+
+ sed -i 's/ignore: 0/ignore: 1/g' sql/Pg-upgrade2/konjunkturpaket_2020*
+ sed -i 's/\bkonjunktur[^ ]*//g' sql/Pg-upgrade2/release_3_5_*
+
+
+Alternativ sollten die Datenbank-Upgrade-Skripte gegen einen Testdatenbestand ausgeführt werden
+und der kivitendo-Dienstleister Ihres Vertrauens griffbereit sein.
+
+Weitere Änderungen:
+
+Für den MT940-Import erwartet kivitendo aqbanking ab Version 6.
+
+Für die Erzeugung von ZUGFeRD 2.0 fähigen PDFs wird ein aktuelles TexLive ab Version 2018 benötigt.
+Details hierzu auch in der Dokumentation (HTML oder Dokumentation.pdf).
+
+Bitte wie immer vor dem Anmelden an der Weboberfläche 'scripts/installation_check.pl -v' ausführen.
+
+Es sollten mindestens zwei Perl-Module "CAM::PDF" und "XML::LibXML" dort erscheinen, falls noch nicht installiert.
+
+Diese Version ist ferner mit Postgres Datenbanken ab Version 12 kompatibel, da die Abhängigkeit von oids entfernt wurde.
+
+Sicherheitshinweis:
+
+Für git-Installation sollte geprüft werden ob das Verzeichnis .git/ für den Webserver auslesbar ist.
+Gleiches gilt für alle Installation für den Ordner config/, der die Datei kivitendo.conf beinhaltet.
+Die Standard-Konfiguration des Apache2 Webservers sollte letzteres verhindern, aber wir weisen darauf hin
+dies einmal zu überprüfen.
+
+Ab dieser Version wird eine globale .htaccess ausgeliefert die beide Verzeichnisse mittels rewrite sichert.
+Dafür muss einmalig das Modul rewrite für den Apache, bspw. mit "a2enmode rewrite" aktiviert werden.
+Regeldetails:
+
+<IfModule mod_rewrite.c>
+  RewriteEngine On
+  RewriteRule .*(\.git|config).*$ - [F,NC]
+</IfModule>
+
+Ferner wurde ein Security-Audit der kivitendo Version 3.1 veröffentlicht.
+Hierfür empfehlen wir die Ausarbeitung eines Sicherheitskonzept mit einem kivitendo Partner Eurer Wahl.
+Falls dies nicht möglich sein sollte, weisen wir darauf hin, dass ein SQL-Backup tages- und wochenaktuell
+für einen etwaigen Restore zu Verfügung stehen sollte. Ferner besteht die Gefahr, dass angemeldete
+Benutzer Formfelder mißbrauchen können, Abhilfe schafft hier zum Beispiel der Einsatz von modsecurity unter
+Apache2 (https://doxsec.wordpress.com/2017/06/11/using-modsecurity-web-application-firewall-to-prevent-sql-injection-and-xss-using-blocking-rules/)
+
+Upgrade auf v3.5.4
+
+* Task-Server berücksichtigt Memory-Limit
+
+Falls für fgci-Prozesse ein Memory-Limit in der Konfigurationsdatei eingerichtet
+ist, wird dies nun auch vom Task-Server berücksichtigt. Dieser beendet sich bei
+Überschreitung des Limits. Deshalb muss dafür gesorgt werden, dass der
+Task-Server in diesem Fall neu gestartet wird (z.B. über den systemd-Service).
+Siehe auch aktuelle kivitendo-Dokumentation.
+
+
+Upgrade auf v3.5.3
+
+* Fallback-Module entfernt
+
+Einige Default-Module die als Fallback zu Verfügung standen, werden ab
+dieser Version nicht mehr mit ausgeliefert.
+Bitte vor dem Anmelden an der Weboberfläche 'scripts/installation_check.pl -v' ausführen
+und die entsprechenden Module installieren.
+S.a. weitere Details in der aktuellen kivitendo-Dokumentation.
+
+
 Upgrade auf v3.5.1
 
 * Neue Perlabhängigkeiten
 Upgrade auf v3.5.1
 
 * Neue Perlabhängigkeiten