doc/UPGRADE

   1 Wichtige Hinweise zum Upgrade von älteren Versionen
   2 ===================================================
   3
   4
   5 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
   6
   7 Upgrade auf v2.7.0
   8 ==================
   9
  10 1. Templateumstellungen
  11
  12 Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
  13 Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
  14 benennen Sie ihn um bevor Sie das Update starten.
  15
  16 2. Neue Abhängigkeiten
  17
  18 Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
  19
  20 $ scripts/installation_check.pl
  21
  22 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
  23 der Installationsanweisung.
  24
  25 Es sind zwei neue Abhängigkeiten dazugekommen.
  26
  27 * JSON
  28 * String::ShellQuote
  29
  30 3. CSV-Import wurde neu in Perl implementiert
  31
  32 Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
  33 lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
  34 funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
  35 benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
  36 nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
  37
  38
  39 Upgrade auf v2.6.3
  40 ==================
  41
  42 1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
  43 authentication.pl und lx-erp.conf, sowie deren Varianten,
  44 abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
  45 aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
  46 lx_office.conf.default. Die entsprechenden Werte muß man selber neu
  47 konfigurieren, dies ist automatisiert zu fehleranfällig.
  48
  49 Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
  50 angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
  51
  52 Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
  53 man lx_office.conf nicht einchecken.
  54
  55 Eine etwas ausführlichere Beschreibung findet sich in Kapitel 2.3
  56 "Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf
  57
  58 2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
  59 handelt es sich um einen Dämonen, der im Hintergrund läuft, in
  60 regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
  61 zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
  62 Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
  63 benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
  64 bekommen. Die Einrichtung des Dämonen wird in der
  65 Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
  66
  67 3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
  68 hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
  69 den folgenden Befehl im Lx-Office Verzeichnis aus:
  70
  71 $ scripts/installation_check.pl
  72
  73 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
  74 der Installationsanweisung.
  75
  76 Zumindest folgende Module sind neu benötigt:
  77
  78 * Config::Std
  79 * Params::Validate
  80
  81 4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
  82 "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
  83 Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
  84 seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
  85 dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
  86 hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für
  87 FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf
  88
  89
  90 Upgrade auf v2.6.2
  91 ==================
  92
  93  Vor dem Einloggen
  94  -----------------
  95
  96 Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
  97 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
  98 Lx-Office Verzeichnis aus:
  99
 100 $ scripts/installation_check.pl
 101
 102 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 103 der Installationsanweisung.
 104
 105 Zumindest folgende Module sind neu benötigt:
 106
 107 * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
 108   Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
 109   Distribution sollte für die automatische Installation der anderen
 110   zwei Pakete sorgen)
 111
 112  Neue Gruppenrechte
 113  ------------------
 114
 115 Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
 116 Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
 117 davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
 118
 119 Für bereits bestehende Gruppen muss es sofern gewünscht vom
 120 Administrator manuell gewährt werden.
 121
 122
 123 Upgrade auf v2.6.1
 124 ==================
 125
 126  Vor dem Einloggen
 127  -----------------
 128
 129 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
 130 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
 131 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
 132 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
 133 geändert.
 134
 135 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
 136 Lx-Office Verzeichnis aus:
 137
 138 $ scripts/installation_check.pl
 139
 140 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 141 der Installationsanweisung.
 142
 143 Zumindest folgende Module sind neu benötigt:
 144
 145 * URI
 146 * XML::Writer
 147
 148  Neue Konfigurationsvariablen
 149  ----------------------------
 150
 151 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
 152 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
 153 standardmäßig deaktiviert.