Verzia 1.0.0-alpha.1najnovšia
Kapitola 2.7
Inštalácia edície Enterprise a aplikovanie licencie
Čo sa zmení pri inštalácii edície Enterprise, ako požiadať o licenciu z účtu Adverant, tri spôsoby jej importu vrátane všetkých kódov odmietnutia a ako spoločnosť Harrow Port Authority previedla svoju pilotnú prevádzku edície Community priamo na edíciu Enterprise bez akejkoľvek straty dát.
Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

Inštalácia edície Enterprise má dve polovice a prichádzajú rôznymi cestami. Obrazy Enterprise prichádzajú s balíkom chart pre Enterprise, stiahnuté pomocou sťahovacieho tokenu (pull token). Licencia prichádza ako podpísaný súbor z vášho účtu Adverant a importujete ju do bežiacej inštalácie. Žiadna polovica nefunguje bez tej druhej: obrazy bez licencie bežia na základnej úrovni Community a licencia bez obrazov Enterprise nemá čo zapnúť.
V Harrow Port Authority sme to urobili v tomto poradí, šesť týždňov po pilotnej prevádzke Community v kapitole 2.6, Inštalácia edície Community v prostredí Kubernetes. Inovácia na balík chart pre Enterprise trvala jedno okno údržby; import licencie trval dve minúty. Táto kapitola pokrýva obe polovice. Začína čistou inštaláciou a končí presunom existujúcej inštalácie Community na mieste.
Rozdiely oproti edícii Community
Dve hodnoty a balík chart, ktorý ich číta.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueVšetko ostatné v súbore hodnôt zostáva presne tak, ako bolo, predovšetkým názov inštalácie a správcovia kľúčov (custodians). Tieto dva kľúče sa musia zhodovať a balík chart odmietne edition: enterprise s enterprise.enabled: false, alebo naopak.
Edícia sa musí zhodovať aj so zámkom obrazov balíka chart. Každý balík chart nesie zámok pre jednu edíciu a zámok Enterprise uvádza obrazy Community plus zostavy Enterprise. Ak nasmerujete súbor hodnôt Enterprise na balík chart pre Community, vykreslenie sa zastaví s files/images.lock.json is the community lock; this install is edition enterprise. Inštalácia Enterprise teda potrebuje balík chart pre Enterprise.
Balík chart a balík pre Enterprise sa nachádzajú na stránke Stiahnutia (Downloads) vo vašom účte Adverant, ktorá nadväzuje na vašu licenciu. Súbor balíka chart má rovnaký názov ako ten pre Community, nexus-1.0.0-alpha.1.tgz, preto ich uchovávajte v oddelených priečinkoch. Skontrolujte ho presne tak, ako opisuje kapitola 2.4, Získanie a overenie vydania, oproti kľúču vydania, ktorého odtlačok ste skontrolovali:
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
Potom spustite slučku overenia podpisov z kapitoly 2.4, Získanie a overenie vydania, nad súborom enterprise/nexus/files/images.lock.json. Pokrýva obrazy Enterprise, ako aj tie zdieľané.
Token na sťahovanie (pull token)
Obrazy Community sú verejné. Obrazy Enterprise potrebujú sťahovací token zo stránky Sťahovacie tokeny a inštalačné príkazy (Pull tokens and install commands) vo vašom účte, nakonfigurovaný pre behové prostredie kontajnerov vašich uzlov tak, ako ukazuje kapitola 2.4, Získanie a overenie vydania, krok 3. V systéme k3s je to položka configs pre registry.adverant.ai v súbore /etc/rancher/k3s/registries.yaml na každom uzle.
Vytvorte jeden token pre každý klaster a nastavte mu dátum ukončenia platnosti, ktorý si všimnete. Keď platnosť tokenu vyprší, bežiace pody pokračujú v činnosti, ale pod preplánovaný na uzol, ktorý ešte obraz nemá, ho nedokáže stiahnuť. Dátum ukončenia platnosti tokenu sme vložili do toho istého kalendára ako dátum certifikátu.
Čistá inštalácia edície Enterprise
Ak inštalujete Enterprise od začiatku, postupujte podľa kapitoly 2.6, Inštalácia edície Community v prostredí Kubernetes, krok za krokom, s tromi rozdielmi:
Vložte sťahovací token na každý uzol pred krokom 6.
Použite hodnoty Enterprise (dva kľúče uvedené vyššie) v kroku 4.
V kroku 6 inštalujte zo súboru balíka chart pre Enterprise, ktorý ste stiahli:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Všetko po inštalačnom príkaze je rovnaké ako v kapitole 2.6, Inštalácia edície Community v prostredí Kubernetes, a rovnaké je aj pravidlo o --wait: nepoužívajte ho. Ak namiesto toho inštalujete pomocou nexusctl, pridajte do príkazu --edition enterprise:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKeď je každá pracovná záťaž pripravená, prejdite prvým spustením v kapitole 2.12, Prvé spustenie. Licencia je jednou zo šiestich vecí, ktoré konzola uvádza predtým, ako sa ktokoľvek prihlási. Kým nie je importovaná, inštalácia beží na základnej úrovni Community a každá oblasť Enterprise je zobrazená sivo so zámkom.
Žiadosť o licenciu
Licencia od spoločnosti Adverant sa vydáva pre identitu jednej inštalácie, tú, ktorú úložisko kľúčov vytvorilo pod keys.installationName pri inštalácii. Účet teda potrebuje vedieť, ktorú inštaláciu máte na mysli, predtým ako ju môže vydať.
- Prihláste sa do svojho účtu Adverant na adrese
https://account.adverant.ai. - V inštalácii otvorte Táto inštalácia (This installation) a potom Licencia (Licence). Zobrazí sa jednorazový kód a odtlačok inštalácie.
- Vo svojom účte otvorte Priradiť nasadenie (Claim a deployment) a zadajte kód. Potom porovnajte odtlačok, ktorý účet prijal, s tým, ktorý zobrazuje inštalácia, skupinu po skupine; každá skupina sa musí zhodovať.
- Stlačte tlačidlo priradenia. Inštalácia sa pridá do časti Nasadenia (Deployments) vo vašom účte, so svojou verziou a stavom licencie.
- Adverant vydá licenciu pre túto inštaláciu. Stiahnite si súbor zo svojho účtu; je pomenovaný podľa identifikátora licencie,
<licence-id>.json.
Kód priradenia funguje raz a len krátky čas. Ak jeho platnosť vyprší, účet ho odmietne s CLAIM_CODE_EXPIRED a inštalácia zobrazí nový.
Existujú ešte dve ďalšie cesty a kapitola 2.13, Licencie, pokrýva obe v plnom rozsahu. Zariadenia (appliances) a súpravy pre okrajové siete (edge kits) nemajú obrazovku na zobrazenie kódu, takže sa priraďujú pomocou kľúča priradenia vytlačeného na škatuli, zadaného v časti Zadať kľúč priradenia (Enter a claim key) alebo načítaného zo súboru objednávky od výrobcu. Inštalácia bez spojenia s vonkajšou sieťou používa Offline výmenu (Offline exchange): vytvorí podpísaný súbor žiadosti o licenciu, vy ho prenesiete do svojho účtu a súbor licencie prinesiete späť. Raz ročne rovnakým spôsobom vytvorí podpísaný výkaz o používaní. Každý súbor vo výmene je podpísaný, takže súbor zmenený po ceste je odmietnutý, s LICENCE_REQUEST_SIGNATURE_INVALID pre žiadosť a USAGE_FILE_SIGNATURE_INVALID pre súbor o používaní.
Čo obsahuje súbor licencie
Licencia je dokument JSON vo formáte nexus-licence/v1, dvakrát podpísaný spoločnosťou Adverant dvoma nezávislými kľúčmi. Nemusíte ho čítať, ale pomáha vedieť, čo je v ňom, keď sa niekto opýta, čo ste kúpili.
| Pole | Čo uvádza |
|---|---|
licence_id |
Vlastný identifikátor licencie, UUID (univerzálne jedinečný identifikátor) malými písmenami |
type |
alpha, evaluation alebo commercial |
licensee |
Názov organizácie a identifikátor zákazníka Adverant |
scope |
Inštalácia, pre ktorú je určená, a prípadné organizácie, ktoré udelenie menuje |
edition |
enterprise |
grants |
Skupiny funkcií, ktoré odomyká, každú pre celú inštaláciu alebo pre menované organizácie |
add_ons a domain_packs |
Schopnosti licencované samostatne; jedným z nich je balík Logistika a námorná doprava (Logistics and maritime pack) |
metric |
Ako sa licencia počíta, named-seat, per-core alebo per-environment, a množstvo |
term |
starts_on, ends_on a dni upozornenia a odkladu |
matrix |
Verzia matice edícií, voči ktorej bola napísaná |
signatures |
Dva podpisy spoločnosti Adverant |
Skúšobná licencia trvá najviac 30 dní, pre najviac päť menovaných osôb, bez odkladu. Komerčná licencia upozorňuje 30 dní pred ukončením platnosti a potom štandardne poskytuje 30 dní odkladu. Čo sa deje na každom stupni tohto rebríčka, je uvedené v kapitole 2.13, Licencie.
Podpisy pokrývajú dokument tak, ako ho spoločnosť Adverant vytvorila. Odošlite ho presne tak, ako ste ho dostali; neotvárajte ho v editore, ktorý by ho mohol upraviť.
Import licencie
Licenciu môže importovať iba správca inštalácie: vlastník alebo správca celej organizácie, ktorá inštaláciu vlastní, kým je do nej prihlásený. Importovať ju môže aj plný správca platformy. Licencia nikdy nie je hodnotou balíka chart ani súborom pripojeným do podu. Ide do prihlasovacej služby nexus-auth, ktorá ju skontroluje offline voči koreňom dôveryhodnosti zabudovaným do jej vlastného obrazu a zaznamená ju v jednej transakcii. Môžete ju importovať tromi spôsobmi a všetky končia na tom istom mieste.
V konzole
Počas prvého spustenia otvorte Šesť vecí predtým, ako sa ktokoľvek prihlási (Six things before anyone signs in), a potom Licencia (Licence). Stránka Importovať licenciu (Import the licence) prijme súbor: presuňte ho na stránku alebo ho vyberte. Stránka ho skontroluje offline priamo v inštalácii, potom vypíše skupiny funkcií, ktoré otvára, s informáciou, ako je každá chránená a dokedy. Skupiny, ktoré licencia nezahŕňa, zostanú vypísané sivo.
Neskôr je ten istý import dostupný cez tlačidlo Importovať novú licenciu (Import a new licence) na stránke licencie danej inštalácie. Keď platnosť licencie vyprší, obmedzená stránka licencie ponúka Importovať obnovenú licenciu (Import a renewed licence).
Pomocou nexusctl
nexusctl licence import <licence-id>.jsonnexusctl odošle súbor nezmenený na importovaciu trasu inštalácie ako správca inštalácie a oznámi stav licencie alebo kód odmietnutia z tabuľky nižšie.
Cez API
Importovacia trasa je súčasťou aplikačného programovacieho rozhrania (API) prihlasovacej služby na vašej adrese hosts.auth. Telom je dokument licencie, bajt po bajte:
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> je prístupový token prihláseného správcu inštalácie. Použite --data-binary, nikdy nie -d, ktorý odstraňuje zalomenia riadkov, a tým mení odosielané bajty. Trasa neprijíma žiadny reťazec dopytu (query string) a v tele nič okrem dokumentu; telo, ktoré sa na najvyššej úrovni pokúša pomenovať organizáciu alebo osobu, je odmietnuté skôr, ako sa čokoľvek prečíta.
Úspešný import odpovie 201 Created. Skrátené telo vyzerá takto:
{
"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 počíta organizácie v inštalácii, ktoré teraz držia licenciu. tenants_without_organisation počíta organizácie, ktoré licencia menuje, ale táto inštalácia ich nemá.
Keď je import odmietnutý
Odmietnutý import nič nemení: nezapíše sa žiadny riadok a platná licencia, ak nejaká existuje, zostane tak, ako bola. Auditný záznam inštalácie zaznamenáva každý pokus, vrátane tých odmietnutých.
| Kód | Stav | Čo to znamená | Čo robiť |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Jeden z dvoch podpisov spoločnosti Adverant chýba alebo sa nepodarilo overiť jeho platnosť; súbor bol po podpísaní zmenený | Požiadajte spoločnosť Adverant o súbor znova; neupravujte ho |
LICENCE_FORMAT_INVALID |
422 | Súbor nie je licenciou, ktorú toto vydanie dokáže prečítať | Odošlite súbor presne tak, ako ho spoločnosť Adverant poskytla |
LICENCE_ROOT_UNKNOWN |
422 | Je podpísaný kľúčom, ktorému táto inštalácia nedôveruje | Požiadajte o licenciu podpísanú pre korene dôveryhodnosti tohto vydania, alebo vykonajte inováciu |
LICENCE_MATRIX_MISMATCH |
422 | Je napísaná voči matici edícií, ktorú toto vydanie nečíta, alebo udeľuje skupinu, ktorú toto vydanie nepozná | Vykonajte inováciu alebo požiadajte o licenciu napísanú pre toto vydanie |
LICENCE_OTHER_INSTALLATION |
409 | Bola vydaná pre inú inštaláciu | Požiadajte o licenciu vydanú pre identitu tejto inštalácie |
TRANSITION_NOT_PERMITTED |
409 | Licencia s týmto identifikátorom už bola importovaná; každá sa importuje raz | Ak sa musia zmeniť podmienky, požiadajte spoločnosť Adverant o novú licenciu |
LICENCE_REVOKED |
403 | Spoločnosť Adverant túto licenciu stiahla | Požiadajte spoločnosť Adverant o novú |
LICENCE_LOCKED |
403 | Obdobie platnosti licencie sa ešte nezačalo; dovtedy platí základná úroveň Community | Importujte ju znova v prvý deň jej platnosti alebo neskôr |
RECORD_NOT_FOUND |
404 | Inštalácia ešte nebola deklarovaná, takže nemá žiadnu identitu na porovnanie | Dokončite krok prvého správcu (kapitola 2.12, Prvé spustenie) a potom vykonajte import |
VALIDATION_FAILED |
400 | Telo bolo nečitateľné alebo malo viac ako 1 MiB, prípadne bol odoslaný reťazec dopytu | Odošlite súbor ako celé telo, bez dopytu |
Pri úspešnom importe sa môže vrátiť ešte jeden kód, skôr ako upozornenie než odmietnutie: LICENCE_CLOCK_BEHIND_FLOOR znamená, že hodiny inštalácie ukazujú skorší čas ako najneskorší čas, ktorý už zaznamenala, takže licencia sa číta k tomuto neskoršiemu času. Posunutie hodín späť nikdy neoživí licenciu po skončení platnosti. Iba token na resetovanie času, ktorý spoločnosť Adverant podpíše pre danú inštaláciu, zníži túto spodnú hranicu.
Priamy prechod z edície Community na Enterprise
Toto sme urobili v Harrow. Nič sa nepreinštalováva a nič sa nemigruje: je to tá istá inštalácia, s tou istou identitou a tými istými údajmi, len je z nej zapnuté viac. Názov inštalácie a správcovia kľúčov zostávajú presne tak, ako boli; pri inovácii prípojný bod správy kľúčov (custody hook) skontroluje, či je úložisko kľúčov už inicializované, a neurobí nič iné.
Vložte sťahovací token na každý uzol a reštartujte tam behové prostredie kontajnerov.
Stiahnite si balík chart pre Enterprise z časti Stiahnutia (Downloads) a overte ho spolu s jeho obrazmi tak, ako je uvedené vyššie.
Zmeňte dve hodnoty vo svojom existujúcom súbore hodnôt:
edition: enterpriseaenterprise.enabled: true. Nemeňte nič iné.Spustite predbežnú kontrolu (preflight) s novým súborom.
nexusctl preflight --context harrow-prod --values harrow-values.yamlInovujte vydanie na balík chart pre Enterprise, opäť bez
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mPri inovácii sa prípojné body (hooks) spustia pred nasadením nových podov a každá migrácia použije iba tie súbory, ktoré ešte predtým nepoužila. Vygenerované tajomstvá sa načítajú späť z inštalácie a zachovajú sa. Helm končí s:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Počkajte na pracovné záťaže, presne ako v kapitole 2.6, Inštalácia edície Community v prostredí Kubernetes, krok 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportujte licenciu ktorýmkoľvek z troch spôsobov uvedených vyššie.
V konzole otvorte Táto inštalácia (This installation), potom Licencia (Licence) a potom Prejsť na Enterprise (Move to Enterprise). Stránka prečíta licenciu a pred vykonaním akýchkoľvek krokov ukáže, čo sa stiahne a čo sa zmení. Taktiež spočíta ľudí a obsah organizácie a označí ich ako zachované. Stlačte Stiahnuť a zapnúť (Fetch and switch on). Každá časť sa pred použitím skontroluje voči kľúču vydania spoločnosti Adverant a skupiny funkcií sa zapínajú jedna po druhej.
Naše okno trvalo hodinu; práca v ňom trvala asi dvadsať minút, z čoho väčšinu tvorilo čakanie na schému počas behu prípojných bodov. Ľudia z pilotnej prevádzky sa nasledujúce ráno prihlásili do toho istého pracovného priestoru, pričom oblasti ponuky pre Enterprise už neboli sivé.
Po importe
Stránka licencie v časti Táto inštalácia vypisuje každú skupinu funkcií v licencii s jej počtom miest a obdobím platnosti. Uvádza tiež, ako je každá časť dodávaná, napríklad skompilovaná a licencovaná pre skupinu Enterprise, alebo s otvoreným zdrojovým kódom pre základnú úroveň Community. Skupiny mimo licencie zostávajú vypísané sivo. Správcovia môžu zúžiť dosah skupiny v rámci organizácie; nikto okrem spoločnosti Adverant nemôže rozšíriť to, čo licencia udeľuje.
Stav licencie sa pri každom čítaní znova vypočíta z dokumentu a dátumu, takže vypršanie platnosti nastane bez naplánovanej úlohy. Každý v inštalácii vidí v konzole rovnaké upozornenie, keď sa blíži koniec: LICENCE_ENDS_SOON od 30 dní pred koncom, potom LICENCE_IN_GRACE počas odkladného obdobia. Členovia vidia upozornenie a dátumy; samotnú licenciu vidia iba správcovia inštalácie. Kapitola 2.13, Licencie, pokrýva obnovenie a rebríček vypršania platnosti.
Ak tento postup zlyhá
| Čo vidíte | Príčina | Čo robiť |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Bol zmenený iba jeden z dvoch kľúčov | Zmeňte oba |
files/images.lock.json is the community lock; this install is edition enterprise |
Bol použitý balík chart pre Community | Použite balík chart pre Enterprise z časti Stiahnutia (Downloads) |
image ... is a enterprise image; a community install takes only community images |
Názov obrazu Enterprise sa dostal do vykresľovania Community | Skontrolujte edition a priečinok balíka chart |
ImagePullBackOff na obraze Enterprise po inovácii |
Uzol nemá sťahovací token alebo jeho token už nie je platný | Skontrolujte registries.yaml na danom uzle alebo vytvorte nový token |
| Kód odmietnutia licencie | Pozrite si tabuľku odmietnutí vyššie | Postupujte podľa príslušného riadka; nič sa nezmenilo |
Keď stránka licencie zobrazuje Enterprise a skupiny, ktoré ste očakávali, inštalácia je licencovaná. Ďalšou zastávkou je prvé spustenie v kapitole 2.12, Prvé spustenie, ak ste si inštaláciu ešte nepriradili. Ak ste tak už urobili, asistent stále potrebuje vlastné kľúče modelov umelej inteligencie (AI) organizácie predtým, ako dokáže komukoľvek odpovedať. Kapitola 2.14, Poskytovatelia a modely AI, ukazuje, ako ich pripojiť.




