kivitendo/doc/UPGRADE @ e08c98d4
| 4c24a5f4 | Sven Schöling | Wichtige Hinweise zum Upgrade von älteren Versionen
|
||
| 590d623e | Moritz Bunkus | ===================================================
|
||
** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
|
||||
| 1d81586f | Geoffrey Richardson | Upgrade auf v2.6.3
|
||
==================
|
||||
Mit Version 2.6.3. wurden die beiden Konfigurationsdateien authentication.pl
|
||||
und lx-erp.conf, sowie deren Varianten, abgeschafft. Stattdessen gibt es nun
|
||||
die Datei lx_office.conf, die aber erst neu angelegt werden muß. Als Vorlage
|
||||
dient hierfür die Datei lx_office.conf.default. Die entsprechenden Werte muß
|
||||
man selber neu konfigurieren, dies ist automatisiert zu fehleranfällig.
|
||||
Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
|
||||
angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
|
||||
Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
|
||||
man lx_office.conf nicht einchecken.
|
||||
| ca4c3871 | Geoffrey Richardson | Eine etwas ausführlichere Beschreibung findet sich in der Datei:
|
||
doc/konfigurationsdatei.txt
|
||||
| 1d81586f | Geoffrey Richardson | |||
| c65ce0ef | Moritz Bunkus | Upgrade auf v2.6.2
|
||
==================
|
||||
Vor dem Einloggen
|
||||
-----------------
|
||||
Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
|
||||
Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
|
||||
Lx-Office Verzeichnis aus:
|
||||
$ scripts/installation_check.pl
|
||||
Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
|
||||
der Installationsanweisung.
|
||||
Zumindest folgende Module sind neu benötigt:
|
||||
* Readonly (optional mit Begleitermodul Readonly::XS)
|
||||
* Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
|
||||
Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
|
||||
Distribution sollte für die automatische Installation der anderen
|
||||
zwei Pakete sorgen)
|
||||
| 9796c472 | Moritz Bunkus | Neue Gruppenrechte
|
||
------------------
|
||||
Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
|
||||
Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
|
||||
davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
|
||||
Für bereits bestehende Gruppen muss es sofern gewünscht vom
|
||||
Administrator manuell gewährt werden.
|
||||
| c65ce0ef | Moritz Bunkus | |||
| 8eb4af24 | Sven Schöling | Upgrade auf v2.6.1
|
||
==================
|
||||
Vor dem Einloggen
|
||||
-----------------
|
||||
Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
|
||||
Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
|
||||
(und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
|
||||
anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
|
||||
geändert.
|
||||
Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
|
||||
Lx-Office Verzeichnis aus:
|
||||
$ scripts/installation_check.pl
|
||||
Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
|
||||
der Installationsanweisung.
|
||||
Zumindest folgende Module sind neu benötigt:
|
||||
* URI
|
||||
* XML::Writer
|
||||
Neue Konfigurationsvariablen
|
||||
----------------------------
|
||||
In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
|
||||
Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
|
||||
standardmäßig deaktiviert.
|
||||
| 3001e127 | Moritz Bunkus | Upgrade auf v2.6.0
|
||
| 8c7e4493 | Moritz Bunkus | ==================
|
||
| 3001e127 | Moritz Bunkus | Mit Version 2.6.0 wurde der Code zur Benutzerauthentifizierung neu
|
||
| 8c7e4493 | Moritz Bunkus | geschrieben. Die Umstellung erfordert eine manuelle
|
||
| 4c24a5f4 | Sven Schöling | Konfiguration. Bestehende Benutzeraccounts können aber von Lx-Office
|
||
automatisch übernommen werden.
|
||||
| 8c7e4493 | Moritz Bunkus | |||
| 0e6ac5bb | Sven Schöling | Bevor Sie sich das erste mal einloggen
|
||
--------------------------------------
|
||||
| a13d2254 | Moritz Bunkus | Kopieren Sie bitte die Datei "lx-erp.conf" und
|
||
ggfs. "lx-erp-local.conf" in das neue Unterverzeichnis "config/". Die
|
||||
| 4c24a5f4 | Sven Schöling | alte Datei im Lx-Office-Stammverzeichnis kann daraufhin gelöscht
|
||
| a13d2254 | Moritz Bunkus | werdern.
|
||
| 0e6ac5bb | Sven Schöling | |||
| 4c24a5f4 | Sven Schöling | Als nächstes muss die neue datenbankgestützte Benutzerverwaltung
|
||
konfiguriert werden. Die dafür notwendigen Einstellungen werden in der
|
||||
Datei "config/authentification.pl" vorgenommen, für die eine
|
||||
| 8d3529cd | Moritz Bunkus | kommentierte Vorlage in "config/authentication.pl.default"
|
||
bereitliegt.
|
||||
| 0e6ac5bb | Sven Schöling | |||
Weitere Informationen zu dieser Datei finden Sie in der Dokumentation
|
||||
| 8d3529cd | Moritz Bunkus | "doc/INSTALL/index.html" und dort in den Kapiteln
|
||
| 8c7e4493 | Moritz Bunkus | "Benutzerauthentifizierung und Administratorpasswort" sowie "Benutzer-
|
||
und Gruppenverwaltung".
|
||||
Nach der Einrichtung der Datei "config/authentication.pl" muss im
|
||||
Webbrowser das Administrationsinterface aufgerufen werden. Nach
|
||||
erfolgter Anmeldung werden Sie durch den Upgradeprozess geleitet.
|
||||
Die weiteren erforderlichen Datenbankupgrades werden erst vorgenommen,
|
||||
wenn sich ein Benutzer erfolgreich anmeldet.
|
||||
| 65a609b5 | Moritz Bunkus | Neue Perl-Module
|
||
----------------
|
||||
| 4c24a5f4 | Sven Schöling | Mit Version 2.6.0 werden zusätzlich die folgenden Perl-Module benötigt,
|
||
| 65a609b5 | Moritz Bunkus | die bis Version 2.4.3 inklusive noch keine Voraussetzung waren:
|
||
* PDF::API2
|
||||
| 8c7e4493 | Moritz Bunkus | |||
| 44472690 | Moritz Bunkus | Upgrade von v2.4.0 und neuer auf v2.4.3
|
||
| a939b727 | Moritz Bunkus | =======================================
|
||
| f4ee2556 | Moritz Bunkus | |||
| 44472690 | Moritz Bunkus | Ein Upgrade von v2.4.0 oder neuer auf v2.4.3 aus zwei Teilen: den
|
||
| a939b727 | Moritz Bunkus | Dateien (einfaches Entpacken und Kopieren in das
|
||
| 4c24a5f4 | Sven Schöling | Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
|
||
| 31119ad2 | Moritz Bunkus | |||
Neue Variablen in der Datei lx-erp.conf
|
||||
---------------------------------------
|
||||
Wenn Sie eine eigene Version der Konfigurationsdatei "lx-erp.conf"
|
||||
einsetzen und diese nicht mit der Standardkonfigurationsdatei
|
||||
| 4c24a5f4 | Sven Schöling | überschreiben, so beachten Sie bitte, dass die folgenden neuen
|
||
Variablen hinzugekommen sind und von Ihnen manuell ergänzt werden
|
||||
| 31119ad2 | Moritz Bunkus | sollten: $html2ps_bin, $ghostscript_bin, $pg_dump_exe und
|
||
$pg_restore_exe. Die Variable '$jscalendar' kann hingegen entfernt
|
||||
| 4c24a5f4 | Sven Schöling | werden, da sie nicht mehr benötigt wird.
|
||
| 31119ad2 | Moritz Bunkus | |||
| 4c24a5f4 | Sven Schöling | Die Standardwerte für diese Variablen finden Sie in der Datei
|
||
| 31119ad2 | Moritz Bunkus | "lx-erp.conf.default".
|
||
| 4c24a5f4 | Sven Schöling | Neue Abhängigkeiten von Perl-Modulen
|
||
| 31119ad2 | Moritz Bunkus | ------------------------------------
|
||
| 4c24a5f4 | Sven Schöling | Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
|
||
| 31119ad2 | Moritz Bunkus | der Datei "doc/INSTALL". Seit Version 2.4.0 sind die folgenden Module
|
||
neu hinzugekommen:
|
||||
- Achive::Zip
|
||||
- Template
|
||||
- Text::CSV_XS
|
||||
- Text::Iconv
|
||||
- Time::HiRes
|
||||
- YAML
|
||||
| 4c24a5f4 | Sven Schöling | Nach Möglichkeit sollten auch die aktuellen Versionen der
|
||
| 31119ad2 | Moritz Bunkus | Datenbankpakete "DBI" und "DBD::Pg" installiert werden.
|
||
Datenbankupgrade
|
||||
----------------
|
||||
Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
|
||||
Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
|
||||
** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
|
||||
Upgrade von v2.4.0 auf 2.4.1 sowie von 2.4.1 auf 2.4.2
|
||||
======================================================
|
||||
Ein Upgrade von v2.4.0 auf v2.4.1 oder von v2.4.1 auf v2.4.2 besteht
|
||||
aus zwei Teilen: den Dateien (einfaches Entpacken und Kopieren in das
|
||||
| 4c24a5f4 | Sven Schöling | Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
|
||
| f4ee2556 | Moritz Bunkus | |||
| 4c24a5f4 | Sven Schöling | Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
|
||
| f6e5b55a | Moritz Bunkus | der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss
|
||
| 31119ad2 | Moritz Bunkus | sichergestellt werden, dass das Modul "YAML" installiert ist.
|
||
| 3a280667 | Moritz Bunkus | |||
| f4ee2556 | Moritz Bunkus | Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
|
||
Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
|
||||
** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
|
||||
Anders als beim Upgrade auf 2.4.0 handelt es bei den Datenbankupgrades
|
||||
| 31119ad2 | Moritz Bunkus | auf 2.4.1 und 2.4.2 nur um automatisch ablaufende Scripte, die keine
|
||
Benutzereingaben erfordern.
|
||||
| f4ee2556 | Moritz Bunkus | |||
| 590d623e | Moritz Bunkus | Upgrade von v2.2.0 bis 2.2.2 auf 2.4.0
|
||
| ccf2eedc | Moritz Bunkus | ======================================
|
||
| 590d623e | Moritz Bunkus | |||
Ein direktes Upgrade von den unmodifizierten Versionen 2.2.0, 2.2.1
|
||||
| 4c24a5f4 | Sven Schöling | und 2.2.2 auf 2.4.0 ist möglich. Ein solches Upgrade besteht aus zwei
|
||
| 590d623e | Moritz Bunkus | Teilen: den Dateien (einfaches Entpacken und Kopieren in das
|
||
| 4c24a5f4 | Sven Schöling | Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
|
||
| 590d623e | Moritz Bunkus | |||
| 4c24a5f4 | Sven Schöling | Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
|
||
| 3a280667 | Moritz Bunkus | der Datei "doc/INSTALL".
|
||
| 590d623e | Moritz Bunkus | Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
|
||
Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
|
||||
** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
|
||||
| 4c24a5f4 | Sven Schöling | Das Datenbankupgrade enthält zwei interaktive Upgradepfade für neue
|
||
| 590d623e | Moritz Bunkus | Features in Lx-Office 2.4.0: Einheiten sowie Buchungsgruppen.
|
||
| 4c24a5f4 | Sven Schöling | Einführung von Einheiten
|
||
| 590d623e | Moritz Bunkus | ------------------------
|
||
In Versionen von Lx-Office vor 2.4.0 konnte der Benutzer bei den
|
||||
Stammdaten aber auch in den Einkaufs- und Verkaufsdialogen beliebige
|
||||
| 4c24a5f4 | Sven Schöling | Texte als "Einheit" angeben. Lx-Office 2.4.0 ändert dies nun. Der
|
||
Administrator kann unter "System -> Einheiten -> Maßeinheiten" die bei
|
||||
| 590d623e | Moritz Bunkus | Waren und Erzeugnissen verwendbaren und bei "System -> Einheiten ->
|
||
Dienstleistungseinheiten" die bei Dienstleistungen verwendbaren
|
||||
| 4c24a5f4 | Sven Schöling | Einheiten festlegen. Lx-Office 2.4.0 bringt bereits für beide Typen
|
||
| 590d623e | Moritz Bunkus | einige Standardeinheiten mit.
|
||
| 4c24a5f4 | Sven Schöling | Einheiten können wiederum auf anderen Einheiten basieren. So ist
|
||
| 590d623e | Moritz Bunkus | z.B. "kg" als das 1000fache der Einheit "g" definiert. Der Benutzer
|
||
muss beim Anlegen von Artikeln in den Stammdaten eine Einheit aus
|
||||
| 4c24a5f4 | Sven Schöling | einer Drop-Down-Liste auswählen. In den Einkaufs- und Verkaufsmasken
|
||
| 590d623e | Moritz Bunkus | werden dann dem Benutzer nur noch diejenigen Einheiten zur Auswahl
|
||
angeboten, die sich in die in den Stammdaten hinterlegte Einheit
|
||||
| 4c24a5f4 | Sven Schöling | umrechnen lassen. So würden z.B. für eine Ware, deren
|
||
| 590d623e | Moritz Bunkus | Stammdateneinheit "kg" ist, nur die Einheiten "g", "kg", "t" zur
|
||
| 4c24a5f4 | Sven Schöling | Auswahl aufgelistet, nicht aber "Stück" oder "Tag", "Stunde".
|
||
| 590d623e | Moritz Bunkus | |||
Das Datenbankupgrade muss nun alle im System verwendeten Einheiten in
|
||||
den Stammdaten sowie in den Einkaufs- und Verkaufsdaten so anpassen,
|
||||
dass dort nur noch Einheiten auftreten, die im System verwendet werden
|
||||
| 4c24a5f4 | Sven Schöling | können. Da dies nur eingeschränkt automatisch möglich ist, werden dem
|
||
Benutzer, der das Datenbankupgrade nach dem Login durchführt, einige
|
||||
| 590d623e | Moritz Bunkus | Masken angezeigt, in denen er neue Einheiten in der Datenbank anlegen
|
||
kann, und in denen er "alte" Einheiten durch "neue" Einheiten ersetzen
|
||||
lassen kann.
|
||||
| 4c24a5f4 | Sven Schöling | Zuletzt muss er noch für all die Waren, für die früher gar keine
|
||
| 590d623e | Moritz Bunkus | Einheit eingetragen wurde, eine Standardeinheit getrennt nach Waren /
|
||
Erzeugnissen und Dienstleistungen festlegen, die statt dessen
|
||||
eingesetzt wird.
|
||||
| 4c24a5f4 | Sven Schöling | Einführung von Steuerzonen und Buchungsgruppen
|
||
| 590d623e | Moritz Bunkus | ----------------------------------------------
|
||
| fe7d7b5e | Moritz Bunkus | In den Versionen von Lx-Office vor 2.4.0 wurden bei Artikeln und
|
||
| 4c24a5f4 | Sven Schöling | Dienstleistungen jeweils ein Konto für Erlöse und ein Konto für den
|
||
Aufwand hinterlegt. Über diese Konten wurde dann auch definiert
|
||||
| fe7d7b5e | Moritz Bunkus | welcher Steuersatz zu berechnen ist. Wollte man einen Artikel mal mit
|
||
| 4c24a5f4 | Sven Schöling | und mal ohne Steuer verkaufen (Inland, Ausland), waren hierfür zwei
|
||
| fe7d7b5e | Moritz Bunkus | Artikel notwendig.
|
||
| 4c24a5f4 | Sven Schöling | In der Version 2.4.0 können nun bei jedem Artikel für die
|
||
verschiedenen Fälle
|
||||
| 7e7b0f89 | Philip Reetz | - Inland
|
||
- EU mit UStId
|
||||
- EU ohne UStId
|
||||
| 4c24a5f4 | Sven Schöling | - Außerhalb EU
|
||
verschiedene Erlös- und Aufwandskonten definiert werden. Dadurch
|
||||
werden dann auch jeweils die richtigen Steuersätze berechnet.
|
||||
| fe7d7b5e | Moritz Bunkus | |||
Damit jetzt nicht bei jedem Artikel mehrere Konten definiert werden
|
||||
| 4c24a5f4 | Sven Schöling | müssen, werden alle Konten, die zu einer bestimmten Warengruppe
|
||
gehören, in einer Buchungsgruppe zusammengefasst. Diese
|
||||
Buchungsgruppen werden zunächst unter "System" definiert und können
|
||||
| fe7d7b5e | Moritz Bunkus | dann den Artikeln und Dienstleistungen zugewiesen werden.
|
||
Beim Datenbankupdate werden aus der Datenbank alle Kombinationen von
|
||||
| 4c24a5f4 | Sven Schöling | Erlös- und Aufwandskonten geholt, die bereits verwendet wurden. Für
|
||
diese Kombinationen müssen im Upgradeprozess Buchungsgruppen angelegt
|
||||
| fe7d7b5e | Moritz Bunkus | werden, indem man den einzelnen Kombinationen einen Namen zuweist. Die
|
||
| 4c24a5f4 | Sven Schöling | Konten für nicht Inland sind mit den Standardkonten vorbelegt, können
|
||
aber vor dem Speichern geändert werden.
|
||||
| fe7d7b5e | Moritz Bunkus | |||
Diese neu angelegten Buchungsgruppen werden automatisch den
|
||||
vorhandenen Artikeln und Dienstleistungen zugewiesen. Buchungsgruppen
|
||||
| 4c24a5f4 | Sven Schöling | können genau wie vorher die Kontenzuordnung nachträglich nicht mehr
|
||
geändert werden.
|
||||
| fe7d7b5e | Moritz Bunkus | |||
| 4c24a5f4 | Sven Schöling | Möchte man in der Buchhaltung eine neue Kombination von Erlös- und
|
||
Aufwandskonten für bestimmte Artikel und Waren verwenden, legt man
|
||||
zunächst die entsprechenden konnten (z.B. 8401 und 3401) an und
|
||||
| fe7d7b5e | Moritz Bunkus | erstellt dann eine neue Buchungsgruppe mit diesen Konten. Die
|
||
Benennung der Buchungsgruppe kann frei erfolgen.
|
||||
Beim Anlegen einer neuen Waren oder Dienstleistung werden dann durch
|
||||
Auswahl dieser Buchungsgruppe automatisch alle Konten auf einen Schlag
|
||||
korrekt zugeordnet.
|
||||
Wird in einer Verkaufs- oder Einkaufsmaske eine andere Steuerzone als
|
||||
| 4c24a5f4 | Sven Schöling | Inland ausgewählt, werden bei den Artikeln auch automatisch die
|
||
anderen Erlös- und Aufwandskonten der Buchungsgruppe verwendet.
|
||||
| ccf2eedc | Moritz Bunkus | |||
| 73fb84d7 | Moritz Bunkus | Dokumentenvorlagen, Umbennante Vorlagenvariablen
|
||
------------------------------------------------
|
||||
| ccf2eedc | Moritz Bunkus | |||
Einige Variablen, die in Dokumentenvorlagen verwendet werden, mussten
|
||||
| 4c24a5f4 | Sven Schöling | aufgrund von Namenskonflikten umbenannt werden. Dazu gehören:
|
||
| ccf2eedc | Moritz Bunkus | |||
* Adress- und Kontaktinformationen des angemeldeten Mitarbeiters. Die
|
||||
| b2d25cea | Moritz Bunkus | Variablen "company", "address" und "businessnumber" haben alle einen
|
||
| 4c24a5f4 | Sven Schöling | Präfix "employee_" bekommen und heißen nun "employee_company",
|
||
| b2d25cea | Moritz Bunkus | "employee_address" und "employee_businessnumber".
|
||
| 73fb84d7 | Moritz Bunkus | |||
| 4c24a5f4 | Sven Schöling | Zu beachten ist außerdem, dass der Befehl <%include ...%> in
|
||
Dokumentenvorlagen nicht mehr zur Verfügung steht.
|