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