Verzió 1.0.0-alpha.1legújabb
2.7. fejezet
Az Enterprise telepítése és a licenc alkalmazása
Mi változik az Enterprise kiadás telepítésekor, hogyan igényelhet licencet az Adverant-fiókjából, a három importálási mód az összes elutasítási kóddal, és hogyan alakította át a Harrow Port Authority a Community próbaverzióját helyben Enterprise kiadássá adatvesztés nélkül.
Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

Egy Enterprise telepítésnek két fele van, és ezek különböző utakon érkeznek. Az Enterprise képfájlok az Enterprise charttal érkeznek, amelyeket egy letöltési tokennel (pull token) kell lehúzni. A licenc egy aláírt fájlként érkezik az Ön Adverant-fiókjából, amelyet a futó telepítésbe kell importálnia. Egyik fél sem működik a másik nélkül: a licenc nélküli képfájlok a Community alapszinten futnak, az Enterprise képfájlok nélküli licencnek pedig nincs mit bekapcsolnia.
A Harrow Port Authoritynál ebben a sorrendben csináltuk, hat héttel a 2.6. fejezetben (A Community telepítése Kubernetesre) leírt Community próbaüzem után. Az Enterprise chartra történő frissítés egyetlen karbantartási ablakot vett igénybe; a licenc importálása két percig tartott. Ez a fejezet mindkét felet lefedi. Egy tiszta telepítéssel kezdődik, és egy meglévő Community telepítés helyben történő átállításával zárul.
Miben tér el a Community kiadástól
Két érték, és a chart, amely beolvassa őket.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueAz értékfájlban minden más pontosan úgy marad, ahogy volt, mindenekelőtt a telepítés neve és a kulcsőrzők. A két kulcsnak egyeznie kell, és a chart elutasítja a edition: enterprise értéket a enterprise.enabled: false értékkel, vagy fordítva.
A kiadásnak meg kell egyeznie a chart képfájl-zárolásával (images lock) is. Minden chart-csomag egy adott kiadás zárolását hordozza, és az Enterprise zárolás felsorolja a Community képfájlokat, valamint az Enterprise buildeket. Ha egy Enterprise értékfájlt a Community chartra irányít, a renderelés a files/images.lock.json is the community lock; this install is edition enterprise hibával leáll. Az Enterprise telepítéshez tehát az Enterprise chartra van szükség.
Az Enterprise chart és a csomag az Adverant-fiókja Letöltések (Downloads) oldalán található, amely követi az Ön licencét. A chart fájl neve megegyezik a Community változatéval, nexus-1.0.0-alpha.1.tgz, ezért tartsa a kettőt külön mappában. Ellenőrizze pontosan úgy, ahogyan a 2.4. fejezet (Kiadás beszerzése és ellenőrzése) leírja, azon kiadási kulcs alapján, amelynek az ujjlenyomatát már ellenőrizte:
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
Ezután futtassa a 2.4. fejezetben (Kiadás beszerzése és ellenőrzése) található aláírás-ellenőrző ciklust a enterprise/nexus/files/images.lock.json fájlon. Ez lefedi az Enterprise képfájlokat és a megosztottakat is.
A letöltési token (pull token)
A Community képfájlok nyilvánosak. Az Enterprise képfájlokhoz szükség van egy letöltési tokenre a fiókja Letöltési tokenek és telepítési parancsok (Pull tokens and install commands) oldaláról, amelyet a csomópontok konténer-futtatókörnyezetéhez kell konfigurálni, ahogyan azt a 2.4. fejezet (Kiadás beszerzése és ellenőrzése) 3. lépése mutatja. A k3s esetében ez egy configs bejegyzés a registry.adverant.ai számára a /etc/rancher/k3s/registries.yaml fájlban, minden csomóponton.
Készítsen fürtönként egy tokent, és adjon meg neki egy olyan lejárati dátumot, amelyet biztosan észrevesz. Amikor egy token lejár, a futó podok tovább működnek, de egy olyan csomópontra átütemezett pod, amelyen még nincs meg a képfájl, nem tudja azt lehúzni. Mi a token lejárati dátumát ugyanabba a naptárba írjuk be, mint a tanúsítványét.
Új Enterprise telepítés
Ha kezdettől fogva az Enterprise kiadást telepíti, kövesse a 2.6. fejezetet (A Community telepítése Kubernetesre) lépésről lépésre, három eltéréssel:
Helyezze el a letöltési tokent minden csomóponton a 6. lépés előtt.
Használja az Enterprise értékeket (a fenti két kulcsot) a 4. lépésben.
A 6. lépésben telepítsen a letöltött Enterprise chart fájlból:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
A telepítési parancs után minden megegyezik a 2.6. fejezetben (A Community telepítése Kubernetesre) leírtakkal, beleértve a --wait kapcsolóra vonatkozó szabályt is: ne használja. Ha ehelyett a nexusctl paranccsal telepít, adja hozzá a --edition enterprise kapcsolót a parancshoz:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseAmikor minden munkafolyamat (workload) készen áll, menjen végig az első futtatáson a 2.12. fejezet (Az első futtatás) szerint. A licenc egyike annak a hat dolognak, amelyet a konzol felsorol, mielőtt bárki bejelentkezne. Amíg nincs importálva, a telepítés a Community alapszinten fut, és minden Enterprise terület szürkén, lakattal jelenik meg.
A licenc igénylése
Az Adveranttól származó licencet egy adott telepítés személyazonosságára állítják ki, arra, amelyet a kulcstároló a telepítéskor a keys.installationName alatt létrehozott. Ezért a fióknak tudnia kell, melyik telepítésre gondol, mielőtt kiállíthatna egyet.
- Jelentkezzen be az Adverant-fiókjába a
https://account.adverant.aicímen. - A telepítésen nyissa meg az Ez a telepítés (This installation), majd a Licenc (Licence) menüpontot. Itt látható egy egyszer használatos kód és a telepítés ujjlenyomata.
- A fiókjában nyissa meg a Telepítés igénylése (Claim a deployment) oldalt, és adja meg a kódot. Ezután hasonlítsa össze a fiók által fogadott ujjlenyomatot azzal, amelyet a telepítés mutat, csoportonként; minden csoportnak egyeznie kell.
- Nyomja meg az igénylés gombot. A telepítés bekerül a fiókja Telepítések (Deployments) listájába, a verziójával és a licencállapotával együtt.
- Az Adverant kiállítja a licencet az adott telepítéshez. Töltse le a fájlt a fiókjából; a neve a licencazonosítója után
<licence-id>.jsonlesz.
Egy igénylőkód csak egyszer és rövid ideig használható. Ha lejár, a fiók CLAIM_CODE_EXPIRED hibával elutasítja, a telepítés pedig egy újat jelenít meg.
Két másik út is létezik, és a 2.13. fejezet (Licencek) mindkettőt részletesen bemutatja. A célgépek (appliances) és a peremhálózati készletek (edge kits) nem rendelkeznek képernyővel a kód megjelenítéséhez, ezért a dobozra nyomtatott igénylőkulccsal lehet őket igényelni, amelyet az Igénylőkulcs megadása (Enter a claim key) oldalon kell begépelni, vagy a gyártó rendelési fájljából kell beolvasni. A kifelé vezető úttal nem rendelkező telepítések az Offline cserét (Offline exchange) használják: a rendszer készít egy aláírt licencigénylő fájlt, Ön elviszi azt a fiókjába, majd visszaviszi a licencfájlt. Évente egyszer ugyanígy készít egy aláírt használati kimutatást is. A csere során minden fájl alá van írva, így az útközben módosított fájlokat a rendszer elutasítja: az igénylést LICENCE_REQUEST_SIGNATURE_INVALID, a használati fájlt pedig USAGE_FILE_SIGNATURE_INVALID kóddal.
Mit tartalmaz a licencfájl
A licenc egy nexus-licence/v1 formátumú JSON-dokumentum, amelyet az Adverant kétszer írt alá két független kulccsal. Önnek nem kell elolvasnia, de hasznos tudni, mi van benne, ha valaki megkérdezi, mit vásároltak.
| Mező | Mit tartalmaz |
|---|---|
licence_id |
A licenc saját azonosítója, egy kisbetűs UUID (univerzálisan egyedi azonosító) |
type |
alpha, evaluation vagy commercial |
licensee |
A szervezet neve és Adverant ügyfél-azonosítója |
scope |
A telepítés, amelyhez szól, és bármely szervezet, amelyet a jogosultság megnevez |
edition |
enterprise |
grants |
Az általa feloldott funkciócsoportok, egyenként a teljes telepítésre vagy a megnevezett szervezetekre |
add_ons és domain_packs |
Külön licencelt képességek; a Logisztikai és tengerészeti csomag (Logistics and maritime pack) például ilyen |
metric |
Hogyan számolják a licencet (named-seat, per-core vagy per-environment), valamint a mennyiség |
term |
starts_on, ends_on, valamint a figyelmeztetési és türelmi napok száma |
matrix |
A kiadási mátrix verziója, amely alapján íródott |
signatures |
Az Adverant két aláírása |
Egy próbaverziós (evaluation) licenc legfeljebb 30 napig érvényes, legfeljebb öt megnevezett személyre, türelmi idő nélkül. Egy kereskedelmi licenc a lejárat előtt 30 nappal figyelmeztet, majd alapértelmezés szerint 30 nap türelmi időt biztosít. Hogy mi történik ennek a létrának az egyes fokain, azt a 2.13. fejezet (Licencek) tartalmazza.
Az aláírások a dokumentumot abban a formában védik, ahogyan az Adverant elkészítette. Pontosan úgy küldje el, ahogyan megkapta; ne nyissa meg olyan szerkesztőben, amely esetleg átformázhatja.
A licenc importálása
Csak telepítési adminisztrátor importálhat licencet: a telepítést birtokló teljes szervezet tulajdonosa vagy adminisztrátora, miközben be van jelentkezve. Egy teljes jogosultságú platformadminisztrátor szintén importálhat licencet. A licenc soha nem egy chart-érték vagy egy podba csatolt fájl. A bejelentkezési szolgáltatásba (nexus-auth) kerül, amely offline ellenőrzi azt a saját képfájljába épített megbízhatósági gyökerek (trust roots) alapján, és egyetlen tranzakcióban rögzíti. Háromféleképpen importálhatja, és mindegyik ugyanoda vezet.
A konzolon
Az első futtatás során nyissa meg a Hat dolog, mielőtt bárki bejelentkezne (Six things before anyone signs in), majd a Licenc (Licence) menüpontot. A Licenc importálása (Import the licence) oldal fogadja a fájlt: húzza rá az oldalra, vagy válassza ki. Az oldal offline ellenőrzi azt magán a telepítésen, majd felsorolja az általa megnyitott funkciócsoportokat, feltüntetve, hogy melyik hogyan van védve és meddig érvényes. A licencben nem szereplő csoportok továbbra is a listán maradnak, szürkén.
Később ugyanez az importálás az Új licenc importálása (Import a new licence) gombbal érhető el a telepítés licencoldalán. Amikor egy licenc lejárt, a korlátozott licencoldal a Megújított licenc importálása (Import a renewed licence) lehetőséget kínálja fel.
A nexusctl használatával
nexusctl licence import <licence-id>.jsonA nexusctl változatlan formában elküldi a fájlt a telepítés importálási útvonalára telepítési adminisztrátorként, és jelenti a licenc állapotát vagy az alábbi táblázatban szereplő elutasítási kódot.
Az API-n keresztül
Az importálási útvonal a bejelentkezési szolgáltatás alkalmazásprogramozási felületének (API) része, az Ön hosts.auth címén. A törzs (body) maga a licencdokumentum, bájtról bájtra:
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>.jsonA <admin-token> egy bejelentkezett telepítési adminisztrátor hozzáférési tokenje. Használja a --data-binary kapcsolót, soha ne a -d kapcsolót, mert az eltávolítja a sortöréseket, és így megváltoztatja az elküldött bájtokat. Az útvonal nem fogad el lekérdezési karakterláncot (query string), és a törzsben sem lehet más a dokumentumon kívül; azt a törzset, amely a legfelső szintjén egy szervezetet vagy személyt próbál megnevezni, a rendszer még azelőtt elutasítja, hogy bármit is beolvasna belőle.
A sikeres importálás 201 Created válasszal tér vissza. Lerövidítve a törzs így néz ki:
{
"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
}
A organizations azokat a telepítésen lévő szervezeteket számolja meg, amelyek mostantól rendelkeznek a licenccel. A tenants_without_organisation azokat a licencben megnevezett szervezeteket számolja meg, amelyek nem találhatók meg ezen a telepítésen.
Amikor az importálást elutasítják
Az elutasított importálás semmit sem változtat meg: nem íródik új sor, és a hatályos licenc – ha van ilyen – változatlan marad. A telepítés auditnaplója minden kísérletet rögzít, beleértve az elutasítottakat is.
| Kód | Állapot | Mit jelent | Teendők |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Az Adverant két aláírásának egyike hiányzik vagy nem ellenőrizhető; a fájlt az aláírás után módosították | Kérje el újra a fájlt az Adveranttól; ne szerkessze |
LICENCE_FORMAT_INVALID |
422 | A fájl nem olyan licenc, amelyet ez a kiadás be tud olvasni | Küldje el a fájlt pontosan úgy, ahogyan az Adverant átadta |
LICENCE_ROOT_UNKNOWN |
422 | Olyan kulccsal írták alá, amelyben ez a telepítés nem bízik meg | Kérjen egy olyan licencet, amelyet ennek a kiadásnak a megbízhatósági gyökereihez írtak alá, vagy frissítsen |
LICENCE_MATRIX_MISMATCH |
422 | Olyan kiadási mátrix alapján íródott, amelyet ez a kiadás nem tud értelmezni, vagy olyan csoportot engedélyez, amelyet ez a kiadás nem ismer | Frissítsen, vagy kérjen egy ehhez a kiadáshoz írt licencet |
LICENCE_OTHER_INSTALLATION |
409 | Egy másik telepítéshez állították ki | Kérjen egy olyan licencet, amelyet ennek a telepítésnek a személyazonosságára állítottak ki |
TRANSITION_NOT_PERMITTED |
409 | Ezzel az azonosítóval már importáltak licencet; mindegyik csak egyszer importálható | Kérjen új licencet az Adveranttól, ha a feltételeknek változniuk kell |
LICENCE_REVOKED |
403 | Az Adverant visszavonta ezt a licencet | Kérjen egy újat az Adveranttól |
LICENCE_LOCKED |
403 | A licenc futamideje még nem kezdődött el; addig a Community alapszint érvényes | Importálja újra az első érvényességi napon vagy azután |
RECORD_NOT_FOUND |
404 | A telepítést még nem deklarálták, így nincs személyazonossága, amely alapján ellenőrizni lehetne | Fejezze be az első adminisztrátori lépést (2.12. fejezet, Az első futtatás), majd importálja |
VALIDATION_FAILED |
400 | A törzs olvashatatlan volt, meghaladta az 1 MiB méretet, vagy lekérdezési karakterláncot küldtek | Küldje el a fájlt a teljes törzsként, lekérdezés nélkül |
Még egy kód érkezhet vissza sikeres importáláskor, elutasítás helyett értesítésként: a LICENCE_CLOCK_BEHIND_FLOOR azt jelenti, hogy a telepítés órája korábbi időpontot mutat, mint a legutóbbi időpont, amelyet már látott, ezért a rendszer a licencet azon a későbbi időponton értelmezi. Az óra visszaállítása soha nem éleszt újra egy lejárt licencet. Csak egy olyan idő-visszaállító token csökkenti ezt a küszöböt, amelyet az Adverant ír alá a telepítés számára.
A Community helyben történő átalakítása Enterprise kiadássá
A Harrow-nál így csináltuk. Semmit sem kell újratelepíteni és semmit sem kell migrálni: ez ugyanaz a telepítés, ugyanazzal a személyazonossággal és ugyanazokkal az adatokkal, csak több minden van bekapcsolva rajta. A telepítés neve és a kulcsőrzők pontosan úgy maradnak, ahogy voltak; frissítéskor a kulcsőrzési kampó (custody hook) ellenőrzi, hogy a kulcstároló már inicializálva van-e, és nem csinál semmi mást.
Helyezze el a letöltési tokent minden csomóponton, és indítsa újra ott a konténer-futtatókörnyezetet.
Töltse le az Enterprise chartot a Letöltések (Downloads) oldalról, és ellenőrizze azt, valamint a képfájljait a fentiek szerint.
Módosítsa a két értéket a meglévő értékfájljában:
edition: enterpriseésenterprise.enabled: true. Semmi mást ne változtasson meg.Futtassa az előzetes ellenőrzést (preflight) az új fájllal.
nexusctl preflight --context harrow-prod --values harrow-values.yamlFrissítse a kiadást az Enterprise chartra, ismét a
--waitnélkül.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mFrissítéskor a kampók (hooks) az új podok elindulása előtt futnak le, és minden migráció csak azokat a fájlokat alkalmazza, amelyeket korábban még nem alkalmazott. A generált titkokat a rendszer visszaolvassa a telepítésből és megtartja. A Helm a következővel zárul:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Várja meg a munkafolyamatokat, pontosan úgy, ahogyan a 2.6. fejezet (A Community telepítése Kubernetesre) 7. lépésében szerepel.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImportálja a licencet a fenti három módszer bármelyikével.
A konzolon nyissa meg az Ez a telepítés (This installation), majd a Licenc (Licence), végül a Váltás Enterprise-ra (Move to Enterprise) menüpontot. Az oldal beolvassa a licencet, és megmutatja, mi lesz letöltve és mi fog változni, mielőtt bármi is történne. Emellett megszámolja a szervezet munkatársait és tartalmait, és mindegyiket megtartottként jelöli meg. Nyomja meg a Letöltés és bekapcsolás (Fetch and switch on) gombot. Minden egyes részt ellenőriz a rendszer az Adverant kiadási kulcsa alapján a használat előtt, és a funkciócsoportok egyesével kapcsolnak be.
A karbantartási ablakunk egyórás volt; a munka ezen belül nagyjából húsz percet vett igénybe, aminek a nagy részét a sémára való várakozás tette ki, miközben a kampók futottak. A próbaüzem résztvevői másnap reggel ugyanabba a munkatérbe jelentkeztek be, de a menü Enterprise területei már nem voltak beszürkítve.
Az importálás után
Az Ez a telepítés (This installation) alatti licencoldal felsorolja a licencben szereplő összes funkciócsoportot a felhasználói helyekkel (seats) és a futamidővel együtt. Azt is megmutatja, hogy az egyes részek hogyan érhetők el: például lefordítva és licencelve egy Enterprise csoport esetében, vagy nyílt forráskódként a Community alapszinten. A licencen kívüli csoportok továbbra is a listán maradnak, szürkén. Az adminisztrátorok szűkíthetik, hogy egy csoport mire terjedjen ki a szervezeten belül; az Adveranton kívül azonban senki sem bővítheti ki azt, amit a licenc biztosít.
A licenc állapotát a rendszer minden beolvasáskor újra kiszámítja a dokumentumból és a dátumból, így a lejárat ütemezett feladat (scheduled job) nélkül is bekövetkezik. A telepítésen mindenki ugyanazt az értesítést látja a konzolon, ahogy közeledik a lejárat: LICENCE_ENDS_SOON a lejárat előtt 30 nappal, majd LICENCE_IN_GRACE a türelmi időszak alatt. A tagok látják az értesítést és a dátumokat; magát a licencet csak a telepítési adminisztrátorok látják. A 2.13. fejezet (Licencek) ismerteti a megújítást és a lejárati létrát.
Ha ez sikertelen
| Amit lát | Ok | Teendők |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
A két kulcs közül csak az egyiket módosították | Módosítsa mindkettőt |
files/images.lock.json is the community lock; this install is edition enterprise |
A Community chartot használták | Használja az Enterprise chartot a Letöltések (Downloads) oldalról |
image ... is a enterprise image; a community install takes only community images |
Egy Enterprise képfájlnév került egy Community renderelésbe | Ellenőrizze a edition értéket és a chart mappáját |
ImagePullBackOff egy Enterprise képfájlon a frissítés után |
Egy csomópontnak nincs letöltési tokenje, vagy a tokenje már nem érvényes | Ellenőrizze a registries.yaml fájlt az adott csomóponton, vagy készítsen új tokent |
| Licencelutasítási kód | Lásd a fenti elutasítási táblázatot | Kövesse a hozzá tartozó sort; semmi sem változott |
Amikor a licencoldal az Enterprise kiadást és a várt csoportokat mutatja, a telepítés licencelése megtörtént. A következő állomás az első futtatás a 2.12. fejezetben (Az első futtatás), ha még nem igényelte a telepítést. Ha már igényelte, az asszisztensnek még szüksége van a szervezet saját mesterséges intelligencia (AI) modellkulcsaira, mielőtt bárkinek válaszolni tudna. A 2.14. fejezet (AI-szolgáltatók és modellek) bemutatja, hogyan kell csatlakoztatni őket.




