kivitendo/doc/UPGRADE @ 6d169764
590d623e | Moritz Bunkus | Wichtige Hinweise zum Upgrade von ?lteren Versionen
|
||
===================================================
|
||||
** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
|
||||
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
|
||
Konfiguration. Bestehende Benutzeraccounts k?nnen aber von Lx-Office
|
||||
automatisch ?bernommen werden.
|
||||
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
|
||||
alte Datei im Lx-Office-Stammverzeichnis kann daraufhin gel?scht
|
||||
werdern.
|
||||
0e6ac5bb | Sven Schöling | |||
8d3529cd | Moritz Bunkus | 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
|
||||
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
|
||
----------------
|
||||
Mit Version 2.6.0 werden zus?tzlich die folgenden Perl-Module ben?tigt,
|
||||
die bis Version 2.4.3 inklusive noch keine Voraussetzung waren:
|
||||
* Digest::MD5
|
||||
* 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
|
||
31119ad2 | Moritz Bunkus | Installationsverzeichnis gen?gen) sowie dem Datenbankupgrade.
|
||
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
|
||||
?berschreiben, so beachten Sie bitte, dass die folgenden neuen
|
||||
Variablen hinzugekommen sind und von Ihnen manuell erg?nzt werden
|
||||
sollten: $html2ps_bin, $ghostscript_bin, $pg_dump_exe und
|
||||
$pg_restore_exe. Die Variable '$jscalendar' kann hingegen entfernt
|
||||
werden, da sie nicht mehr ben?tigt wird.
|
||||
Die Standardwerte f?r diese Variablen finden Sie in der Datei
|
||||
"lx-erp.conf.default".
|
||||
Neue Abh?ngigkeiten von Perl-Modulen
|
||||
------------------------------------
|
||||
Bitte beachten Sie auch die Liste der ben?tigten Perl-Module am Anfang
|
||||
der Datei "doc/INSTALL". Seit Version 2.4.0 sind die folgenden Module
|
||||
neu hinzugekommen:
|
||||
- Achive::Zip
|
||||
- IO::Wrap (aus dem Paket "IO::Stringy")
|
||||
- Template
|
||||
- Text::CSV_XS
|
||||
- Text::Iconv
|
||||
- Time::HiRes
|
||||
- YAML
|
||||
Nach M?glichkeit sollten auch die aktuellen Versionen der
|
||||
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
|
||||
a1880fd9 | Moritz Bunkus | Installationsverzeichnis gen?gen) sowie dem Datenbankupgrade.
|
||
f4ee2556 | Moritz Bunkus | |||
3a280667 | Moritz Bunkus | 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
|
||||
f4ee2556 | Moritz Bunkus | 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
|
||
Installationsverzeichnis gen?gen) sowie dem Datenbankupgrade.
|
||||
3a280667 | Moritz Bunkus | Bitte beachten Sie auch die Liste der ben?tigten Perl-Module am Anfang
|
||
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! **
|
||||
Das Datenbankupgrade enth?lt zwei interaktive Upgradepfade f?r neue
|
||||
Features in Lx-Office 2.4.0: Einheiten sowie Buchungsgruppen.
|
||||
Einf?hrung von Einheiten
|
||||
------------------------
|
||||
In Versionen von Lx-Office vor 2.4.0 konnte der Benutzer bei den
|
||||
Stammdaten aber auch in den Einkaufs- und Verkaufsdialogen beliebige
|
||||
Texte als "Einheit" angeben. Lx-Office 2.4.0 ?ndert dies nun. Der
|
||||
Administrator kann unter "System -> Einheiten -> Ma?einheiten" die bei
|
||||
Waren und Erzeugnissen verwendbaren und bei "System -> Einheiten ->
|
||||
Dienstleistungseinheiten" die bei Dienstleistungen verwendbaren
|
||||
Einheiten festlegen. Lx-Office 2.4.0 bringt bereits f?r beide Typen
|
||||
einige Standardeinheiten mit.
|
||||
Einheiten k?nnen wiederum auf anderen Einheiten basieren. So ist
|
||||
z.B. "kg" als das 1000fache der Einheit "g" definiert. Der Benutzer
|
||||
muss beim Anlegen von Artikeln in den Stammdaten eine Einheit aus
|
||||
einer Drop-Down-Liste ausw?hlen. In den Einkaufs- und Verkaufsmasken
|
||||
werden dann dem Benutzer nur noch diejenigen Einheiten zur Auswahl
|
||||
angeboten, die sich in die in den Stammdaten hinterlegte Einheit
|
||||
umrechnen lassen. So w?rden z.B. f?r eine Ware, deren
|
||||
Stammdateneinheit "kg" ist, nur die Einheiten "g", "kg", "t" zur
|
||||
Auswahl aufgelistet, nicht aber "St?ck" oder "Tag", "Stunde".
|
||||
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
|
||||
k?nnen. Da dies nur eingeschr?nkt automatisch m?glich ist, werden dem
|
||||
Benutzer, der das Datenbankupgrade nach dem Login durchf?hrt, einige
|
||||
Masken angezeigt, in denen er neue Einheiten in der Datenbank anlegen
|
||||
kann, und in denen er "alte" Einheiten durch "neue" Einheiten ersetzen
|
||||
lassen kann.
|
||||
Zuletzt muss er noch f?r all die Waren, f?r die fr?her gar keine
|
||||
Einheit eingetragen wurde, eine Standardeinheit getrennt nach Waren /
|
||||
Erzeugnissen und Dienstleistungen festlegen, die statt dessen
|
||||
eingesetzt wird.
|
||||
Einf?hrung von Steuerzonen und Buchungsgruppen
|
||||
----------------------------------------------
|
||||
fe7d7b5e | Moritz Bunkus | In den Versionen von Lx-Office vor 2.4.0 wurden bei Artikeln und
|
||
Dienstleistungen jeweils ein Konto f?r Erl?se und ein Konto f?r den
|
||||
Aufwand hinterlegt. ?ber diese Konten wurde dann auch definiert
|
||||
welcher Steuersatz zu berechnen ist. Wollte man einen Artikel mal mit
|
||||
und mal ohne Steuer verkaufen (Inland, Ausland), waren hierf?r zwei
|
||||
Artikel notwendig.
|
||||
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
|
||||
- Au?erhalb EU
|
||||
fe7d7b5e | Moritz Bunkus | verschiedene Erl?s- und Aufwandskonten definiert werden. Dadurch
|
||
werden dann auch jeweils die richtigen Steuers?tze berechnet.
|
||||
Damit jetzt nicht bei jedem Artikel mehrere Konten definiert werden
|
||||
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
|
||||
dann den Artikeln und Dienstleistungen zugewiesen werden.
|
||||
Beim Datenbankupdate werden aus der Datenbank alle Kombinationen von
|
||||
Erl?s- und Aufwandskonten geholt, die bereits verwendet wurden. F?r
|
||||
diese Kombinationen m?ssen im Upgradeprozess Buchungsgruppen angelegt
|
||||
werden, indem man den einzelnen Kombinationen einen Namen zuweist. Die
|
||||
Konten f?r nicht Inland sind mit den Standardkonten vorbelegt, k?nnen
|
||||
aber vor dem Speichern ge?ndert werden.
|
||||
Diese neu angelegten Buchungsgruppen werden automatisch den
|
||||
vorhandenen Artikeln und Dienstleistungen zugewiesen. Buchungsgruppen
|
||||
k?nnen genau wie vorher die Kontenzuordnung nachtr?glich nicht mehr
|
||||
7e7b0f89 | Philip Reetz | ge?ndert werden.
|
||
fe7d7b5e | Moritz Bunkus | |||
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
|
||||
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
|
||||
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
|
||||
aufgrund von Namenskonflikten umbenannt werden. Dazu geh?ren:
|
||||
* Adress- und Kontaktinformationen des angemeldeten Mitarbeiters. Die
|
||||
b2d25cea | Moritz Bunkus | Variablen "company", "address" und "businessnumber" haben alle einen
|
||
Pr?fix "employee_" bekommen und hei?en nun "employee_company",
|
||||
"employee_address" und "employee_businessnumber".
|
||||
73fb84d7 | Moritz Bunkus | |||
Zu beachten ist au?erdem, dass der Befehl <%include ...%> in
|
||||
Dokumentenvorlagen nicht mehr zur Verf?gung steht.
|