Verze 1.0.0-alpha.1nejnovější
Kapitola 2.7
Instalace edice Enterprise a uplatnění licence
Co se změní při instalaci edice Enterprise, jak požádat o licenci ze svého účtu Adverant, tři způsoby jejího importu včetně všech kódů zamítnutí a jak organizace Harrow Port Authority převedla svůj pilotní provoz edice Community na Enterprise přímo na místě bez ztráty dat.
Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

Instalace edice Enterprise má dvě poloviny a každá přichází jinou cestou. Obrazy Enterprise přicházejí s chartem Enterprise a stahují se pomocí stahovacího tokenu (pull token). Licence přichází jako podepsaný soubor z vašeho účtu Adverant a importujete ji do běžící instalace. Žádná polovina nefunguje bez té druhé: obrazy bez licence běží na základní úrovni Community a licence bez obrazů Enterprise nemá co zapnout.
V Harrow Port Authority jsme to provedli v tomto pořadí, šest týdnů po pilotním provozu edice Community v kapitole 2.6, Instalace edice Community v prostředí Kubernetes. Upgrade na chart Enterprise zabral jedno servisní okno; import licence trval dvě minuty. Tato kapitola pokrývá obě poloviny. Začíná čistou instalací a končí převodem stávající instalace Community na místě.
Rozdíly oproti edici Community
Dvě hodnoty a chart, který je čte.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueVše ostatní v souboru hodnot zůstává přesně tak, jak bylo, především název instalace a správci klíčů (custodians). Tyto dva klíče si musí odpovídat a chart odmítne edition: enterprise s enterprise.enabled: false nebo naopak.
Edice musí také odpovídat zámku obrazů (images lock) daného chartu. Každý balíček chartu nese zámek pro jednu edici a zámek Enterprise obsahuje obrazy Community plus sestavení Enterprise. Pokud nasměrujete soubor hodnot Enterprise na chart Community, vykreslování se zastaví s chybou files/images.lock.json is the community lock; this install is edition enterprise. Instalace Enterprise tedy vyžaduje chart Enterprise.
Chart a balíček Enterprise najdete na stránce Ke stažení (Downloads) ve svém účtu Adverant, který je navázán na vaši licenci. Soubor chartu má stejný název jako ten pro Community, nexus-1.0.0-alpha.1.tgz, proto uchovávejte oba v oddělených složkách. Zkontrolujte jej přesně tak, jak popisuje kapitola 2.4, Získání a ověření vydání, oproti klíči vydání, jehož otisk jste zkontrolovali:
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
Poté spusťte smyčku ověření podpisů z kapitoly 2.4, Získání a ověření vydání, nad souborem enterprise/nexus/files/images.lock.json. Pokrývá jak obrazy Enterprise, tak ty sdílené.
Token pro stahování
Obrazy Community jsou veřejné. Obrazy Enterprise vyžadují stahovací token ze stránky Stahovací tokeny a instalační příkazy (Pull tokens and install commands) ve vašem účtu, nakonfigurovaný pro kontejnerový runtime vašich uzlů, jak ukazuje kapitola 2.4, Získání a ověření vydání, krok 3. V prostředí k3s je to položka configs pro registry.adverant.ai v souboru /etc/rancher/k3s/registries.yaml na každém uzlu.
Vytvořte jeden token pro každý cluster a nastavte mu datum vypršení platnosti, kterého si všimnete. Když platnost tokenu vyprší, běžící pody pokračují v činnosti, ale pod přeplánovaný na uzel, který daný obraz ještě nemá, jej nemůže stáhnout. Datum vypršení platnosti tokenu zapisujeme do stejného kalendáře jako u certifikátu.
Čistá instalace edice Enterprise
Pokud instalujete edici Enterprise od začátku, postupujte podle kapitoly 2.6, Instalace edice Community v prostředí Kubernetes, krok za krokem, se třemi rozdíly:
Před krokem 6 vložte stahovací token na každý uzel.
V kroku 4 použijte hodnoty Enterprise (dva klíče uvedené výše).
V kroku 6 proveďte instalaci ze souboru chartu Enterprise, který jste stáhli:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Vše po instalačním příkazu je stejné jako v kapitole 2.6, Instalace edice Community v prostředí Kubernetes, a totéž platí pro pravidlo ohledně --wait: nepoužívejte jej. Pokud místo toho instalujete pomocí nexusctl, přidejte do příkazu --edition enterprise:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseKdyž jsou všechny úlohy (workloads) připraveny, projděte prvním spuštěním v kapitole 2.12, První spuštění. Licence je jednou ze šesti věcí, které konzole vypíše předtím, než se kdokoli přihlásí. Dokud není importována, instalace běží na základní úrovni Community a každá oblast Enterprise je zobrazena zašedle se zámkem.
Žádost o licenci
Licence od společnosti Adverant se vydává pro identitu jedné instalace – tu, kterou úložiště klíčů vytvořilo pod keys.installationName při instalaci. Účet tedy potřebuje vědět, kterou instalaci máte na mysli, než může licenci vydat.
- Přihlaste se ke svému účtu Adverant na adrese
https://account.adverant.ai. - V instalaci otevřete Tuto instalaci (This installation) a poté Licence. Zobrazí se jednorázový kód a otisk instalace.
- Ve svém účtu otevřete Nárokovat nasazení (Claim a deployment) a zadejte kód. Poté porovnejte otisk, který účet obdržel, s tím, který zobrazuje instalace, skupinu po skupině; každá skupina se musí shodovat.
- Stiskněte tlačítko pro nárokování. Instalace se připojí k položce Nasazení (Deployments) ve vašem účtu, se svou verzí a stavem licence.
- Adverant vydá licenci pro danou instalaci. Stáhněte soubor ze svého účtu; je pojmenován podle ID své licence,
<licence-id>.json.
Kód pro nárokování funguje jednou a po krátkou dobu. Pokud vyprší, účet jej odmítne s chybou CLAIM_CODE_EXPIRED a instalace zobrazí nový.
Existují ještě dvě další cesty a kapitola 2.13, Licence, obě podrobně popisuje. Zařízení (appliances) a sady pro okraj sítě (edge kits) nemají obrazovku, na které by zobrazily kód, takže se nárokují pomocí klíče pro nárokování vytištěného na krabici, který se zadá na stránce Zadat klíč pro nárokování (Enter a claim key) nebo se načte ze souboru objednávky výrobce. Instalace bez připojení ven využívá Offline výměnu (Offline exchange): vytvoří podepsaný soubor žádosti o licenci, ten přenesete do svého účtu a soubor licence přinesete zpět. Jednou ročně stejným způsobem vytvoří podepsaný výkaz o využití. Každý soubor ve výměně je podepsán, takže soubor změněný po cestě je odmítnut, s kódem LICENCE_REQUEST_SIGNATURE_INVALID pro žádost a USAGE_FILE_SIGNATURE_INVALID pro soubor o využití.
Co obsahuje licenční soubor
Licence je dokument JSON ve formátu nexus-licence/v1, dvakrát podepsaný společností Adverant dvěma nezávislými klíči. Nemusíte jej číst, ale je užitečné vědět, co v něm je, když se někdo zeptá, co jste zakoupili.
| Pole | Co uvádí |
|---|---|
licence_id |
Vlastní ID licence, malými písmeny psané UUID (univerzálně jedinečný identifikátor) |
type |
alpha, evaluation nebo commercial |
licensee |
Název organizace a zákaznické ID u společnosti Adverant |
scope |
Instalace, pro kterou je určena, a případné organizace jmenované v udělení (grant) |
edition |
enterprise |
grants |
Skupiny funkcí, které odemyká, každou buď pro celou instalaci, nebo pro jmenované organizace |
add_ons a domain_packs |
Schopnosti licencované samostatně; jedním z nich je balíček Logistika a námořní doprava (Logistics and maritime pack) |
metric |
Jak se licence počítá, named-seat, per-core nebo per-environment, a množství |
term |
starts_on, ends_on a dny upozornění a odkladu (grace) |
matrix |
Verze matice edic, vůči které byla sepsána |
signatures |
Dva podpisy společnosti Adverant |
Zkušební licence trvá nejvýše 30 dní, pro nejvýše pět jmenovaných osob, bez odkladu. Komerční licence upozorňuje 30 dní před koncem platnosti a poté ve výchozím nastavení poskytuje 30 dní odkladu. Co se děje na jednotlivých stupních tohoto žebříčku, je uvedeno v kapitole 2.13, Licence.
Podpisy pokrývají dokument tak, jak jej společnost Adverant vytvořila. Odešlete jej přesně tak, jak jste jej obdrželi; neotevírejte jej v editoru, který by jej mohl upravit či naformátovat.
Import licence
Licenci může importovat pouze administrátor instalace: vlastník nebo administrátor celé organizace, která instalaci vlastní, když je do ní přihlášen. Importovat ji může také plný administrátor platformy. Licence nikdy není hodnotou chartu ani souborem připojeným do podu. Putuje do přihlašovací služby nexus-auth, která ji offline zkontroluje vůči kořenům důvěryhodnosti zabudovaným do jejího vlastního obrazu a zaznamená ji v jediné transakci. Importovat ji můžete třemi způsoby a všechny končí na stejném místě.
V konzoli
Během prvního spuštění otevřete Šest věcí předtím, než se kdokoli přihlásí (Six things before anyone signs in), a poté Licence. Stránka Importovat licenci (Import the licence) přijme soubor: přetáhněte jej na stránku nebo jej vyberte. Stránka jej offline zkontroluje přímo v samotné instalaci a poté vypíše skupiny funkcí, které otevírá, spolu s tím, jak je každá chráněna a do kdy. Skupiny, které licence nezahrnuje, zůstávají vypsané a zašedlé.
Později je tentýž import dostupný pod tlačítkem Importovat novou licenci na stránce licence dané instalace. Když platnost licence vypršela, omezená stránka licence nabízí tlačítko Importovat obnovenou licenci.
Pomocí nexusctl
nexusctl licence import <licence-id>.jsonPříkaz nexusctl odešle soubor beze změny na importní cestu instalace jako administrátor instalace a ohlásí stav licence nebo kód odmítnutí z tabulky níže.
Prostřednictvím API
Importní cesta je součástí aplikačního programovacího rozhraní (API) přihlašovací služby na vaší adrese hosts.auth. Tělem požadavku je dokument licence, bajt po bajtu:
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 přístupový token přihlášeného administrátora instalace. Použijte --data-binary, nikdy -d, který odstraňuje zalomení řádků a tím mění odesílané bajty. Cesta nepřijímá žádný řetězec dotazu (query string) a v těle nic jiného než samotný dokument; tělo, které se na své nejvyšší úrovni pokusí jmenovat organizaci nebo osobu, je odmítnuto dříve, než se cokoli přečte.
Úspěšný import odpoví 201 Created. Zkrácené tělo vypadá 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čítá organizace v instalaci, které nyní drží licenci. tenants_without_organisation počítá organizace jmenované v licenci, které tato instalace neobsahuje.
Když je import odmítnut
Odmítnutý import nic nemění: nezapíše se žádný řádek a platná licence, pokud nějaká existuje, zůstává tak, jak byla. Auditní protokol instalace zaznamenává každý pokus, včetně těch odmítnutých.
| Kód | Stav | Co to znamená | Co dělat |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Jeden ze dvou podpisů společnosti Adverant chybí nebo neprošel ověřením; soubor byl po podepsání změněn | Požádejte společnost Adverant o soubor znovu; neupravujte jej |
LICENCE_FORMAT_INVALID |
422 | Soubor není licencí, kterou toto vydání dokáže přečíst | Odešlete soubor přesně tak, jak jej společnost Adverant poskytla |
LICENCE_ROOT_UNKNOWN |
422 | Je podepsán klíčem, kterému tato instalace nedůvěřuje | Požádejte o licenci podepsanou pro kořeny důvěryhodnosti tohoto vydání, nebo proveďte upgrade |
LICENCE_MATRIX_MISMATCH |
422 | Je sepsána vůči matici edic, kterou toto vydání nečte, nebo uděluje skupinu, kterou toto vydání nezná | Proveďte upgrade, nebo požádejte o licenci sepsanou pro toto vydání |
LICENCE_OTHER_INSTALLATION |
409 | Byla vydána pro jinou instalaci | Požádejte o licenci vydanou pro identitu této instalace |
TRANSITION_NOT_PERMITTED |
409 | Licence s tímto ID již byla importována; každá se importuje pouze jednou | Pokud se musí změnit podmínky, požádejte společnost Adverant o novou licenci |
LICENCE_REVOKED |
403 | Společnost Adverant tuto licenci stáhla | Požádejte společnost Adverant o novou |
LICENCE_LOCKED |
403 | Doba platnosti licence ještě nezačala; do té doby platí základní úroveň Community | Importujte ji znovu v první den její platnosti nebo později |
RECORD_NOT_FOUND |
404 | Instalace ještě nebyla deklarována, takže nemá žádnou identitu, vůči které by bylo možné provést kontrolu | Dokončete krok prvního administrátora (kapitola 2.12, První spuštění) a poté proveďte import |
VALIDATION_FAILED |
400 | Tělo bylo nečitelné nebo větší než 1 MiB, případně byl odeslán řetězec dotazu | Odešlete soubor jako celé tělo, bez dotazu |
Při úspěšném importu se může vrátit ještě jeden kód, spíše jako upozornění než odmítnutí: LICENCE_CLOCK_BEHIND_FLOOR znamená, že hodiny instalace ukazují dřívější čas než nejnovější čas, který již zaznamenaly, takže licence se čte k tomuto pozdějšímu času. Posunutí hodin zpět nikdy neoživí vypršelou licenci. Základní časovou hranici sníží pouze token pro resetování času, který společnost Adverant pro danou instalaci podepíše.
Přechod z edice Community na Enterprise na místě
Takto jsme to udělali v Harrow. Nic se nepřeinstalovává a nic se nemigruje: je to tatáž instalace, se stejnou identitou a stejnými daty, jen je v ní zapnuto více funkcí. Název instalace a správci klíčů zůstávají přesně tak, jak byli; při upgradu háček (hook) správy klíčů zkontroluje, zda je úložiště klíčů již inicializováno, a neudělá nic dalšího.
Vložte stahovací token na každý uzel a restartujte na něm kontejnerový runtime.
Stáhněte chart Enterprise ze stránky Ke stažení (Downloads) a ověřte jej i jeho obrazy podle postupu výše.
Změňte dvě hodnoty ve svém stávajícím souboru hodnot:
edition: enterpriseaenterprise.enabled: true. Nic jiného neměňte.Spusťte předběžnou kontrolu (preflight) s novým souborem.
nexusctl preflight --context harrow-prod --values harrow-values.yamlProveďte upgrade vydání na chart Enterprise, opět bez
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mPři upgradu se háčky (hooks) spustí před nasazením nových podů a každá migrace aplikuje pouze ty soubory, které ještě neaplikovala. Vygenerované tajné údaje (secrets) se načtou zpět z instalace a zachovají se. Helm skončí s:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Počkejte na úlohy (workloads), přesně jako v kapitole 2.6, Instalace edice Community v prostředí Kubernetes, krok 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportujte licenci jedním ze tří výše uvedených způsobů.
V konzoli otevřete Tuto instalaci (This installation), poté Licence a následně Přejít na Enterprise (Move to Enterprise). Stránka načte licenci a předtím, než se cokoli stane, ukáže, co se stáhne a co se změní. Také spočítá osoby a obsah organizace a označí je jako zachované. Stiskněte Stáhnout a zapnout. Každá část je před použitím zkontrolována vůči klíči vydání společnosti Adverant a skupiny funkcí se zapínají jedna po druhé.
Naše servisní okno mělo hodinu; samotná práce v něm zabrala asi dvacet minut, z čehož většinu tvořilo čekání na schéma během běhu háčků. Lidé z pilotního provozu se následující ráno přihlásili do stejného pracovního prostoru, přičemž oblasti Enterprise v nabídce již nebyly zašedlé.
Po importu
Stránka licence pod položkou Tato instalace (This installation) vypisuje každou skupinu funkcí v licenci spolu s počtem míst a dobou platnosti. Uvádí také, jak je každá část dodávána, například zkompilovaná a licencovaná pro skupinu Enterprise, nebo jako open source pro základní úroveň Community. Skupiny mimo licenci zůstávají vypsané a zašedlé. Administrátoři mohou zúžit dosah skupiny uvnitř organizace; nikdo kromě společnosti Adverant nemůže rozšířit to, co licence uděluje.
Stav licence se při každém čtení znovu vypočítá z dokumentu a data, takže k vypršení platnosti dochází bez plánované úlohy. Všichni v instalaci vidí v konzoli stejné upozornění, když se blíží konec: LICENCE_ENDS_SOON od 30 dnů před koncem, poté LICENCE_IN_GRACE během doby odkladu. Členové vidí upozornění a data; samotnou licenci vidí pouze administrátoři instalace. Kapitola 2.13, Licence, pokrývá obnovení a žebříček vypršení platnosti.
Pokud to selže
| Co vidíte | Příčina | Co dělat |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Byl změněn pouze jeden ze dvou klíčů | Změňte oba |
files/images.lock.json is the community lock; this install is edition enterprise |
Byl použit chart Community | Použijte chart Enterprise ze stránky Ke stažení (Downloads) |
image ... is a enterprise image; a community install takes only community images |
Název obrazu Enterprise se dostal do vykreslování Community | Zkontrolujte edition a složku chartu |
ImagePullBackOff u obrazu Enterprise po upgradu |
Uzel nemá žádný stahovací token, nebo jeho token již není platný | Zkontrolujte registries.yaml na daném uzlu, nebo vytvořte nový token |
| Kód odmítnutí licence | Viz tabulka odmítnutí výše | Postupujte podle příslušného řádku; nic nebylo změněno |
Když stránka licence zobrazuje Enterprise a skupiny, které jste očekávali, instalace je licencována. Další zastávkou je první spuštění v kapitole 2.12, První spuštění, pokud jste si instalaci ještě nenárokovali. Pokud ano, asistent stále potřebuje vlastní klíče modelů umělé inteligence (AI) dané organizace, než bude moci komukoli odpovědět. Kapitola 2.14, Poskytovatelé a modely AI, ukazuje, jak je připojit.




