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
   8 Upgrade auf v3.x.0
   9 ==================
  10
  11 * Neue Softwarevoraussetzungen: Perl v5.10.1 oder neuer sowie
  12   PostgreSQL 8.4 oder neuer werden zwingend vorausgesetzt. Ein Betrieb
  13   mit älteren Versionen ist nicht mehr möglich.
  14
  15 * Neue Perl-Modul-Abhängigkeiten:
  16
  17   * File::Copy::Recursive
  18   * Rose::DB::Object muss v0.788 oder neuer sein (aufgrund eines Bugs
  19     in besagtem Modul im Zusammenspiel mit PostgreSQL)
  20
  21   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
  22
  23   $ scripts/installation_check.pl -ro
  24
  25 * Die Datenbank muss zwingend Unicode als Encoding nutzen. Daher wird
  26   auch die Konfigurationsvariable "system.dbcharset" nicht mehr
  27   unterstützt.
  28
  29 * Einführung von Mandanten. Früher war die Konfiguration der
  30   Datenbanken für jeden Benutzer getrennt vorzunehmen. Mit diesem
  31   Release wurden Mandanten eingeführt: ein Mandant bekommt einen Namen
  32   sowie die Datenbankkonfiguration, und Benutzer bekommen
  33   Zugriffsrechte auf einen oder mehrere Mandanten.
  34
  35   Um dieses Update durchzuführen, müssen Sie sich einmal im
  36   Administrationsbereich anmelden. Vorher ist kein Login im
  37   Benutzerbereich möglich.
  38
  39   Die neue Struktur bedingt, dass viele Scripte, die bisher zur
  40   Konfiguration nur einen Benutzer verlangt haben, jetzt auch einen
  41   Mandanten verlangen. Die Konfiguration dieser Scripte ist deshalb
  42   manuell anzupassen. Dazu gehören:
  43
  44   - der Task-Server (config/kivitendo.conf)
  45   - CSV-Import von der Shell aus (scripts/csv-import-from-shell.sh)
  46
  47   Die folgenden Scripte sind ebenfalls betroffen, allerdings nur für
  48   Entwickler interessant:
  49
  50   - scripts/dbupgrade2_tool.pl
  51   - scripts/rose_auto_create_model.pl
  52
  53
  54 Upgrade auf v3.0.0
  55 ==================
  56
  57 * Neue Abhängigkeiten
  58
  59   * Clone 1.16
  60   * Email::MIME
  61   * FCGI jetzt min Version 0.72
  62   * Test::Harness 3.00
  63   * IO::Socket::SSL
  64   * Net::LDAP
  65   * Net::SMTP::SSL
  66   * Net::SSLGlue
  67
  68   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
  69
  70   $ scripts/installation_check.pl -ro
  71
  72 * Neue Entwicklerabhängigkeiten
  73
  74   * Test::Deep
  75   * GD 2.00
  76
  77 * Diverse umstrittene Features zum nicht standardkonformen Umgang mit gebuchten
  78   Rechnungen sind jetzt standardmässig deaktiviert und müssen unter "System"
  79   -> "Mandantenkonfiguration" aktiviert werden.
  80
  81 * Die Übersetzungen "de_DE" und "fr" für die alternative deutsche Version und
  82   französische Version respektive wurden entfernt. Es bleiben offiziell
  83   unterstützte Übersetzungen in Deutsch ("de") und English ("en").
  84
  85 * Dieses ist die letzte Version, die Perl-Versionen vor 5.10.1
  86   unterstützen wird.  Ab dem nächsten Release werden Sprachkonstrukte
  87   verwendet werden, die nicht mehr in 5.8 kompilieren, und Module, die
  88   seit v5.10.1 zu den Coremodulen gehören, werden ab dann nicht mehr
  89   als explizite Abhängigkeiten gelistet.
  90
  91
  92 Upgrade auf v2.7.0
  93 ==================
  94
  95 * In der Version 2.7.0 wird das XUL Menü entfernt. Alle Benutzer die das XUL
  96   Menü noch eingestellt haben, werden beim ersten Einloggen auf ein
  97   Kompatibilitätsmenü gesetzt. Das Javascriptmenü wurde entsprechend erweitert
  98   um der Funktionalität nahe zu kommen.
  99
 100 * Das Lizenzenfeature wurde ersatzlos entfernt.
 101
 102 * In den LaTeX Vorlagen gilt der Befehl "pagebreak" und die dazugehörigen
 103   "sumcarriedforward" und "lastpage" als deprecated und werden in einer
 104   kommenden Version komplett entfernt. Die Mechanik ist anfällig gegenüber
 105   subtilen Formatierungsfehlern bei bestimmten Zahlenformaten und ist
 106   grundsätzlich fehlerhaft in den gemachten Annahmen über den verfügbaren Platz
 107   auf einer Seite. Die Standardvorlagen sind entsprechend angepasst worden
 108   und müssen in der Administration neu angelegt werden.
 109
 110 * Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
 111   Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
 112   benennen Sie ihn um bevor Sie das Update starten.
 113
 114 * Die Druckvorlagen für USTVA vor 2012 wurden entfernt und das Ausdrucken von
 115   USTVA als PDF ist deprecated. Da die Eingabe von Erklärungen als PDF nicht
 116   mehr gestattet ist, sollten Archivkopien der USTVA direkt bei Elster bezogen
 117   werden, oder auf anderem Wege erstellt werden. Der Prozess dazu wird sich in
 118   einer kommenden Version ändern.
 119
 120 * Die Namen der von LaTeX generierten PDF-Dateien sind jetzt in der
 121   eingestellten Dokumentensprache, nicht mehr in der Oberflächensprache des
 122   Bearbeiters.
 123
 124 * Neue Abhängigkeiten
 125
 126   * JSON
 127   * String::ShellQuote
 128   * Digest::SHA (optional, empfohlen)
 129
 130   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
 131
 132   $ scripts/installation_check.pl -ro
 133
 134 * CSV-Import wurde neu in Perl implementiert
 135
 136   Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
 137   lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
 138   funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
 139   benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
 140   nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
 141
 142 * Rechteverwaltung
 143
 144   * Das Recht "Kunden und Lieferanten bearbeiten" wurde aufgespalten in zwei
 145     einzelne Rechte. Ein Updatescript passt bestehende Gruppenaentsprechend an.
 146   * Das Recht "Preise nd Rabatte bearbeiten" wurde neu eingeführt und ist
 147     notwendig um in Belegen Preise ändern zu können. Es wird beim Upgrade
 148     automatisch allen Benutzern erteilt.
 149   * Das Recht "Administration" wurde neu eingeführt, und ist dazu da
 150     administrative Tätigkeiten an der Mandantendatenbank aus einm Benutzerlogin
 151     heraus durchzuführen. Es ist standardmäßig NICHT vergeben.
 152   * Der Vorlageneditor wurde unter das Recht Administration gestellt, war
 153     vorher Konfiguration.
 154
 155
 156 Upgrade auf v2.6.3
 157 ==================
 158
 159 1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
 160 authentication.pl und lx-erp.conf, sowie deren Varianten,
 161 abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
 162 aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
 163 lx_office.conf.default. Die entsprechenden Werte muß man selber neu
 164 konfigurieren, dies ist automatisiert zu fehleranfällig.
 165
 166 Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
 167 angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
 168
 169 Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
 170 man lx_office.conf nicht einchecken.
 171
 172 Eine etwas ausführlichere Beschreibung findet sich in Kapitel 2.3
 173 "Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf
 174
 175 2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
 176 handelt es sich um einen Dämonen, der im Hintergrund läuft, in
 177 regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
 178 zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
 179 Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
 180 benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
 181 bekommen. Die Einrichtung des Dämonen wird in der
 182 Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
 183
 184 3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
 185 hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
 186 den folgenden Befehl im Lx-Office Verzeichnis aus:
 187
 188 $ scripts/installation_check.pl
 189
 190 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 191 der Installationsanweisung.
 192
 193 Zumindest folgende Module sind neu benötigt:
 194
 195 * Config::Std
 196 * Params::Validate
 197
 198 4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
 199 "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
 200 Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
 201 seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
 202 dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
 203 hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für
 204 FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf
 205
 206
 207 Upgrade auf v2.6.2
 208 ==================
 209
 210  Vor dem Einloggen
 211  -----------------
 212
 213 Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
 214 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
 215 Lx-Office Verzeichnis aus:
 216
 217 $ scripts/installation_check.pl
 218
 219 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 220 der Installationsanweisung.
 221
 222 Zumindest folgende Module sind neu benötigt:
 223
 224 * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
 225   Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
 226   Distribution sollte für die automatische Installation der anderen
 227   zwei Pakete sorgen)
 228
 229  Neue Gruppenrechte
 230  ------------------
 231
 232 Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
 233 Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
 234 davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
 235
 236 Für bereits bestehende Gruppen muss es sofern gewünscht vom
 237 Administrator manuell gewährt werden.
 238
 239
 240 Upgrade auf v2.6.1
 241 ==================
 242
 243  Vor dem Einloggen
 244  -----------------
 245
 246 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
 247 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
 248 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
 249 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
 250 geändert.
 251
 252 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
 253 Lx-Office Verzeichnis aus:
 254
 255 $ scripts/installation_check.pl
 256
 257 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 258 der Installationsanweisung.
 259
 260 Zumindest folgende Module sind neu benötigt:
 261
 262 * URI
 263 * XML::Writer
 264
 265  Neue Konfigurationsvariablen
 266  ----------------------------
 267
 268 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
 269 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
 270 standardmäßig deaktiviert.