Version 1.0.0-alpha.1senaste
Kapitel 2.7
Installera Enterprise och tillämpa en licens
Vad som ändras när ni installerar Enterprise-utgåvan, hur ni begär en licens från ert Adverant-konto, de tre sätten att importera den med alla avvisningskoder och hur Harrow Port Authority flyttade sin Community-pilot till Enterprise på plats utan att förlora något.
Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

En Enterprise-installation har två halvor, och de anländer längs olika vägar. Enterprise-avbildningarna kommer med Enterprise-diagrammet och hämtas med en hämtningstoken. Licensen kommer som en signerad fil från ditt Adverant-konto, och du importerar den i den körande installationen. Ingendera halvan fungerar utan den andra: avbildningar utan licens körs på Community-golvnivå, och en licens utan Enterprise-avbildningar har ingenting att slå på.
På Harrow Port Authority gjorde vi det i den ordningen, sex veckor efter Community-piloten i kapitel 2.6, Installera Community på Kubernetes. Uppgraderingen till Enterprise-diagrammet tog ett underhållsfönster; licensimporten tog två minuter. Detta kapitel täcker båda halvorna. Det börjar med en nyinstallation och slutar med att en befintlig Community-installation flyttas på plats.
Vad som skiljer sig från Community
Två värden och diagrammet som läser dem.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueAllt annat i värdefilen förblir exakt som det var, framför allt installationsnamnet och förvaltarna. De två nycklarna måste stämma överens, och diagrammet nekar edition: enterprise med enterprise.enabled: false, eller det omvända.
Utgåvan måste också stämma överens med diagrammets avbildningslås. Varje diagrampaket bär låset för en utgåva, och Enterprise-låset listar Community-avbildningarna plus Enterprise-byggena. Om du pekar en Enterprise-värdefil mot Community-diagrammet stoppar renderingen med files/images.lock.json is the community lock; this install is edition enterprise. En Enterprise-installation behöver alltså Enterprise-diagrammet.
Enterprise-diagrammet och paketet finns på sidan Downloads i ditt Adverant-konto, som följer din licens. Diagramfilen har samma namn som den för Community, nexus-1.0.0-alpha.1.tgz, så förvara de två i separata mappar. Kontrollera den exakt så som kapitel 2.4, Hämta och verifiera en utgåva, beskriver, mot den utgåvenyckel vars fingeravtryck du kontrollerade:
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 sedan signaturloopen från kapitel 2.4, Hämta och verifiera en utgåva, över enterprise/nexus/files/images.lock.json. Den omfattar såväl Enterprise-avbildningarna som de delade.
Pull-token
Community-avbildningar är publika. Enterprise-avbildningar behöver en hämtningstoken från sidan Pull tokens and install commands i ditt konto, konfigurerad för dina noders containerkörmiljö så som kapitel 2.4, Hämta och verifiera en utgåva, steg 3, visar. På k3s är det en configs-post för registry.adverant.ai i /etc/rancher/k3s/registries.yaml på varje nod.
Skapa en token per kluster och ge den ett slutdatum som du lägger märke till. När en token går ut fortsätter körande poddar att köra, men en podd som omplaceras till en nod som inte har avbildningen än kan inte hämta den. Vi lägger slutdatumet för token i samma kalender som certifikatets.
En ny Enterprise-installation
Om du installerar Enterprise från början ska du följa kapitel 2.6, Installera Community på Kubernetes, steg för steg, med tre skillnader:
Lägg in hämtningstoken på varje nod före steg 6.
Använd Enterprise-värdena (de två nycklarna ovan) i steg 4.
I steg 6 installerar du från den Enterprise-diagramfil som du laddade ner:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Allt efter installationskommandot är detsamma som i kapitel 2.6, Installera Community på Kubernetes, och det gäller även regeln om --wait: använd den inte. Om du installerar med nexusctl i stället lägger du till --edition enterprise i kommandot:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseNär varje arbetslast är redo går du igenom den första körningen i kapitel 2.12, Den första körningen. Licensen är en av de sex saker som konsolen listar innan någon loggar in. Tills den har importerats körs installationen på Community-golvnivå och varje Enterprise-område visas utgråat med ett lås.
Begära licensen
En licens från Adverant utfärdas för en enskild installations identitet, den som nyckellagret skapade under keys.installationName vid installationen. Kontot behöver därför veta vilken installation du menar innan det kan utfärda en.
- Logga in på ditt Adverant-konto på
https://account.adverant.ai. - På installationen öppnar du This installation och sedan Licence. Där visas en engångskod och installationens fingeravtryck.
- I ditt konto öppnar du Claim a deployment och anger koden. Jämför sedan det fingeravtryck som kontot tog emot med det som installationen visar, grupp för grupp; varje grupp måste stämma överens.
- Tryck på knappen för att göra anspråk. Installationen läggs till under Deployments i ditt konto, med sin version och sin licensstatus.
- Adverant utfärdar licensen för den installationen. Ladda ner filen från ditt konto; den är namngiven efter sitt licens-id,
<licence-id>.json.
En anspråkskod fungerar en gång och under en kort tid. Om den går ut nekar kontot den med CLAIM_CODE_EXPIRED, och installationen visar en ny.
Två andra vägar finns, och kapitel 2.13, Licenser, täcker båda i sin helhet. Enheter och edge-kit har ingen skärm som kan visa en kod, så man gör anspråk på dem med en anspråksnyckel som är tryckt på lådan, inskriven under Enter a claim key eller inläst från tillverkarens orderfil. En installation utan väg ut använder Offline exchange: den skapar en signerad fil för licensbegäran, du tar med den till ditt konto och tar med licensfilen tillbaka. En gång om året skapar den en signerad användningsredovisning på samma sätt. Varje fil i utbytet är signerad, så en fil som har ändrats på vägen nekas, med LICENCE_REQUEST_SIGNATURE_INVALID för en begäran och USAGE_FILE_SIGNATURE_INVALID för en användningsfil.
Vad licensfilen innehåller
Licensen är ett JSON-dokument i formatet nexus-licence/v1, signerat två gånger av Adverant med två oberoende nycklar. Du behöver inte läsa det, men det är bra att veta vad som finns i det när någon frågar vad ni har köpt.
| Fält | Vad det anger |
|---|---|
licence_id |
Licensens eget id, ett UUID (universally unique identifier) med gemener |
type |
alpha, evaluation eller commercial |
licensee |
Organisationens namn och kund-id hos Adverant |
scope |
Den installation den gäller för, samt eventuella organisationer som ett tillstånd namnger |
edition |
enterprise |
grants |
De funktionsgrupper den låser upp, var och en för hela installationen eller för namngivna organisationer |
add_ons och domain_packs |
Funktioner som licensieras separat; paketet Logistics and maritime är ett exempel |
metric |
Hur licensen räknas, named-seat, per-core eller per-environment, samt antalet |
term |
starts_on, ends_on samt antalet dagar med varning och respit |
matrix |
Den version av utgåvematrisen som den skrevs mot |
signatures |
Adverants två signaturer |
En utvärderingslicens gäller i högst 30 dagar, för högst fem namngivna personer, utan respit. En kommersiell licens varnar 30 dagar innan den går ut och ger sedan 30 dagars respit som standard. Vad som händer vid varje steg på den trappan finns i kapitel 2.13, Licenser.
Signaturerna täcker dokumentet så som Adverant skapade det. Skicka det exakt som du tog emot det; öppna det inte i en redigerare som kan tänkas snygga till det.
Importera licensen
Endast en installationsadministratör kan importera en licens: en ägare eller administratör för hela den organisation som äger installationen, medan personen är inloggad på den. En fullständig plattformsadministratör kan också importera en. Licensen är aldrig ett diagramvärde eller en fil som monteras i en podd. Den går in i inloggningstjänsten, nexus-auth, som kontrollerar den offline mot de tillitsrötter som är inbyggda i dess egen avbildning och registrerar den i en enda transaktion. Du kan importera den på tre sätt, och de slutar alla på samma ställe.
I konsolen
Under den första körningen öppnar du Six things before anyone signs in och sedan Licence. Sidan Import the licence tar emot filen: släpp den på sidan eller välj den. Sidan kontrollerar den offline på själva installationen och listar sedan de funktionsgrupper den öppnar, tillsammans med hur var och en är skyddad och fram till när. Grupper som licensen inte omfattar förblir listade, men utgråade.
Senare utgörs samma import av knappen Import a new licence på installationens licenssida. När en licens har gått ut erbjuder den begränsade licenssidan Import a renewed licence.
Med nexusctl
nexusctl licence import <licence-id>.jsonnexusctl skickar filen, oförändrad, till installationens importväg som en installationsadministratör, och rapporterar licensens status eller nekandekoden från tabellen nedan.
Via API:et
Importvägen är en del av inloggningstjänstens applikationsprogrammeringsgränssnitt (API), på din hosts.auth-adress. Innehållet (body) är licensdokumentet, 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> är åtkomsttoken för en inloggad installationsadministratör. Använd --data-binary, aldrig -d, som tar bort radbrytningar och därmed ändrar de byte du skickar. Vägen tar ingen frågesträng och ingenting i innehållet utöver dokumentet; ett innehåll som försöker namnge en organisation eller en person på den översta nivån nekas innan någonting läses.
En godkänd import svarar med 201 Created. Nedkortat ser innehållet ut så här:
{
"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 räknar de organisationer på installationen som nu innehar licensen. tenants_without_organisation räknar organisationer som licensen namnger men som denna installation inte rymmer.
När importen nekas
En nekad import ändrar ingenting: ingen rad skrivs, och den gällande licensen, om det finns någon, förblir som den var. Installationens granskningslogg registrerar varje försök, inklusive de nekade.
| Kod | Status | Vad det innebär | Vad du ska göra |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | En av Adverants två signaturer saknas eller kan inte verifieras; filen ändrades efter signering | Be Adverant om filen igen; redigera den inte |
LICENCE_FORMAT_INVALID |
422 | Filen är inte en licens som denna utgåva kan läsa | Skicka filen exakt så som Adverant gav den |
LICENCE_ROOT_UNKNOWN |
422 | Den är signerad med en nyckel som denna installation inte litar på | Be om en licens som är signerad för denna utgåvas tillitsrötter, eller uppgradera |
LICENCE_MATRIX_MISMATCH |
422 | Den är skriven mot en utgåvematris som denna utgåva inte läser, eller beviljar en grupp som denna utgåva inte känner till | Uppgradera, eller be om en licens som är skriven mot denna utgåva |
LICENCE_OTHER_INSTALLATION |
409 | Den utfärdades för en annan installation | Be om en licens som är utfärdad för denna installations identitet |
TRANSITION_NOT_PERMITTED |
409 | En licens med detta id har redan importerats; var och en importeras en gång | Be Adverant om en ny licens om villkoren måste ändras |
LICENCE_REVOKED |
403 | Adverant har återkallat denna licens | Be Adverant om en ny |
LICENCE_LOCKED |
403 | Licensens giltighetstid har inte börjat; Community-golvnivån gäller fram till dess | Importera den igen på eller efter dess första dag |
RECORD_NOT_FOUND |
404 | Installationen har inte deklarerats än, så den har ingen identitet att kontrollera mot | Slutför den första administratörens steg (kapitel 2.12, Den första körningen) och importera sedan |
VALIDATION_FAILED |
400 | Innehållet var oläsligt eller över 1 MiB, eller så skickades en frågesträng | Skicka filen som hela innehållet, utan frågesträng |
Ytterligare en kod kan returneras vid en lyckad import, som ett meddelande snarare än ett nekande: LICENCE_CLOCK_BEHIND_FLOOR betyder att installationens klocka visar en tidigare tidpunkt än den senaste tid som den redan har sett, så licensen läses vid den senare tidpunkten. Att ställa tillbaka en klocka återupplivar aldrig en utgången licens. Endast en tidsåterställningstoken som Adverant signerar för installationen sänker golvet.
Flytta Community till Enterprise på plats
Detta är vad vi gjorde på Harrow. Ingenting installeras om och ingenting migreras: det är samma installation, med samma identitet och samma data, och mer av den är påslaget. Installationsnamnet och förvaltarna förblir exakt som de var; vid en uppgradering kontrollerar förvaltningskroken att nyckellagret redan är initierat och gör ingenting annat.
Lägg in hämtningstoken på varje nod och starta om containerkörmiljön där.
Hämta Enterprise-diagrammet från Downloads och verifiera det och dess avbildningar enligt ovan.
Ändra de två värdena i din befintliga värdefil:
edition: enterpriseochenterprise.enabled: true. Ändra ingenting annat.Kör förkontrollen (preflight) med den nya filen.
nexusctl preflight --context harrow-prod --values harrow-values.yamlUppgradera utgåvan till Enterprise-diagrammet, återigen utan
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mVid en uppgradering körs krokarna innan de nya poddarna rullas ut, och varje migrering tillämpar endast de filer som den inte har tillämpat tidigare. De genererade hemligheterna läses tillbaka från installationen och behålls. Helm avslutar med:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Vänta på arbetslasterna, exakt som i kapitel 2.6, Installera Community på Kubernetes, steg 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportera licensen, på något av de tre sätten ovan.
I konsolen öppnar du This installation, sedan Licence och därefter Move to Enterprise. Sidan läser licensen och visar vad som kommer att hämtas och vad som kommer att ändras innan någonting sker. Den räknar också organisationens personer och innehåll och markerar var och en som behållen. Tryck på Fetch and switch on. Varje del kontrolleras mot Adverants utgåvenyckel innan den används, och funktionsgrupperna slås på en i taget.
Vårt fönster var en timme; arbetet inom det tog ungefär tjugo minuter, varav det mesta var väntetiden för schemat medan krokarna kördes. Pilotens deltagare loggade in nästa morgon till samma arbetsyta, där Enterprise-områdena i menyn inte längre var utgråade.
Efter importen
Licenssidan under This installation listar varje funktionsgrupp i licensen med dess platser och giltighetstid. Den anger också hur varje del levereras, till exempel kompilerad och licensierad för en Enterprise-grupp, eller öppen källkod för Community-golvnivån. Grupper utanför licensen förblir listade, men utgråade. Administratörer kan begränsa vad en grupp når inom organisationen; ingen utom Adverant kan utvidga vad en licens beviljar.
Licensens status räknas ut på nytt från dokumentet och datumet vid varje läsning, så utgång sker utan ett schemalagt jobb. Alla på installationen ser samma meddelande i konsolen när slutet närmar sig: LICENCE_ENDS_SOON från 30 dagar före slutet, sedan LICENCE_IN_GRACE under respitperioden. Medlemmar ser meddelandet och datumen; endast installationsadministratörer ser själva licensen. Kapitel 2.13, Licenser, täcker förnyelse och utgångstrappan.
Om detta misslyckas
| Vad ni ser | Orsak | Vad du ska göra |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Endast en av de två nycklarna ändrades | Ändra båda |
files/images.lock.json is the community lock; this install is edition enterprise |
Community-diagrammet användes | Använd Enterprise-diagrammet från Downloads |
image ... is a enterprise image; a community install takes only community images |
Ett Enterprise-avbildningsnamn nådde en Community-rendering | Kontrollera edition och diagrammappen |
ImagePullBackOff på en Enterprise-avbildning efter uppgraderingen |
En nod har ingen hämtningstoken, eller så är dess token inte längre giltig | Kontrollera registries.yaml på den noden, eller skapa en ny token |
| En nekandekod för licens | Se nekandetabellen ovan | Följ dess rad; ingenting ändrades |
När licenssidan visar Enterprise och de grupper du förväntade dig är installationen licensierad. Nästa anhalt är den första körningen i kapitel 2.12, Den första körningen, om du inte har gjort anspråk på installationen än. Om du har gjort det behöver assistenten fortfarande organisationens egna nycklar till modeller för artificiell intelligens (AI) innan den kan svara någon. Kapitel 2.14, AI-leverantörer och modeller, visar hur du ansluter dem.




