projekt kivitendo

Wichtige Hinweise zum Upgrade von älteren Versionen

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

Upgrade auf v3.5.6

In dieser Version sind die Mehrwertsteueranpassungen für den SKR03 und SKR04

ab 1.7.2020 vorhanden. Wer diese Anpassungen schon manuell eingestellt hat, sollte

die Upgrade-Skripte deaktivieren.

Dies betrifft diese drei Skripte "sql/Pg-upgrade2/konjunkturpaket_2020*"

Folgender sed-Einzeiler erledigt das:

sed -i 's/ignore: 0/ignore: 1/g' sql/Pg-upgrade2/konjunkturpaket_2020*

und der kivitendo-Dienstleister Ihres Vertrauens griffbereit sein.

Weitere Änderungen:

Für den MT940-Import erwartet kivitendo aqbanking ab Version 6.

Für die Erzeugung von ZUGFeRD 2.0 fähigen PDFs wird ein aktuelles TexLive ab Version 2018 benötigt.

Details hierzu auch in der Dokumentation (HTML oder Dokumentation.pdf).

Diese Version ist ferner mit Postgres Datenbanken ab Version 12 kompatibel, da die Abhängigkeit von oids entfernt wurde.

Für git-Installation sollte geprüft werden ob das Verzeichnis .git/ für den Webserver auslesbar ist.

Gleiches gilt für alle Installation für den Ordner config/, der die Datei kivitendo.conf beinhaltet.

dies einmal zu überprüfen.

Ab dieser Version wird eine globale .htaccess ausgeliefert die beide Verzeichnisse mittels rewrite sichert.

Dafür muss einmalig das Modul rewrite für den Apache, bspw. mit "a2enmode rewrite" aktiviert werden.

Regeldetails:

<IfModule mod_rewrite.c>

RewriteEngine On

RewriteRule .*(\.git|config).*$ - [F,NC]

</IfModule>

* Task-Server berücksichtigt Memory-Limit

Falls für fgci-Prozesse ein Memory-Limit in der Konfigurationsdatei eingerichtet

ist, wird dies nun auch vom Task-Server berücksichtigt. Dieser beendet sich bei

Überschreitung des Limits. Deshalb muss dafür gesorgt werden, dass der

Task-Server in diesem Fall neu gestartet wird (z.B. über den systemd-Service).

Siehe auch aktuelle kivitendo-Dokumentation.

* Fallback-Module entfernt

Einige Default-Module die als Fallback zu Verfügung standen, werden ab

dieser Version nicht mehr mit ausgeliefert.

* Neue Perlabhängigkeiten

* LWP::UserAgent für WebshopApi

Diese verwendet das Shopmodul, wenn installiert, beim Bestellimport

um zu entscheiden ob ein Kunde neu angelegt oder als Vorschlag angezeigt wird.

Die Erweiterung wird bisher nur beim Ableich der Straße genutzt, da hier oft

unterschiedliche Schreibweisen vorhanden sind.

z.B Dorfstraße, Dorfstrasse, Dorfstr., Dorf Straße usw..

So wird vermieden, dass Kunden eventuell doppelt angelegt werden.

Erweiterung für die eigene Distribution nachinstalliert werden.

Bei debian/ubuntu befindet sich diese im Paket postgresql-contrib

und kann mit

Dazu braucht der DatenbankSuperbenutzer "postgres" ein Passwort

psql

\password

<Eingabe passwort>

\q

bei Updatescripten, die SuperUserRechte benötigen eingegeben werden.

Im KNE-Export war im Belegfeld2 die Fälligkeit der Buchung gesetzt und in

Buchungsbeschreibung der Kunden- oder Lieferantenname.

unternimmt kivitendo keine eigene Normalisierung, bzw. Konvertierung

des Datenfelds.

Hier exemplarisch ein SQL-Schnipsel zum Ersetzen der Leerzeichen in diesem Feld:

UPDATE customer SET ustid=REPLACE(ustid, ' ', '') WHERE ustid LIKE '% %';

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

* Sys::CPU

* Thread::Pool::Simple

* pdfinfo

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

CSV-Datei ebenfalls umbenannt werden.

aus letter.custoemr_vendor erzeugt werden.

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

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

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

Spalte part_type

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

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.

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

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.

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.

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.

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

natürlich weiterhin.

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.

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

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

für das Upgrade auf Mandantenfähigkeit vorausgesetzt.

mit älteren Versionen ist nicht mehr möglich.

* File::Copy::Recursive

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

$ scripts/installation_check.pl -ro

unterstützt.

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)

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.

benutzerangepasste Versionen der Druckvorlagen im Druckvorlagenverzeichnis

mehr unterstützt.

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

* 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

* Test::Deep

* GD 2.00

"Mandantenkonfiguration" aktiviert werden.

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.

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

benennen Sie ihn um bevor Sie das Update starten.

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.

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.

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

automatisch allen Benutzern erteilt.

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

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

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.

angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.

man lx_office.conf nicht einchecken.

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

handelt es sich um einen Dämonen, der im Hintergrund läuft, in

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:

der Installationsanweisung.

* 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

hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für

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

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

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

Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im

Lx-Office Verzeichnis aus:

der Installationsanweisung.

Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer

Distribution sollte für die automatische Installation der anderen

zwei Pakete sorgen)

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

Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig

davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.

Administrator manuell gewährt werden.

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

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

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.

Lx-Office Verzeichnis aus:

der Installationsanweisung.

* XML::Writer

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

Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist