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.

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=latest   # latest 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 jeweils aktuelle Version von livectl erhalten Sie somit per

curl -OJ $(echo https://git.42i.org/api/packages/live/generic/livectl/latest/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/latest/$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:latest

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. Die jeweils aktuelle Version steht über den latest-Kanal bereit; für produktive Nutzung pinnen Sie bitte eine konkrete Version (siehe Pinning).

Lizenzbedingungen#

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