Version 1.0.0-alpha.1aktuell
Kapitel 2.7
Installation von Enterprise und Einspielen einer Lizenz
Was sich bei der Installation der Enterprise-Edition ändert, wie Sie über Ihr Adverant-Konto eine Lizenz anfordern, welche drei Möglichkeiten zum Importieren es gibt (einschließlich aller Ablehnungscodes) und wie die Harrow Port Authority ihren Community-Piloten im laufenden Betrieb ohne Datenverlust auf Enterprise umgestellt hat.
Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

Eine Enterprise-Installation besteht aus zwei Hälften, und sie gelangen über unterschiedliche Wege ins System. Die Enterprise-Images werden mit dem Enterprise-Chart geliefert und über ein Pull-Token abgerufen. Die Lizenz erhalten Sie als signierte Datei aus Ihrem Adverant-Konto und importieren sie in die laufende Installation. Keine der beiden Hälften funktioniert ohne die andere: Images ohne Lizenz laufen auf der Community-Basisstufe, und eine Lizenz ohne Enterprise-Images hat nichts, was sie freischalten könnte.
Bei der Harrow Port Authority sind wir genau in dieser Reihenfolge vorgegangen, sechs Wochen nach dem Community-Pilotprojekt aus Kapitel 2.6, Installation von Community auf Kubernetes. Das Upgrade auf das Enterprise-Chart erforderte ein einziges Wartungsfenster; der Lizenzimport dauerte zwei Minuten. Dieses Kapitel behandelt beide Hälften. Es beginnt mit einer Neuinstallation und endet mit der direkten Umstellung einer bestehenden Community-Installation.
Unterschiede zur Community-Edition
Zwei Werte und das Chart, das sie ausliest.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueAlles andere in der Values-Datei bleibt genau so, wie es war, vor allem der Installationsname und die Treuhänder (Custodians). Die beiden Schlüssel müssen übereinstimmen, und das Chart verweigert edition: enterprise in Kombination mit enterprise.enabled: false oder umgekehrt.
Die Edition muss zudem mit der Image-Sperrdatei (Images Lock) des Charts übereinstimmen. Jedes Chart-Paket enthält die Sperrdatei für eine bestimmte Edition, und die Enterprise-Sperrdatei führt die Community-Images sowie die Enterprise-Builds auf. Wenn Sie eine Enterprise-Values-Datei auf das Community-Chart anwenden, bricht das Rendering mit files/images.lock.json is the community lock; this install is edition enterprise ab. Für die Enterprise-Installation ist daher zwingend das Enterprise-Chart erforderlich.
Das Enterprise-Chart und das zugehörige Bundle finden Sie auf der Seite „Downloads“ Ihres Adverant-Kontos, die an Ihre Lizenz gekoppelt ist. Die Chart-Datei trägt denselben Namen wie die der Community-Edition, nexus-1.0.0-alpha.1.tgz; bewahren Sie die beiden daher in getrennten Ordnern auf. Überprüfen Sie die Datei genau wie in Kapitel 2.4, Abrufen und Verifizieren eines Releases, beschrieben anhand des Release-Schlüssels, dessen Fingerabdruck Sie kontrolliert haben:
nexusctl verify enterprise/nexus-1.0.0-alpha.1.tgz
tar -xzf enterprise/nexus-1.0.0-alpha.1.tgz -C enterprise
jq -r '.version, .edition' enterprise/nexus/files/images.lock.json1.0.0-alpha.1
enterprise
Führen Sie anschließend die Signaturschleife aus Kapitel 2.4, Abrufen und Verifizieren eines Releases, über enterprise/nexus/files/images.lock.json aus. Sie deckt sowohl die Enterprise-Images als auch die gemeinsam genutzten Images ab.
Das Pull-Token
Community-Images sind öffentlich. Enterprise-Images benötigen ein Pull-Token von der Seite „Pull tokens and install commands“ Ihres Kontos, das für die Container-Laufzeitumgebung Ihrer Knoten konfiguriert werden muss, wie in Kapitel 2.4, Abrufen und Verifizieren eines Releases, Schritt 3, gezeigt. Unter k3s ist dies ein configs-Eintrag für registry.adverant.ai in /etc/rancher/k3s/registries.yaml auf jedem Knoten.
Erstellen Sie ein Token pro Cluster und versehen Sie es mit einem Ablaufdatum, das Ihnen rechtzeitig auffällt. Wenn ein Token abläuft, laufen bestehende Pods zwar weiter, aber ein Pod, der auf einen Knoten verschoben wird, auf dem das Image noch nicht vorliegt, kann es nicht mehr abrufen. Wir tragen das Ablaufdatum des Tokens in denselben Kalender ein wie das des Zertifikats.
Eine frische Enterprise-Installation
Wenn Sie Enterprise von Grund auf neu installieren, folgen Sie Schritt für Schritt Kapitel 2.6, Installation von Community auf Kubernetes, mit drei Abweichungen:
Hinterlegen Sie das Pull-Token vor Schritt 6 auf jedem Knoten.
Verwenden Sie in Schritt 4 die Enterprise-Werte (die beiden oben genannten Schlüssel).
Installieren Sie in Schritt 6 aus der heruntergeladenen Enterprise-Chart-Datei:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Alles nach dem Installationsbefehl verläuft genauso wie in Kapitel 2.6, Installation von Community auf Kubernetes, und dasselbe gilt für die Regel zu --wait: Verwenden Sie diese Option nicht. Wenn Sie stattdessen mit nexusctl installieren, fügen Sie dem Befehl --edition enterprise hinzu:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseSobald alle Workloads bereit sind, durchlaufen Sie die Ersteinrichtung in Kapitel 2.12, Der erste Start. Die Lizenz ist einer der sechs Punkte, die die Konsole auflistet, bevor sich jemand anmeldet. Bis sie importiert wird, läuft die Installation auf der Community-Basisstufe, und jeder Enterprise-Bereich wird ausgegraut mit einem Schlosssymbol dargestellt.
Anfordern der Lizenz
Eine Lizenz von Adverant wird für die Identität einer bestimmten Installation ausgestellt – genau jene, die der Schlüsselspeicher bei der Installation unter keys.installationName geprägt hat. Daher muss das Konto wissen, welche Installation Sie meinen, bevor es eine Lizenz ausstellen kann.
- Melden Sie sich unter
https://account.adverant.aibei Ihrem Adverant-Konto an. - Öffnen Sie in der Installation „This installation“ und anschließend „Licence“. Dort werden ein Einmalcode und der Fingerabdruck der Installation angezeigt.
- Öffnen Sie in Ihrem Konto „Claim a deployment“ und geben Sie den Code ein. Vergleichen Sie dann den Fingerabdruck, den das Konto empfangen hat, Gruppe für Gruppe mit dem, den die Installation anzeigt; jede Gruppe muss übereinstimmen.
- Klicken Sie auf die Schaltfläche zum Beanspruchen (Claim). Die Installation wird unter „Deployments“ in Ihrem Konto mit ihrer Version und ihrem Lizenzstatus aufgenommen.
- Adverant stellt die Lizenz für diese Installation aus. Laden Sie die Datei aus Ihrem Konto herunter; sie ist nach ihrer Lizenz-ID benannt,
<licence-id>.json.
Ein Beanspruchungscode (Claim-Code) ist nur einmal und nur für kurze Zeit gültig. Wenn er abläuft, lehnt das Konto ihn mit CLAIM_CODE_EXPIRED ab, und die Installation zeigt einen neuen Code an.
Es gibt noch zwei weitere Wege, die beide in Kapitel 2.13, Lizenzen, ausführlich behandelt werden. Appliances und Edge-Kits verfügen über keinen Bildschirm zur Anzeige eines Codes; sie werden daher über einen auf dem Gehäuse aufgedruckten Claim-Schlüssel beansprucht, der unter „Enter a claim key“ eingegeben oder aus der Bestelldatei des Herstellers ausgelesen wird. Eine Installation ohne Verbindung nach außen nutzt den Offline-Austausch („Offline exchange“): Sie erzeugt eine signierte Lizenzanforderungsdatei, die Sie in Ihr Konto übertragen, woraufhin Sie die Lizenzdatei zurücktragen. Einmal im Jahr erstellt sie auf dieselbe Weise eine signierte Nutzungsabrechnung. Jede Datei beim Austausch ist signiert, sodass eine unterwegs veränderte Datei abgelehnt wird – mit LICENCE_REQUEST_SIGNATURE_INVALID bei einer Anforderung und USAGE_FILE_SIGNATURE_INVALID bei einer Nutzungsdatei.
Was die Lizenzdatei enthält
Die Lizenz ist ein JSON-Dokument im Format nexus-licence/v1, das von Adverant zweimal mit zwei unabhängigen Schlüsseln signiert wurde. Sie müssen es nicht selbst lesen, aber es ist hilfreich zu wissen, was darin steht, falls jemand fragt, was Sie erworben haben.
| Feld | Bedeutung |
|---|---|
licence_id |
Die eigene ID der Lizenz, eine kleingeschriebene UUID (Universally Unique Identifier) |
type |
alpha, evaluation oder commercial |
licensee |
Der Name der Organisation und die Adverant-Kunden-ID |
scope |
Die Installation, für die sie bestimmt ist, sowie alle Organisationen, die in einer Berechtigung (Grant) genannt werden |
edition |
enterprise |
grants |
Die Funktionsgruppen, die sie freischaltet, jeweils für die gesamte Installation oder für benannte Organisationen |
add_ons und domain_packs |
Separat lizenzierte Fähigkeiten; das Paket für Logistik und Schifffahrt (Logistics and maritime pack) ist eine davon |
metric |
Wie die Lizenz abgerechnet wird – named-seat, per-core oder per-environment – sowie die Anzahl |
term |
starts_on, ends_on sowie die Tage für Vorwarnung und Kulanzfrist (Grace Period) |
matrix |
Die Version der Editionsmatrix, auf deren Grundlage sie ausgestellt wurde |
signatures |
Die beiden Signaturen von Adverant |
Eine Evaluierungslizenz gilt höchstens 30 Tage für maximal fünf benannte Personen und ohne Kulanzfrist. Eine kommerzielle Lizenz gibt standardmäßig 30 Tage vor Ablauf eine Warnung aus und gewährt anschließend 30 Tage Kulanzfrist. Was auf den einzelnen Stufen dieser Eskalationsleiter geschieht, erfahren Sie in Kapitel 2.13, Lizenzen.
Die Signaturen sichern das Dokument genau so ab, wie Adverant es erstellt hat. Übermitteln Sie es exakt so, wie Sie es erhalten haben; öffnen Sie es nicht in einem Editor, der es möglicherweise automatisch umformatiert.
Importieren der Lizenz
Nur ein Installationsadministrator kann eine Lizenz importieren: ein Eigentümer oder Administrator der gesamten Organisation, der die Installation gehört, während er an dieser angemeldet ist. Ein uneingeschränkter Plattformadministrator kann ebenfalls eine Lizenz importieren. Die Lizenz ist niemals ein Chart-Wert oder eine in einen Pod eingebundene Datei. Sie wird an den Anmeldedienst nexus-auth übergeben, der sie offline gegen die in seinem eigenen Image verankerten Vertrauensanker (Trust Roots) prüft und in einer einzigen Transaktion speichert. Sie können sie auf drei Wegen importieren, die alle zum selben Ziel führen.
In der Konsole
Öffnen Sie beim ersten Start „Six things before anyone signs in“ und anschließend „Licence“. Die Seite „Import the licence“ nimmt die Datei entgegen: Ziehen Sie sie auf die Seite oder wählen Sie sie aus. Die Seite prüft die Datei offline direkt auf der Installation und listet dann die freigeschalteten Funktionsgruppen auf – einschließlich der Art ihres Schutzes und der Gültigkeitsdauer. Gruppen, die nicht in der Lizenz enthalten sind, bleiben ausgegraut in der Liste.
Später erfolgt derselbe Import über die Schaltfläche Import a new licence auf der Lizenzseite der Installation. Wenn eine Lizenz abgelaufen ist, bietet die eingeschränkte Lizenzseite die Option Import a renewed licence.
Mit nexusctl
nexusctl licence import <licence-id>.jsonnexusctl sendet die Datei unverändert als Installationsadministrator an die Import-Route der Installation und meldet den Status der Lizenz oder den Ablehnungscode aus der unten stehenden Tabelle.
Über die API
Die Import-Route ist Teil der Programmierschnittstelle (Application Programming Interface, API) des Anmeldedienstes unter Ihrer hosts.auth-Adresse. Der Anfragekörper (Body) ist das Lizenzdokument, Byte für Byte:
curl -sS -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "authorization: Bearer <admin-token>" \
-H "content-type: application/json" \
--data-binary @<licence-id>.json<admin-token> ist das Zugriffstoken eines angemeldeten Installationsadministrators. Verwenden Sie --data-binary, niemals -d, da letzteres Zeilenumbrüche entfernt und somit die gesendeten Bytes verändert. Die Route akzeptiert keinen Query-String und im Body nichts außer dem Dokument selbst; ein Body, der auf oberster Ebene versucht, eine Organisation oder eine Person anzugeben, wird abgelehnt, noch bevor irgendetwas gelesen wird.
Ein erfolgreicher Import antwortet mit 201 Created. Gekürzt sieht der Body wie folgt aus:
{
"licence": {
"licence_id": "<licence-id>",
"state": "licensed",
"edition": "enterprise",
"licensee": {"name": "Harrow Port Authority", "customer_id": "<customer-id>"},
"term": {"starts_on": "2026-12-01", "ends_on": "2027-11-30", "warn_days": 30, "grace_days": 30},
"groups": ["enterprise-base", "..."]
},
"organizations": 1,
"tenants_without_organisation": 0
}
organizations zählt die Organisationen auf der Installation, die nun über die Lizenz verfügen. tenants_without_organisation zählt die in der Lizenz genannten Organisationen, die auf dieser Installation nicht vorhanden sind.
Wenn der Import abgelehnt wird
Ein abgelehnter Import verändert nichts: Es wird kein Datensatz geschrieben, und die aktuell gültige Lizenz – sofern vorhanden – bleibt unverändert bestehen. Das Audit-Protokoll der Installation zeichnet jeden Versuch auf, einschließlich der abgelehnten.
| Code | Status | Bedeutung | Vorgehensweise |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Eine der beiden Signaturen von Adverant fehlt oder lässt sich nicht verifizieren; die Datei wurde nach dem Signieren verändert | Fordern Sie die Datei erneut bei Adverant an; bearbeiten Sie sie nicht |
LICENCE_FORMAT_INVALID |
422 | Die Datei ist keine Lizenz, die dieses Release lesen kann | Senden Sie die Datei genau so, wie Adverant sie bereitgestellt hat |
LICENCE_ROOT_UNKNOWN |
422 | Sie wurde mit einem Schlüssel signiert, dem diese Installation nicht vertraut | Fordern Sie eine Lizenz an, die für die Vertrauensanker dieses Releases signiert wurde, oder führen Sie ein Upgrade durch |
LICENCE_MATRIX_MISMATCH |
422 | Sie wurde für eine Editionsmatrix ausgestellt, die dieses Release nicht lesen kann, oder gewährt eine Gruppe, die dieses Release nicht kennt | Führen Sie ein Upgrade durch oder fordern Sie eine für dieses Release ausgestellte Lizenz an |
LICENCE_OTHER_INSTALLATION |
409 | Sie wurde für eine andere Installation ausgestellt | Fordern Sie eine Lizenz an, die für die Identität dieser Installation ausgestellt ist |
TRANSITION_NOT_PERMITTED |
409 | Eine Lizenz mit dieser ID wurde bereits importiert; jede Lizenz kann nur einmal importiert werden | Fordern Sie bei Adverant eine neue Lizenz an, falls sich die Konditionen ändern müssen |
LICENCE_REVOKED |
403 | Adverant hat diese Lizenz zurückgezogen | Fordern Sie bei Adverant eine neue Lizenz an |
LICENCE_LOCKED |
403 | Die Laufzeit der Lizenz hat noch nicht begonnen; bis dahin gilt die Community-Basisstufe | Importieren Sie sie am oder nach ihrem ersten Gültigkeitstag erneut |
RECORD_NOT_FOUND |
404 | Die Installation wurde noch nicht deklariert und hat daher noch keine Identität, gegen die geprüft werden könnte | Schließen Sie den Schritt für den ersten Administrator ab (Kapitel 2.12, Der erste Start) und importieren Sie dann die Lizenz |
VALIDATION_FAILED |
400 | Der Body war unlesbar oder größer als 1 MiB, oder es wurde ein Query-String mitgesendet | Senden Sie die Datei als gesamten Body ohne Query-String |
Bei einem erfolgreichen Import kann noch ein weiterer Code zurückgegeben werden, allerdings als Hinweis statt als Ablehnung: LICENCE_CLOCK_BEHIND_FLOOR bedeutet, dass die Uhr der Installation eine frühere Zeit anzeigt als den spätesten Zeitpunkt, den sie bereits registriert hat; die Lizenz wird daher zu diesem späteren Zeitpunkt ausgewertet. Das Zurückstellen einer Uhr erweckt eine abgelaufene Lizenz niemals wieder zum Leben. Nur ein von Adverant für die Installation signiertes Zeit-Reset-Token kann diese Zeituntergrenze wieder absenken.
Umstellung von Community auf Enterprise im laufenden Betrieb
Genau so sind wir bei Harrow vorgegangen. Nichts wird neu installiert und nichts migriert: Es bleibt dieselbe Installation mit derselben Identität und denselben Daten, nur dass weitere Funktionen zugeschaltet werden. Der Installationsname und die Treuhänder bleiben genau wie zuvor; bei einem Upgrade prüft der Custody-Hook lediglich, ob der Schlüsselspeicher bereits initialisiert ist, und unternimmt sonst nichts.
Hinterlegen Sie das Pull-Token auf jedem Knoten und starten Sie dort die Container-Laufzeitumgebung neu.
Laden Sie das Enterprise-Chart unter „Downloads“ herunter und verifizieren Sie das Chart sowie dessen Images wie oben beschrieben.
Ändern Sie die beiden Werte in Ihrer bestehenden Values-Datei:
edition: enterpriseundenterprise.enabled: true. Ändern Sie nichts anderes.Führen Sie die Vorabprüfung (Preflight) mit der neuen Datei aus.
nexusctl preflight --context harrow-prod --values harrow-values.yamlFühren Sie ein Upgrade des Releases auf das Enterprise-Chart durch, wiederum ohne
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mBei einem Upgrade werden die Hooks ausgeführt, bevor die neuen Pods ausgerollt werden, und jede Migration wendet nur jene Dateien an, die zuvor noch nicht angewendet wurden. Die generierten Secrets werden aus der Installation zurückgelesen und beibehalten. Helm schließt mit folgender Ausgabe ab:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Warten Sie auf die Workloads, genau wie in Kapitel 2.6, Installation von Community auf Kubernetes, Schritt 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportieren Sie die Lizenz über einen der drei oben genannten Wege.
Öffnen Sie in der Konsole „This installation“, dann „Licence“ und anschließend „Move to Enterprise“. Die Seite liest die Lizenz ein und zeigt an, was heruntergeladen und was geändert wird, bevor irgendetwas geschieht. Außerdem zählt sie die Personen und Inhalte der Organisation und markiert diese jeweils als beibehalten („kept“). Klicken Sie auf Fetch and switch on. Jede Komponente wird vor der Verwendung gegen den Release-Schlüssel von Adverant geprüft, und die Funktionsgruppen werden nacheinander zugeschaltet.
Unser Wartungsfenster betrug eine Stunde; die eigentliche Arbeit darin dauerte rund zwanzig Minuten, wovon der Großteil auf das Warten auf das Schema während der Ausführung der Hooks entfiel. Die Teilnehmenden des Pilotprojekts meldeten sich am nächsten Morgen in derselben Arbeitsumgebung an – nur dass die Enterprise-Bereiche im Menü nicht mehr ausgegraut waren.
Nach dem Import
Die Lizenzseite unter „This installation“ listet jede in der Lizenz enthaltene Funktionsgruppe samt Arbeitsplätzen (Seats) und Laufzeit auf. Sie gibt auch an, wie jeder Teil bereitgestellt wird, beispielsweise kompiliert und lizenziert für eine Enterprise-Gruppe oder als Open Source für die Community-Basisstufe. Gruppen außerhalb der Lizenz bleiben ausgegraut aufgelistet. Administratoren können den Wirkungsbereich einer Gruppe innerhalb der Organisation einschränken; niemand außer Adverant kann erweitern, was eine Lizenz gewährt.
Der Status der Lizenz wird bei jedem Lesezugriff anhand des Dokuments und des aktuellen Datums neu berechnet, sodass der Ablauf ganz ohne geplanten Hintergrundjob eintritt. Wenn das Ende näher rückt, sehen alle Personen auf der Installation denselben Hinweis in der Konsole: LICENCE_ENDS_SOON ab 30 Tagen vor Ablauf, anschließend LICENCE_IN_GRACE während der Kulanzfrist. Mitglieder sehen den Hinweis und die Daten; nur Installationsadministratoren sehen die Lizenz selbst. Kapitel 2.13, Lizenzen, behandelt die Verlängerung und die Eskalationsstufen beim Ablauf.
Wenn etwas fehlschlägt
| Was Sie sehen | Ursache | Vorgehensweise |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Nur einer der beiden Schlüssel wurde geändert | Ändern Sie beide |
files/images.lock.json is the community lock; this install is edition enterprise |
Das Community-Chart wurde verwendet | Verwenden Sie das Enterprise-Chart aus dem Bereich „Downloads“ |
image ... is a enterprise image; a community install takes only community images |
Ein Enterprise-Image-Name ist in ein Community-Rendering gelangt | Prüfen Sie edition und den Chart-Ordner |
ImagePullBackOff bei einem Enterprise-Image nach dem Upgrade |
Ein Knoten hat kein Pull-Token, oder sein Token ist nicht mehr gültig | Prüfen Sie registries.yaml auf diesem Knoten oder erstellen Sie ein neues Token |
| Ein Lizenz-Ablehnungscode | Siehe die Ablehnungstabelle oben | Befolgen Sie die entsprechende Zeile; es wurde nichts geändert |
Wenn die Lizenzseite „Enterprise“ und die erwarteten Gruppen anzeigt, ist die Installation lizenziert. Die nächste Station ist die Ersteinrichtung in Kapitel 2.12, Der erste Start, sofern Sie die Installation noch nicht beansprucht haben. Falls Sie dies bereits getan haben, benötigt der Assistent noch die organisationsinternen Schlüssel für Modelle der künstlichen Intelligenz (KI), bevor er jemandem antworten kann. Kapitel 2.14, KI-Anbieter und -Modelle, zeigt, wie Sie diese anbinden.




