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