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