Lizenz

Der Lizenzschlüssel#

Deinen Lizenzschlüssel erhältst du per E-Mail. Er sieht so aus:

LIC-XXXX-XXXX-XXXX-XXXX

Er besteht aus vier Gruppen zu je vier Zeichen: Ziffern und Grossbuchstaben. Die Buchstaben I, L, O und U kommen nie vor, damit nichts verwechselt wird. Ein Zeichen, das wie ein O aussieht, ist also immer die Ziffer Null.

• In der Eingabe während der Installation darfst du Kleinbuchstaben verwenden, sie werden umgewandelt.
• Mit --license musst du den Schlüssel in Grossbuchstaben angeben. Kleinbuchstaben werden dort abgelehnt.

Bewahre den Schlüssel sicher auf. Du brauchst ihn bei der ersten Installation und wenn du auf einen neuen Server umziehst. Die Installation, license info, license check und license renew zeigen nur die letzten vier Zeichen an. Den ganzen Schlüssel sieht im Kundenportal unter «Lizenzen», wer dort Lizenzen verwalten darf.

Aktivierung#

Bei der Installation wird die Lizenz aktiviert:

• Mit --license wird der angegebene Schlüssel verwendet.
• Ist der Server bereits aktiviert, verwendet eine erneute Installation den gespeicherten Schlüssel und fragt nicht nach.
• Sonst fragt die Installation nach dem Schlüssel.

Bei jeder Installation wird die Lizenz beim Lizenzserver aktiviert. Bei Netzproblemen versucht aictl es dreimal. Ist der Lizenzserver danach immer noch nicht erreichbar, hängt es vom Server ab:

• Bereits aktiviert: Eine erneute Installation mit demselben Schlüssel läuft mit der bestehenden Aktivierung weiter, solange diese gilt, auch innerhalb der Offline-Kulanz. Sie warnt und nennt den Stand der Lizenz. So klappt eine Reparatur auch während eines Ausfalls des Lizenzservers.
• Noch nicht aktiviert oder neuer Schlüssel: Die Installation bricht ab. Eine erste Aktivierung braucht immer den Lizenzserver.

Antwortet der Lizenzserver und lehnt die Lizenz ab, etwa weil sie gesperrt ist, bricht die Installation in jedem Fall ab.

Die Aktivierung bindet die Lizenz an diesen Server. Dafür wird eine Kennung verwendet, die das Betriebssystem für den Server vergibt.

Wichtig: Die Systemuhr des Servers muss stimmen. Weicht sie zu stark ab, lehnt die Installation die Lizenz mit einem Hinweis auf die Zeitsynchronisierung ab. Schalte sie ein und starte die Installation erneut:

sudo timedatectl set-ntp true

Was in der Lizenz enthalten ist#

Die Lizenz legt fest:

• deinen Plan,
• welche Erweiterungen freigeschaltet sind,
• bis wann sie gültig ist,
• bis wann neue Versionen inklusive sind,
• wie viele Benutzer dein Plan vorsieht. Die Anzahl wird gemeldet, aber nicht durchgesetzt: Wächst dein Team darüber hinaus, sperren wir niemanden aus, sondern melden uns für ein Upgrade,
• ob die Schnittstelle der KI-Zentrale für externe Programme enthalten ist. Ohne sie ist die Verwaltungsoberfläche der KI-Zentrale erreichbar, ihre Schnittstelle beantwortet Anfragen von aussen aber mit einem Fehler. Chat, Automationen und Erweiterungen sind davon nicht betroffen,
• wie viele Installationen dein Plan gleichzeitig erlaubt. Jede Installation braucht einen eigenen Lizenzschlüssel, denn ein Schlüssel gilt immer nur für einen Server.

Die aktuellen Angaben zeigt dir:

aictl license info

Der Befehl braucht keine Internetverbindung und zeigt den Stand der letzten Bestätigung: die letzten vier Zeichen des Schlüssels, Zustand, Plan, Erweiterungen, Gültigkeit, Update-Zeitraum, Benutzer, Schnittstelle, Serverkennung, wie lange die letzte Bestätigung gilt und wann der Server zuletzt Kontakt hatte. Die Werte können deshalb veraltet sein.

Die Bestätigung im Hintergrund#

Der Hintergrunddienst bestätigt die Lizenz beim Start und danach alle 12 Stunden beim Lizenzserver. Erreicht er ihn nicht, versucht er es alle 5 Minuten erneut, bis es klappt. Dabei erhält er eine frisch signierte Bestätigung, die etwa einen Tag gilt. Es werden nur Lizenzinformationen übertragen, niemals deine Daten. Was genau übermittelt wird, steht unter Sicherheit und Datenschutz.

Hat die gespeicherte Bestätigung während einer Offline-Zeit ihre Gültigkeit verloren und lehnt der Lizenzserver sie ab, aktiviert der Hintergrunddienst die Lizenz mit dem gespeicherten Schlüssel automatisch neu.

Was passiert ohne Verbindung?#

swaiz ist so gebaut, dass eine unterbrochene Internetverbindung dein Team nicht aufhält. Die Lizenz wird auf dem Server selbst geprüft, und es gibt grosszügige Fristen. Sie zählen ab dem letzten erfolgreichen Kontakt mit dem Lizenzserver:

Sobald die Verbindung wieder steht, holt der Hintergrunddienst eine neue Lizenz, spätestens nach 5 Minuten. Sofort geht es mit sudo aictl license renew, siehe unten.

Ende der Laufzeit#

Erreicht die Lizenz ihr Enddatum, gilt dieselbe Abfolge unabhängig von der Verbindung: zuerst 14 Tage eingeschränkt, danach gestoppt. So hast du genug Zeit, um zu verlängern. Ein Enddatum ohne Uhrzeit gilt ab dem Beginn dieses Tages.

Widerruf oder Sperre#

Sperrt oder widerruft der Lizenzserver eine Lizenz, wird die Plattform bei der nächsten Bestätigung sofort gestoppt, ohne Fristen.

Was «eingeschränkt» bedeutet#

Die laufende Plattform arbeitet unverändert weiter. Blockiert sind nur Befehle, die etwas Neues einrichten:

Die Meldung lautet dann license expired (…): expansion is blocked until the license is renewed — the running stack is unaffected …. Im Zustand «gestoppt» heisst es stattdessen the stack stays stopped.

Wichtig: Auch ein neues Firmenzertifikat und geänderte Zugangsdaten werden erst mit apply wirksam. Solange die Lizenz eingeschränkt ist, kannst du sie deshalb nicht übernehmen.

Dieselbe Einschränkung gilt, wenn die Lizenz ungültig ist, etwa weil sie zu einem anderen Server gehört. Eine ungültige Lizenz hält die Plattform aber nie an.

Was «gestoppt» bedeutet#

Der Hintergrunddienst hält die Plattform samt Erweiterungen innerhalb von 30 Sekunden an und lässt sie angehalten. Startest du sie mit start, hält er sie bei seiner nächsten Prüfung wieder an. Deine Daten bleiben unangetastet. Sobald die Lizenz wieder gültig ist, startet der Hintergrunddienst die Plattform und die Erweiterungen von selbst.

Eine Erweiterung fällt aus der Lizenz#

Steht eine installierte Erweiterung nicht mehr auf deiner Lizenz, läuft sie zunächst weiter. status und apply warnen und nennen das Datum, an dem sie angehalten wird: 7 Tage, nachdem der Server die Lizenz zum ersten Mal ohne sie gesehen hat. Danach hält der Hintergrunddienst sie an, und start lässt sie angehalten. Ihre Daten bleiben unangetastet. Steht sie wieder auf der Lizenz, hol die neue Freischaltung mit sudo aictl license renew ab. Der Hintergrunddienst startet die Erweiterung dann innerhalb von 30 Sekunden wieder.

Ohne Aktivierung#

Fehlt die Lizenzaktivierung auf dem Server ganz, etwa weil die Datei gelöscht wurde, läuft die Plattform weiter. Es finden aber keine Bestätigungen statt, status meldet einen Fehler, und Neues ist blockiert. Aktiviere die Lizenz mit sudo aictl install neu.

Neue Erweiterungen und Planänderungen abholen#

Hast du eine Erweiterung dazugekauft oder deinen Plan geändert, wird das mit der nächsten Bestätigung wirksam, spätestens nach 12 Stunden. Möchtest du nicht warten:

sudo aictl license renew

license renew holt sofort eine neue Bestätigung und zeigt Plan, Erweiterungen und Gültigkeit. Danach listet der Befehl neu freigeschaltete Erweiterungen und verfügbare Updates mit dem passenden Befehl auf. Installiert oder aktualisiert wird nichts, das machst du bewusst mit extension install oder extension update, siehe Erweiterungen verwalten.

Der Hintergrunddienst übernimmt die neue Bestätigung innerhalb von etwa 30 Sekunden. Wurde eine Sperre aufgehoben, startet er die Plattform damit von selbst wieder.

Ändert sich, ob die Schnittstelle der KI-Zentrale enthalten ist, führe danach zusätzlich sudo aictl apply aus.

Mögliche Meldungen:

• the license server has revoked this license oder … suspended …: Die Lizenz wurde gesperrt, die Plattform wird angehalten. Melde dich beim Support.
• could not reach the license server (offline?) — nothing changed: Der Server ist nicht erreichbar. Es wurde nichts verändert.

Lizenz prüfen#

aictl license check

Dieser Befehl fragt den Lizenzserver direkt nach dem aktuellen Stand und zeigt Schlüssel, Zustand, Plan, Erweiterungen, Gültigkeit und Update-Zeitraum. Er speichert nichts. Lehnt der Server die gespeicherte Bestätigung ab, hilft sudo aictl license renew.

license info und license check funktionieren für die Person, die die Plattform installiert hat, auch ohne sudo. Meldet der Befehl «permission denied», verwende sudo.

Systemuhr#

Die Lizenz ist zeitabhängig, deshalb muss die Systemuhr stimmen. status warnt, sobald die Uhr zwei Minuten oder mehr vom Lizenzserver abweicht. Schalte die Zeitsynchronisierung ein:

sudo timedatectl set-ntp true

Eine Uhr, die nach vorne springt, korrigiert sich mit der nächsten Bestätigung von selbst.

Wenn der Update-Zeitraum endet#

Nach dem Ende des Update-Zeitraums läuft deine Installation unverändert weiter, und Sicherheitsupdates erhältst du auch danach. license info zeigt beim Update-Zeitraum den Zusatz (ended: security releases only).

Willst du eine Version einer Erweiterung installieren, die nach dem Ende deines Update-Zeitraums erschienen ist, lehnt der Lizenzserver den Download mit einer Erklärung ab. Du kannst dann

• die Update-Verlängerung bei uns bestellen und danach sudo aictl license renew ausführen, oder
• eine ältere Version installieren: sudo aictl extension install <name> --version <version>.

Serverwechsel#

Die Lizenz ist an genau einen Server gebunden, und der Lizenzserver akzeptiert sie nur von diesem Server. Die Kennung des Servers ändert sich vor allem, wenn du das Betriebssystem neu installierst oder auf einen anderen Server wechselst.

• Zuerst freigeben: Entfernst du die Plattform auf dem bisherigen Server mit sudo aictl uninstall, gibt aictl die Lizenz auf dem Lizenzserver frei. Läuft der bisherige Server nicht mehr oder soll er bis zum Wechsel weiterlaufen, melde dich beim Support unter [email protected]. Wir heben die Bindung dann auf. Ohne Freigabe lehnt der Lizenzserver jede Aktivierung vom neuen Server ab.
• Danach aktivieren: Auf dem neuen Server aktiviert sudo aictl install die Lizenz und bindet sie an diesen Server. Liegt dort bereits eine Lizenzaktivierung, etwa aus einem zurückgespielten Backup, erledigt der Hintergrunddienst das bei seiner nächsten Bestätigung von selbst. Sofort geht es mit sudo aictl license renew.
• Ohne Freigabe meldet aictl: if this machine legitimately replaced the licensed one, ask your vendor to free the previous installation. status zeigt die Lizenz dann als ungültig an. Die Plattform läuft weiter, nur Neues ist blockiert.
• Der bisherige Server kann seine Lizenz nach dem Wechsel nicht mehr bestätigen.
• Geklonte virtuelle Maschinen haben dieselbe Kennung wie ihr Original. Verwende für jede Installation eine eigene Maschine.
• uninstall --keep-data behält die Lizenz und gibt sie nicht frei. Kann uninstall den Lizenzserver nicht erreichen, meldet es das und entfernt die Plattform trotzdem. Die Lizenz bleibt dann an den Server gebunden, bis der Support sie freigibt.

Wie ein Umzug abläuft, steht unter Backup und Wiederherstellung.

Zusätzliche Modell-Rechner brauchen keine eigene Lizenz.