Versie 1.0.0-alpha.1nieuwste
Hoofdstuk 2.17
Probleemoplossing
De problemen die beheerders het vaakst tegenkomen, geordend op wat u ziet. Bij elk probleem vindt u de oorzaak, het commando dat dit bevestigt en de oplossing, en het hoofdstuk sluit af met het versturen van een ondersteuningsbundel.
Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

Het meeste van wat er misgaat bij een installatie van Nexus gaat mis op dezelfde dozijn manieren, en bijna allemaal kondigen ze zichzelf aan met een code. Dit hoofdstuk is ingedeeld naar wat u ziet, in ruwweg de volgorde waarin u elk probleem zou tegenkomen: installeren, claimen, licentiëren en vervolgens draaien. Voor elk probleem krijgt u de oorzaak, een opdracht die dit bevestigt, en de oplossing.
De voorbeelden gebruiken de installatie van Harrow Port Authority: namespace nexus, release nexus, hosts console.harrow.example, api.harrow.example en auth.harrow.example. Vervang deze door die van uzelf. Drie gewoonten besparen tijd bij elk probleem dat hier wordt besproken:
- Lees de code vóór het bericht. Elke weigering in Nexus eindigt met een machinecode, en dit hoofdstuk is op die code geïndexeerd.
- Voer
nexusctl preflightopnieuw uit na elke wijziging aan het cluster of het values-bestand. Het leest het cluster zonder het te wijzigen, en het meldt de meeste weigeringen van de chart bij naam voordat Helm dat doet. - Gebruik
--explainbij elknexusctl-werkwoord waar u niet zeker van bent. Dit toont dekubectl- enhelm-bewerkingen zonder ze uit te voeren.
De installatie loopt vast
U hebt de installatie gestart en deze is niet voltooid. helm is na vijftien minuten nog niet teruggekeerd, of is wel teruggekeerd en pods staan nog steeds in Init of Pending, of het adres van de console reageert niet.
De meest voorkomende oorzaak is helm install --wait. Nexus maakt zijn database, zijn rollen en het schema van elke service aan in post-install-hooks, en de bootstrap-hook is wat elke service zijn databasewachtwoord geeft. Met --wait wacht Helm tot de Deployments gereed zijn voordat het die hooks uitvoert, terwijl de Deployments wachten op de hooks. Geen van beide komt vooruit. Installeer nooit met --wait; installeer zonder deze vlag en wacht achteraf.
De andere oorzaken zijn gewone Kubernetes-oorzaken. Images kunnen niet worden opgehaald omdat global.imageRegistry de verkeerde registry noemt, of omdat een Enterprise-installatie geen pull-token heeft. Een volume blijft op Pending staan omdat de opslagklasse niet bestaat. cert-manager ontbreekt, in welk geval de installatie helemaal niet blijft hangen: deze mislukt binnen enkele seconden, omdat de certificaatuitgevers van de chart de bronnen van cert-manager nodig hebben.
Begin met de pods en de hook-Jobs:
kubectl -n nexus get pods,jobs
kubectl -n nexus describe pod <pod-name>
kubectl -n nexus logs job/<job-name>
kubectl get crd certificates.cert-manager.iodescribe toont fouten bij het ophalen van images en niet-gekoppelde volumes in de bijbehorende events. Een hook-Job die 0/1 voltooiingen toont met een mislukte pod, heeft de installatie gestopt, omdat hook-Jobs een backoff-limiet van 0 hebben en nooit stilzwijgend opnieuw worden geprobeerd. In het bijbehorende logboek staat waarom.
Zo lost u elke oorzaak op:
- Als Helm wacht met
--wait, stopt u het, maakt u de installatie ongedaan en installeert u opnieuw zonder de vlag. Wacht vervolgens op de services:
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s- Controleer bij pull-fouten
global.imageRegistryen, voor Enterprise, het pull-token op de pagina Pull tokens and install commands van uw account. - Stel voor
Pending-volumesstorage.classNamein op een opslagklasse waarover het cluster beschikt, of maak er een de standaard. - Installeer bij een ontbrekende cert-manager cert-manager v1.21.3 en voer de installatie opnieuw uit.
- Los bij een mislukte hook op wat er in het bijbehorende logboek wordt genoemd en voer de installatie opnieuw uit.
Een pod wacht op zijn schema
De pod van een service blijft minutenlang in Init:0/1 staan. Elke service die de database gebruikt, heeft een init-container, wait-for-schema, die de pod vasthoudt totdat het release-register aangeeft dat de migraties voor de image van deze release zijn toegepast. Dat is normaal gedurende de eerste minuten van een installatie of een upgrade, terwijl de migratie-hooks worden uitgevoerd. Het is een probleem wanneer het niet ophoudt.
Lees het logboek van de init-container:
kubectl -n nexus logs <pod-name> -c wait-for-schemaHet logboek noemt het onderdeel, de migratieketens waarop het wacht en de tijdslimiet, en drukt vervolgens een regel af telkens wanneer de status verandert:
wait-for-schema: nexus-auth waits for nexus_release.schema_applied (read as nexus_ledger_reader) to show: nexus-auth-migrations=sha256:…; gives up after 1800s
| Voortgangsregel vermeldt | Wat het betekent |
|---|---|
| Welke ketens nog moeten worden toegepast voor deze release | De genoemde migratie-hooks zijn nog niet voltooid. Bekijk die Jobs. |
| Dat het release-register niet kan worden gelezen, met de foutmelding van de database | Postgres reageert niet, of het register bestaat niet omdat de database-bootstrap niet is uitgevoerd. |
FAILED (<component>): after <n>s, … |
Het heeft het opgegeven na schemaWait.timeoutSeconds (standaard 1.800). De init-container start opnieuw op; de service zelf is nooit gestart. |
Een keten die nooit wordt toegepast, betekent bijna altijd dat de bijbehorende migratie-Job is mislukt. Zoek deze met kubectl -n nexus get jobs en lees het logboek. Los op wat daarin wordt genoemd (een volle schijf, een externe database die de migrator niet kan bereiken, een rolconflict) en voer helm upgrade uit met dezelfde waarden: de hooks worden opnieuw uitgevoerd, en elke hook kan veilig opnieuw worden uitgevoerd.
Verhoog schemaWait.timeoutSeconds alleen wanneer een migratie traag en gezond is, zoals een grote eerste migratie op trage opslag kan zijn. Het verhogen ervan om een mislukte Job te verbergen, zorgt er alleen maar voor dat de pod langer wacht op iets dat nooit zal komen.
De sleutelkluis is verzegeld
Na een stroomuitval, een herstart van een node of een herstart van een containerruntime komen pods weer terug en laadt de console, en alles wat een sleutel nodig heeft, mislukt of wacht. De unsealer start na elke herstart van zijn node verzegeld op, en de sleutelopslag kan zichzelf niet ontzegelen totdat de unsealer open is.
Vraag het aan OpenBao in elke pod:
kubectl -n nexus exec openbao-unsealer-0 -c openbao -- \
bao status -format=json -address=https://127.0.0.1:8200 \
-ca-cert=/openbao/tls/ca.crt -tls-server-name=openbao-unsealer
echo "exit $?"Exitcode 0 is ontzegeld, 2 is verzegeld en 1 betekent dat er geen antwoord kon worden gegeven (vraag het over een minuut opnieuw). Voer hetzelfde uit tegen openbao-0 met -tls-server-name=openbao voor de sleutelopslag. Als de unsealer ontzegeld is en de sleutelopslag niet, is de sleutelopslag bezig zichzelf te ontzegelen; geef het een minuut.
Om een verzegelde unsealer te herstellen, voert één beheerder (custodian) unseal.sh van de chart uit met zijn eigen age-identiteit. Hoofdstuk 2.15, Dag twee: Nexus beheren, bevat de volledige opdracht. De exitcode van het script vertelt u wat er is gebeurd:
| Afsluitcode | Betekenis | Wat te doen |
|---|---|---|
| 0 | Ontzegeld | Controleer kubectl -n nexus get deploy,statefulset binnen een minuut. |
| 1 | Nog steeds verzegeld, of een ontzegelingsaanroep is mislukt | Lees de share-regels die zijn afgedrukt; voer het opnieuw uit. |
| 2 | Er ontbreekt een vereiste | Het bericht noemt het: AGE_IDENTITY, een binair bestand zoals age of jq, of een instelling voor de directe modus. |
| 3 | Deze identiteit kan de shares niet ontsleutelen | U bent geen beheerder (custodian) van deze installatie. Er is niets ingediend. Zoek een beheerder die dat wel is. |
U kunt zich niet aanmelden via HTTP
De console laadt op een http://-adres, of via een kubectl port-forward naar 127.0.0.1, en het aanmelden mislukt. De vraag om de passkey verschijnt nooit, of het aanmelden keert in een lus terug naar het begin.
Aanmelden vereist de eigen HTTPS-oorsprong (origin) van de console. De console accepteert alleen een aanmelding vanaf https://<hosts.console>, bewaart de sessie in een __Host--cookie die is gemarkeerd als Secure (wat een browser alleen via HTTPS opslaat), en de passkey van de eerste beheerder vereist een pagina met een geldig certificaat. Browsers weigeren passkeys achter een certificaatfout. Een port-forward naar http://127.0.0.1 kan zich nooit aanmelden.
Controleer wat de browser daadwerkelijk heeft bereikt:
curl -sI https://console.harrow.example
kubectl -n nexus get ingressDe eerste moet antwoorden via HTTPS met een certificaat dat uw machine vertrouwt. De tweede moet de drie hosts tonen met de namen die u hebt ingesteld in hosts.*.
Om dit op te lossen, bereikt u de console op https://console.harrow.example, de exacte naam in hosts.console, met een certificaat dat de browser vertrouwt. Controleer bij tls.mode: existing of tls.existingSecret een certificaat bevat voor alle drie de hosts. Controleer bij tls.mode: cert-manager of de ClusterIssuer het heeft uitgegeven. Bij tls.mode: none eindigt Transport Layer Security (TLS) op uw eigen loadbalancer, en daar moet het certificaat kloppen. Installeer voor een particuliere certificaatautoriteit het bijbehorende certificaat op de machines waarvan uw beheerders zich aanmelden.
De claimcode is verlopen
Op Claim this installation weigert de pagina de code met CLAIM_CODE_EXPIRED (410). Een claimcode bestaat uit drie groepen van vier tekens. Deze werkt één keer, gedurende 30 minuten, met 5 pogingen. Daarna, of na de vijfde foute poging, is de code ongeldig en is er niets geclaimd of gewijzigd.
Maak een nieuwe code aan vanuit de terminal die toegang heeft tot het cluster:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleHiermee wordt een nieuwe code en de vingerafdruk van de installatie afgedrukt. Voer de code binnen 30 minuten in op de claimpagina en vergelijk de vingerafdruk opnieuw.
Twee gerelateerde antwoorden:
RATE_LIMITED(429) op de claimpagina betekent dat er in de afgelopen minuut verschillende pogingen op de pagina zijn gedaan. Wacht het aantal seconden dat wordt aangegeven. Als u die pogingen niet hebt gedaan, probeert iemand anders op uw netwerk de pagina te gebruiken; zoek uit wie dat is voordat u claimt.TRANSITION_NOT_PERMITTED(409) betekent dat de installatie al is geclaimd en dat de bijbehorende claimpagina voorgoed is uitgeschakeld. Meld u in plaats daarvan aan. Als u deze niet hebt geclaimd, behandel dit dan als een beveiligingsincident.
De vingerafdruk komt niet overeen
De claimpagina toont CLAIM_FINGERPRINT_MISMATCH (403), of u ziet zelf dat de acht groepen van vier op de pagina afwijken van de groepen die uw terminal heeft afgedrukt. Zelfs één afwijkende groep betekent dat de browser met een andere installatie communiceert.
Stop. Typ de code niet in op die pagina. Mogelijk antwoordt er op dat adres iets anders dan uw installatie, wellicht een machine die is opgezet om de eerste beheerder te onderscheppen. Als u deze zou claimen, zou die machine uw organisatie in handen hebben. Uw eigen installatie is ongewijzigd en nog steeds niet geclaimd.
Controleer waar de naam naartoe verwijst en welk certificaat heeft geantwoord:
nslookup console.harrow.example
kubectl -n nexus get ingress
curl -svI https://console.harrow.exampleHet adres moet dat van uw ingress-controller zijn, en het certificaat moet het certificaat zijn dat u hebt geïnstalleerd voor hosts.console.
Om dit op te lossen, geeft u uw beveiligingsteam het adres dat heeft geantwoord en bewaart u het installatielogboek, waarin de vingerafdruk staat die de installatie heeft afgedrukt. Corrigeer het Domain Name System (DNS)-record of de proxy die u elders heen heeft gestuurd. Maak vervolgens een nieuwe claimcode aan met nexusctl claim-code --administrator <email> en claim vanuit een browser op een netwerk dat u vertrouwt, waarbij u alle acht de groepen opnieuw vergelijkt.
De licentie wordt geweigerd
Het importeren op Import the licence, Import a new licence of nexusctl licence import antwoordt met een weigering. Een geweigerde import verandert niets: de geldende licentie blijft van kracht en de klokondergrens verschuift niet.
Lees de code en de stap:
curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "Authorization: Bearer <access-token>" \
-H "Content-Type: application/json" \
--data-binary @harrow-2027.licence.jsonDe body van de weigering bevat code, message, refused_at (de stap die is mislukt) en troubleshooting. Om de status van de geldende licentie te zien, leest u GET https://auth.harrow.example/api/v1/installation/licence/state uit met hetzelfde token.
| Code | HTTP | Gebruikelijke oorzaak | Oplossing |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Het bestand is bewerkt, opnieuw opgemaakt of opnieuw opgeslagen, of er ontbreekt een handtekening | Download het opnieuw vanuit uw account en importeer het ongewijzigd |
LICENCE_FORMAT_INVALID |
422 | Geen licentie: verkeerd bestand, afgekapt of verpakt in een ander object | Verstuur het bestand precies zoals Adverant het heeft verstrekt |
LICENCE_ROOT_UNKNOWN |
422 | Ondertekend met een sleutel die deze release niet bevat | Voer een upgrade uit, of vraag om een licentie die is ondertekend voor uw release |
LICENCE_MATRIX_MISMATCH |
422 | Geschreven voor een nieuwere editiematrix, of kent een groep toe die deze build niet kent | Voer een upgrade uit, of vraag om een licentie die is geschreven voor uw release |
LICENCE_OTHER_INSTALLATION |
409 | Uitgegeven voor een andere installatie, vaak de licentie van het testcluster op productie | Vraag om een licentie voor de identiteit van deze installatie |
LICENCE_REVOKED |
403 | Adverant heeft deze ingetrokken | Vraag Adverant om een nieuwe licentie |
LICENCE_LOCKED |
403 | De starts_on ervan ligt na de huidige datum |
Importeer deze op of na de eerste geldigheidsdag |
TRANSITION_NOT_PERMITTED |
409 | Deze licentie-ID is al geïmporteerd | U hoeft niets te doen als deze van kracht is; vraag het aan Adverant als de voorwaarden moeten worden gewijzigd |
RECORD_NOT_FOUND |
404 | De installatie is nog niet gedeclareerd en heeft dus nog geen identiteit | Voltooi de stap voor de eerste beheerder en importeer vervolgens |
TENANT_NOT_A_PARAMETER |
403 | De body noemt een organisatie op het hoogste niveau | Stuur alleen het licentiebestand als de body |
Twee dingen lijken op licentieproblemen, maar zijn dat niet. Een uitgelezen status die LICENCE_CLOCK_BEHIND_FLOOR bevat, betekent dat de klok van de node een eerdere tijd aangeeft dan de laatste tijd die de installatie heeft gezien; corrigeer de tijd van de node, en als de klok vooruit had gelopen en de ondergrens had meegetrokken, vraag Adverant dan om een tijdreset-token. En een licentie die wordt geïmporteerd en een groep nog steeds als een teaser toont, kent die groep doorgaans niet toe: lees eerst de toekenningen op de licentiepagina.
Geen AI-antwoorden
De kunstmatige-intelligentie-assistent (AI-assistent) toont MODEL_NOT_CONNECTED (503), een workflowstap mislukt met NO_PROVIDER_FOR_ROLE (422), of antwoorden houden gewoon op.
De pool van de organisatie heeft geen sleutel die kan antwoorden, of de router kan de provider niet bereiken. Elke organisatie brengt haar eigen modelsleutel mee. Als er geen sleutel in gebruik is, is er geen AI – dat is een bewuste keuze – en springt er geen gedeelde sleutel bij.
Controleer de pool en de keuze van de router, elk met het eigen toegangstoken van de persoon:
GET https://console.harrow.example/api/v1/ai-providers
GET https://api.harrow.example/api/ai/routing-policy/effective
De eerste geeft een overzicht van elke provider, of deze kan antwoorden en waarom niet ("No key in use: 1 withdrawn, 1 lapsed"), en de status van elke sleutel. De tweede geeft als antwoord het model dat de router zou gebruiken voor de organisatie, of de weigering in woorden. Controleer vervolgens het pad het cluster uit met deze twee opdrachten:
kubectl -n nexus get networkpolicy nexus-operator-egress -o yaml
kubectl -n nexus logs deploy/nexus-gatewayWat elke bevinding betekent:
| U vindt | Oplossing |
|---|---|
| Geen sleutel in de pool | Een eigenaar of beheerder voegt een organisatiesleutel toe op het AI-schakelbord of via Instellingen, AI-modellen |
Sleutels invalid, expired of exhausted |
Voeg een nieuwe sleutel toe; de oude blijft vermeld als geschiedenis |
Sleutels resting |
Wacht: een falende sleutel rust 60 seconden, en na 5 mislukkingen op rij wordt deze uitgeschakeld (PROVIDER_KEY_SWITCHED_OFF) |
NO_PROVIDER_FOR_ROLE met sleutels in gebruik |
De rol heeft geen toewijzing en er komt niets overeen; stel de rol in het routeringsbeleid in |
MODEL_CAPABILITY_UNAVAILABLE (422) |
Het verzoek vereist een mogelijkheid, of een dataverblijfplaats (residency), die geen enkele provider in de pool biedt; schakel er een in die dat wel doet |
Geen nexus-operator-egress-beleid, of de bereiken van de provider ontbreken daarin |
Voeg de bereiken, geschreven in Classless Inter-Domain Routing (CIDR)-notatie, toe aan networkPolicy.externalEgressCIDRs en voer een upgrade uit |
| Een lokale modelserver die niet antwoordt | Controleer ai.localProvider.baseUrl, vermeld de server in ai.installationHosts en sta het bereik ervan toe in networkPolicy.externalEgressCIDRs |
Een sleutel van een gehoste provider die vanaf een laptop werkt en op de installatie mislukt, ligt bijna altijd aan het netwerkbeleid. De namespace weigert standaard uitgaand verkeer (egress).
429-antwoorden
Een client krijgt 429 Too Many Requests als antwoord. Nexus heeft vier plaatsen die dit kunnen melden, en de body vertelt u welke.
| Waar | Code en detail | Wat u moet wijzigen |
|---|---|---|
| nexus-auth, per aangemelde persoon | RATE_LIMITED met limit, windowSeconds en retryAfterSeconds |
auth.rateLimitPerMinute (standaard 5000), voor zware automatisering |
| Een limiet voor een scriptsleutel, app of eenheid (Enterprise) | RATE_LIMITED met vermelding van de sleutel en de bijbehorende limiet |
De limiet onder Instellingen, Rate-limieten, met een reden |
| De claimpagina bij het eerste gebruik | RATE_LIMITED met retry_after_seconds |
Niets: wacht en zoek uit wie er nog meer de pagina probeert te gebruiken |
| Een modelprovider | De router behandelt dit als een voorbijgaande storing en gaat door naar de volgende provider | Voeg een andere sleutel of provider toe als dit vaak gebeurt |
Elk antwoord bevat een Retry-After-header. Een zich goed gedragende client wacht zo lang en probeert het niet eerder opnieuw.
Als alle gebruikers tegelijk één limiet lijken te delen, controleer dan proxy.trustedCIDRs. Wanneer dit het podnetwerk van uw ingress-controller niet dekt, kan nexus-auth de X-Forwarded-For-header niet vertrouwen en ziet het elk verzoek als afkomstig van de controller. De standaardwaarde, 10.42.0.0/16, past alleen bij k3s.
kubectl get pods -A -o wideZoek het podadres van de ingress-controller in de uitvoer en zorg ervoor dat proxy.trustedCIDRs dit dekt.
Upgradefouten
De upgrade is teruggedraaid. De pagina Upgrade toont UPGRADE_ROLLED_BACK: er is een stap mislukt, elke engine staat weer op de vorige release en de gegevens zijn niet gewijzigd. De pagina noemt de stap. Een veelvoorkomende oorzaak is een volume dat te klein is voor de nieuwe indeling van een opslag. Los op wat er wordt genoemd, voer nexusctl upgrade plan --bundle <file> opnieuw uit en pas de upgrade vervolgens toe. De back-up wordt eerst opnieuw gemaakt.
De chart weigert te renderen met EXTERNAL_KEY_ENCRYPTION_KEY_INVALID. De Secret nexus-generated bevat EXTERNAL_KEY_ENCRYPTION_KEY in een vorm die de chart niet kan gebruiken. Het moet base64 van 32 bytes zijn, of de onbewerkte sleutel van 32 bytes van een oudere installatie. Iemand heeft de Secret bewerkt of vervangen. Zet de sleutel terug waaronder de gegevens van deze installatie zijn verzegeld, als base64 van de 32 bytes ervan (printf %s "$OLD" | base64), en voer de upgrade opnieuw uit. Laat de chart geen nieuwe aanmaken: gegevens die onder de oude sleutel zijn verzegeld, zouden onleesbaar blijven.
Scripts worden na de upgrade geweigerd met TOKEN_ORG_MISSING. Elke service die Application Programming Interface (API)-sleutels controleert via nexus-auth, weigert nu een sleutel zonder organisatie met 403 TOKEN_ORG_MISSING. Geef elk van zulke sleutels een organisatie, of geef een nieuwe sleutel uit.
Sleutels melden gedurende een uur de verkeerde applicatie. Wis de gecachte sleutelvermeldingen in de cache van nexus-auth, de Valkey-opslag van de installatie. Hoofdstuk 2.15, Dag twee: Nexus beheren, bevat de opdracht voor de opslag binnen het cluster en voor een externe opslag.
Een migratie-hook is mislukt. helm upgrade meldt een mislukte pre-upgrade-hook. Het schema wordt verplaatst voordat de nieuwe pods worden uitgerold, dus de draaiende release blijft nog steeds actief. Lees het logboek van de Job met kubectl -n nexus logs job/<job-name>, los op wat daarin wordt genoemd en voer de upgrade opnieuw uit.
Services konden hun tabellen enkele seconden niet gebruiken. Bij de eerste upgrade van een installatie die is gemaakt vanuit een eerdere chart, verliest elke service zijn oude standaard tabelrechten en krijgt deze zijn eigen rechten terug vanuit zijn eigen migratie. De onderbreking duurt enkele seconden. Voer de upgrade uit in een rustige periode, of schaal de services eerst terug naar nul.
De release op schijf is geweigerd. Importeren vanaf media toont MEDIA_SIGNATURE_INVALID (422): de bestanden zijn niet ondertekend met de releasesleutel die op deze installatie is geïnstalleerd. Er is niets geladen en de draaiende release blijft draaien. Bewaar de media voor uw beveiligingsteam en vraag Adverant om nieuwe media via de offline uitwisseling.
Een weigering bij het renderen van de chart
helm install, helm upgrade of helm template stopt voordat er iets wordt toegepast, met een bericht dat begint met een code of een waarde noemt. De chart weigert waarden die deze niet veilig kan uitvoeren. Er is niets op het cluster gewijzigd.
Render de chart afzonderlijk om elke weigering te zien zonder het cluster aan te raken. Gebruik op Enterprise de Enterprise-chart die u hebt gedownload in plaats van het oci://-adres, en stel networkPolicy.apiServerCIDRs in bij de waarden, omdat een offline render dit niet uit het cluster kan lezen:
helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version <version> \
-n nexus -f harrow-values.yaml > /dev/null
nexusctl preflight --context harrow-prod --values harrow-values.yamlPreflight controleert dezelfde identiteitswaarden in zijn sectie "time and keys" en meldt dezelfde codes. De exitcode ervan is 0 wanneer de installatie kan doorgaan (waarschuwingen blokkeren niet), 1 wanneer ten minste één controle is mislukt en 2 wanneer deze niet kon worden uitgevoerd.
| Weigering | Oorzaak | Oplossing |
|---|---|---|
INSTALLATION_NAME_MISSING |
keys.installationName is leeg |
Stel dit in op de eigen naam van deze installatie, overeenkomend met ^[a-z][a-z0-9-]{0,62}$. Dit is permanent zodra de sleutelopslag voor het eerst start |
INSTALLATION_NAME_EXAMPLE |
De naam is de naam uit de voorbeeld-values-bestanden van de chart | Stel uw eigen naam in |
keys.installationName "…" does not match … |
Hoofdletters, liggende streepjes of een cijfer aan het begin | Gebruik kleine letters, cijfers en koppeltekens, beginnend met een letter |
KEYS_CUSTODIAN_MISSING |
keys.custody.recipients is leeg |
Vermeld de age-ontvangers van uw beheerders (custodians), de openbare helften |
KEYS_CUSTODIAN_EXAMPLE |
Een ontvanger is de voorbeeldbeheerder uit de values-bestanden van de chart, van wie niemand de identiteit bezit | Vervang deze door de ontvangers van uw eigen beheerders |
keys.custody.recipients: … |
Een ontvanger in een vorm waarnaar de custody-Job niet kan versleutelen | Gebruik age1…, age1tag1…, age1tagpq1…, age1pq1… of age1se1…, in kleine letters |
NEXUS_EDITION_INVALID |
edition is noch community, noch enterprise |
Stel een van de twee in |
edition=… but enterprise.enabled=… |
De twee spreken elkaar tegen | Stel enterprise.enabled: true precies in wanneer edition gelijk is aan enterprise |
global.imageRegistry is required |
Geen registry genoemd | Stel de registry in waaruit uw nodes de images ophalen |
hosts.<name> is required |
Er ontbreekt een openbare host | Stel hosts.console, hosts.api en hosts.auth in |
tls.existingSecret is required when tls.mode is existing |
Geen certificaat-Secret genoemd | Noem de Secret, of kies een andere tls.mode |
tls.clusterIssuer is required when tls.mode is cert-manager |
Geen uitgever (issuer) genoemd | Noem uw ClusterIssuer |
dataTier.<store>.external.host is required when mode is external |
Een externe opslag zonder adres | Geef de bijbehorende host op, en de bijbehorende Secret in existingSecret |
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read |
helm template heeft geen cluster om ze in op te zoeken |
Geef de adressen van de API-server op als /32-bereiken |
EXTERNAL_KEY_ENCRYPTION_KEY_INVALID |
De gegenereerde sleutel in nexus-generated heeft de verkeerde vorm |
Zie "Upgradefouten" hierboven |
Een values-bestand dat een sleutel gebruikt die de chart niet heeft, of een waarde van het verkeerde type, wordt vóór al deze controles geweigerd door het schema van de chart. telemetry.enabled: true is één voorbeeld: het schema accepteert alleen false.
Een ondersteuningsbundel versturen
Wanneer niets hiervan het probleem oplost, stuurt u Adverant een ondersteuningsbundel (support bundle) bij uw ondersteuningsverzoek.
nexusctl support-bundle --out harrow-support-<request-number>.tar.gz<request-number> is het nummer van het verzoek dat u hebt geopend op de pagina Support and support bundles van uw account. U kunt dezelfde bundel maken vanaf de pagina Support bundle van de console onder This installation.
De bundel bevat enginelogboeken van de afgelopen 24 uur, status- en versiegegevens, instellingen zonder hun geheimen, en de preflight- en installatierapporten. Voordat deze wordt weggeschreven, vervangt redactie namen, geheimen en adressen, en leest u een voorbeeld van wat er precies naar buiten gaat. Berichten, bestanden en geheugen van personen worden nooit verzameld.
Upload deze bij het verzoek in uw account, of sla deze op media op en neem deze mee naar buiten als de installatie geen verbinding met buiten heeft. Alleen de ondersteuningstechnici die op het verzoek worden genoemd, kunnen de bundel openen, en deze wordt na 30 dagen gewist. Vermeld in het verzoek naar welk van de bovenstaande problemen u keek en wat de controles in dit hoofdstuk lieten zien: dat bespaart een extra berichtwisseling.


