Werkwijze Voor: beheerders, gebruikers

Problemen met opslag oplossen

Oorzaken en oplossingen voor onvoldoende ruimte, een image in gebruik, een te grote upload, een onbereikbare datastore en geweigerde bestandsbewerkingen.

Elke weigering komt met een berichtid zoals error.datastore.insufficient_space. De pagina foutcodes leidt van het id naar de volledige beschrijving.

Onvoldoende ruimte

Oorzaak. Een nieuwe of vergrote schijf vraagt meer bytes dan de datastore vrij heeft, of een schijf met thin provisioning is groter dan de limiet die de beheerder heeft ingesteld: error.datastore.insufficient_space.

Oplossing. Kies een kleinere schijf of een datastore met meer vrije ruimte. Maak ruimte vrij door bestanden te verwijderen waar niets naar verwijst: kyvernon datastore orphans <datastore> toont de schijfimages waar geen virtuele machine, sjabloon of snapshot naar verwijst, zie Schijven. Een beheerder kan max_thin_disk_gib voor schijven met thin provisioning verhogen.

Image in gebruik

Oorzaak. Een schijf moest worden gemaakt van een imagebestand dat nog de schijf is van een andere virtuele machine die draait of is onderbroken: error.image_in_use. Het verwijderen of overschrijven van een bestand dat de schijf van een virtuele machine, of van een van haar snapshots, bevat, wordt ook geweigerd: error.datastore_file_in_use.

Oplossing. Schakel de virtuele machine uit die het bestand bevat, of verwijder haar wanneer ze niet meer nodig is. Maak nieuwe schijven van een image die geen enkele machine gebruikt, van een sjabloon, of kloon de virtuele machine in plaats van haar bestand. Een gekoppelde kloon vraagt dat zijn basisimage blijft: verwijder de klonen vóór de image.

Upload te groot

Oorzaak. Het bestand is groter dan de uploadlimiet van de controller, max_upload_bytes in de sectie [files] van zijn configuratie: error.datastore_upload_too_large. Het antwoord heeft status 413.

Oplossing. Een beheerder verhoogt de limiet en herstart de controller, of zet het bestand op een andere manier op de datastore, bijvoorbeeld door het op de host te kopiëren. Een upload die vroeg eindigde, meldt error.datastore_upload_incomplete: upload het bestand opnieuw met kyvernon datastore upload <datastore> <file> --path <path> --overwrite.

Datastore onbereikbaar

Oorzaak. Geen enkele verbonden host koppelt de datastore, of de opslagverbinding van de hosts is verbroken: error.datastore_inaccessible en error.datastore_no_host. De console toont Datastore niet toegankelijk.

Oplossing. Controleer de koppeling, het netwerkpad en de toestand van de opslagserver. Verbind een host die bewust is losgekoppeld opnieuw met kyvernon host reconnect <host>.

Schrijven geweigerd

Oorzaak. De datastore is alleen-lezen gekoppeld: error.datastore_read_only.

Oplossing. Kies een andere datastore, of vraag een beheerder hem lezen-en-schrijven te koppelen.

Pad geweigerd

Oorzaak. Het pad is leeg, absoluut, bevat .. of verlaat de root van de datastore: error.datastore_bad_path. Een bestand dat al bestaat, wordt gemeld als error.datastore_file_exists, en een map die niet leeg is als error.datastore_folder_not_empty.

Oplossing. Gebruik een pad relatief ten opzichte van de root, zoals images/disk1.qcow2. Sta overschrijven bewust toe met --overwrite, of verwijder eerst de inhoud van de map.

Versie 0.1. Laatst gewijzigd: 2026-11-13