Version 1.0.0-alpha.1seneste
Kapitel 2.7
Installation af Enterprise og aktivering af en licens
Hvad der ændrer sig, når De installerer Enterprise-udgaven, hvordan De anmoder om en licens fra Deres Adverant-konto, de tre måder at importere den på med alle afvisningskoder, og hvordan Harrow Port Authority opgraderede sin Community-pilot til Enterprise direkte på stedet uden at miste noget.
Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

En Enterprise-installation består af to halvdele, og de ankommer ad forskellige veje. Enterprise-images følger med Enterprise-chartet og hentes med et pull-token. Licensen leveres som en signeret fil fra din Adverant-konto, og du importerer den i den kørende installation. Ingen af halvdelene fungerer uden den anden: images uden licens kører på Community-basisniveauet, og en licens uden Enterprise-images har intet at aktivere.
Hos Harrow Port Authority gjorde vi det i den rækkefølge, seks uger efter Community-pilotprojektet i kapitel 2.6, Installation af Community på Kubernetes. Opgraderingen til Enterprise-chartet tog ét vedligeholdelsesvindue; licensimporten tog to minutter. Dette kapitel dækker begge halvdele. Det starter med en ny installation og slutter med en eksisterende Community-installation, der opgraderes på stedet.
Hvad der adskiller sig fra Community
To værdier og det chart, der læser dem.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueAlt andet i værdifilen forbliver præcis, som det var, frem for alt installationsnavnet og de nøglebetroede. De to nøgler skal stemme overens, og chartet afviser edition: enterprise med enterprise.enabled: false eller omvendt.
Udgaven skal også stemme overens med chartets image-lås. Hver chart-pakke indeholder låsen for én udgave, og Enterprise-låsen angiver Community-images plus Enterprise-builds. Peger man en Enterprise-værdifil mod Community-chartet, stopper gengivelsen med files/images.lock.json is the community lock; this install is edition enterprise. En Enterprise-installation kræver altså Enterprise-chartet.
Enterprise-chartet og -bundtet findes på siden Downloads på din Adverant-konto, som følger din licens. Chart-filen har samme navn som Community-filen, nexus-1.0.0-alpha.1.tgz, så opbevar de to i separate mapper. Kontroller den præcis som beskrevet i kapitel 2.4, Hentning og verificering af en udgivelse, op imod den udgivelsesnøgle, hvis fingeraftryk du kontrollerede:
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
Kør derefter signaturløkken fra kapitel 2.4, Hentning og verificering af en udgivelse, over enterprise/nexus/files/images.lock.json. Den dækker både Enterprise-images og de delte images.
Pull-tokenet
Community-images er offentlige. Enterprise-images kræver et pull-token fra siden Pull tokens and install commands på din konto, konfigureret til dine noders container-runtime som vist i kapitel 2.4, Hentning og verificering af en udgivelse, trin 3. På k3s er det en configs-post for registry.adverant.ai i /etc/rancher/k3s/registries.yaml på hver node.
Opret ét token pr. klynge, og giv det en udløbsdato, du lægger mærke til. Når et token udløber, fortsætter kørende pods, men en pod, der omplaceres til en node, som endnu ikke har det pågældende image, kan ikke hente det. Vi har sat tokenets udløbsdato i samme kalender som certifikatets.
En ny Enterprise-installation
Hvis du installerer Enterprise fra bunden, skal du følge kapitel 2.6, Installation af Community på Kubernetes, trin for trin, med tre forskelle:
Læg pull-tokenet på hver node før trin 6.
Brug Enterprise-værdierne (de to nøgler ovenfor) i trin 4.
I trin 6 skal du installere fra den Enterprise-chart-fil, du har downloadet:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Alt efter installationskommandoen er det samme som i kapitel 2.6, Installation af Community på Kubernetes, og det gælder også reglen om --wait: brug den ikke. Hvis du i stedet installerer med nexusctl, skal du føje --edition enterprise til kommandoen:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseNår alle workloads er klar, skal du gennemgå den første kørsel i kapitel 2.12, Den første kørsel. Licensen er et af de seks punkter, som konsollen viser, før nogen logger ind. Indtil den er importeret, kører installationen på Community-basisniveauet, og hvert Enterprise-område vises nedtonet med en hængelås.
Anmodning om licensen
En licens fra Adverant udstedes til én installations identitet – den, som nøglelageret oprettede under keys.installationName ved installationen. Kontoen skal derfor vide, hvilken installation du mener, før den kan udstede en licens.
- Log ind på din Adverant-konto på
https://account.adverant.ai. - Åbn This installation og derefter Licence på installationen. Her vises en engangskode og installationens fingeraftryk.
- Åbn Claim a deployment på din konto, og indtast koden. Sammenlign derefter det fingeraftryk, kontoen har modtaget, med det, som installationen viser, gruppe for gruppe; hver eneste gruppe skal stemme overens.
- Tryk på tilknytningsknappen. Installationen føjes til Deployments på din konto med dens versions- og licensstatus.
- Adverant udsteder licensen til den pågældende installation. Download filen fra din konto; den er opkaldt efter sit licens-id,
<licence-id>.json.
En tilknytningskode virker én gang og i kort tid. Hvis den udløber, afviser kontoen den med CLAIM_CODE_EXPIRED, og installationen viser en ny.
Der findes to andre veje, og kapitel 2.13, Licenser, beskriver dem begge i detaljer. Appliances og edge-kits har ingen skærm til at vise en kode, så de tilknyttes med en tilknytningsnøgle, der er trykt på æsken, indtastet under Enter a claim key eller indlæst fra producentens ordrefil. En installation uden forbindelse udadtil bruger Offline exchange: den opretter en signeret licensanmodningsfil, du overfører den til din konto, og du tager licensfilen med tilbage. Én gang om året opretter den en signeret forbrugsopgørelse på samme måde. Hver fil i udvekslingen er signeret, så en fil, der ændres undervejs, afvises med LICENCE_REQUEST_SIGNATURE_INVALID for en anmodning og USAGE_FILE_SIGNATURE_INVALID for en forbrugsfil.
Hvad licensfilen indeholder
Licensen er et JSON-dokument i formatet nexus-licence/v1, signeret to gange af Adverant med to uafhængige nøgler. Du behøver ikke at læse det, men det er nyttigt at vide, hvad det indeholder, når nogen spørger, hvad I har købt.
| Felt | Hvad der står i den |
|---|---|
licence_id |
Licensens eget id, en UUID (universally unique identifier) med små bogstaver |
type |
alpha, evaluation eller commercial |
licensee |
Organisationens navn og Adverant-kunde-id |
scope |
Den installation, den gælder for, og eventuelle organisationer, som en tildeling navngiver |
edition |
enterprise |
grants |
De funktionsgrupper, den låser op for, hver især for hele installationen eller for navngivne organisationer |
add_ons og domain_packs |
Kapabiliteter, der licenseres separat; Logistik- og maritim-pakken er en af dem |
metric |
Hvordan licensen opgøres, named-seat, per-core eller per-environment, samt antallet |
term |
starts_on, ends_on samt antal dage med varsel og henstand |
matrix |
Versionen af den udgavematrix, den er udarbejdet op imod |
signatures |
Adverants to signaturer |
En evalueringslicens gælder i højst 30 dage for højst fem navngivne personer uden henstandsperiode. En kommerciel licens giver et varsel 30 dage før udløb og derefter som standard 30 dages henstand. Hvad der sker på hvert trin af denne forløbsstige, er beskrevet i kapitel 2.13, Licenser.
Signaturerne dækker dokumentet, præcis som Adverant har oprettet det. Send det nøjagtigt, som du har modtaget det; åbn det ikke i en editor, der kan finde på at omformatere det.
Import af licensen
Kun en installationsadministrator kan importere en licens: en ejer eller administrator af hele den organisation, der ejer installationen, mens vedkommende er logget ind på den. En fuld platformsadministrator kan også importere en. Licensen er aldrig en chart-værdi eller en fil, der monteres i en pod. Den sendes til logintjenesten, nexus-auth, som kontrollerer den offline mod de rodcertifikater, der er indbygget i dens eget image, og registrerer den i én samlet transaktion. Du kan importere den på tre måder, og de ender alle samme sted.
I konsollen
Under den første kørsel skal du åbne Six things before anyone signs in og derefter Licence. Siden Import the licence tager imod filen: træk den ind på siden, eller vælg den. Siden kontrollerer den offline på selve installationen og viser derefter de funktionsgrupper, den åbner, samt hvordan hver enkelt er beskyttet, og hvor længe. Grupper, som licensen ikke omfatter, forbliver på listen, men er nedtonede.
Senere foretages den samme import via knappen Import a new licence på installationens licensside. Når en licens er udløbet, viser den begrænsede licensside knappen Import a renewed licence.
Med nexusctl
nexusctl licence import <licence-id>.jsonnexusctl sender filen uændret til installationens importrute som installationsadministrator og rapporterer licensens status eller afvisningskoden fra tabellen nedenfor.
Via API'et
Importruten er en del af logintjenestens applikationsprogrammeringsgrænseflade (API) på din hosts.auth-adresse. Brødteksten er selve licensdokumentet, byte for 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> er adgangstokenet for en installationsadministrator, der er logget ind. Brug --data-binary, aldrig -d, da sidstnævnte fjerner linjeskift og dermed ændrer de bytes, du sender. Ruten tager ingen forespørgselsstreng og intet andet i brødteksten end selve dokumentet; en brødtekst, der forsøger at angive en organisation eller en person på øverste niveau, afvises, før noget overhovedet læses.
En vellykket import svarer med 201 Created. I forkortet form ser brødteksten således ud:
{
"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 tæller de organisationer på installationen, der nu har licensen. tenants_without_organisation tæller organisationer, som licensen navngiver, men som denne installation ikke indeholder.
Når importen afvises
En afvist import ændrer intet: der skrives ingen rækker, og den gældende licens – hvis der er en – forbliver uændret. Installationens revisionslog registrerer ethvert forsøg, også de afviste.
| Kode | Status | Hvad det betyder | Hvad du skal gøre |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | En af Adverants to signaturer mangler eller kan ikke verificeres; filen er blevet ændret efter signering | Bed Adverant om filen igen; rediger den ikke |
LICENCE_FORMAT_INVALID |
422 | Filen er ikke en licens, som denne udgivelse kan læse | Send filen nøjagtigt, som Adverant har leveret den |
LICENCE_ROOT_UNKNOWN |
422 | Den er signeret med en nøgle, som denne installation ikke har tillid til | Bed om en licens, der er signeret til denne udgivelses rodcertifikater, eller opgrader |
LICENCE_MATRIX_MISMATCH |
422 | Den er udarbejdet op imod en udgavematrix, som denne udgivelse ikke kan læse, eller tildeler en gruppe, som denne udgivelse ikke kender | Opgrader, eller bed om en licens, der er udarbejdet til denne udgivelse |
LICENCE_OTHER_INSTALLATION |
409 | Den blev udstedt til en anden installation | Bed om en licens udstedt til denne installations identitet |
TRANSITION_NOT_PERMITTED |
409 | En licens med dette id er allerede blevet importeret; hver licens kan kun importeres én gang | Bed Adverant om en ny licens, hvis vilkårene skal ændres |
LICENCE_REVOKED |
403 | Adverant har trukket denne licens tilbage | Bed Adverant om en ny |
LICENCE_LOCKED |
403 | Licensperioden er ikke begyndt endnu; Community-basisniveauet gælder indtil da | Importer den igen på eller efter dens første gyldighedsdag |
RECORD_NOT_FOUND |
404 | Installationen er endnu ikke blevet deklareret, så den har ingen identitet at kontrollere op imod | Fuldfør trinnet for den første administrator (kapitel 2.12, Den første kørsel), og importer derefter |
VALIDATION_FAILED |
400 | Brødteksten kunne ikke læses eller var over 1 MiB, eller der blev sendt en forespørgselsstreng | Send filen som hele brødteksten uden forespørgselsstreng |
Endnu en kode kan blive returneret ved en vellykket import som en meddelelse snarere end en afvisning: LICENCE_CLOCK_BEHIND_FLOOR betyder, at installationens ur viser et tidligere tidspunkt end det seneste tidspunkt, den allerede har registreret, så licensen aflæses ud fra dette senere tidspunkt. At stille uret tilbage genopliver aldrig en udløbet licens. Kun et tidsnulstillingstoken, som Adverant signerer til installationen, kan sænke denne tidsgrænse.
Opgradering fra Community til Enterprise på stedet
Sådan gjorde vi hos Harrow. Intet geninstalleres, og intet migreres: det er den samme installation med den samme identitet og de samme data, hvor blot mere af den er aktiveret. Installationsnavnet og de nøglebetroede forbliver præcis, som de var; ved en opgradering kontrollerer custody-hooket blot, at nøglelageret allerede er initialiseret, og foretager sig ikke yderligere.
Læg pull-tokenet på hver node, og genstart container-runtimen der.
Hent Enterprise-chartet fra Downloads, og verificer det samt dets images som beskrevet ovenfor.
Ændr de to værdier i din eksisterende værdifil:
edition: enterpriseogenterprise.enabled: true. Ændr intet andet.Kør preflight-kontrollen med den nye fil.
nexusctl preflight --context harrow-prod --values harrow-values.yamlOpgrader udgivelsen til Enterprise-chartet, igen uden
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mVed en opgradering kører hooks før de nye pods rulles ud, og hver migrering anvender kun de filer, den ikke har anvendt før. De genererede hemmeligheder læses tilbage fra installationen og bevares. Helm afslutter med:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Vent på alle workloads, præcis som i kapitel 2.6, Installation af Community på Kubernetes, trin 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImporter licensen på en af de tre måder, der er beskrevet ovenfor.
I konsollen skal du åbne This installation, derefter Licence og så Move to Enterprise. Siden læser licensen og viser, hvad der vil blive hentet, og hvad der vil blive ændret, før der sker noget. Den optæller også organisationens brugere og indhold og markerer begge dele som bevaret. Tryk på Fetch and switch on. Hver del kontrolleres mod Adverants udgivelsesnøgle, før den tages i brug, og funktionsgrupperne aktiveres én ad gangen.
Vores vedligeholdelsesvindue var på en time; selve arbejdet tog omkring tyve minutter, hvoraf det meste var ventetid på databaseskemaet, mens hooks kørte. Pilotprojektets brugere loggede ind næste morgen på det samme arbejdsområde, hvor Enterprise-områderne i menuen ikke længere var nedtonede.
Efter importen
Licenssiden under This installation viser hver funktionsgruppe i licensen med tilhørende pladser og gyldighedsperiode. Den angiver også, hvordan hver del leveres, f.eks. kompileret og licenseret for en Enterprise-gruppe eller open source for Community-basisniveauet. Grupper uden for licensen forbliver på listen, men er nedtonede. Administratorer kan indsnævre, hvad en gruppe dækker internt i organisationen; ingen andre end Adverant kan udvide, hvad en licens tildeler.
Licensens status genberegnes ud fra dokumentet og datoen ved hver aflæsning, så udløb sker uden et planlagt job. Alle på installationen ser den samme meddelelse i konsollen, når udløbsdatoen nærmer sig: LICENCE_ENDS_SOON fra 30 dage før udløb og derefter LICENCE_IN_GRACE i henstandsperioden. Medlemmer ser meddelelsen og datoerne; kun installationsadministratorer ser selve licensen. Kapitel 2.13, Licenser, dækker fornyelse og udløbsforløbet.
Hvis dette fejler
| Hvad du ser | Årsag | Hvad du skal gøre |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Kun en af de to nøgler blev ændret | Ændr begge |
files/images.lock.json is the community lock; this install is edition enterprise |
Community-chartet blev brugt | Brug Enterprise-chartet fra Downloads |
image ... is a enterprise image; a community install takes only community images |
Et Enterprise-imagenavn nåede frem til en Community-gengivelse | Kontroller edition og chart-mappen |
ImagePullBackOff på et Enterprise-image efter opgraderingen |
En node har intet pull-token, eller dens token er ikke længere gyldigt | Kontroller registries.yaml på den pågældende node, eller opret et nyt token |
| En afvisningskode for licensen | Se afvisningstabellen ovenfor | Følg anvisningen i den pågældende række; intet blev ændret |
Når licenssiden viser Enterprise og de grupper, du forventede, er installationen licenseret. Næste trin er den første kørsel i kapitel 2.12, Den første kørsel, hvis du endnu ikke har tilknyttet installationen. Hvis du har gjort det, mangler assistenten stadig organisationens egne modelnøgler til kunstig intelligens (AI), før den kan svare nogen. Kapitel 2.14, AI-udbydere og -modeller, viser, hvordan man forbinder dem.




