projekt kivitendo

Wichtige Hinweise zum Upgrade von älteren Versionen

** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **

* Zum Mail-Versenden werden zwei neue perl Pakete MIME::Entity und MIME::Parser

benötigt. Damit können beliebige Anhänge,

auch andere Emails(.eml) versendet werden.

* Die Tabelle "files" ist hinzugekommen. Diese wird von der Dateiverwaltung

benötigt.

eingebaut werden, z.B. falls zweiseitg ausgedruckt wird. Statt die Anzahl

Seiten per Ghostscript zu ermitteln wird dazu "pdfinfo" genutzt.

Das muß installiert sein. Der Script "installation_check.pl" prüft dies.

multipliziert, um Lücken für neue Rechte zu schaffen.

migriert. Bei Kunden ohne Preisgruppe ist der Datenbankwert jetzt NULL statt

"0". Falls Kunden per CSV-Import importiert werden muß dieses Feld in der

CSV-Datei ebenfalls umbenannt werden.

das auf dem Zielsystem absolut nicht möglich ist, muss das Upgradescript

sql/Pg-Upgrade2/trigram_indices.sql deaktiviert oder entfernt werden.

(letter.tex) angepasst worden. Statt letter.customer muss der Adressat jetzt

aus letter.custoemr_vendor erzeugt werden.

Erkennung von Waren/Dienstleistungen/Erzeugnissen gibt es nun in parts eine

neue Spalte part_type vom ENUM-Typ, der auf die Werte 'part', 'service',

'assembly' und 'assortment' beschränkt ist.

und income_accno_id entfernt. Deren Funktionalität wurde schon lange durch

Buchungsgruppen ersetzt und für die Erkennung des Artikeltyps gibt es nun die

Spalte part_type

==================

* Neue Druckvariante Gelangensbestätigung für Verkaufs-Aufträge

Im Standard-Vorlagensatz RB befindet sich als Vorlage die ic_supply.tex

als Orientierung für die Anpassung an eigene Vorlagen. Eigene Vorlagen

müssen entsprechend um diesen Typ für die 3.4.1 erweitert werden.

Die Erzeugung der Druckausgabe für die Brieffunktion wurde auf die

Verwendung des Template Toolkits umgestellt. Dazu muss die verwendete

Druckvorlage "letter.tex" angepasst werden. Im Standard-Vorlagensatz RB ist

das bereits geschehen. Falls keine manuellen Änderungen an der "letter.tex"

aus einer vorherigen Version gemacht wurden, reicht es, diese Datei

("templates/print/RB/letter.tex") in das verwendete Vorlagenverzeichnis zu

kopieren. Ansonsten kann diese Datei als Beispiel dienen.

Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:

$ scripts/installation_check.pl -ro

(2.6.1 Grundkonfiguration mittels CGI) wurde geändert. Ein einfacher Alias

auf das Programmverzeichnis funktioniert nicht mehr, und es muss immer ein

AliasMatch auf einen dispatcher eingerichtet werden. Die Dokumentation wurde

aktualisiert. Für Benutzer der empfohlenen FastCGI Anbindung ändert sich

nichts.

der Task-Server laufen soll, muss in der Administrationsoberfläche

in der Konfiguration des Mandanten hinterlegt werden, welchen

kivitendo-Benutzer der Task-Server nutzen soll. Ist bei einem

Mandanten kein Benutzer hinterlegt, so ignoriert der Task-Server

diesen Mandanten.

Im Gegenzug wurden die beiden Konfigurations-Einstellungen »client«

und »login« aus dem Abschnitt [task_server] entfernt. Der

Task-Server prüft beim Starten allerdings, ob diese Einstellungen

noch existieren und verweigert den Start mit einer hilfreichen

Fehlermeldung, solange sie noch vorhanden sind.

entfernt. Für BenutzerInnen, die noch alte Mechanismen verwenden,

müssen die Passwörter einmalig in der Administrationsoberfläche

zurückgesetzt werden.

Dies betrifft nur Accounts, deren Passwort sich das letzte Mal vor

kivitendo 2.7.0 geändert hat.

==================

* Bei Upgrade von Versionen vor v.3.2.x wie immer erst die dortigen

Upgradehinweise beachten.

* Es gibt keine neuen Perl-Modul-Abhängigkeiten.

* Die alte ungepflegte Druckvorlagenvariante "Standard" wurde entfernt.

Bereits verwendete Druckvorlagen, die darauf aufbauen, funktionieren

natürlich weiterhin.

* Für die Verwendung des MT940 Import Features der Bankerweiterung muß

aqbanking installiert werden. Dies wird nur für die Konvertierung vom MT940

ins CSV Format benötigt, das Kommandozeilentool "aqbanking-cli" befindet sich

z.B. unter Ubuntu im Paket aqbanking-tools.

* GD

* HTML::Restrict

* Image::Info

Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:

$ scripts/installation_check.pl -ro

Upgradehinweise der Vorversionen beachten.

Hier hat sich das Standardverhalten geändert und ggf. werden shipto* nicht mehr

ausgedruckt, hier müssten die Druckvorlagen individuell angepasst werden, s.a.

Changelog -> Verkaufsbeleg-Ausdruck.

* BEVOR ein Aufruf im Administrationsbereich erfolgt, muss zwingend der

webdav Ordner im Installationspfad vorhanden sein!

- mkdir webdav/

- Rechte für webserver setzen ($ chmod www-data webdav/)

Dieses "Feature" war in vorhergehenden Versionen optional, wird aber

für das Upgrade auf Mandantenfähigkeit vorausgesetzt.

PostgreSQL 8.4 oder neuer werden zwingend vorausgesetzt. Ein Betrieb

mit älteren Versionen ist nicht mehr möglich.

* Neue Perl-Modul-Abhängigkeiten:

* File::Copy::Recursive

in besagtem Modul im Zusammenspiel mit PostgreSQL)

Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:

$ scripts/installation_check.pl -ro

auch die Konfigurationsvariable "system.dbcharset" nicht mehr

unterstützt.

Datenbanken für jeden Benutzer getrennt vorzunehmen. Mit diesem

Release wurden Mandanten eingeführt: ein Mandant bekommt einen Namen

sowie die Datenbankkonfiguration, und Benutzer bekommen

Zugriffsrechte auf einen oder mehrere Mandanten.

Um dieses Update durchzuführen, müssen Sie sich einmal im

Administrationsbereich anmelden. Vorher ist kein Login im

Benutzerbereich möglich.

Die neue Struktur bedingt, dass viele Scripte, die bisher zur

Konfiguration nur einen Benutzer verlangt haben, jetzt auch einen

Mandanten verlangen. Die Konfiguration dieser Scripte ist deshalb

manuell anzupassen. Dazu gehören:

- der Task-Server (config/kivitendo.conf)

- CSV-Import von der Shell aus (scripts/csv-import-from-shell.sh)

Die folgenden Scripte sind ebenfalls betroffen, allerdings nur für

Entwickler interessant:

- scripts/dbupgrade2_tool.pl

- scripts/rose_auto_create_model.pl

der Gruppe Vollzugriff

- Stammdaten -> Kunden und Lieferanten erfassen. Alle Lieferanten bearbeiten.

Alle Kunden bearbeiten

- Konfiguration -> Verändern der kivitendo-Installationseinstellungen (die

meisten Menüpunkte unterhalb von 'System')

wurden entfernt.

jetzt alle zentral in den Webvorlagen verwaltet, es werden keine

benutzerangepasste Versionen der Druckvorlagen im Druckvorlagenverzeichnis

mehr unterstützt.

* Neue Abhängigkeiten

* Clone 1.16

* Email::MIME

* FCGI jetzt min Version 0.72

* Test::Harness 3.00

* IO::Socket::SSL

* Net::LDAP

* Net::SSLGlue

Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:

$ scripts/installation_check.pl -ro

* Neue Entwicklerabhängigkeiten

* Test::Deep

* GD 2.00

* Diverse umstrittene Features zum nicht standardkonformen Umgang mit gebuchten

"Mandantenkonfiguration" aktiviert werden.

* Die Übersetzungen "de_DE" und "fr" für die alternative deutsche Version und

französische Version respektive wurden entfernt. Es bleiben offiziell

unterstützen wird. Ab dem nächsten Release werden Sprachkonstrukte

verwendet werden, die nicht mehr in 5.8 kompilieren, und Module, die

==================

Kompatibilitätsmenü gesetzt. Das Javascriptmenü wurde entsprechend erweitert

um der Funktionalität nahe zu kommen.

"sumcarriedforward" und "lastpage" als deprecated und werden in einer

kommenden Version komplett entfernt. Die Mechanik ist anfällig gegenüber

subtilen Formatierungsfehlern bei bestimmten Zahlenformaten und ist

grundsätzlich fehlerhaft in den gemachten Annahmen über den verfügbaren Platz

auf einer Seite. Die Standardvorlagen sind entsprechend angepasst worden

Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,

benennen Sie ihn um bevor Sie das Update starten.

USTVA als PDF ist deprecated. Da die Eingabe von Erklärungen als PDF nicht

mehr gestattet ist, sollten Archivkopien der USTVA direkt bei Elster bezogen

werden, oder auf anderem Wege erstellt werden. Der Prozess dazu wird sich in

einer kommenden Version ändern.

eingestellten Dokumentensprache, nicht mehr in der Oberflächensprache des

Bearbeiters.

* String::ShellQuote

lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,

funktionieren nicht mehr. Stattdessen kann scripts/csv-import-from-shell.sh

benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen

nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.

* Rechteverwaltung

* Das Recht "Kunden und Lieferanten bearbeiten" wurde aufgespalten in zwei

einzelne Rechte. Ein Updatescript passt bestehende Gruppenaentsprechend an.

* Das Recht "Preise nd Rabatte bearbeiten" wurde neu eingeführt und ist

notwendig um in Belegen Preise ändern zu können. Es wird beim Upgrade

automatisch allen Benutzern erteilt.

* Das Recht "Administration" wurde neu eingeführt, und ist dazu da

administrative Tätigkeiten an der Mandantendatenbank aus einm Benutzerlogin

heraus durchzuführen. Es ist standardmäßig NICHT vergeben.

vorher Konfiguration.

==================

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.

"Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf

regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese

zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser

Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen

benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen

bekommen. Die Einrichtung des Dämonen wird in der

Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.

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:

* Config::Std

* Params::Validate

"mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die

Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,

seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich

dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert

FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf

==================

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:

* 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)

------------------

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.

==================

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.