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