Naslag Voor: beheerders, gebruikers

Datastorefouten

Oorzaken en oplossingen voor de foutcodes van datastores, datastorebestanden, uploads en schijfimages.

error.datastore.not_shareable

Tekst in de console
Datastore {datastore} kan niet op één host worden gekoppeld of ontkoppeld. Verwijder de datastore, of kies een NFS-datastore.
Betekenis voor API-clients
The datastore cannot be mounted on or unmounted from a single host: an iSCSI (VMFS-like) datastore belongs to one host, a local datastore to its own.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
datastorede naam van de datastore.

Oorzaak. Een datastore zou worden gekoppeld aan een host, of losgekoppeld van één host, die de datastore niet kan delen. Een datastore op een iSCSI-LUN (het type dat op VMFS lijkt) is een bestandssysteem van één host en kan zo niet tussen hosts worden verplaatst. Een lokale datastore is een map van de eigen host en kan alleen daar opnieuw worden gekoppeld.

Oplossing.

  1. Verwijder een iSCSI-datastore die u niet meer gebruikt: kyvernon host remove-datastore <id> <ds-id>, of van alle hosts: kyvernon datastore remove <ds-id>.
  2. Gebruik een NFS-datastore om opslag tussen hosts te delen, en koppel die aan elke host: kyvernon host mount-datastore <id> <ds-id>.

error.datastore.insufficient_space

Tekst in de console
Datastore {datastore} heeft ruimte voor {available} bytes; er is om {requested} bytes gevraagd. Kies een kleinere schijf of een andere datastore.
Betekenis voor API-clients
A new or grown disk asks for more bytes than the datastore has free (thick) or than the thin-disk cap.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
requestedde bytes die de bewerking vraagt.
availablede bytes die de datastore, of de thin-schijflimiet, kan geven.
datastorede naam van de datastore.

Oorzaak. Een nieuwe of vergrote schijf vraagt meer bytes dan de datastore vrij heeft (thick-schijven), of meer dan de grootste toegestane thin-schijf. Die limiet is max_thin_disk_gib in de sectie [vm_ops] van de controllerconfiguratie, of de capaciteit van de datastore wanneer de instelling 0 is.

Oplossing.

  1. Kies een kleinere schijfgrootte, of een datastore met meer vrije ruimte.
  2. Maak ruimte vrij op de datastore: verwijder bestanden die nergens meer worden gebruikt. kyvernon datastore orphans <id> toont schijfimages waarnaar geen virtuele machine, sjabloon of snapshot verwijst.
  3. Voor thin-schijven kan een beheerder max_thin_disk_gib verhogen. Geef de bericht-id en de naam van de datastore door.

error.image_in_use

Tekst in de console
Het imagebestand ondersteunt nog de virtuele machine {vm}. Verwijder of verplaats die virtuele machine eerst.
Betekenis voor API-clients
The image file backs a VM.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
vmde id van de virtuele machine waarvan het bestand de schijf is.

Oorzaak. Er zou een schijf worden gemaakt van een imagebestand dat nog de schijf van een andere virtuele machine is. Het kopiëren of koppelen van het bestand van een virtuele machine die draait of is onderbroken, of van een gekoppelde kloon ervan, wordt geweigerd.

Oplossing.

  1. Schakel de virtuele machine uit die het bestand bevat, of verwijder die virtuele machine als ze niet meer nodig is.
  2. Maak de schijf van een sjabloon, of kloon de virtuele machine in plaats van haar bestand.
  3. Herhaal de bewerking.

error.datastore_bad_path

Tekst in de console
Het pad is ongeldig: het moet relatief zijn, onder de root van de datastore liggen en niet leeg zijn. Corrigeer het pad.
Betekenis voor API-clients
The datastore path is empty, absolute, or escapes the root.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
fieldhet aanvraagveld met het geweigerde pad.

Oorzaak. Het pad op de datastore is leeg, absoluut, bevat .. of een interne naam, of zou de hoofdmap van de datastore verlaten. De hoofdmap zelf kan niet worden verwijderd.

Oplossing.

  1. Geef een pad op dat relatief is ten opzichte van de hoofdmap van de datastore, bijvoorbeeld images/disk1.qcow2.
  2. Begin het pad niet met / en gebruik geen ...

error.datastore_file_exists

Tekst in de console
Er bestaat al een bestand of map met die naam. Kies een andere naam, of sta overschrijven toe.
Betekenis voor API-clients
The file or folder exists (use overwrite).
Code
ALREADY_EXISTS, HTTP 409

Oorzaak. Op de bestemming bestaat al een bestand of map met die naam.

Oplossing.

  1. Kies een andere naam, of verwijder het bestaande bestand als het niet meer nodig is: kyvernon datastore rm <id> <path>.
  2. Om het bestand bewust te vervangen, herhaalt u de bewerking met overschrijven toegestaan: kyvernon datastore upload <id> <file> --overwrite, of --overwrite bij cp en mv.

error.datastore_file_not_found

Tekst in de console
Het bestand bestaat niet op de datastore. Het is mogelijk verwijderd. Vernieuw de lijst.
Betekenis voor API-clients
No such file on the datastore.
Code
NOT_FOUND, HTTP 404

Oorzaak. Het bestand bestaat niet op de datastore. Het is mogelijk verplaatst of verwijderd, of de naam van de datastore is onjuist.

Oplossing.

  1. Toon de map: kyvernon datastore ls <id> <path>. Vernieuw in de console de bestandslijst met Vernieuwen.
  2. Herhaal de bewerking met het pad zoals het wordt getoond.

error.datastore_folder_not_found

Tekst in de console
De map bestaat niet op de datastore. Ze is mogelijk verwijderd. Vernieuw de lijst.
Betekenis voor API-clients
No such folder on the datastore.
Code
NOT_FOUND, HTTP 404

Oorzaak. De map bestaat niet op de datastore, of het pad leidt naar een bestand terwijl een map werd verwacht.

Oplossing.

  1. Toon de bovenliggende map: kyvernon datastore ls <id> <path>.
  2. Maak de map aan, met de bovenliggende mappen: kyvernon datastore mkdir <id> <path>. Gebruik in de console Nieuwe map.

error.datastore_folder_not_empty

Tekst in de console
De map bevat nog bestanden. Verwijder eerst de inhoud.
Betekenis voor API-clients
The folder still has entries.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De map bevat nog bestanden of mappen, en een map kan alleen worden verwijderd wanneer ze leeg is.

Oplossing.

  1. Toon de inhoud: kyvernon datastore ls <id> <path>.
  2. Verwijder eerst de bestanden erin: kyvernon datastore rm <id> <path>/<name>.
  3. Verwijder de map.

error.datastore_file_in_use

Tekst in de console
Het bestand ondersteunt een schijf van de virtuele machine {vm}. Verwijder die schijf eerst uit de virtuele machine.
Betekenis voor API-clients
The file backs a VM disk.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
vmde naam van de virtuele machine die het bestand gebruikt.
vmIdde id van die virtuele machine.

Oorzaak. Het bestand of de map bevat een schijf van een virtuele machine, of van een snapshot ervan. Kyvernon weigert zulke bestanden te verwijderen of te overschrijven.

Oplossing.

  1. Verwijder de schijf uit die virtuele machine, of verwijder de virtuele machine, als de gegevens niet meer nodig zijn.
  2. Herhaal de bewerking.

error.datastore_upload_too_large

Tekst in de console
De upload overschrijdt de limiet van {limit} bytes. Splits het bestand of vraag een beheerder de limiet te verhogen.
Betekenis voor API-clients
The upload exceeds limit bytes (HTTP 413).
Code
RESOURCE_EXHAUSTED, HTTP 413
ArgumentInhoud
limitde uploadlimiet in bytes.

Oorzaak. Het bestand is groter dan de uploadlimiet van de controller. De limiet is max_upload_bytes in de sectie [files] van de controllerconfiguratie. De waarde 0 betekent geen limiet.

Oplossing.

  1. Splits het bestand, of zet het op een andere manier op de datastore, bijvoorbeeld door het op de host te kopiëren.
  2. Een beheerder kan max_upload_bytes verhogen en de controller herstarten. Geef de bericht-id en de grootte van het bestand door.

error.datastore_upload_incomplete

Tekst in de console
De upload eindigde voordat het hele bestand binnen was. Upload het bestand opnieuw.
Betekenis voor API-clients
The upload ended before Content-Length bytes.
Code
INVALID_ARGUMENT, HTTP 400

Oorzaak. De upload eindigde voordat het in Content-Length aangekondigde aantal bytes was aangekomen. De verbinding is verbroken, of de client is eerder gestopt.

Oplossing.

  1. Upload het bestand opnieuw: kyvernon datastore upload <id> <file> --path <path> --overwrite.
  2. Upload bij een onstabiele verbinding vanaf een machine met een betere verbinding met de controller.

error.datastore_read_only

Tekst in de console
De datastore weigert schrijfbewerkingen. Kies een andere datastore of vraag een beheerder de datastore beschrijfbaar te maken.
Betekenis voor API-clients
The datastore refuses writes.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De datastore weigert schrijfbewerkingen. Ze is alleen-lezen gekoppeld, of haar pool is als alleen-lezen gemarkeerd.

Oplossing.

  1. Kies een andere datastore.
  2. Een beheerder maakt de datastore schrijfbaar, of koppelt ze met lees- en schrijfrechten. Geef de naam van de datastore door.

error.datastore_range_invalid

Tekst in de console
Het gevraagde deel van het bestand bestaat niet. Download het hele bestand.
Betekenis voor API-clients
The Range header cannot be satisfied (HTTP 416).
Code
INVALID_ARGUMENT, HTTP 416

Oorzaak. De header Range van een download vraagt bytes voorbij het einde van het bestand.

Oplossing.

  1. Download het hele bestand: kyvernon datastore download <id> <path> --to <local-path>.
  2. API-clients die een download hervatten, stellen het begin van het bereik lager in dan de grootte van het bestand, die ze eerst lezen.

error.datastore_inaccessible

Tekst in de console
Datastore {datastore} is niet toegankelijk vanaf de hosts. Controleer de opslagverbinding van de hosts.
Betekenis voor API-clients
The datastore is not accessible from its hosts.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
datastorede naam van de datastore.

Oorzaak. De datastore is gemarkeerd als niet toegankelijk vanaf haar hosts, of heeft geen bestandspad dat de controller kan gebruiken.

Oplossing.

  1. Controleer de opslagverbinding van de hosts die de datastore koppelen: de koppeling, het netwerkpad en de status van de opslagserver.
  2. Herstel de verbinding. De datastore wordt weer toegankelijk zodra een host haar meldt.
  3. Geef de bericht-id en de naam van de datastore door wanneer u de opslag zelf niet kunt bereiken.

error.datastore_no_host

Tekst in de console
Geen enkele verbonden host koppelt datastore {datastore}. Verbind een host die de datastore koppelt.
Betekenis voor API-clients
No connected host mounts the datastore.
Code
hangt af van de oorzaak
ArgumentInhoud
datastorede naam van de datastore.

Oorzaak. Geen enkele host die met de controller is verbonden, koppelt de datastore, dus geen host kan haar bestanden lezen of schrijven.

Oplossing.

  1. Controleer welke hosts de datastore koppelen: kyvernon inventory datastore <id>.
  2. Verbind een host die haar koppelt, of koppel de datastore aan een verbonden host. Een beheerder verbindt een host opnieuw met kyvernon host reconnect <id>.

error.datastore_not_on_host

Tekst in de console
De gekozen host koppelt datastore {datastore} niet. Kies een andere host of datastore.
Betekenis voor API-clients
The chosen host does not mount the datastore.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
datastorede id van de datastore.

Oorzaak. Een schijf is geplaatst op een datastore die de gekozen host niet koppelt.

Oplossing.

  1. Kies een datastore die de host koppelt, of kies een host die de datastore koppelt.
  2. Herhaal de bewerking.

error.datastore_not_shared

Tekst in de console
De bewerking vereist een datastore die door beide hosts wordt gedeeld. Kies een gedeelde datastore.
Betekenis voor API-clients
The operation needs a datastore shared by both hosts.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De bewerking verplaatst een draaiende virtuele machine naar een andere host, wat een datastore vereist die beide hosts koppelen. Een virtuele machine samen met haar schijven verplaatsen naar een host die de datastore niet koppelt, wordt niet geboden.

Oplossing.

  1. Kies een datastore die beide hosts koppelen.
  2. Schakel de virtuele machine uit en verplaats haar met een datastore van de doelhost: kyvernon vm relocate <id> --host <host> --datastore <datastore>.

Versie 0.1. Laatst gewijzigd: 2026-11-13