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.6.3
   8 ==================
   9
  10 1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
  11 authentication.pl und lx-erp.conf, sowie deren Varianten,
  12 abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
  13 aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
  14 lx_office.conf.default. Die entsprechenden Werte muß man selber neu
  15 konfigurieren, dies ist automatisiert zu fehleranfällig.
  16
  17 Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
  18 angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
  19
  20 Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
  21 man lx_office.conf nicht einchecken.
  22
  23 Eine etwas ausführlichere Beschreibung findet sich in der Datei:
  24 doc/konfigurationsdatei.txt
  25
  26 2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
  27 handelt es sich um einen Dämonen, der im Hintergrund läuft, in
  28 regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
  29 zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
  30 Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
  31 benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
  32 bekommen. Die Einrichtung des Dämonen wird in der
  33 Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
  34
  35 3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
  36 hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
  37 den folgenden Befehl im Lx-Office Verzeichnis aus:
  38
  39 $ scripts/installation_check.pl
  40
  41 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
  42 der Installationsanweisung.
  43
  44 Zumindest folgende Module sind neu benötigt:
  45
  46 * Config::Std
  47 * Params::Validate
  48
  49 4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
  50 "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
  51 Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
  52 seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
  53 dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
  54 hat. Details dazu finden sich in der Datei doc/INSTALL.fcgi.
  55
  56
  57 Upgrade auf v2.6.2
  58 ==================
  59
  60  Vor dem Einloggen
  61  -----------------
  62
  63 Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
  64 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
  65 Lx-Office Verzeichnis aus:
  66
  67 $ scripts/installation_check.pl
  68
  69 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
  70 der Installationsanweisung.
  71
  72 Zumindest folgende Module sind neu benötigt:
  73
  74 * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
  75   Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
  76   Distribution sollte für die automatische Installation der anderen
  77   zwei Pakete sorgen)
  78
  79  Neue Gruppenrechte
  80  ------------------
  81
  82 Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
  83 Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
  84 davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
  85
  86 Für bereits bestehende Gruppen muss es sofern gewünscht vom
  87 Administrator manuell gewährt werden.
  88
  89
  90 Upgrade auf v2.6.1
  91 ==================
  92
  93  Vor dem Einloggen
  94  -----------------
  95
  96 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
  97 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
  98 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
  99 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
 100 geändert.
 101
 102 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
 103 Lx-Office Verzeichnis aus:
 104
 105 $ scripts/installation_check.pl
 106
 107 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
 108 der Installationsanweisung.
 109
 110 Zumindest folgende Module sind neu benötigt:
 111
 112 * URI
 113 * XML::Writer
 114
 115  Neue Konfigurationsvariablen
 116  ----------------------------
 117
 118 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
 119 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
 120 standardmäßig deaktiviert.
 121
 122
 123 Upgrade auf v2.6.0
 124 ==================
 125
 126 Mit Version 2.6.0 wurde der Code zur Benutzerauthentifizierung neu
 127 geschrieben. Die Umstellung erfordert eine manuelle
 128 Konfiguration. Bestehende Benutzeraccounts können aber von Lx-Office
 129 automatisch übernommen werden.
 130
 131  Bevor Sie sich das erste mal einloggen
 132  --------------------------------------
 133
 134 Kopieren Sie bitte die Datei "lx-erp.conf" und
 135 ggfs. "lx-erp-local.conf" in das neue Unterverzeichnis "config/". Die
 136 alte Datei im Lx-Office-Stammverzeichnis kann daraufhin gelöscht
 137 werdern.
 138
 139 Als nächstes muss die neue datenbankgestützte Benutzerverwaltung
 140 konfiguriert werden. Die dafür notwendigen Einstellungen werden in der
 141 Datei "config/authentification.pl" vorgenommen, für die eine
 142 kommentierte Vorlage in "config/authentication.pl.default"
 143 bereitliegt.
 144
 145 Weitere Informationen zu dieser Datei finden Sie in der Dokumentation
 146 "doc/INSTALL/index.html" und dort in den Kapiteln
 147 "Benutzerauthentifizierung und Administratorpasswort" sowie "Benutzer-
 148 und Gruppenverwaltung".
 149
 150 Nach der Einrichtung der Datei "config/authentication.pl" muss im
 151 Webbrowser das Administrationsinterface aufgerufen werden. Nach
 152 erfolgter Anmeldung werden Sie durch den Upgradeprozess geleitet.
 153
 154 Die weiteren erforderlichen Datenbankupgrades werden erst vorgenommen,
 155 wenn sich ein Benutzer erfolgreich anmeldet.
 156
 157  Neue Perl-Module
 158  ----------------
 159
 160 Mit Version 2.6.0 werden zusätzlich die folgenden Perl-Module benötigt,
 161 die bis Version 2.4.3 inklusive noch keine Voraussetzung waren:
 162
 163 * PDF::API2
 164
 165
 166 Upgrade von v2.4.0 und neuer auf v2.4.3
 167 =======================================
 168
 169 Ein Upgrade von v2.4.0 oder neuer auf v2.4.3 aus zwei Teilen: den
 170 Dateien (einfaches Entpacken und Kopieren in das
 171 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
 172
 173  Neue Variablen in der Datei lx-erp.conf
 174  ---------------------------------------
 175
 176 Wenn Sie eine eigene Version der Konfigurationsdatei "lx-erp.conf"
 177 einsetzen und diese nicht mit der Standardkonfigurationsdatei
 178 überschreiben, so beachten Sie bitte, dass die folgenden neuen
 179 Variablen hinzugekommen sind und von Ihnen manuell ergänzt werden
 180 sollten: $html2ps_bin, $ghostscript_bin, $pg_dump_exe und
 181 $pg_restore_exe. Die Variable '$jscalendar' kann hingegen entfernt
 182 werden, da sie nicht mehr benötigt wird.
 183
 184 Die Standardwerte für diese Variablen finden Sie in der Datei
 185 "lx-erp.conf.default".
 186
 187  Neue Abhängigkeiten von Perl-Modulen
 188  ------------------------------------
 189
 190 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
 191 der Datei "doc/INSTALL". Seit Version 2.4.0 sind die folgenden Module
 192 neu hinzugekommen:
 193
 194 - Achive::Zip
 195 - Template
 196 - Text::CSV_XS
 197 - Text::Iconv
 198 - Time::HiRes
 199 - YAML
 200
 201 Nach Möglichkeit sollten auch die aktuellen Versionen der
 202 Datenbankpakete "DBI" und "DBD::Pg" installiert werden.
 203
 204  Datenbankupgrade
 205  ----------------
 206
 207 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
 208 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
 209
 210 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 211
 212
 213 Upgrade von v2.4.0 auf 2.4.1 sowie von 2.4.1 auf 2.4.2
 214 ======================================================
 215
 216 Ein Upgrade von v2.4.0 auf v2.4.1 oder von v2.4.1 auf v2.4.2 besteht
 217 aus zwei Teilen: den Dateien (einfaches Entpacken und Kopieren in das
 218 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
 219
 220 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
 221 der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss
 222 sichergestellt werden, dass das Modul "YAML" installiert ist.
 223
 224 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
 225 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
 226
 227 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 228
 229 Anders als beim Upgrade auf 2.4.0 handelt es bei den Datenbankupgrades
 230 auf 2.4.1 und 2.4.2 nur um automatisch ablaufende Scripte, die keine
 231 Benutzereingaben erfordern.
 232
 233
 234 Upgrade von v2.2.0 bis 2.2.2 auf 2.4.0
 235 ======================================
 236
 237 Ein direktes Upgrade von den unmodifizierten Versionen 2.2.0, 2.2.1
 238 und 2.2.2 auf 2.4.0 ist möglich. Ein solches Upgrade besteht aus zwei
 239 Teilen: den Dateien (einfaches Entpacken und Kopieren in das
 240 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
 241
 242 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
 243 der Datei "doc/INSTALL".
 244
 245 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
 246 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
 247
 248 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 249
 250 Das Datenbankupgrade enthält zwei interaktive Upgradepfade für neue
 251 Features in Lx-Office 2.4.0: Einheiten sowie Buchungsgruppen.
 252
 253
 254
 255 Einführung von Einheiten
 256 ------------------------
 257
 258 In Versionen von Lx-Office vor 2.4.0 konnte der Benutzer bei den
 259 Stammdaten aber auch in den Einkaufs- und Verkaufsdialogen beliebige
 260 Texte als "Einheit" angeben. Lx-Office 2.4.0 ändert dies nun. Der
 261 Administrator kann unter "System -> Einheiten -> Maßeinheiten" die bei
 262 Waren und Erzeugnissen verwendbaren und bei "System -> Einheiten ->
 263 Dienstleistungseinheiten" die bei Dienstleistungen verwendbaren
 264 Einheiten festlegen. Lx-Office 2.4.0 bringt bereits für beide Typen
 265 einige Standardeinheiten mit.
 266
 267 Einheiten können wiederum auf anderen Einheiten basieren. So ist
 268 z.B. "kg" als das 1000fache der Einheit "g" definiert. Der Benutzer
 269 muss beim Anlegen von Artikeln in den Stammdaten eine Einheit aus
 270 einer Drop-Down-Liste auswählen. In den Einkaufs- und Verkaufsmasken
 271 werden dann dem Benutzer nur noch diejenigen Einheiten zur Auswahl
 272 angeboten, die sich in die in den Stammdaten hinterlegte Einheit
 273 umrechnen lassen. So würden z.B. für eine Ware, deren
 274 Stammdateneinheit "kg" ist, nur die Einheiten "g", "kg", "t" zur
 275 Auswahl aufgelistet, nicht aber "Stück" oder "Tag", "Stunde".
 276
 277 Das Datenbankupgrade muss nun alle im System verwendeten Einheiten in
 278 den Stammdaten sowie in den Einkaufs- und Verkaufsdaten so anpassen,
 279 dass dort nur noch Einheiten auftreten, die im System verwendet werden
 280 können. Da dies nur eingeschränkt automatisch möglich ist, werden dem
 281 Benutzer, der das Datenbankupgrade nach dem Login durchführt, einige
 282 Masken angezeigt, in denen er neue Einheiten in der Datenbank anlegen
 283 kann, und in denen er "alte" Einheiten durch "neue" Einheiten ersetzen
 284 lassen kann.
 285
 286 Zuletzt muss er noch für all die Waren, für die früher gar keine
 287 Einheit eingetragen wurde, eine Standardeinheit getrennt nach Waren /
 288 Erzeugnissen und Dienstleistungen festlegen, die statt dessen
 289 eingesetzt wird.
 290
 291
 292 Einführung von Steuerzonen und Buchungsgruppen
 293 ----------------------------------------------
 294
 295 In den Versionen von Lx-Office vor 2.4.0 wurden bei Artikeln und
 296 Dienstleistungen jeweils ein Konto für Erlöse und ein Konto für den
 297 Aufwand hinterlegt. Über diese Konten wurde dann auch definiert
 298 welcher Steuersatz zu berechnen ist. Wollte man einen Artikel mal mit
 299 und mal ohne Steuer verkaufen (Inland, Ausland), waren hierfür zwei
 300 Artikel notwendig.
 301
 302 In der Version 2.4.0 können nun bei jedem Artikel für die
 303 verschiedenen Fälle
 304 - Inland
 305 - EU mit UStId
 306 - EU ohne UStId
 307 - Außerhalb EU
 308 verschiedene Erlös- und Aufwandskonten definiert werden. Dadurch
 309 werden dann auch jeweils die richtigen Steuersätze berechnet.
 310
 311 Damit jetzt nicht bei jedem Artikel mehrere Konten definiert werden
 312 müssen, werden alle Konten, die zu einer bestimmten Warengruppe
 313 gehören, in einer Buchungsgruppe zusammengefasst. Diese
 314 Buchungsgruppen werden zunächst unter "System" definiert und können
 315 dann den Artikeln und Dienstleistungen zugewiesen werden.
 316
 317 Beim Datenbankupdate werden aus der Datenbank alle Kombinationen von
 318 Erlös- und Aufwandskonten geholt, die bereits verwendet wurden. Für
 319 diese Kombinationen müssen im Upgradeprozess Buchungsgruppen angelegt
 320 werden, indem man den einzelnen Kombinationen einen Namen zuweist. Die
 321 Konten für nicht Inland sind mit den Standardkonten vorbelegt, können
 322 aber vor dem Speichern geändert werden.
 323
 324 Diese neu angelegten Buchungsgruppen werden automatisch den
 325 vorhandenen Artikeln und Dienstleistungen zugewiesen.  Buchungsgruppen
 326 können genau wie vorher die Kontenzuordnung nachträglich nicht mehr
 327 geändert werden.
 328
 329 Möchte man in der Buchhaltung eine neue Kombination von Erlös- und
 330 Aufwandskonten für bestimmte Artikel und Waren verwenden, legt man
 331 zunächst die entsprechenden konnten (z.B. 8401 und 3401) an und
 332 erstellt dann eine neue Buchungsgruppe mit diesen Konten.  Die
 333 Benennung der Buchungsgruppe kann frei erfolgen.
 334
 335 Beim Anlegen einer neuen Waren oder Dienstleistung werden dann durch
 336 Auswahl dieser Buchungsgruppe automatisch alle Konten auf einen Schlag
 337 korrekt zugeordnet.
 338
 339 Wird in einer Verkaufs- oder Einkaufsmaske eine andere Steuerzone als
 340 Inland ausgewählt, werden bei den Artikeln auch automatisch die
 341 anderen Erlös- und Aufwandskonten der Buchungsgruppe verwendet.
 342
 343 Dokumentenvorlagen, Umbennante Vorlagenvariablen
 344 ------------------------------------------------
 345
 346 Einige Variablen, die in Dokumentenvorlagen verwendet werden, mussten
 347 aufgrund von Namenskonflikten umbenannt werden. Dazu gehören:
 348
 349 * Adress- und Kontaktinformationen des angemeldeten Mitarbeiters. Die
 350   Variablen "company", "address" und "businessnumber" haben alle einen
 351   Präfix "employee_" bekommen und heißen nun "employee_company",
 352   "employee_address" und "employee_businessnumber".
 353
 354 Zu beachten ist außerdem, dass der Befehl <%include ...%> in
 355 Dokumentenvorlagen nicht mehr zur Verfügung steht.