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