Command Line Client Binaries#

Für nicht-IT Anwender:
Falls Sie technisch noch versiert sind und sich fragen, was genau Sie hier benötigen, dann wollen Sie vermutlich das hier (Windows Client für Intel) verwenden. Danach lesen Sie die Bedienungsanleitung.
Sie benötigen diesen Client ausschließlich zum Hochladen von CSV-Dateien. Wenn Sie Daten über das Web Interface erfassen, benötigen Sie nichts von dieser Seite.

macOS: Nach einem Download über den Browser meldet macOS das Programm als „beschädigt" — das ist der Gatekeeper-Schutz für unsignierte Kommandozeilen-Programme, nicht ein defekter Download. Einmalig im Terminal freischalten:

xattr -d com.apple.quarantine ~/Downloads/livectl-darwin-*
chmod +x ~/Downloads/livectl-darwin-*

Das xattr entfernt die Quarantäne-Markierung des Browsers — sie ist der Grund für die Meldung. Das chmod macht die Datei ausführbar; allein reicht es nicht, weil der Gatekeeper vor dem Ausführungsrecht greift. Danach im Terminal testen: ~/Downloads/livectl-darwin-arm64 --help

Beim Download per curl (siehe unten) entfällt der Freischalt-Schritt komplett. livectl ist ein Kommandozeilen-Programm — es wird im Terminal gestartet, nicht per Doppelklick im Finder.

Weitere Binaries (ältere Versionen)#

Als registrierter Anwender bekommen Sie Zugang zu unserem git und können sich dort auch ältere Versionen der Binaries herunterladen.

Gehen Sie dazu entweder über die Web Seite, oder verwenden Sie auf der Kommandozeile

VERSION=prod     # prod (passend zur produktiven Umgebung), latest (Entwicklungsstand) oder eine feste Version, z. B. 1.5.1001
OS=linux         # darwin|windows|linux
ARCH=amd64       # arm64|amd64
BIN=livectl      # live|livectl
curl -OJ https://git.42i.org/api/packages/live/generic/$BIN/$VERSION/$BIN-$OS-$ARCH

Die zur produktiven Umgebung passende Version von livectl erhalten Sie somit per

curl -OJ $(echo https://git.42i.org/api/packages/live/generic/livectl/prod/livectl-$(uname -s)-$(uname -m) | tr '[:upper:]' '[:lower:]' | sed 's/x86_64/amd64/')

(Das sed bildet die uname-Architektur x86_64 auf den Artefaktnamen amd64 ab; auf ARM-Systemen passt arm64 direkt.)

Sie können den Text aus den Kommandozeilen-Beispielen kopieren, indem sie in das Feld klicken, bis ein blauer Rahmen erscheint. Dann einfach CTRL-C bzw. CMD-C

Kommandozeilenclient (CLI) auf Linux#

Wenn Sie das CLI auf Linux verwenden möchten, ist hier der schnelle bash-basierte Download für die jeweils aktuelle Version:

FILE=$(echo "livectl-$(uname -s)-$(uname -m)" | tr '[:upper:]' '[:lower:]' | sed 's/x86_64/amd64/')
curl -OJ https://git.42i.org/api/packages/live/generic/livectl/prod/$FILE
chmod 755 $FILE
mv $FILE /usr/bin/livectl

Server#

Achtung: Wenn Sie nicht wissen, was ein Server ist, brauchen sie den nicht.

Binaries#

Server Images#

docker pull oci.inkasso.live/live:prod

Versionen#

Die Versionierung von INKASSO.live ist SemVer-nah und folgt dem Format <Major>.<Minor>.<rev>. Die aktuelle Version ist 1.5.

• Major kennzeichnet eine nicht rückwärtskompatible Schema-Änderung (API und/oder Datenbank). Das ist ein echtes Upgrade auf neue Funktionen; ein Rücksprung nach dem Upgrade ist nicht möglich, da durch Änderungen am Datenbank-Schema Datenverlust auftreten kann.

• Minor bringt neue Features und bleibt rückwärtskompatibel: Daten einer älteren Minor-Version (z. B. 1.4) lassen sich mit einer neueren (z. B. 1.5) weiterverwenden.

• rev (die dritte Stelle) ist die interne, fortlaufende Revision: ein Zähler, der bei jeder Veröffentlichung um eins hochzählt (z. B. 1.5.1001).

Funktionen werden unabhängig von der Version über ihren Reifegrad (alpha → beta → release) sichtbar geschaltet: release sehen alle, alpha/beta nur mit entsprechendem Recht und aktiviertem Preview-Schalter. Es gibt keine getrennten lab- oder beta-Versionen des Clients mehr — Sie laden immer denselben Client; der Reifegrad einer Funktion wird serverseitig gesteuert.

Pinning#

Pinning beschreibt die Möglichkeit, eine bestimmte Version festzuhalten oder in einer definierten Major Version zu bleiben. Zum Beispiel können Sie die Version latest verwenden, um die jeweils neuste Version der Software zu verwenden. Aber das bedeutet auch, dass sie ggf. automatisch auf ein neues Major Release wechseln, ohne es vorher mal getestet zu haben, nur weil eine neue latest Version eingestellt wird. Das ist in Test-Systemen ggf. gewünscht, bei produktiven Systemen jedoch nicht.

Für diesen Fall pinnen Sie auf eine bestimmte, unveränderliche Version, z. B. 1.5.1001. Egal welche neuen Versionen kommen, Ihr System bleibt auf genau diesem Build, bis Sie es bewusst anheben.

Für automatische Updates verwenden Sie bitte die OCI-Images und z. B. Watchtower bei Compose oder ArgoCD bei Kubernetes.

Tags#

Hinweise#

Wichtig:
INKASSO.live befindet sich in aktiver Entwicklung. Der produktiv freigegebene Stand steht über den prod-Kanal bereit; latest trägt den jeweils neuesten Entwicklungsstand und ist für Testsysteme gedacht. Für produktive Nutzung pinnen Sie bitte zusätzlich eine konkrete Version (siehe Pinning).

Lizenzbedingungen#

Für die Nutzung der Software gelten die beschriebenen Lizenzbedingungen.