Log indBook en briefing

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

17 minutters læsetid

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.

To parallelle spor, der fører ind i én boks til højre med teksten "Enterprise installation". Øverste spor: "Adverant account: Downloads" fører til "Enterprise chart and its images lock" og derefter til "helm install or helm upgrade, edition: enterprise", hvortil en sideboks med teksten "pull token on every node" er forbundet. Nederste spor: "Adverant account: Deployments" fører til "signed licence file" og derefter til "import into the running installation". Begge spor mødes ved boksen til højre. Under den står der i en billedtekst: "images without a licence run at the Community floor".
De to halvdele af en Enterprise-installation, og hvor de hver især kommer fra.

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: true

Alt 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.json
1.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:

  1. Læg pull-tokenet på hver node før trin 6.

  2. Brug Enterprise-værdierne (de to nøgler ovenfor) i trin 4.

  3. 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 enterprise

Nå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.

  1. Log ind på din Adverant-konto på https://account.adverant.ai.
  2. Åbn This installation og derefter Licence på installationen. Her vises en engangskode og installationens fingeraftryk.
  3. Å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.
  4. Tryk på tilknytningsknappen. Installationen føjes til Deployments på din konto med dens versions- og licensstatus.
  5. 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.

Tilknyt en udrulning
Tilknyt en udrulning
Tilknytning af en udrulning på Adverant-kontoen. Engangskoden indtastes først, hvorefter fingeraftrykket sammenlignes i grupper af fire, så ingen kan tilknytte en installation, de ikke står foran.

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.

Offline-udveksling
Offline-udveksling
Offline-udvekslingen på Adverant-kontoen. Signerede filer overføres manuelt i begge retninger, og en fil, der er ændret undervejs, afvises ved navn.

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.

Importer licensen
Importer licensen
Import af licensen i konsollen. Filen kontrolleres på selve installationen; siden viser, hvad den låser op for opdelt efter funktionsgruppe, og en fil, der ikke består signaturkontrollen, behandles som fraværende med den tilhørende fejlkode.

Med nexusctl

nexusctl licence import <licence-id>.json

nexusctl 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.

  1. Læg pull-tokenet på hver node, og genstart container-runtimen der.

  2. Hent Enterprise-chartet fra Downloads, og verificer det samt dets images som beskrevet ovenfor.

  3. Ændr de to værdier i din eksisterende værdifil: edition: enterprise og enterprise.enabled: true. Ændr intet andet.

  4. Kør preflight-kontrollen med den nye fil.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Opgrader 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 45m

    Ved 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: 2
  6. Vent 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=900s
  7. Importer licensen på en af de tre måder, der er beskrevet ovenfor.

  8. 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.

Fra Community til Enterprise
Fra Community til Enterprise
Overflytning af en Community-installation til Enterprise. Siden bekræfter, at licensen er ægte, og viser, hvad der vil blive hentet, før noget hentes; organisationens brugere og filer er markeret som bevaret.

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.

Licens og hvad den låser op for
Licens og hvad den låser op for
Dette er licenssiden for en Enterprise-installation. Tallene øverst angiver pladser og gyldighedsperiode; under dem vises hver funktionsgruppe med angivelse af, hvordan den er beskyttet, og grupperne uden for licensen forbliver nedtonede.

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.