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