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