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