BejelentkezésBemutató kérése

2.9. fejezet

A telepítő lemezképfájl

Indítson el egy üres szervert vagy virtuális gépet a Nexus telepítő lemezképfájljáról, amely hálózat nélkül telepíti az operációs rendszert, a k3s-t, a cert-managert és a Nexust, használat előtt minden fájlt ellenőrizve.

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

17 perc olvasási idő

Harrow keleti rakpartján a kikötőmesteri hivatalnak egyetlen szervere van, nincs internetkapcsolata, és nincs a helyszínen senki, aki Kubernetes rendszert üzemeltetne. Tomás Reilly-nak ennek ellenére szüksége volt rajta a Nexus-ra. Kiírta a lemezképet egy USB (Universal Serial Bus) meghajtóra, mellé tett egy második, kisebb meghajtót négy sornyi beállítással, és elindította a szervert. Egy órával később a képernyőn megjelent a konzol címe és a hosts fájlhoz hozzáadandó három sor. Egyetlen Kubernetes parancsot sem gépelt be.

Ez a telepítő lemezkép feladata. Egy minimális operációs rendszert ír a szerver lemezére, majd az első indításkor minden magával hozott fájlt ellenőriz az Adverant kiadási kulcsával, hálózat nélkül telepíti a k3s-t, importálja az összes képfájlt, telepíti a cert-manager-t és a Nexus-t, végül ellenőrzi, hogy minden pod fut-e. Bármilyen hiba esetén az adott lépés azonnal megáll egy megnevezett okkal. Nincs csökkentett módú működés, és sehol sincs alapértelmezett jelszó.

A két lemezképfájl

Minden kiadás kétféle lemezképként érhető el, két processzorarchitektúrához: amd64 és arm64.

Fájl Mit tartalmaz Ki töltheti le
nexus-alpha-installer-1.0.0-alpha.1-<arch>.iso Csak a telepítő: az operációs rendszer, a k3s v1.33.6+k3s1, a cert-manager v1.21.3 és az első indítási telepítő. Bármelyik kiadással működik, és nem tartalmaz Nexus képfájlokat. Bárki, innen: downloads.adverant.ai
nexus-alpha-<edition>-1.0.0-alpha.1-<arch>.iso Ugyanez a telepítő, kiegészítve az adott kiadás offline csomagjával egy második, NEXUS-BUNDLE címkéjű partíción. Egyetlen adathordozó mindent telepít. Community: bárki. Enterprise: kizárólag a saját Adverant-fiókjából

Ahol <arch> értéke amd64 vagy arm64, és <edition> értéke community vagy enterprise.

A telepítő mindig csak egy NEXUS-BUNDLE címkéjű fájlrendszert keres. A mindent egyben tartalmazó (all-in-one) lemezkép esetén ez maga a lemezképen lévő partíció. A csak telepítőt tartalmazó lemezkép esetén a csomagot egy második, ilyen címkével ellátott lemezen vagy USB-meghajtón kell biztosítania, ami akkor praktikus, ha több telephelyet telepít egyetlen telepítő meghajtóról, és csak a csomagot cseréli. A csomagot a 2.10. fejezet, Zárt hálózati (air-gapped) telepítés ismerteti.

Az Enterprise lemezképek és az Enterprise csomagok soha nem névtelenek. Ezeket a saját Adverant-fiókjából töltheti le a https://account.adverant.ai címen, a Downloads (Letöltések) oldalon, a licence mellett. A Community lemezképek és csomagok nyilvánosak.

Két lemezábra látható egymás mellett. A bal oldali, „installer-only image” (csak telepítő lemezkép) egyetlen partícióval rendelkezik, amelynek címkéje „operating system installer, k3s, cert-manager, first-boot installer” (operációsrendszer-telepítő, k3s, cert-manager, első indítási telepítő), mellette pedig egy külön USB-meghajtó található „NEXUS-BUNDLE: the edition's offline bundle” (NEXUS-BUNDLE: a kiadás offline csomagja) címkével. A jobb oldali, „all-in-one image” (mindent egyben tartalmazó lemezkép) ugyanazzal az első partícióval, valamint ugyanazon a lemezen egy második, „NEXUS-BUNDLE” címkéjű partícióval rendelkezik. Mindkettő alatt egy kis USB-meghajtó látható „NEXUS-SEED: seed.yaml, and licence.json for Enterprise” (NEXUS-SEED: seed.yaml, és licence.json az Enterprise-hoz) címkével, valamint egy „optional for Community” (Community esetén elhagyható) megjegyzéssel. Mindhárom címkétől nyilak mutatnak lefelé egyetlen dobozra: „first boot finds each by its label” (az első indítás mindegyiket a címkéje alapján találja meg).
A csak telepítőt tartalmazó lemezkép és a mindent egyben tartalmazó lemezkép, valamint az, hogy az első indítás hol találja az egyes részeket.

Miből épül fel a lemezkép

Az operációs rendszer a Debian 13-on alapul, és nem hivatalos Debian lemezkép. Kizárólag a Debian alaprendszert tartalmazza, semmi mást: nincsenek extra csomagok, nincs asztali környezet és nincs tükrözés (mirror). A k3s saját konténer-futtatókörnyezetet és hálózatkezelést hoz magával. A rendszerindítási lánc (shim, GRUB, a kernel és a kezdeti ramdisk) bájtról bájtra megegyezik a Debian által szállítottal, így a bekapcsolt Secure Boot funkcióval rendelkező gépek bármely más Debian telepítőhöz hasonlóan elindítják.

Ugyanazon kiadás két összeállítása (buildje) bájtról bájtra azonos lemezképet eredményez, és a kiadást addig nem teszik közzé, amíg ez nem teljesül. A lemezképen található összes bináris fájl Debian forráscsomagját a lemezkép mellett teszik közzé nexus-alpha-installer-1.0.0-alpha.1-debian-source.tar néven, ugyanabban az ellenőrzőösszeg-listában.

A letöltés ellenőrzése kiírás előtt

A downloads.adverant.ai címen található lemezkép-könyvtár tartalmazza a lemezképeket, egy minden közzétett fájlt lefedő SHA256SUMS fájlt, valamint a SHA256SUMS.sigstore.json fájlt, amely a lista felett az Adverant kiadási kulcsával készített aláírás. Szerezze be külön a kiadási nyilvános kulcsot, mentse el release.pub néven, és ellenőrizze az ujjlenyomatát a 2.4. fejezet, Kiadás beszerzése és ellenőrzése című részben leírtak szerint.

  1. Ellenőrizze az ellenőrzőösszeg-lista aláírását. A Nexus kiadásokhoz nincs átláthatósági napló (transparency log), ezért a napló-lekérdezést kihagyó kapcsoló használata kötelező.
cosign verify-blob --key release.pub --insecure-ignore-tlog=true \
  --bundle SHA256SUMS.sigstore.json SHA256SUMS
Verified OK
  1. Ellenőrizze a letöltött lemezképet a lista alapján:
grep nexus-alpha-community-1.0.0-alpha.1-amd64.iso SHA256SUMS | sha256sum -c -
nexus-alpha-community-1.0.0-alpha.1-amd64.iso: OK

Mac gépen használja a shasum -a 256 -c - parancsot a sha256sum -c - helyett.

  1. Írja ki a lemezképet egy USB-meghajtóra az általában használt eszközzel, vagy csatolja a virtuális géphez optikai lemezként.

A k3s ellenőrzőösszegeket tesz közzé a kiadási fájljaihoz, aláírást azonban nem, ezért a lemezképen belüli k3s fájlokat a k3s által közzétett, a fájlokkal azonos forrásból származó ellenőrzőösszegek alapján ellenőrzik. Minden, amit az Adverant épített, alá van írva.

Darabolt csomagok

A külön meghajtón hordozott csomag több gigabájt méretű. Egyes fájlrendszerek, köztük a FAT (File Allocation Table), nem képesek 4 GiB vagy annál nagyobb fájlokat tárolni, ezért a csomagfájlokat 2047 MiB méretű darabokban teszik közzé, amelyek bármilyen meghajtóra ráférnek. Használat előtt illessze össze a darabokat sorrendben, és ellenőrizze az egyesített fájlt a hozzá tartozó .sha256 alapján.

A szükséges hardver

Az első indítás ellenőrzi a gépet, mielőtt bármihez hozzányúlna, és megtagadja a folytatást, ha a gép túl kicsi.

Ellenőrzés Az alapszint Mikor ellenőrzik
Architektúra A lemezkép sajátja: amd64 lemezkép amd64-en, arm64 lemezkép arm64-en Első indítás
Memória 16 GiB Első indítás
Céllemez Pontosan egy, legalább 64 GB-os üres lemez, vagy a seed által megnevezett lemez Az operációs rendszer kiírása előtt
Szabad hely a / alatt 50 GB az operációs rendszer telepítése után Első indítás
Óra Nem régebbi a lemezkép készítésének dátumánál Első indítás

Ezek minimumértékek, nem ajánlások. A chart alapértelmezéseivel csak a Nexus kötetei 142 GiB-ot tesznek ki, így egy 64 GB-os lemez átmegy a telepítőn, de napokon belül megtelik. Használja azt, amivel egyetlen csomópontnak rendelkeznie kell: 8 vCPU (virtual central processing units), 32 GiB memória és egy 250 GB-os SSD (solid-state drive). Kiértékeléshez elegendő négy vCPU, 16 GiB memória és 200 GB tárhely.

Az óra ellenőrzésére azért van szükség, mert a szervernek a telepítéskor nincs hálózati kapcsolata, így időszinkronizáló szolgáltatása sem. A tanúsítványokat és az aláírásokat az óra alapján ellenőrzik. Ha a gép hardveres órája a lemezkép készítési dátuma mögött jár, az első indítás leáll, és kéri a beállítását. Állítsa be a firmware-beállításokban, majd indítsa újra a gépet.

Fizikai szerverek és virtuális gépek

A lemezkép UEFI (Unified Extensible Firmware Interface) firmware-en indul el, fizikai szervereken és virtuális gépeken egyaránt. A rendszerbetöltőt a cserélhető adathordozók útvonalára és a szokásos útvonalra is telepíti, így a mentett rendszerindítási bejegyzésekkel nem rendelkező VM (virtual machine) is megtalálja az első újraindítás után. Adjon a VM-nek a fenti táblázatban szereplő memóriát és lemezterületet, egy üres virtuális lemezt, valamint a lemezképet CD-ként.

A telepítő szigorú szabály alapján választja ki a céllemezt, és soha nem „az első lemezt” választja.

  • Kihagyja azt az adathordozót, amelyről elindult.
  • Kihagyja a cserélhető lemezeket, kivéve, ha a seed megnevez egyet.
  • Kihagy minden olyan lemezt, amelyen már van bármilyen típusú partíciós tábla.
  • Kihagyja a 64 GB alatti lemezeket, és ezt jelzi a konzolon.
  • Csak akkor telepít, ha pontosan egy lemez marad.

Egy két üres lemezzel rendelkező szerveren megáll, és választást kér Öntől. Választani úgy tud, hogy megnevezi a lemezt a seedben a wipe: true használatával – ez az egyetlen módja annak is, hogy olyan lemezre írjon, amelyen már vannak partíciók.

A NEXUS-SEED kötet

A seed egy kis méretű kötet, általában egy USB-meghajtó, NEXUS-SEED címkéjű fájlrendszerrel és a legfelső szintjén egy seed.yaml fájllal. A telepítő csak olvasható módban csatolja fel, beolvassa a beállításokat, és csak a legvégén csatolja fel újra írhatóként, hogy ott hagyja Önnek az operációs rendszer jelszavát.

# seed.yaml on the NEXUS-SEED volume
domain: harrow.example
adminEmail: aoife.brennan@harrow.example
edition: enterprise
timeout: 45m
Kulcs Mit állít be Ha hiányzik
domain A telepítés tartománya (domain). A telepítő ebből származtatja a három állomásnevet: console.<domain>, api.<domain> és auth.<domain>. Bekéri a szerver konzolján
adminEmail Annak a személynek az e-mail-címe, aki az első adminisztrátor lesz Bekéri a szerver konzolján
edition community vagy enterprise. Ha be van állítva, egyeznie kell a csomag kiadásával. A csomagból veszi át
timeout Mennyi ideig tarthat a cert-manager és a Nexus telepítése, időtartamként megadva, például 30m vagy 1h 30m
time Az aktuális idő UTC-ben, az óraüzenet által kiírt formátumban (2026-11-14T09:00:00Z), olyan gépekhez, amelyek hardveres órája nem állítható be, vagy nem tartja meg a beállítást. Egy offline gép nem tud időszolgáltató szervert lekérdezni. A hardveres órát használja
disk A céllemez /dev/<name> formában, kizárólag a wipe: true beállítással együtt használva A fenti üreslemez-szabály érvényesül
wipe A true engedélyezi a telepítőnek a disk által megnevezett lemez törlését Soha egyetlen lemezt sem töröl

Enterprise esetén helyezze a licencfájlt ugyanarra a kötetre licence.json néven. Enélkül az első indítás megáll a seed lépésnél, és jelzi, hogy hiányzik a licenc. A Community nem igényel licencet, és Community esetén a teljes seed elhagyható: a telepítő bekéri a tartományt és az e-mail-címet a konzolon, majd folytatja a munkát.

A telepítő minden sort a sor elején álló key: value formátumként olvas be. Soronként egy kulcsot írjon, a legfelső szinten, idézőjelek és behúzás nélkül. Az idézőjelek közé tett értéket az idézőjelekkel együtt olvassa be.

Az első indításkor a telepítő a konzolon bekéri a kulcstár őrzőjét (custodian) is: egy age kulcs nyilvános felét (age1...), amelyet az őrző saját gépén készítettek a age-keygen -o custodian.key paranccsal. A kulcstár ehhez zárja hozzá a helyreállítási kulcsait. Az őrzőket a 2.8. fejezet, Egygépes telepítések ismerteti. Az őrző a privát felet offline és biztonságban tartja: enélkül újraindítás után senki sem tudja feloldani a kulcstárat.

Mi történik a bekapcsolástól a konzol címéig

Első szakasz: az operációs rendszer

A lemezkép egy felügyelet nélküli Debian telepítőbe indul el. Nem állít be hálózatot, nem használ tükrözést (mirror), és az alaprendszeren kívül nem telepít semmilyen csomagot. Az időzónát UTC-re (Coordinated Universal Time) állítja, letiltja a root bejelentkezést, és létrehoz egyetlen felhasználót, nexus néven, zárolt jelszóval. A fenti szabály alapján kiválasztja a céllemezt, és létrehoz egy GPT (globally unique identifier partition table) lemezt egy EFI (Extensible Firmware Interface) rendszerpartícióval és egy ext4 gyökér-fájlrendszerrel, lapozófájl (swap) nélkül.

A végén átmásolja a Nexus telepítőt az új rendszerre, minden átmásolt fájlt ellenőriz a lemezkép ellenőrzőösszeg-listája alapján, és engedélyez egy első indítási szolgáltatást. Ha bármelyik átmásolt fájl nem egyezik, ott megáll. Ezután kiadja az adathordozót, és újraindul.

Második szakasz: az első indítás

Az első indításkor a nexus-install szolgáltatás egyszer lefut. Minden lépés kiíródik a szerver konzoljára és a naplóba (journal), és késznek jelöli magát, így egy újrapróbálkozás az első olyan lépéstől indul, amely még nincs kész. A szolgáltatás egészében legfeljebb négy órán át futhat, mielőtt a systemd leállítaná, ami hagy időt egy lassú lemezre és egy órányi várakozásra a csomagot tartalmazó meghajtó csatlakoztatásához.

  1. Előellenőrzés (Preflight). Az architektúra, az óra, a memória és a szabad lemezterület, a fenti táblázat szerint.
  2. Hasznos teher (Payload). A telepítő saját fájljai: az ellenőrzőösszeg-lista aláírása a magával hozott kiadási kulccsal, majd minden fájl ellenőrzése a lista alapján.
  3. Seed. Beolvassa a seed.yaml fájlt, és a konzolon bekéri a hiányzó adatokat.
  4. Csomag (Bundle). Megkeresi a NEXUS-BUNDLE címkéjű kötetet, és csak olvasható módban csatolja fel. Ha nincs ilyen, kiírja a waiting-for-bundle üzenetet, és legfeljebb egy órát vár arra, hogy Ön csatlakoztassa. Ezután bármilyen importálás előtt lefuttatja a teljes csomagellenőrzést a magával hozott kiadási kulccsal, amely a VERIFY-BUNDLE PASS üzenettel zárul. Az Enterprise csomaghoz szükséges a licence.json megléte a seeden, és a seed kiadásának egyeznie kell a csomag kiadásával.
  5. k3s. Telepíti a k3s v1.33.6+k3s1 verzióját a lemezkép saját fájljaiból kikapcsolt letöltések mellett, és legfeljebb tíz percet vár arra, hogy a csomópont Ready állapotba kerüljön. Ezután eltávolítja a k3s zárt hálózati (air-gap) képfájl-archívumát, hogy a képfájlok ne importálódjanak újra minden indításkor.
  6. Importálás (Import). Importálja a csomagból az összes ellenőrzött képfájlt, valamint a cert-manager képfájljait a csomópont konténertárolójába. Soha semmit nem tölt le tárolóból (registry).
  7. cert-manager, majd Nexus. Telepíti a cert-manager v1.21.3 verzióját, majd a csomagból a Nexus chartot, mindkettőt a seed timeout időkorlátján belül.
  8. Átvétel (Acceptance). Ellenőrzi, hogy minden pod Running állapotban van-e, és minden hook Job befejeződött-e.
  9. Hitelesítő adatok (Credential). Új, véletlenszerű jelszót ad a nexus operációsrendszer-felhasználónak, egyszer megjeleníti a konzolon, és kiírja a seed kötet nexus-os-password.txt fájljába, ha a kötet írható.

A 4. lépésben szereplő csomagellenőrzés ugyanaz a parancsfájl, amelyet a 2.10. fejezet, Zárt hálózati (air-gapped) telepítés során kézzel futtat, és ugyanazokat a sorokat írja ki:

  1 SHA256SUMS OK files=<n>
  2 SHA256SUMS signature OK
  3 images signed + SBOM-attested: <n>
  4 helm lint --strict OK nexus-1.0.0-alpha.1.tgz
  5 coverage OK rendered=<n> lock=<n>
  6 source offer OK images=5 files=<n>
VERIFY-BUNDLE PASS files=<n> images=<n>

A 3. sor megszámolja azokat a képfájlokat, amelyek érvényes aláírással és aláírt SBOM-mal (software bill of materials – az egyes képfájlok tartalmának listájával) rendelkeznek. A darabszámok (<n>) a kiadástól függenek. Ami számít, az az utolsó sor.

A telepítés a chart jelenlegi formájában írja be az értékeket: a global.domain értéket és a három hosts.* nevet a seed tartományából, valamint a keys.custody.recipients értéket a konzolon megadott őrzőtől. A csomag saját chartjából és képfájljaiból telepít, így a lemezre kerülő kiadás pontosan az a kiadás, amelyet ellenőriztek.

Kilenc dobozból álló vízszintes lánc: Preflight, Payload, Seed, Bundle, k3s, Import, cert-manager and Nexus, Acceptance, Credential. Minden doboz alatt egy rövid piros címke mutatja, mi állíthatja meg: „memory, disk, clock, architecture” (memória, lemez, óra, architektúra), „signature or checksum” (aláírás vagy ellenőrzőösszeg), „no domain or email; no licence for Enterprise” (nincs tartomány vagy e-mail; nincs licenc az Enterprise-hoz), „no NEXUS-BUNDLE in 1 h; VERIFY-BUNDLE FAIL” (nincs NEXUS-BUNDLE 1 órán belül; VERIFY-BUNDLE FAIL), „node not Ready in 10 min” (a csomópont nem Ready 10 percen belül), „an image will not import” (egy képfájl nem importálható), „helm install fails within the timeout” (a helm telepítés sikertelen az időkorláton belül), „a pod not running, a Job not complete” (egy pod nem fut, egy Job nem fejeződött be), a Credential alatt pedig nincs semmi. Minden dobozból egy visszamutató nyíl vezet a lánc elejére, „nexus-install retry resumes at the first step not done” (a nexus-install retry az első el nem végzett lépésnél folytatja) felirattal.
A telepítő lemezkép első indítása lépésről lépésre, ahol bármelyik lépés képes megállítani a telepítést.

Az utolsó sorok a konzolon

Amikor minden lépés sikeresen lefutott, a konzol egyszer megjeleníti az operációs rendszer jelszavát és a megnyitandó címet:

nexus-install: OS login: user nexus, password <shown-once>  (shown once; change it with passwd)
nexus-install: DONE: https://console.harrow.example  (add to /etc/hosts: 10.20.4.15 console.harrow.example api.harrow.example auth.harrow.example)

Írja fel a jelszót, vagy vegye ki a seed meghajtóról, majd jelentkezzen be nexus felhasználóként, és változtassa meg a passwd paranccsal. Senki – beleértve az Adverantot is – nem ismer alapértelmezett jelszót ehhez a géphez, mert nem létezik ilyen.

A hosts sorban szereplő cím a szerver saját címe. Mivel a rakparton nincs DNS (Domain Name System), Tomás ezt az egy sort adta hozzá minden olyan laptop hosts fájljához, amelyről használni kívánták a konzolt. DNS-sel rendelkező telephelyen ehelyett adjon hozzá rekordokat a három névhez.

Kész, vagy még nem
Kész, vagy még nem
A telepítés után a készenléti lista tartalmaz egy kimenőforgalom-tesztet is, így az üzemeltető igazolni tudja, hogy az elmúlt órában semmi sem próbált meg kimenni a hálózatra.

A telepítés után

A telepítés még nincs birtokba véve (unclaimed). Senki sem tud bejelentkezni, amíg valaki birtokba nem veszi egy böngészőben, összehasonlítva a telepítés ujjlenyomatát a szerver által mutatottal. A 2.12. fejezet, Az első futtatás ismerteti a birtokbavételt, az első adminisztrátort és a hozzáférési kulcsot (passkey). Az első adminisztrátornak annak a személynek kell lennie, akinek az e-mail-címe szerepel a seedben.

A csomópont saját kubeconfig fájlja a /etc/rancher/k3s/k3s.yaml helyen található, és csak a root olvashatja. Ha munkaállomásról szeretne dolgozni a fürtön, a nexusctl kubeconfig parancs írja ki azt, ahogyan azt a 2.8. fejezet, Egygépes telepítések ismerteti.

A frissítések ugyanúgy érkeznek, ahogy a telepítés történt: egy kiadás aláírt adathordozón, amelyet a szerverre már telepített kulcs alapján ellenőriznek, és soha nem a lemez által magával hozott kulcs alapján. Ezt az ellenőrzést a 2.10. fejezet, Zárt hálózati (air-gapped) telepítés ismerteti.

Telepítés igénylése
Telepítés igénylése
A telepítést követő birtokbavételi oldal. Az ujjlenyomat nyolc darab négykarakteres csoportban jelenik meg, hogy sorról sorra összehasonlítható legyen a szerver konzoljával.

Ha ez sikertelen

Minden hiba kiírja a nexus-install: FAILED <step>: <what is missing> üzenetet a konzolra, és ugyanezt beírja a /var/lib/nexus/install.state fájlba. Hárítsa el az okot, és futtassa újra a telepítést az első olyan lépéstől, amely még nincs kész:

sudo nexus-install retry
Üzenet Mit jelent Teendők
FAILED preflight: payload is for arm64, this machine is amd64 A másik architektúrához tartozó lemezképet indította el. Használja a gép architektúrájának megfelelő lemezképet.
FAILED preflight: memory 11 GiB, need >= 16 GiB A gép nem éri el a minimumértéket. Bővítse a memóriát, vagy adjon többet a VM-nek.
FAILED preflight: free disk 38 GB on /, need >= 50 GB A gyökér-fájlrendszer túl kicsi. Telepítse nagyobb lemezre.
FAILED preflight: the clock (...) is older than the build (...); set the RTC or give time: in the seed A hardveres óra a telepítő készítésének dátuma mögött jár. Állítsa be az órát a firmware-ben, vagy adja meg a time értéket a seed.yaml fájlban, majd próbálja újra.
FAILED payload: SHA256SUMS signature does not verify A telepítő saját fájljai nem egyeznek azokkal, amelyeket az Adverant aláírt. Álljon meg. Töltse le újra a lemezképet, és kiírás előtt ellenőrizze.
FAILED seed: the installation domain and the first administrator e-mail are required Sem a seed, sem a konzol nem adta meg őket. Adja hozzá őket a seed.yaml fájlhoz, vagy válaszoljon a bekérésekre.
FAILED seed: Enterprise bundle: licence file missing on NEXUS-SEED (licence.json) A csomag Enterprise kiadású, és a seeden nincs licenc. Helyezze a licence.json fájlt a seed kötetre.
FAILED bundle: no volume labelled NEXUS-BUNDLE within 1 h Nem csatlakoztattak csomagot időben. Csatlakoztassa a csomagot tartalmazó meghajtót, és próbálja újra.
FAILED bundle: the bundle does not verify with this installer's release key A csomagellenőrzés nem a VERIFY-BUNDLE PASS üzenettel zárult. A saját kimenete, az üzenet felett, megnevezi a lépést. Álljon meg. Ne használja azt a csomagot. Szerezzen be egy újat.
FAILED bundle: the seed asks for enterprise, the bundle is community A seed és a csomag eltér egymástól. Javítsa a edition értéket a seedben, vagy hozza a megfelelő csomagot.
FAILED k3s: node not Ready within 10 min A k3s nem indult el. Ellenőrizze a naplóban (journal) a k3s bejegyzéseit, majd próbálja újra.
FAILED nexus: helm install nexus A chart nem települt az időkorláton belül. Nézze meg a kubectl -n nexus get pods,jobs kimenetét, növelje a timeout értékét a seedben, ha a gép lassú, majd próbálja újra.
FAILED acceptance: pods not ready Néhány pod nem fut a telepítés után. Az üzenet legfeljebb ötöt nevez meg. Olvassa el az eseményeiket, javítsa a hibát, majd próbálja újra.
FAILED acceptance: jobs not complete: <jobs> Egy hook Job nem fejeződött be. Olvassa el a megnevezett Job naplóját a kubectl -n nexus logs job/<name> paranccsal, javítsa ki a jelzett hibát, majd próbálja újra.

Az operációs rendszer kiírása előtt a lemezválasztás is megállíthatja a telepítést. Ennek üzenete nexus select-disk: REFUSED: formában kezdődik. A leggyakoribb a found 2 empty disks of >= 64 GB; need exactly one, or a NEXUS-SEED seed.yaml naming the disk with wipe: true. Nevezze meg a lemezt a seedben, és indítsa újra a gépet.

A sikertelen csomagellenőrzést kell igazán komolyan venni. Ez azt jelenti, hogy a lemezen lévő fájlok nem azok, amelyeket az Adverant aláírt, vagy egy fájlt hozzáadtak. A telepítő ezen a ponton még semmit sem importált, így a szerver változatlan. Őrizze meg a lemezt a biztonsági csapata számára.