doc/UPGRADE

   1 Wichtige Hinweise zum Upgrade von älteren Versionen
   2 ===================================================
   3
   4 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
   5
   6 Upgrade auf v3.9.2
   7
   8 Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
   9
  10 * Änderung bei Schweizer QR-Rechnung mit QR-IBAN/QR-Referenz
  11
  12   Bisher wurde für die QR-IBAN eine zusätzliche Zeile bei den Bankkonten
  13   erfasst. Die QR-IBAN wird aber jeweils als zusätzliche IBAN für ein
  14   existierendes Bankkonto vergeben. Daher wird diese neu als zusätzliche Spalte
  15   beim entsprechenden Bankkonto eingetragen. Dies muss nach dem Upgrade unter
  16   System -> Bankkonten angepasst werden.
  17
  18 Upgrade auf v3.9.1
  19
  20 Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
  21
  22 Die Dateieendung für SEPA-XML wurde auf .xml geändert, die vorherigen Werte
  23 können aber über die Mandantenkonfiguration wieder aktiviert werden.
  24
  25 Upgrade auf v3.9.0
  26
  27 Einige neue Perl-Module sind hinzugekommen, Hilfe zum Installieren bietet wie
  28 immer das Skript 'scripts/installation_check.pl -v'.
  29
  30   * Neue Perl Abhängigkeiten:
  31
  32   * Encode::IMAPUTF7
  33   * Mail::IMAPClient
  34
  35 Wichtige Hinweise:
  36
  37 - manuelle Zahlungen von Belegen mit Fremdwährungen verbuchen ist leider seit der Version 3.8 buggy!
  38   Diese Version flickt das Verhalten notdürftig und das Problem liegt auf Wiedervorlage, wenn die
  39   Rechnungsbelege prinzipiell modernisiert werden (aktuell sind die Belegtypen Aufträge und
  40   Lieferschein mit modernen Code implementiert).
  41
  42   Es gibt drei + x Möglichkeiten:
  43   - Zahlungen über das Format MT940 oder CSV importieren und dann über den Menüpunkt 'Kontoauszug
  44     verbuchen' alle Zahlungen verbuchen.
  45   - Zahlungsverkehr -> Zahlungseingang / Zahlungsausgang für die manuelle Zahlungsverbuchung verwenden
  46   - Doch manuell über die Belege die Zahlungen verbuchen, dann aber zwingend die Änderbarkeit von
  47     Zahlungen auf 'niemals' setzen
  48   - Den kivitendo-Dienstleister seiner Wahl für weitere Optionen (Downgrade, Entwicklungsunterstützung
  49     für schnellere Rechnungsüberarbeitung) kontaktieren und beauftragen
  50   Weitere Details, https://kivitendo.de/redmine/issues/563
  51
  52 - Diese Version benötigt zwingend PostgreSQL Version 12 oder höher!
  53
  54 Wer es dennoch zwingend in einer älteren Version benötigt, kann diese beiden Skripte deaktivieren:
  55
  56 Shell-Befehl zum Deaktivieren des Skripts:
  57   sed -i 's/ignore: 0/ignore: 1/' sql/Pg-upgrade2/oe_purchase_order_confirmation_order_types.sql
  58
  59 SQL-Kommando, das ausgeführt werden muss:
  60   ALTER TYPE order_types ADD VALUE IF NOT EXISTS 'purchase_order_confirmation';
  61
  62
  63 Upgrade auf v3.8.0
  64
  65 Buchungskonten die mit einem Bankkonto verknüpft sind, können nicht mehr
  66 manuell in den Belegen bebucht werden.
  67
  68 LaTeX-Druckvorlagen werden nun standardmäßig nicht mehr zwei mal durch
  69 den LaTeX-Interpreter übersetzt. Statt dessen wird in der
  70 Standardkonfiguration das Programm »latexmk --pdflatex« aufgerufen,
  71 das selbständig feststellen kann, ob eine mehrfache Ausführung nötig
  72 ist, z.B. um Referenzen richtig auflösen zu können.
  73
  74 Bei existierenden Installationen muss dafür in der Konfigurationsdatei
  75 »config/kivitendo.conf« der Pfad in der Einstellung »[applications]« →
  76 »latex« umgestellt werden, z.B. auf »latexmk --pdflatex«. Andere
  77 TeX-Interpreter wie luatex werden ebenfalls unterstützt; siehe Ausgabe
  78 von »latexmk --help«.
  79
  80 Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
  81
  82
  83 Upgrade auf v3.7.0
  84
  85 Es sind keine neuen Perl-Abhängigkeiten hinzugekommen.
  86
  87 Upgrade auf v3.6.1
  88
  89 Das manuelle Korrigieren der Steuer bei Skontoverbuchungen entfällt seit
  90 dieser Version, da die Steuerkorrektur automatisch gemacht wird.
  91
  92 Ein neues Perl-Modul ist hinzugekommen, Hilfe zum Installieren bietet wie immer
  93 das Skript 'scripts/installation_check.pl -v'.
  94
  95   * IPC::Run
  96
  97
  98 Upgrade auf v3.6.0
  99
 100 Der 'neue Auftrags-Controller' ist mittlerweile weder neu noch experimentell und
 101 die entsprechende Mandantenkonfiguration 'Experimentellen neuen Auftrags-Controller'
 102 verwenden wird bei diesem Upgrade hart auf 'Ja' gesetzt.
 103 Die alte, noch aktive Auftragsmaske wird in einer zukünftigen Version von kivitendo entfernt
 104 werden.
 105
 106 Einige neue Perl-Module sind hinzugekommen, Hilfe zum Installieren bietet wie immer
 107 das Skript 'scripts/installation_check.pl -v'.
 108
 109   * Neue Perl Abhängigkeiten:
 110
 111   * Term::ReadLine::Gnu
 112   * Imager::QRCode
 113   * Imager
 114   * REST::Client
 115
 116
 117
 118 Upgrade auf v3.5.8
 119
 120 Die API für 'Erzeugnis fertigen' wurde geändert:
 121 Die Einstellung der Mandantenkonfiguration für 'Zum Fertigen wird das Standardlager
 122 des Bestandteils verwendet, nicht das Ziellager' hat keine Auswirkung mehr.
 123 Falls dieser Wert auf 'Nein' steht funktioniert das Verfahren wie vorher auch.
 124 Falls dieser Wert auf 'Ja' steht, muss geprüft werden, ob das Verfahren noch so
 125 benötigt wird.
 126 Alternativ kann 'Erzeugnis fertigen' ab dieser Version auch Erzeugnisbestandteile aus
 127 fremden Lagern (nicht das Ziellager) nehmen. Dies sollte i.d.R. den Prozeß abbilden können.
 128
 129 Die Mandantenkonfiguration 'Standard-Auslagern ohne Prüfung auf Bestand' wird bei diesem
 130 Versionsupgrade hart auf 'Nein' gesetzt und kann vom kivitendo Administrator selbständig
 131 wieder auf 'Ja' gesetzt werden. Das Verfahren wird aber prinzipiell in einer zukünftigen
 132 Version von kivitendo nicht mehr unterstützt werden.
 133
 134
 135 Upgrade auf v3.5.7
 136   * Neue Perl Abhängigkeiten:
 137
 138   * Math::Round
 139   * Try::Tiny
 140
 141
 142 Upgrade auf v3.5.6.1
 143
 144 Die Abwärtskompatibilität zur Lagermengen-Berechnung in Lieferscheinen wurde
 145 aufgehoben. Wer nicht mit Workflows arbeitet (nicht empfohlen) muss diese
 146 explizit in der Mandantenkonfiguration wieder aktivieren.
 147
 148
 149 Upgrade auf v3.5.6
 150
 151 In dieser Version sind die Mehrwertsteueranpassungen für den SKR03 und SKR04
 152 ab 1.7.2020 vorhanden. Wer diese Anpassungen schon manuell eingestellt hat, sollte
 153 die Upgrade-Skripte deaktivieren.
 154 Dies betrifft diese drei Skripte "sql/Pg-upgrade2/konjunkturpaket_2020*", sowie
 155 ferner das Entfernen der Release-Abhängigkeiten dieser Skripte:
 156
 157 Folgende zwei Sed-Kommandos erledigen das:
 158
 159  sed -i 's/ignore: 0/ignore: 1/g' sql/Pg-upgrade2/konjunkturpaket_2020*
 160  sed -i 's/\bkonjunktur[^ ]*//g' sql/Pg-upgrade2/release_3_5_*
 161
 162
 163 Alternativ sollten die Datenbank-Upgrade-Skripte gegen einen Testdatenbestand ausgeführt werden
 164 und der kivitendo-Dienstleister Ihres Vertrauens griffbereit sein.
 165
 166 Weitere Änderungen:
 167
 168 Für den MT940-Import erwartet kivitendo aqbanking ab Version 6.
 169
 170 Für die Erzeugung von ZUGFeRD 2.0 fähigen PDFs wird ein aktuelles TexLive ab Version 2018 benötigt.
 171 Details hierzu auch in der Dokumentation (HTML oder Dokumentation.pdf).
 172
 173 Bitte wie immer vor dem Anmelden an der Weboberfläche 'scripts/installation_check.pl -v' ausführen.
 174
 175 Es sollten mindestens zwei Perl-Module "CAM::PDF" und "XML::LibXML" dort erscheinen, falls noch nicht installiert.
 176
 177 Diese Version ist ferner mit Postgres Datenbanken ab Version 12 kompatibel, da die Abhängigkeit von oids entfernt wurde.
 178
 179 Sicherheitshinweis:
 180
 181 Für git-Installation sollte geprüft werden ob das Verzeichnis .git/ für den Webserver auslesbar ist.
 182 Gleiches gilt für alle Installation für den Ordner config/, der die Datei kivitendo.conf beinhaltet.
 183 Die Standard-Konfiguration des Apache2 Webservers sollte letzteres verhindern, aber wir weisen darauf hin
 184 dies einmal zu überprüfen.
 185
 186 Ab dieser Version wird eine globale .htaccess ausgeliefert die beide Verzeichnisse mittels rewrite sichert.
 187 Dafür muss einmalig das Modul rewrite für den Apache, bspw. mit "a2enmode rewrite" aktiviert werden.
 188 Regeldetails:
 189
 190 <IfModule mod_rewrite.c>
 191   RewriteEngine On
 192   RewriteRule .*(\.git|config).*$ - [F,NC]
 193 </IfModule>
 194
 195 Ferner wurde ein Security-Audit der kivitendo Version 3.1 veröffentlicht.
 196 Hierfür empfehlen wir die Ausarbeitung eines Sicherheitskonzept mit einem kivitendo Partner Eurer Wahl.
 197 Falls dies nicht möglich sein sollte, weisen wir darauf hin, dass ein SQL-Backup tages- und wochenaktuell
 198 für einen etwaigen Restore zu Verfügung stehen sollte. Ferner besteht die Gefahr, dass angemeldete
 199 Benutzer Formfelder mißbrauchen können, Abhilfe schafft hier zum Beispiel der Einsatz von modsecurity unter
 200 Apache2 (https://doxsec.wordpress.com/2017/06/11/using-modsecurity-web-application-firewall-to-prevent-sql-injection-and-xss-using-blocking-rules/)
 201
 202 Upgrade auf v3.5.4
 203
 204 * Task-Server berücksichtigt Memory-Limit
 205
 206 Falls für fgci-Prozesse ein Memory-Limit in der Konfigurationsdatei eingerichtet
 207 ist, wird dies nun auch vom Task-Server berücksichtigt. Dieser beendet sich bei
 208 Überschreitung des Limits. Deshalb muss dafür gesorgt werden, dass der
 209 Task-Server in diesem Fall neu gestartet wird (z.B. über den systemd-Service).
 210 Siehe auch aktuelle kivitendo-Dokumentation.
 211
 212
 213 Upgrade auf v3.5.3
 214
 215 * Fallback-Module entfernt
 216
 217 Einige Default-Module die als Fallback zu Verfügung standen, werden ab
 218 dieser Version nicht mehr mit ausgeliefert.
 219 Bitte vor dem Anmelden an der Weboberfläche 'scripts/installation_check.pl -v' ausführen
 220 und die entsprechenden Module installieren.
 221 S.a. weitere Details in der aktuellen kivitendo-Dokumentation.
 222
 223
 224 Upgrade auf v3.5.1
 225
 226 * Neue Perlabhängigkeiten
 227
 228 * LWP::Authen::Digest für WebshopApi
 229 * LWP::UserAgent für WebshopApi
 230
 231 * Zwingende Postgres Erweiterung pg_trgm(Trigram)
 232
 233   Die Trigramerweiterung bietet eine Ähnlichkeitsuche.
 234   Diese verwendet das Shopmodul, wenn installiert, beim Bestellimport
 235   um zu entscheiden ob ein Kunde neu angelegt oder als Vorschlag angezeigt wird.
 236   Die Erweiterung wird bisher nur beim Ableich der Straße genutzt, da hier oft
 237   unterschiedliche Schreibweisen vorhanden sind.
 238   z.B Dorfstraße, Dorfstrasse, Dorfstr., Dorf Straße usw..
 239   So wird vermieden, dass Kunden eventuell doppelt angelegt werden.
 240
 241   * Zunächst muss geprüft werden, ob die Erweiterung prinzipiell für postgres
 242   vorhanden ist, dafür kann folgendes Select-Statement in template1 genutzt werden:
 243
 244   # select * from pg_available_extensions where name ='pg_trgm';
 245
 246   Sollte bei diesem Statement kein Ergebnis kommen, so muss die entsprechende
 247   Erweiterung für die eigene Distribution nachinstalliert werden.
 248   Bei debian/ubuntu befindet sich diese im Paket postgresql-contrib
 249   und kann mit
 250
 251   $ apt install postgresql-contrib
 252
 253   installiert werden.
 254
 255   * Diese Erweiterung wird mit dem SQL-Updatescript sql/Pg-upgrade2/trigram_extension.sql
 256   und Datenbank-Super-Benutzer Rechten automatisch installiert.
 257   Dazu braucht der DatenbankSuperbenutzer "postgres" ein Passwort
 258
 259   su - postgres
 260   psql
 261   \password
 262   <Eingabe passwort>
 263   \q
 264
 265   Passwort und Benutzername können jetzt beim Anlegen einer neuen Datenbank bzw.
 266   bei Updatescripten, die SuperUserRechte benötigen eingegeben werden.
 267
 268
 269   * Änderungen DATEV-Export Format CSV
 270
 271   Die Felder Belegfeld2 und Buchungsbeschreibung werden nicht mehr befüllt.
 272   Im KNE-Export war im Belegfeld2 die Fälligkeit der Buchung gesetzt und in
 273   Buchungsbeschreibung der Kunden- oder Lieferantenname.
 274   Bei nicht valider Umsatz-Steuer-Identnummer wird der Export abgelehnt.
 275   Da das Feld ein Freitext-Feld und keine Validierung bei der Eingabe hat(te)
 276   unternimmt kivitendo keine eigene Normalisierung,  bzw. Konvertierung
 277   des Datenfelds.
 278
 279   Eine Bereinigung der Ust-IDs muss der kivitendo-Admin eigenverantwortlich unternehmen.
 280   Hier exemplarisch ein SQL-Schnipsel zum Ersetzen der Leerzeichen in diesem Feld:
 281   UPDATE customer SET ustid=REPLACE(ustid, ' ', '') WHERE ustid LIKE '% %';
 282
 283   Upgrade auf v3.5.0
 284   ===========================
 285
 286   * Neue Perl Abhängigkeiten:
 287
 288   * File::MimeInfo - für den Dateiupload
 289   * Sys::CPU
 290   * Thread::Pool::Simple
 291
 292   * Neue externe Abhängigkeiten:
 293
 294   * pdfinfo
 295
 296   * In der Rechte-Tabelle auth.master_rights wurden alle Positionswerte mit 100
 297   multipliziert, um Lücken für neue Rechte zu schaffen.
 298
 299   * In der Tabelle "customer" wurde die Spalte "klass" nach "pricegroup_id"
 300   migriert. Bei Kunden ohne Preisgruppe ist der Datenbankwert jetzt NULL statt
 301   "0". Falls Kunden per CSV-Import importiert werden muß dieses Feld in der
 302   CSV-Datei ebenfalls umbenannt werden.
 303
 304   * Für das neue Feature Lieferantenbriefe ist die Standardvorlage für Briefe
 305   (letter.tex) angepasst worden. Statt letter.customer muss der Adressat jetzt
 306   aus letter.custoemr_vendor erzeugt werden.
 307
 308   * In der Tabelle parts wurde die Boolean-Spalte "assembly" entfernt. Zur
 309   Erkennung von Waren/Dienstleistungen/Erzeugnissen gibt es nun in parts eine
 310   neue Spalte part_type vom ENUM-Typ, der auf die Werte 'part', 'service',
 311   'assembly' und 'assortment' beschränkt ist.
 312
 313   * In der Tabelle parts wurde die Spalten inventory_accno_id, expense_accno_id
 314   und income_accno_id entfernt. Deren Funktionalität wurde schon lange durch
 315   Buchungsgruppen ersetzt und für die Erkennung des Artikeltyps gibt es nun die
 316   Spalte part_type
 317
 318   Upgrade auf v3.4.1
 319   ==================
 320
 321   * Neue Druckvariante Gelangensbestätigung für Verkaufs-Aufträge
 322
 323   Im Standard-Vorlagensatz RB befindet sich als Vorlage die ic_supply.tex
 324   als Orientierung für die Anpassung an eigene Vorlagen. Eigene Vorlagen
 325   müssen entsprechend um diesen Typ für die 3.4.1 erweitert werden.
 326
 327   * Druckvorlagen für Briefe
 328
 329   Die Erzeugung der Druckausgabe für die Brieffunktion wurde auf die
 330   Verwendung des Template Toolkits umgestellt. Dazu muss die verwendete
 331   Druckvorlage "letter.tex" angepasst werden. Im Standard-Vorlagensatz RB ist
 332   das bereits geschehen. Falls keine manuellen Änderungen an der "letter.tex"
 333   aus einer vorherigen Version gemacht wurden, reicht es, diese Datei
 334   ("templates/print/RB/letter.tex") in das verwendete Vorlagenverzeichnis zu
 335   kopieren. Ansonsten kann diese Datei als Beispiel dienen.
 336
 337
 338   Upgrade auf v3.4.0
 339   ==================
 340
 341   * Neue Perl-Modul-Abhängigkeiten:
 342
 343   * Algorithm::CheckDigits
 344   * PBKDF2::Tiny
 345
 346   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
 347
 348   $ scripts/installation_check.pl -ro
 349
 350   * Der in der Dokumentation beschriebene Mechanismus für die CGI-Anbindung
 351   (2.6.1 Grundkonfiguration mittels CGI) wurde geändert. Ein einfacher Alias
 352   auf das Programmverzeichnis funktioniert nicht mehr, und es muss immer ein
 353   AliasMatch auf einen dispatcher eingerichtet werden. Die Dokumentation wurde
 354   aktualisiert. Für Benutzer der empfohlenen FastCGI Anbindung ändert sich
 355   nichts.
 356
 357   * Der Task-Server ist nun mandantenfähig. Für jeden Mandanten, für den
 358   der Task-Server laufen soll, muss in der Administrationsoberfläche
 359   in der Konfiguration des Mandanten hinterlegt werden, welchen
 360   kivitendo-Benutzer der Task-Server nutzen soll. Ist bei einem
 361   Mandanten kein Benutzer hinterlegt, so ignoriert der Task-Server
 362   diesen Mandanten.
 363
 364   Im Gegenzug wurden die beiden Konfigurations-Einstellungen »client«
 365   und »login« aus dem Abschnitt [task_server] entfernt. Der
 366   Task-Server prüft beim Starten allerdings, ob diese Einstellungen
 367   noch existieren und verweigert den Start mit einer hilfreichen
 368   Fehlermeldung, solange sie noch vorhanden sind.
 369
 370   * Die Unterstützung unsicherer Passwort-Hashing-Mechanism wurde
 371   entfernt. Für BenutzerInnen, die noch alte Mechanismen verwenden,
 372   müssen die Passwörter einmalig in der Administrationsoberfläche
 373   zurückgesetzt werden.
 374
 375   Dies betrifft nur Accounts, deren Passwort sich das letzte Mal vor
 376   kivitendo 2.7.0 geändert hat.
 377
 378   Upgrade auf v3.3.0
 379   ==================
 380
 381   * Bei Upgrade von Versionen vor v.3.2.x wie immer erst die dortigen
 382   Upgradehinweise beachten.
 383
 384   * Es gibt keine neuen Perl-Modul-Abhängigkeiten.
 385
 386   * Die alte ungepflegte Druckvorlagenvariante "Standard" wurde entfernt.
 387   Bereits verwendete Druckvorlagen, die darauf aufbauen, funktionieren
 388   natürlich weiterhin.
 389
 390   * Für die Verwendung des MT940 Import Features der Bankerweiterung muß
 391   aqbanking installiert werden. Dies wird nur für die Konvertierung vom MT940
 392   ins CSV Format benötigt, das Kommandozeilentool "aqbanking-cli" befindet sich
 393   z.B. unter Ubuntu im Paket aqbanking-tools.
 394
 395   Upgrade auf v3.2.0
 396   ==================
 397
 398   * Neue Perl-Modul-Abhängigkeiten:
 399
 400   * GD
 401   * HTML::Restrict
 402   * Image::Info
 403   * List::UtilsBy
 404
 405   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
 406
 407   $ scripts/installation_check.pl -ro
 408
 409   Sofern das Upgrade von einer früheren Version als 3.1.0 geschieht auch die
 410   Upgradehinweise der Vorversionen beachten.
 411
 412   * Druckvorlagen auf shipto-Verwendung prüfen
 413
 414   Hier hat sich das Standardverhalten geändert und ggf. werden shipto* nicht mehr
 415   ausgedruckt, hier müssten die Druckvorlagen individuell angepasst werden, s.a.
 416   Changelog -> Verkaufsbeleg-Ausdruck.
 417
 418   Upgrade auf v3.1.0
 419   ==================
 420
 421
 422   * BEVOR ein Aufruf im Administrationsbereich erfolgt, muss zwingend der
 423   webdav Ordner im Installationspfad vorhanden sein!
 424   -  mkdir webdav/
 425 -  Rechte für webserver setzen ($ chmod www-data webdav/)
 426   Dieses "Feature" war in vorhergehenden Versionen optional, wird aber
 427   für das Upgrade auf Mandantenfähigkeit vorausgesetzt.
 428
 429   * Neue Softwarevoraussetzungen: Perl v5.10.1 oder neuer sowie
 430   PostgreSQL 8.4 oder neuer werden zwingend vorausgesetzt. Ein Betrieb
 431   mit älteren Versionen ist nicht mehr möglich.
 432
 433   * Neue Perl-Modul-Abhängigkeiten:
 434
 435   * File::Copy::Recursive
 436   * Rose::DB::Object muss v0.788 oder neuer sein (aufgrund eines Bugs
 437       in besagtem Modul im Zusammenspiel mit PostgreSQL)
 438
 439   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
 440
 441   $ scripts/installation_check.pl -ro
 442
 443   * Die Datenbank muss zwingend Unicode als Encoding nutzen. Daher wird
 444   auch die Konfigurationsvariable "system.dbcharset" nicht mehr
 445   unterstützt.
 446
 447   * Einführung von Mandanten. Früher war die Konfiguration der
 448   Datenbanken für jeden Benutzer getrennt vorzunehmen. Mit diesem
 449   Release wurden Mandanten eingeführt: ein Mandant bekommt einen Namen
 450   sowie die Datenbankkonfiguration, und Benutzer bekommen
 451   Zugriffsrechte auf einen oder mehrere Mandanten.
 452
 453   Um dieses Update durchzuführen, müssen Sie sich einmal im
 454   Administrationsbereich anmelden. Vorher ist kein Login im
 455   Benutzerbereich möglich.
 456
 457   Die neue Struktur bedingt, dass viele Scripte, die bisher zur
 458   Konfiguration nur einen Benutzer verlangt haben, jetzt auch einen
 459   Mandanten verlangen. Die Konfiguration dieser Scripte ist deshalb
 460   manuell anzupassen. Dazu gehören:
 461
 462   - der Task-Server (config/kivitendo.conf)
 463 - CSV-Import von der Shell aus (scripts/csv-import-from-shell.sh)
 464
 465   Die folgenden Scripte sind ebenfalls betroffen, allerdings nur für
 466   Entwickler interessant:
 467
 468   - scripts/dbupgrade2_tool.pl
 469   - scripts/rose_auto_create_model.pl
 470
 471   * Neue Benutzerrechte
 472
 473   Diese müssen bei vorhandenen Gruppen eventuell nachgepflegt werden. Z.B. bei
 474   der Gruppe Vollzugriff
 475
 476   - Stammdaten -> Kunden und Lieferanten erfassen. Alle Lieferanten bearbeiten.
 477   Alle Kunden bearbeiten
 478   - Konfiguration -> Verändern der kivitendo-Installationseinstellungen (die
 479       meisten Menüpunkte unterhalb von 'System')
 480
 481   * Die alten ungepflegten Druckvorlagenvarianten French und Service
 482   wurden entfernt.
 483
 484   * Die HTML-Druckvorlagen der Berichte (GuV, Bilanz, SuSa, BWA, UStVA) werden
 485   jetzt alle zentral in den Webvorlagen verwaltet, es werden keine
 486   benutzerangepasste Versionen der Druckvorlagen im Druckvorlagenverzeichnis
 487   mehr unterstützt.
 488
 489   Upgrade auf v3.0.0
 490   ==================
 491
 492   * Neue Abhängigkeiten
 493
 494   * Clone 1.16
 495   * Email::MIME
 496   * FCGI jetzt min Version 0.72
 497   * Test::Harness 3.00
 498   * IO::Socket::SSL
 499   * Net::LDAP
 500   * Net::SMTP::SSL
 501   * Net::SSLGlue
 502
 503   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
 504
 505   $ scripts/installation_check.pl -ro
 506
 507   * Neue Entwicklerabhängigkeiten
 508
 509   * Test::Deep
 510   * GD 2.00
 511
 512   * Diverse umstrittene Features zum nicht standardkonformen Umgang mit gebuchten
 513   Rechnungen sind jetzt standardmässig deaktiviert und müssen unter "System" ->
 514   "Mandantenkonfiguration" aktiviert werden.
 515
 516   * Die Übersetzungen "de_DE" und "fr" für die alternative deutsche Version und
 517   französische Version respektive wurden entfernt. Es bleiben offiziell
 518   unterstützte Übersetzungen in Deutsch ("de") und English ("en").
 519
 520   * Dieses ist die letzte Version, die Perl-Versionen vor 5.10.1
 521   unterstützen wird.  Ab dem nächsten Release werden Sprachkonstrukte
 522   verwendet werden, die nicht mehr in 5.8 kompilieren, und Module, die
 523   seit v5.10.1 zu den Coremodulen gehören, werden ab dann nicht mehr
 524   als explizite Abhängigkeiten gelistet.
 525
 526
 527   Upgrade auf v2.7.0
 528   ==================
 529
 530   * In der Version 2.7.0 wird das XUL Menü entfernt. Alle Benutzer die das XUL
 531   Menü noch eingestellt haben, werden beim ersten Einloggen auf ein
 532   Kompatibilitätsmenü gesetzt. Das Javascriptmenü wurde entsprechend erweitert
 533   um der Funktionalität nahe zu kommen.
 534
 535   * Das Lizenzenfeature wurde ersatzlos entfernt.
 536
 537   * In den LaTeX Vorlagen gilt der Befehl "pagebreak" und die dazugehörigen
 538   "sumcarriedforward" und "lastpage" als deprecated und werden in einer
 539   kommenden Version komplett entfernt. Die Mechanik ist anfällig gegenüber
 540   subtilen Formatierungsfehlern bei bestimmten Zahlenformaten und ist
 541   grundsätzlich fehlerhaft in den gemachten Annahmen über den verfügbaren Platz
 542   auf einer Seite. Die Standardvorlagen sind entsprechend angepasst worden
 543   und müssen in der Administration neu angelegt werden.
 544
 545   * Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
 546   Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
 547   benennen Sie ihn um bevor Sie das Update starten.
 548
 549   * Die Druckvorlagen für USTVA vor 2012 wurden entfernt und das Ausdrucken von
 550   USTVA als PDF ist deprecated. Da die Eingabe von Erklärungen als PDF nicht
 551   mehr gestattet ist, sollten Archivkopien der USTVA direkt bei Elster bezogen
 552   werden, oder auf anderem Wege erstellt werden. Der Prozess dazu wird sich in
 553   einer kommenden Version ändern.
 554
 555   * Die Namen der von LaTeX generierten PDF-Dateien sind jetzt in der
 556   eingestellten Dokumentensprache, nicht mehr in der Oberflächensprache des
 557   Bearbeiters.
 558
 559   * Neue Abhängigkeiten
 560
 561   * JSON
 562   * String::ShellQuote
 563 * Digest::SHA (optional, empfohlen)
 564
 565   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
 566
 567   $ scripts/installation_check.pl -ro
 568
 569   * CSV-Import wurde neu in Perl implementiert
 570
 571   Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
 572   lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
 573   funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
 574   benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
 575   nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
 576
 577   * Rechteverwaltung
 578
 579   * Das Recht "Kunden und Lieferanten bearbeiten" wurde aufgespalten in zwei
 580   einzelne Rechte. Ein Updatescript passt bestehende Gruppenaentsprechend an.
 581   * Das Recht "Preise nd Rabatte bearbeiten" wurde neu eingeführt und ist
 582   notwendig um in Belegen Preise ändern zu können. Es wird beim Upgrade
 583   automatisch allen Benutzern erteilt.
 584   * Das Recht "Administration" wurde neu eingeführt, und ist dazu da
 585   administrative Tätigkeiten an der Mandantendatenbank aus einm Benutzerlogin
 586   heraus durchzuführen. Es ist standardmäßig NICHT vergeben.
 587   * Der Vorlageneditor wurde unter das Recht Administration gestellt, war
 588   vorher Konfiguration.
 589
 590
 591   Upgrade auf v2.6.3
 592   ==================
 593
 594   1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
 595   authentication.pl und lx-erp.conf, sowie deren Varianten,
 596   abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
 597   aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
 598   lx_office.conf.default. Die entsprechenden Werte muß man selber neu
 599   konfigurieren, dies ist automatisiert zu fehleranfällig.
 600
 601   Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
 602   angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
 603
 604   Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
 605   man lx_office.conf nicht einchecken.
 606
 607   Eine etwas ausführlichere Beschreibung findet sich in Kapitel 2.3
 608   "Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf
 609
 610   2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
 611   handelt es sich um einen Dämonen, der im Hintergrund läuft, in
 612   regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
 613   zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
 614   Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
 615   benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
 616   bekommen. Die Einrichtung des Dämonen wird in der
 617   Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
 618
 619   3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
 620   hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
 621   den folgenden Befehl im Lx-Office Verzeichnis aus:
 622
 623   $ scripts/installation_check.pl
 624
 625   Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 626   der Installationsanweisung.
 627
 628   Zumindest folgende Module sind neu benötigt:
 629
 630   * Config::Std
 631   * Params::Validate
 632
 633   4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
 634   "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
 635   Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
 636   seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
 637   dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
 638   hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für
 639   FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf
 640
 641
 642   Upgrade auf v2.6.2
 643   ==================
 644
 645   Vor dem Einloggen
 646   -----------------
 647
 648   Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
 649   Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
 650   Lx-Office Verzeichnis aus:
 651
 652   $ scripts/installation_check.pl
 653
 654   Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 655   der Installationsanweisung.
 656
 657   Zumindest folgende Module sind neu benötigt:
 658
 659   * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
 660       Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
 661       Distribution sollte für die automatische Installation der anderen
 662       zwei Pakete sorgen)
 663
 664   Neue Gruppenrechte
 665   ------------------
 666
 667   Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
 668   Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
 669   davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
 670
 671   Für bereits bestehende Gruppen muss es sofern gewünscht vom
 672   Administrator manuell gewährt werden.
 673
 674
 675   Upgrade auf v2.6.1
 676   ==================
 677
 678   Vor dem Einloggen
 679   -----------------
 680
 681   Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
 682   Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
 683   (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
 684   anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
 685   geändert.
 686
 687   Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
 688   Lx-Office Verzeichnis aus:
 689
 690   $ scripts/installation_check.pl
 691
 692   Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 693   der Installationsanweisung.
 694
 695   Zumindest folgende Module sind neu benötigt:
 696
 697   * URI
 698   * XML::Writer
 699
 700   Neue Konfigurationsvariablen
 701   ----------------------------
 702
 703   In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
 704   Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
 705 standardmäßig deaktiviert.