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