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 (Archiv und Labor)#

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

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

VERSION=lab      # lab|beta|1|1.0|1.0.0|latest
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 letzte beta Version von livectl erhalten Sie somit per

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

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 (als Beispiel) die Beta Version:

FILE=$(echo "livectl-$(uname -s)-$(uname -m)" | tr '[:upper:]' '[:lower:]')
curl -OJ https://git.42i.org/api/packages/live/generic/livectl/beta/$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 https://oci.inkasso.live/live:latest

Versionen#

Die Versionierung von INKASSO.live folgt Semver 2 und ist im Format <Major>.<Minor>.<Patch>:

• Major Releases sind größere Versionssprünge mit Änderungen an API und DB Schema.
  Ein echte “Upgrade” auf neue Funktionen und Features. Ein Rücksprung nach dem Upgrade ist nicht möglich, da Datenverlust auftreten kann (Änderungen am Datenbank-Schema).

• Minor Releases beinhalten neue Funktionen, aber sind rückwärts-kompatibel. Sie können also von einer Version 3.2 auf eine Version 3.1 zurückgehen.

• Patches sind Sammlungen von Fehlerbehebungen.

Zudem gibt es ggf.

• beta Versionen. Diese haben keine Nummerierung, da ein Pinning irrelevant ist und auch ein Rückschritt nicht notwendig ist. Beta Versionen sind nicht für den produktiven Einsatz geeignet.

• lab Versionen sind instabile Versionen direkt aus der Entwicklung und beinhalten ggf. Forschungen und Prototypen und nicht für die Benutzung außerhalb der Entwicklung gedacht.

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 können sie pinnen:

• Version 1 zeigt immer auf die neuste 1. Wenn also die 1.3 freigegeben wird, geht ihr System ggf. automatisch auf die 1.3.
• Version 1.2 zeigt immer auf die neuste 1.2. Falls es also mal einen neuen Patch für die 1.2 gibt, wird dieser ggf. automatisch eingespielt. Aber Ihr Server wird sich nicht automatisch auf die 1.3 updaten.
• Version 1.2.1203 zeigt auf eine bestimmte 1.2. Egal was für neue Patches kommen, Ihr System ist auf den Patch 1203 gepinnt und wird nicht automatisch wechseln.

![INFO] Für automatische Updates verwenden Sie bitte die OCI Images und nehmen Sie dann z.B. Watchtower bei Compose, oder ArgoCD bei Kubernetes oder Ähnliches.

Tags#

Hinweise#

Wichtig:
Aktuell ist noch keine Version offiziell freigegeben. Bis zur Freigabe wird es daher keine Version prod geben. Wenn Sie am BETA Programm Teilnehmen, können Sie zum Testen gerne die beta Version verwenden. Diese ist natürlich instabil und sollte nicht produktiv eingesetzt werden.

Lizenzbedingungen#

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