Versie 1.0.0-alpha.1nieuwste
Hoofdstuk 2.7
Enterprise installeren en een licentie toepassen
Wat er verandert wanneer u de Enterprise-editie installeert, hoe u een licentie aanvraagt vanuit uw Adverant-account, de drie manieren om deze te importeren met elke weigeringscode, en hoe Harrow Port Authority zijn Community-pilot ter plekke naar Enterprise heeft overgezet zonder iets te verliezen.
Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

Een Enterprise-installatie bestaat uit twee helften en die komen via verschillende wegen binnen. De Enterprise-images worden geleverd met de Enterprise-chart en binnengehaald met een pull-token. De licentie komt als een ondertekend bestand vanuit uw Adverant-account en u importeert deze in de draaiende installatie. Geen van beide helften werkt zonder de andere: images zonder licentie draaien op het Community-basisniveau, en een licentie zonder Enterprise-images heeft niets om in te schakelen.
Bij Harrow Port Authority hebben we het in die volgorde gedaan, zes weken na de Community-pilot in hoofdstuk 2.6, Community installeren op Kubernetes. De upgrade naar de Enterprise-chart kostte één onderhoudsvenster; het importeren van de licentie duurde twee minuten. Dit hoofdstuk behandelt beide helften. Het begint met een schone installatie en eindigt met een bestaande Community-installatie die op zijn plek wordt omgezet.
Wat verschilt van Community
Twee waarden, en de chart die ze leest.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueAl het andere in het values-bestand blijft precies zoals het was, de installatienaam en de bewaarders voorop. De twee sleutels moeten overeenkomen, en de chart weigert edition: enterprise met enterprise.enabled: false, of omgekeerd.
De editie moet ook overeenkomen met de images-lock van de chart. Elk chart-pakket bevat de lock voor één editie, en de Enterprise-lock vermeldt de Community-images plus de Enterprise-builds. Verwijst u met een Enterprise-values-bestand naar de Community-chart, dan stopt het renderen met files/images.lock.json is the community lock; this install is edition enterprise. De Enterprise-installatie heeft dus de Enterprise-chart nodig.
De Enterprise-chart en -bundel staan op de pagina Downloads van uw Adverant-account, die uw licentie volgt. Het chart-bestand heeft dezelfde naam als dat van Community, nexus-1.0.0-alpha.1.tgz, dus bewaar de twee in afzonderlijke mappen. Controleer het precies zoals beschreven in hoofdstuk 2.4, Een release ophalen en verifiëren, aan de hand van de releasesleutel waarvan u de vingerafdruk hebt gecontroleerd:
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
Voer vervolgens de handtekeninglus uit hoofdstuk 2.4, Een release ophalen en verifiëren, uit over enterprise/nexus/files/images.lock.json. Deze dekt zowel de Enterprise-images als de gedeelde images.
Het pull-token
Community-images zijn openbaar. Enterprise-images hebben een pull-token nodig van de pagina Pull tokens and install commands van uw account, geconfigureerd voor de containerruntime van uw nodes zoals getoond in hoofdstuk 2.4, Een release ophalen en verifiëren, stap 3. Op k3s is dat een configs-vermelding voor registry.adverant.ai in /etc/rancher/k3s/registries.yaml op elke node.
Maak één token per cluster en geef deze een einddatum die u opmerkt. Wanneer een token verloopt, blijven draaiende pods doorwerken, maar een pod die opnieuw wordt ingepland op een node die de image nog niet heeft, kan deze niet binnenhalen. Wij zetten de einddatum van de token in dezelfde agenda als die van het certificaat.
Een nieuwe Enterprise-installatie
Als u Enterprise vanaf het begin installeert, volgt u hoofdstuk 2.6, Community installeren op Kubernetes, stap voor stap, met drie verschillen:
Zet de pull-token op elke node vóór stap 6.
Gebruik de Enterprise-waarden (de twee sleutels hierboven) in stap 4.
Installeer in stap 6 vanuit het Enterprise-chart-bestand dat u hebt gedownload:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Alles na de installatieopdracht is hetzelfde als in hoofdstuk 2.6, Community installeren op Kubernetes, en dat geldt ook voor de regel over --wait: gebruik het niet. Als u in plaats daarvan installeert met nexusctl, voeg dan --edition enterprise toe aan de opdracht:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseWanneer elke workload gereed is, doorloopt u de eerste uitvoering in hoofdstuk 2.12, De eerste uitvoering. De licentie is een van de zes zaken die de console vermeldt voordat iemand zich aanmeldt. Totdat deze is geïmporteerd, draait de installatie op het Community-basisniveau en wordt elk Enterprise-onderdeel grijs met een slotje weergegeven.
De licentie aanvragen
Een licentie van Adverant wordt uitgegeven voor de identiteit van één installatie, degene die de sleutelopslag bij de installatie onder keys.installationName heeft aangemaakt. Het account moet dus weten welke installatie u bedoelt voordat het er een kan uitgeven.
- Meld u aan bij uw Adverant-account op
https://account.adverant.ai. - Open op de installatie This installation en vervolgens Licence. Hier worden een eenmalige code en de vingerafdruk van de installatie getoond.
- Open in uw account Claim a deployment en voer de code in. Vergelijk vervolgens de vingerafdruk die het account heeft ontvangen met degene die de installatie toont, groep voor groep; elke groep moet overeenkomen.
- Druk op de claimknop. De installatie wordt toegevoegd aan Deployments in uw account, met de bijbehorende versie en licentiestatus.
- Adverant geeft de licentie uit voor die installatie. Download het bestand vanuit uw account; het is genoemd naar de bijbehorende licentie-ID,
<licence-id>.json.
Een claimcode werkt eenmalig en gedurende korte tijd. Als deze verloopt, weigert het account de code met CLAIM_CODE_EXPIRED, en toont de installatie een nieuwe.
Er bestaan twee andere routes, en hoofdstuk 2.13, Licenties, behandelt beide volledig. Appliances en edge-kits hebben geen scherm om een code te tonen, dus worden ze geclaimd met een claimsleutel die op de doos is gedrukt, ingetypt bij Enter a claim key of ingelezen uit het bestelbestand van de fabrikant. Een installatie zonder uitgaande verbinding gebruikt de Offline exchange: deze maakt een ondertekend licentieaanvraagbestand aan, u brengt dat naar uw account en u neemt het licentiebestand weer mee terug. Eén keer per jaar maakt de installatie op dezelfde manier een ondertekende gebruiksverklaring aan. Elk bestand in de uitwisseling is ondertekend, dus een bestand dat onderweg is gewijzigd, wordt geweigerd, met LICENCE_REQUEST_SIGNATURE_INVALID voor een aanvraag en USAGE_FILE_SIGNATURE_INVALID voor een gebruiksbestand.
Wat het licentiebestand bevat
De licentie is een JSON-document in de indeling nexus-licence/v1, tweemaal ondertekend door Adverant met twee onafhankelijke sleutels. U hoeft het niet te lezen, maar het helpt om te weten wat erin staat wanneer iemand vraagt wat u hebt aangeschaft.
| Veld | Wat erin staat |
|---|---|
licence_id |
De eigen ID van de licentie, een UUID (universally unique identifier) in kleine letters |
type |
alpha, evaluation of commercial |
licensee |
De naam van de organisatie en de Adverant-klant-ID |
scope |
De installatie waarvoor deze bestemd is, en eventuele organisaties die in een toekenning worden genoemd |
edition |
enterprise |
grants |
De functiegroepen die worden ontgrendeld, elk voor de hele installatie of voor bij naam genoemde organisaties |
add_ons en domain_packs |
Afzonderlijk gelicentieerde mogelijkheden; het pakket voor logistiek en scheepvaart is er één van |
metric |
Hoe de licentie wordt geteld, named-seat, per-core of per-environment, en het aantal |
term |
starts_on, ends_on, en het aantal waarschuwings- en respijtdagen |
matrix |
De versie van de editiematrix waarvoor deze is opgesteld |
signatures |
De twee handtekeningen van Adverant |
Een evaluatielicentie duurt maximaal 30 dagen, voor maximaal vijf bij naam genoemde personen, zonder respijtperiode. Een commerciële licentie waarschuwt 30 dagen voordat deze afloopt en geeft daarna standaard 30 dagen respijt. Wat er bij elke stap op die ladder gebeurt, staat in hoofdstuk 2.13, Licenties.
De handtekeningen dekken het document zoals Adverant het heeft gemaakt. Verstuur het precies zoals u het hebt ontvangen; open het niet in een editor die de opmaak mogelijk opschoont.
De licentie importeren
Alleen een installatiebeheerder kan een licentie importeren: een eigenaar of beheerder van de hele organisatie die eigenaar is van de installatie, terwijl deze daarop is aangemeld. Een volledige platformbeheerder kan er ook een importeren. De licentie is nooit een chart-waarde of een bestand dat in een pod wordt gekoppeld. Deze gaat naar de aanmeldservice, nexus-auth, die de licentie offline controleert aan de hand van de vertrouwensankers die in de eigen image zijn ingebouwd, en deze in één transactie vastlegt. U kunt de licentie op drie manieren importeren, en ze komen allemaal op dezelfde plek uit.
In de console
Open tijdens de eerste uitvoering Six things before anyone signs in en vervolgens Licence. De pagina Import the licence neemt het bestand aan: sleep het naar de pagina of selecteer het. De pagina controleert het offline op de installatie zelf en vermeldt vervolgens de functiegroepen die ermee worden geopend, met daarbij hoe elke groep is beveiligd en tot wanneer. Groepen die niet in de licentie zijn opgenomen, blijven grijs vermeld staan.
Later verloopt diezelfde import via de knop Import a new licence op de licentiepagina van de installatie. Wanneer een licentie is verlopen, biedt de beperkte licentiepagina de knop Import a renewed licence.
Met nexusctl
nexusctl licence import <licence-id>.jsonnexusctl stuurt het bestand ongewijzigd als installatiebeheerder naar de importroute van de installatie, en meldt de status van de licentie of de weigeringscode uit de onderstaande tabel.
Via de API
De importroute maakt deel uit van de application programming interface (API) van de aanmeldservice, op uw hosts.auth-adres. De body is het licentiedocument, byte voor 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> is de toegangstoken van een aangemelde installatiebeheerder. Gebruik --data-binary, nooit -d, want dat verwijdert regeleinden en verandert daarmee de bytes die u verstuurt. De route accepteert geen querystring en niets anders in de body dan het document; een body die op het hoogste niveau een organisatie of persoon probeert te noemen, wordt geweigerd voordat er iets wordt gelezen.
Een geslaagde import antwoordt met 201 Created. Ingekort ziet de body er als volgt uit:
{
"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 telt de organisaties op de installatie die nu over de licentie beschikken. tenants_without_organisation telt organisaties die in de licentie worden genoemd, maar niet op deze installatie aanwezig zijn.
Wanneer de import wordt geweigerd
Een geweigerde import verandert niets: er wordt geen rij geschreven en de geldende licentie, als die er is, blijft zoals die was. Het auditlogboek van de installatie legt elke poging vast, inclusief de geweigerde.
| Code | Status | Wat het betekent | Wat te doen |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Een van de twee handtekeningen van Adverant ontbreekt of kan niet worden geverifieerd; het bestand is na ondertekening gewijzigd | Vraag het bestand opnieuw aan bij Adverant; bewerk het niet |
LICENCE_FORMAT_INVALID |
422 | Het bestand is geen licentie die deze release kan lezen | Verstuur het bestand precies zoals Adverant het heeft verstrekt |
LICENCE_ROOT_UNKNOWN |
422 | Het is ondertekend met een sleutel die deze installatie niet vertrouwt | Vraag om een licentie die is ondertekend voor de vertrouwensankers van deze release, of voer een upgrade uit |
LICENCE_MATRIX_MISMATCH |
422 | Het is opgesteld voor een editiematrix die deze release niet leest, of kent een groep toe die deze release niet kent | Voer een upgrade uit, of vraag om een licentie die is opgesteld voor deze release |
LICENCE_OTHER_INSTALLATION |
409 | Het is uitgegeven voor een andere installatie | Vraag om een licentie die is uitgegeven voor de identiteit van deze installatie |
TRANSITION_NOT_PERMITTED |
409 | Er is al een licentie met deze ID geïmporteerd; elke licentie wordt slechts één keer geïmporteerd | Vraag Adverant om een nieuwe licentie als de voorwaarden moeten worden gewijzigd |
LICENCE_REVOKED |
403 | Adverant heeft deze licentie ingetrokken | Vraag Adverant om een nieuwe |
LICENCE_LOCKED |
403 | De looptijd van de licentie is nog niet begonnen; tot die tijd geldt het Community-basisniveau | Importeer deze opnieuw op of na de eerste dag |
RECORD_NOT_FOUND |
404 | De installatie is nog niet gedeclareerd en heeft dus geen identiteit om mee te vergelijken | Voltooi de stap van de eerste beheerder (hoofdstuk 2.12, De eerste uitvoering) en importeer vervolgens |
VALIDATION_FAILED |
400 | De body was onleesbaar of groter dan 1 MiB, of er is een querystring meegestuurd | Verstuur het bestand als de volledige body, zonder query |
Er kan nog één andere code terugkomen bij een geslaagde import, als kennisgeving in plaats van een weigering: LICENCE_CLOCK_BEHIND_FLOOR betekent dat de klok van de installatie vroeger aangeeft dan het laatste tijdstip dat de installatie al heeft gezien, waardoor de licentie op dat latere tijdstip wordt gelezen. Het terugzetten van de klok wekt een verlopen licentie nooit opnieuw tot leven. Alleen een tijdreset-token die Adverant voor de installatie ondertekent, verlaagt die ondergrens.
Community ter plekke omzetten naar Enterprise
Dit is wat we bij Harrow hebben gedaan. Er wordt niets opnieuw geïnstalleerd en er wordt niets gemigreerd: het is dezelfde installatie, met dezelfde identiteit en dezelfde gegevens, waarvan nu meer is ingeschakeld. De installatienaam en de bewaarders blijven precies zoals ze waren; bij een upgrade controleert de custody-hook of de sleutelopslag al is geïnitialiseerd en doet verder niets.
Zet de pull-token op elke node en herstart daar de containerruntime.
Haal de Enterprise-chart op uit Downloads en verifieer deze en de bijbehorende images zoals hierboven beschreven.
Wijzig de twee waarden in uw bestaande values-bestand:
edition: enterpriseenenterprise.enabled: true. Wijzig verder niets.Voer de preflight-controle uit met het nieuwe bestand.
nexusctl preflight --context harrow-prod --values harrow-values.yamlVoer een upgrade van de release uit naar de Enterprise-chart, opnieuw zonder
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mBij een upgrade worden de hooks uitgevoerd voordat de nieuwe pods worden uitgerold, en past elke migratie alleen de bestanden toe die nog niet eerder zijn toegepast. De gegenereerde secrets worden teruggelezen uit de installatie en behouden. Helm eindigt met:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Wacht op de workloads, precies zoals in hoofdstuk 2.6, Community installeren op Kubernetes, stap 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImporteer de licentie op een van de drie bovenstaande manieren.
Open in de console This installation, vervolgens Licence en daarna Move to Enterprise. De pagina leest de licentie en toont wat er wordt opgehaald en wat er verandert voordat er iets gebeurt. Ook worden de personen en inhoud van de organisatie geteld en elk gemarkeerd als behouden. Druk op Fetch and switch on. Elk onderdeel wordt gecontroleerd aan de hand van de releasesleutel van Adverant voordat het wordt gebruikt, en de functiegroepen worden één voor één ingeschakeld.
Ons onderhoudsvenster was een uur; het werk daarbinnen duurde ongeveer twintig minuten, waarvan het grootste deel bestond uit het wachten op het schema terwijl de hooks draaiden. De deelnemers aan de pilot meldden zich de volgende ochtend aan bij dezelfde werkruimte, waarbij de Enterprise-onderdelen in het menu niet langer grijs waren.
Na het importeren
De licentiepagina onder This installation vermeldt elke functiegroep in de licentie met het aantal seats en de looptijd. Er staat ook bij hoe elk onderdeel wordt geleverd, bijvoorbeeld gecompileerd en gelicentieerd voor een Enterprise-groep, of open source voor het Community-basisniveau. Groepen buiten de licentie blijven grijs vermeld staan. Beheerders kunnen binnen de organisatie inperken wat een groep bereikt; niemand anders dan Adverant kan verruimen wat een licentie toekent.
De status van de licentie wordt bij elke leesbewerking opnieuw berekend op basis van het document en de datum, zodat het verlopen plaatsvindt zonder een geplande taak. Iedereen op de installatie ziet dezelfde melding in de console naarmate het einde nadert: LICENCE_ENDS_SOON vanaf 30 dagen voor het einde, en vervolgens LICENCE_IN_GRACE tijdens de respijtperiode. Leden zien de melding en de datums; alleen installatiebeheerders zien de licentie zelf. Hoofdstuk 2.13, Licenties, behandelt verlenging en de vervalladder.
Als dit mislukt
| Wat u ziet | Oorzaak | Wat te doen |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Slechts een van de twee sleutels is gewijzigd | Wijzig beide |
files/images.lock.json is the community lock; this install is edition enterprise |
De Community-chart is gebruikt | Gebruik de Enterprise-chart uit Downloads |
image ... is a enterprise image; a community install takes only community images |
Een Enterprise-imagenaam heeft een Community-render bereikt | Controleer edition en de chart-map |
ImagePullBackOff op een Enterprise-image na de upgrade |
Een node heeft geen pull-token, of de token is niet langer geldig | Controleer registries.yaml op die node, of maak een nieuwe token aan |
| Een weigeringscode voor een licentie | Zie de weigeringstabel hierboven | Volg de bijbehorende rij; er is niets gewijzigd |
Wanneer de licentiepagina Enterprise en de door u verwachte groepen toont, is de installatie gelicentieerd. De volgende stap is de eerste uitvoering in hoofdstuk 2.12, De eerste uitvoering, als u de installatie nog niet hebt geclaimd. Hebt u dat wel gedaan, dan heeft de assistent nog de eigen sleutels voor kunstmatige intelligentie (AI)-modellen van de organisatie nodig voordat deze iemand kan antwoorden. Hoofdstuk 2.14, AI-providers en -modellen, laat zien hoe u deze koppelt.




