Versjon 1.0.0-alpha.1nyeste
Kapittel 2.7
Installere Enterprise og legge inn en lisens
Hva som endres når du installerer Enterprise-utgaven, hvordan du ber om en lisens fra Adverant-kontoen din, de tre måtene å importere den på med hver avvisningskode, og hvordan Harrow Port Authority oppgraderte sin Community-pilot til Enterprise på stedet uten å miste noe.
Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

En Enterprise-installasjon består av to halvdeler, og de kommer ad ulike veier. Enterprise-avbildningene følger med Enterprise-chartet og hentes med et hentetoken (pull token). Lisensen kommer som en signert fil fra Adverant-kontoen din, og du importerer den inn i den kjørende installasjonen. Ingen av halvdelene fungerer uten den andre: avbildninger uten lisens kjører på Community-grunnivået, og en lisens uten Enterprise-avbildninger har ingenting å slå på.
Hos Harrow Port Authority gjorde vi det i den rekkefølgen, seks uker etter Community-piloten i kapittel 2.6, Installere Community på Kubernetes. Oppgraderingen til Enterprise-chartet tok ett vedlikeholdsvindu; lisensimporten tok to minutter. Dette kapittelet dekker begge halvdelene. Det starter med en ny installasjon og avsluttes med at en eksisterende Community-installasjon oppgraderes på stedet.
Hva som skiller seg fra Community
To verdier, og chartet som leser dem.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueAlt annet i verdifilen forblir nøyaktig som det var, fremfor alt installasjonsnavnet og forvalterne. De to nøklene må samsvare, og chartet avviser edition: enterprise med enterprise.enabled: false, eller omvendt.
Utgaven må også samsvare med chartets avbildningslås (images lock). Hver chart-pakke inneholder låsen for én utgave, og Enterprise-låsen lister opp Community-avbildningene pluss Enterprise-byggene. Peker du en Enterprise-verdifil mot Community-chartet, stopper gjengivelsen med files/images.lock.json is the community lock; this install is edition enterprise. Enterprise-installasjonen trenger altså Enterprise-chartet.
Enterprise-chartet og -pakken ligger på siden Nedlastinger (Downloads) i Adverant-kontoen din, som følger lisensen din. Chart-filen har samme navn som Community-filen, nexus-1.0.0-alpha.1.tgz, så hold de to i adskilte mapper. Kontroller den nøyaktig slik kapittel 2.4, Hente og verifisere en utgivelse, beskriver, mot utgivelsesnøkkelen hvis fingeravtrykk du kontrollerte:
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
Kjør deretter signaturløkken fra kapittel 2.4, Hente og verifisere en utgivelse, over enterprise/nexus/files/images.lock.json. Den dekker Enterprise-avbildningene så vel som de delte.
Pull-tokenet
Community-avbildninger er offentlige. Enterprise-avbildninger trenger et hentetoken fra siden Hentetokener og installasjonskommandoer (Pull tokens and install commands) i kontoen din, konfigurert for nodenes kjøremiljø for containere slik kapittel 2.4, Hente og verifisere en utgivelse, trinn 3, viser. På k3s er det en configs-oppføring for registry.adverant.ai i /etc/rancher/k3s/registries.yaml på hver node.
Lag ett token per klynge og gi det en sluttdato du legger merke til. Når et token utløper, fortsetter kjørende podder, men en pod som flyttes til en node som ikke har avbildningen ennå, kan ikke hente den. Vi legger tokenets sluttdato i samme kalender som sertifikatets.
En ny Enterprise-installasjon
Hvis du installerer Enterprise fra bunnen av, følger du kapittel 2.6, Installere Community på Kubernetes, trinn for trinn, med tre forskjeller:
Legg inn hentetokenet på hver node før trinn 6.
Bruk Enterprise-verdiene (de to nøklene ovenfor) i trinn 4.
I trinn 6 installerer du fra Enterprise-chart-filen du lastet ned:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Alt etter installasjonskommandoen er det samme som i kapittel 2.6, Installere Community på Kubernetes, og det gjelder også regelen om --wait: ikke bruk den. Hvis du installerer med nexusctl i stedet, legger du til --edition enterprise i kommandoen:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseNår hver arbeidsbelastning er klar, går du gjennom førstegangskjøringen i kapittel 2.12, Førstegangskjøringen. Lisensen er én av de seks tingene konsollen lister opp før noen logger inn. Inntil den er importert, kjører installasjonen på Community-grunnivået, og hvert Enterprise-område vises nedtonet med en lås.
Be om lisensen
En lisens fra Adverant utstedes for identiteten til én installasjon – den som nøkkellageret opprettet under keys.installationName ved installasjon. Kontoen må derfor vite hvilken installasjon du mener før den kan utstede en.
- Logg inn på Adverant-kontoen din på
https://account.adverant.ai. - På installasjonen åpner du Denne installasjonen (This installation), og deretter Lisens (Licence). Den viser en engangskode og installasjonens fingeravtrykk.
- I kontoen din åpner du Gjør krav på en utrulling (Claim a deployment) og skriver inn koden. Sammenlign deretter fingeravtrykket kontoen mottok med det installasjonen viser, gruppe for gruppe; hver gruppe må samsvare.
- Trykk på knappen for å gjøre krav. Installasjonen legges til under Utrullinger (Deployments) i kontoen din, med versjon og lisensstatus.
- Adverant utsteder lisensen for den installasjonen. Last ned filen fra kontoen din; den er oppkalt etter lisens-ID-en sin,
<licence-id>.json.
En kravkode fungerer én gang og i kort tid. Hvis den utløper, avviser kontoen den med CLAIM_CODE_EXPIRED, og installasjonen viser en ny.
Det finnes to andre veier, og kapittel 2.13, Lisenser, dekker begge i sin helhet. Appliancer og kantsett (edge kits) har ingen skjerm som kan vise en kode, så de kreves med en kravnøkkel som er trykt på esken, skrevet inn under Skriv inn en kravnøkkel (Enter a claim key) eller lest fra produsentens ordrefil. En installasjon uten forbindelse ut bruker Frakoblet utveksling (Offline exchange): den lager en signert lisensforespørselsfil, du tar den med til kontoen din, og du tar lisensfilen med tilbake. Én gang i året lager den en signert bruksoppgave på samme måte. Hver fil i utvekslingen er signert, så en fil som er endret underveis, blir avvist, med LICENCE_REQUEST_SIGNATURE_INVALID for en forespørsel og USAGE_FILE_SIGNATURE_INVALID for en bruksfil.
Hva lisensfilen inneholder
Lisensen er et JSON-dokument i formatet nexus-licence/v1, signert to ganger av Adverant med to uavhengige nøkler. Du trenger ikke å lese det, men det er nyttig å vite hva som står i det når noen spør hva dere har kjøpt.
| Felt | Hva det sier |
|---|---|
licence_id |
Lisensens egen ID, en UUID (universelt unik identifikator) med små bokstaver |
type |
alpha, evaluation eller commercial |
licensee |
Organisasjonens navn og Adverant-kunde-ID |
scope |
Installasjonen den gjelder for, og eventuelle organisasjoner en tildeling navngir |
edition |
enterprise |
grants |
Funksjonsgruppene den låser opp, hver for hele installasjonen eller for navngitte organisasjoner |
add_ons og domain_packs |
Kapasiteter som lisensieres separat; Logistikk- og maritim-pakken (Logistics and maritime pack) er én slik |
metric |
Hvordan lisensen telles, named-seat, per-core eller per-environment, og antallet |
term |
starts_on, ends_on, samt antall dager med varsling og henstand |
matrix |
Versjonen av utgavematrisen den ble skrevet mot |
signatures |
Adverants to signaturer |
En evalueringslisens varer i høyst 30 dager, for høyst fem navngitte personer, uten henstand. En kommersiell lisens varsler 30 dager før den utløper og gir deretter 30 dagers henstand som standard. Hva som skjer på hvert trinn på den stigen, står i kapittel 2.13, Lisenser.
Signaturene dekker dokumentet slik Adverant laget det. Send det nøyaktig slik du mottok det; ikke åpne det i et redigeringsprogram som kan rydde i det.
Importere lisensen
Kun en installasjonsadministrator kan importere en lisens: en eier eller administrator for hele organisasjonen som eier installasjonen, mens vedkommende er logget inn på den. En full plattformadministrator kan også importere en. Lisensen er aldri en chart-verdi eller en fil som er montert inn i en pod. Den går inn i innloggingstjenesten, nexus-auth, som kontrollerer den frakoblet mot tillitsrøttene som er innebygd i dens egen avbildning, og registrerer den i én transaksjon. Du kan importere den på tre måter, og alle ender på samme sted.
I konsollen
Under førstegangskjøringen åpner du Seks ting før noen logger inn (Six things before anyone signs in), og deretter Lisens (Licence). Siden Importer lisensen (Import the licence) tar imot filen: slipp den på siden, eller velg den. Siden kontrollerer den frakoblet på selve installasjonen, og lister deretter opp funksjonsgruppene den åpner, med hvordan hver av dem er beskyttet og frem til når. Grupper som lisensen ikke omfatter, blir stående på listen, nedtonet.
Senere gjøres den samme importen med knappen Importer en ny lisens (Import a new licence) på installasjonens lisensside. Når en lisens har utløpt, tilbyr den begrensede lisenssiden Importer en fornyet lisens (Import a renewed licence).
Med nexusctl
nexusctl licence import <licence-id>.jsonnexusctl sender filen, uendret, til installasjonens importrute som en installasjonsadministrator, og rapporterer lisensens status eller avvisningskoden fra tabellen nedenfor.
Gjennom API-et
Importruten er en del av innloggingstjenestens programmeringsgrensesnitt (API), på hosts.auth-adressen din. Meldingsteksten (body) er lisensdokumentet, 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 tilgangstokenet til en innlogget installasjonsadministrator. Bruk --data-binary, aldri -d, som fjerner linjeskift og dermed endrer bytene du sender. Ruten tar ingen spørrestreng og ingenting annet i meldingsteksten enn dokumentet; en meldingstekst som forsøker å navngi en organisasjon eller en person på øverste nivå, blir avvist før noe som helst leses.
En vellykket import svarer 201 Created. Forkortet ser meldingsteksten slik ut:
{
"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 teller organisasjonene på installasjonen som nå har lisensen. tenants_without_organisation teller organisasjoner som lisensen navngir, men som denne installasjonen ikke har.
Når importen blir avvist
En avvist import endrer ingenting: ingen rad skrives, og den gjeldende lisensen, hvis det finnes en, forblir som den var. Installasjonens revisjonslogg registrerer hvert forsøk, inkludert de avviste.
| Kode | Status | Hva det betyr | Hva du skal gjøre |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Én av Adverants to signaturer mangler eller kan ikke verifiseres; filen ble endret etter signering | Be Adverant om filen på nytt; ikke rediger den |
LICENCE_FORMAT_INVALID |
422 | Filen er ikke en lisens denne utgivelsen kan lese | Send filen nøyaktig slik Adverant ga den |
LICENCE_ROOT_UNKNOWN |
422 | Den er signert med en nøkkel denne installasjonen ikke stoler på | Be om en lisens signert for denne utgivelsens tillitsrøtter, eller oppgrader |
LICENCE_MATRIX_MISMATCH |
422 | Den er skrevet mot en utgavematrise denne utgivelsen ikke leser, eller tildeler en gruppe denne utgivelsen ikke kjenner | Oppgrader, eller be om en lisens skrevet mot denne utgivelsen |
LICENCE_OTHER_INSTALLATION |
409 | Den ble utstedt for en annen installasjon | Be om en lisens utstedt for denne installasjonens identitet |
TRANSITION_NOT_PERMITTED |
409 | En lisens med denne ID-en er allerede importert; hver lisens importeres én gang | Be Adverant om en ny lisens hvis vilkårene må endres |
LICENCE_REVOKED |
403 | Adverant har trukket tilbake denne lisensen | Be Adverant om en ny |
LICENCE_LOCKED |
403 | Lisensperioden har ikke startet; Community-grunnivået gjelder frem til da | Importer den på nytt på eller etter dens første dag |
RECORD_NOT_FOUND |
404 | Installasjonen er ikke deklarert ennå, så den har ingen identitet å kontrollere mot | Fullfør den første administratorens trinn (kapittel 2.12, Førstegangskjøringen), og importer deretter |
VALIDATION_FAILED |
400 | Meldingsteksten var uleselig eller over 1 MiB, eller en spørrestreng ble sendt | Send filen som hele meldingsteksten, uten spørring |
Én kode til kan returneres ved en vellykket import, som en merknad snarere enn en avvisning: LICENCE_CLOCK_BEHIND_FLOOR betyr at installasjonens klokke viser et tidligere tidspunkt enn det siste tidspunktet den allerede har sett, så lisensen leses ved dette senere tidspunktet. Å stille klokken tilbake gjenoppliver aldri en utløpt lisens. Kun et token for tilbakestilling av tid som Adverant signerer for installasjonen, senker gulvet.
Oppgradere Community til Enterprise på stedet
Dette er hva vi gjorde hos Harrow. Ingenting installeres på nytt og ingenting migreres: det er den samme installasjonen, med den samme identiteten og de samme dataene, og mer av den er slått på. Installasjonsnavnet og forvalterne forblir nøyaktig som de var; ved en oppgradering kontrollerer forvaltnings-hooken at nøkkellageret allerede er initialisert, og gjør ingenting annet.
Legg inn hentetokenet på hver node, og start kjøremiljøet for containere på nytt der.
Hent Enterprise-chartet fra Nedlastinger (Downloads) og verifiser det og tilhørende avbildninger som ovenfor.
Endre de to verdiene i den eksisterende verdifilen din:
edition: enterpriseogenterprise.enabled: true. Ikke endre noe annet.Kjør forhåndskontroll (preflight) med den nye filen.
nexusctl preflight --context harrow-prod --values harrow-values.yamlOppgrader utgivelsen til Enterprise-chartet, igjen uten
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mVed en oppgradering kjører hookene før de nye poddene rulles ut, og hver migrering bruker kun filene den ikke har brukt før. De genererte hemmelighetene leses tilbake fra installasjonen og beholdes. Helm avslutter med:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Vent på arbeidsbelastningene, nøyaktig som i kapittel 2.6, Installere Community på Kubernetes, trinn 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImporter lisensen på en av de tre måtene ovenfor.
I konsollen åpner du Denne installasjonen (This installation), deretter Lisens (Licence), og deretter Gå over til Enterprise (Move to Enterprise). Siden leser lisensen og viser hva som vil bli hentet og hva som vil endre seg før noe skjer. Den teller også organisasjonens personer og innhold og markerer hver av dem som beholdt. Trykk på Hent og slå på (Fetch and switch on). Hver del kontrolleres mot Adverants utgivelsesnøkkel før den tas i bruk, og funksjonsgruppene slås på én om gangen.
Vinduet vårt var på en time; arbeidet innenfor det tok rundt tjue minutter, det meste av tiden gikk med til å vente på skjemaet mens hookene kjørte. Pilotens deltakere logget inn neste morgen til det samme arbeidsområdet, der Enterprise-områdene i menyen ikke lenger var nedtonet.
Etter importen
Lisenssiden under Denne installasjonen (This installation) lister opp hver funksjonsgruppe i lisensen med antall plasser og periode. Den sier også hvordan hver del leveres, for eksempel kompilert og lisensiert for en Enterprise-gruppe, eller åpen kildekode for Community-grunnivået. Grupper utenfor lisensen blir stående på listen, nedtonet. Administratorer kan snevre inn hva en gruppe når innad i organisasjonen; ingen andre enn Adverant kan utvide hva en lisens gir tilgang til.
Lisensens status beregnes på nytt ut fra dokumentet og datoen ved hver avlesning, så utløp skjer uten en planlagt jobb. Alle på installasjonen ser det samme varselet i konsollen når slutten nærmer seg: LICENCE_ENDS_SOON fra 30 dager før slutten, deretter LICENCE_IN_GRACE under henstandsperioden. Medlemmer ser varselet og datoene; kun installasjonsadministratorer ser selve lisensen. Kapittel 2.13, Lisenser, dekker fornyelse og utløpsstigen.
Hvis dette feiler
| Hva dere ser | Årsak | Hva du skal gjøre |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Kun én av de to nøklene ble endret | Endre begge |
files/images.lock.json is the community lock; this install is edition enterprise |
Community-chartet ble brukt | Bruk Enterprise-chartet fra Nedlastinger (Downloads) |
image ... is a enterprise image; a community install takes only community images |
Et Enterprise-avbildningsnavn nådde en Community-gjengivelse | Kontroller edition og chart-mappen |
ImagePullBackOff på en Enterprise-avbildning etter oppgraderingen |
En node har ikke noe hentetoken, eller tokenet er ikke lenger gyldig | Kontroller registries.yaml på den noden, eller lag et nytt token |
| En avvisningskode for lisens | Se avvisningstabellen ovenfor | Følg tilhørende rad; ingenting ble endret |
Når lisenssiden viser Enterprise og gruppene du forventet, er installasjonen lisensiert. Neste stopp er førstegangskjøringen i kapittel 2.12, Førstegangskjøringen, hvis du ikke har gjort krav på installasjonen ennå. Hvis du har gjort det, trenger assistenten fortsatt organisasjonens egne modellnøkler for kunstig intelligens (KI) før den kan svare noen. Kapittel 2.14, KI-leverandører og -modeller, viser hvordan du kobler dem til.




