Naslag Voor: beheerders, gebruikers

Fouten bij opslagmigratie

Oorzaken en oplossingen voor de foutcodes bij het verplaatsen van de schijven van een virtuele machine naar een andere datastore, aan of uit.

error.storage_move.runtime

Tekst in de console
Deze host draait de virtuele machine op de oude runtime, die de schijven van een draaiende virtuele machine niet kan verplaatsen. Zet ze uit om haar schijven te verplaatsen.
Betekenis voor API-clients
A storage migration of a running VM needs Kyvernon VMM; the host runs the VM on the legacy runtime. Power the VM off to move its disks.
Code
UNIMPLEMENTED, HTTP 501
ArgumentInhoud
fieldstorage_move.live.

Oorzaak. De schijven van een draaiende virtuele machine moesten naar een andere datastore worden verplaatst, maar de host draait de machine op de oudere runtime. Alleen Kyvernon VMM kan de schijven van een draaiende machine kopiëren en overschakelen op de kopieën.

Oplossing.

  1. Schakel de virtuele machine uit en verplaats de schijven dan: kyvernon vm power-off <id>, daarna kyvernon vm relocate <id> --datastore <datastore>.
  2. Of verplaats haar eerst naar een host die Kyvernon VMM draait.

error.storage_move.internal_snapshots

Tekst in de console
Schijf {disk} bevat interne snapshots, die niet kunnen verhuizen terwijl de virtuele machine draait. Zet ze uit of verwijder die snapshots.
Betekenis voor API-clients
The active image of the disk holds internal qcow2 snapshots, which a running VM cannot carry to another datastore.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
diskde apparaatsleutel van de schijf.

Oorzaak. Het actieve image van de schijf bevat interne qcow2-snapshots. Het image van een draaiende machine wordt blok voor blok gekopieerd, en interne snapshots kunnen die weg niet volgen. Images met interne snapshots komen van de oudere runtime of van een import; Kyvernon VMM maakt externe snapshots.

Oplossing.

  1. Schakel de virtuele machine uit en verplaats haar dan: een verplaatsing van een uitgeschakelde machine kopieert het bestand met zijn snapshots.
  2. Of verwijder die snapshots eerst.

error.storage_move.nonpersistent

Tekst in de console
Schijf {disk} is onafhankelijk niet-persistent en verhuist alleen terwijl de virtuele machine uitstaat.
Betekenis voor API-clients
An independent non-persistent disk moves only while the VM is powered off.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
diskde apparaatsleutel van de schijf.

Oorzaak. De schijf is onafhankelijk niet-persistent: haar wijzigingen worden weggegooid wanneer de machine stopt, en die weggooilaag kan niet worden verplaatst terwijl de machine draait.

Oplossing.

  1. Schakel de virtuele machine uit en verplaats haar dan: kyvernon vm power-off <id>, daarna kyvernon vm relocate <id> --datastore <datastore>.

error.storage_move.consolidate_with_snapshots

Tekst in de console
De schijfketen kan niet worden samengevoegd zolang de virtuele machine snapshots heeft. Behoud de keten of verwijder eerst de snapshots.
Betekenis voor API-clients
Merging the disk chain (consolidate) would destroy the VM's snapshots.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
diskde apparaatsleutel van de schijf.

Oorzaak. De verplaatsing moest de schijfketen samenvoegen tot één image (chain: consolidate, of moveAllDiskBackingsAndConsolidate vanuit een vSphere-client), maar de virtuele machine heeft snapshots. Het samenvoegen van de keten zou ze vernietigen.

Oplossing.

  1. Verplaats de schijf met haar keten: laat --chain weg (de keten blijft behouden) of gebruik --chain keep.
  2. Of verwijder eerst de snapshots en voeg dan samen: kyvernon vm snapshot remove-all <id>.

error.storage_move.convert_with_chain

Tekst in de console
Het formaat van schijf {disk} kan niet veranderen, omdat ze snapshots of een basis van een gekoppelde kloon heeft. Behoud het formaat of voeg de keten samen.
Betekenis voor API-clients
The provisioning of a disk with a snapshot chain or a linked-clone base cannot change in a move.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
diskde apparaatsleutel van de schijf.

Oorzaak. De verplaatsing moest het formaat van een schijf wijzigen (thin, thick lazy, thick eager) die snapshots heeft of een gekoppelde kloon is. Alleen een schijf die als één image eindigt kan van formaat veranderen.

Oplossing.

  1. Verplaats de schijf in haar huidige formaat: laat --provisioning weg.
  2. Of voeg de keten tijdens het verplaatsen samen (--chain consolidate), wat een machine zonder snapshots vereist.

error.storage_move.has_dependents

Tekst in de console
Schijf {disk} is de basis van gekoppelde klonen ({dependents}). Verplaats die eerst, of koppel aan een identieke basis op het doel.
Betekenis voor API-clients
The image is the base of other VMs' linked clones (dependents).
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
diskde apparaatsleutel van de schijf.
dependentsde virtuele machines waarvan de schijven het image als basis gebruiken.

Oorzaak. Het schijfimage is de basis van gekoppelde klonen van andere virtuele machines. Het alleen verplaatsen zou die klonen zonder hun basis achterlaten.

Oplossing.

  1. Verplaats eerst de gekoppelde klonen, met --chain share-existing, naar dezelfde datastore.
  2. Verplaats daarna deze machine met --chain share-existing: ze koppelt zich aan de kopie van de basis die de klonen al hebben meegebracht.

error.storage_move.destination_exists

Tekst in de console
{path} bestaat al op de doeldatastore. Kies een andere map of verwijder het bestand.
Betekenis voor API-clients
A file that does not belong to the move is in the way at the target path.
Code
ALREADY_EXISTS, HTTP 409
ArgumentInhoud
pathhet pad onder de root van de doeldatastore.
datastorede doeldatastore.

Oorzaak. Op het pad dat de schijf op de doeldatastore zou krijgen bestaat al een bestand dat niet bij de verplaatsing hoort.

Oplossing.

  1. Bekijk het bestand in de datastore-browser: kyvernon datastore ls <datastore> <folder>.
  2. Verwijder het als niets het gebruikt, of geef de schijf een andere map: --disk KEY=DATASTORE,path=<folder>/<file>.qcow2.

error.storage_move.move_type

Tekst in de console
Deze manier om snapshotketens te verplaatsen wordt niet aangeboden.
Betekenis voor API-clients
The chain value or diskMoveType is not offered for a relocation.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
fieldhet verzoekveld dat de waarde bevat.

Oorzaak. De manier om de snapshotketen te verplaatsen wordt niet aangeboden. moveChildMostDiskBacking van vSphere zou de ouders op een andere datastore achterlaten, en createNewChildDiskBacking is een optie van een kloon, niet van een verplaatsing.

Oplossing.

  1. Gebruik keep, share-existing of consolidate (vSphere: moveAllDiskBackingsAndDisallowSharing, moveAllDiskBackingsAndAllowSharing, moveAllDiskBackingsAndConsolidate).

error.storage_move.no_convergence

Tekst in de console
De kopie kon de schrijfacties van de virtuele machine niet bijhouden. Er is niets veranderd. Verhoog of verwijder de snelheidslimiet, of verplaats ze wanneer ze minder schrijft.
Betekenis voor API-clients
The copy of a running VM's disk could not catch up with the guest's writes; the VM stays on its old disks.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
writeRatede schrijfsnelheid van de gast in bytes per seconde.
copyRatede kopieersnelheid in bytes per seconde.

Oorzaak. De kopie van de schijf van een draaiende machine kon de schrijfacties van de gast niet bijhouden, zelfs niet met die schrijfacties tot het minimum vertraagd. Er is niets gewijzigd: de machine draait op haar oude schijven. Een limiet op de kopieersnelheid onder de schrijfsnelheid van de machine leidt hiertoe.

Oplossing.

  1. Open in de console het overzicht van de virtuele machine, kies Limiet wijzigen op de kaart Opslagmigratie en vul een hogere limiet in, of 0 voor geen limiet. Wijzig voor een nieuwe verplaatsing Kopieersnelheid beperken (MiB/s) onder Geavanceerde opties in de wizard.
  2. Verhoog of verwijder met de CLI de limiet op de kopieersnelheid: --max-bandwidth bij kyvernon vm relocate, of kyvernon vm relocation-limit <id> --max-bandwidth 0 terwijl een verplaatsing loopt.
  3. Verplaats de machine wanneer ze minder schrijft, of schakel haar uit en verplaats haar dan.

error.storage_move.switchover_timeout

Tekst in de console
De overschakeling naar de nieuwe schijven duurde te lang en is ongedaan gemaakt. De virtuele machine draait verder op haar oude schijven.
Betekenis voor API-clients
The switch to the new disks did not finish within switchover_max_ms; the VM continues on its old disks.
Code
DEADLINE_EXCEEDED, HTTP 504

Oorzaak. De laatste overschakeling naar de nieuwe schijven, waarbij de schijfverzoeken van de gast wachten, was niet binnen de toegestane tijd klaar (standaard 2 seconden). Ze is teruggedraaid: de machine gaat verder op haar oude schijven en er is niets gewijzigd.

Oplossing.

  1. Start de verplaatsing opnieuw; een golf schrijfacties tijdens de overschakeling is de gebruikelijke reden.
  2. Gebeurt het opnieuw, controleer dan de latentie van de doeldatastore, of verplaats de machine wanneer ze minder schrijft.

error.storage_move.target_io

Tekst in de console
De doeldatastore faalde of antwoordde niet meer tijdens de kopie. De virtuele machine blijft op haar oude schijven.
Betekenis voor API-clients
The target datastore failed or stopped answering during the copy; the VM stays on its old disks.
Code
UNAVAILABLE, HTTP 503
ArgumentInhoud
datastorede doeldatastore, indien bekend.

Oorzaak. De doeldatastore viel uit, liep vol of reageerde niet meer terwijl de schijven werden gekopieerd. De schijfverzoeken van de machine wachten nooit op het doel, dus ze bleef draaien op haar oude schijven; de kopieën zijn verwijderd.

Oplossing.

  1. Controleer de doeldatastore: haar vrije ruimte (kyvernon datastore refresh <datastore>) en, voor NFS of iSCSI, de opslagserver en het netwerkpad.
  2. Start de verplaatsing opnieuw wanneer de datastore reageert.

error.storage_move.vm_stopped

Tekst in de console
De virtuele machine stopte tijdens het verplaatsen van haar schijven. Er is niets veranderd. Verplaats ze opnieuw terwijl ze uitstaat.
Betekenis voor API-clients
The VM stopped during a move of its running disks; nothing changed. Move it again while it is powered off.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De virtuele machine werd uitgeschakeld, door haar gast gestopt of crashte terwijl de schijven van de draaiende machine werden gekopieerd. De verplaatsing is teruggedraaid; er is niets gewijzigd.

Oplossing.

  1. Verplaats de machine nu, terwijl ze is uitgeschakeld: kyvernon vm relocate <id> --datastore <datastore>.
  2. Of schakel haar in en start de verplaatsing opnieuw.

error.storage_move.interrupted

Tekst in de console
Het verplaatsen werd op de host onderbroken. Het wordt automatisch afgewerkt of ongedaan gemaakt zodra de host terug is.
Betekenis voor API-clients
The move was lost with the VMM or the host's state; it is undone or finished from the files.
Code
UNAVAILABLE, HTTP 503

Oorzaak. De host is de verplaatsing kwijtgeraakt: zijn agent is herstart zonder zijn records, of het hypervisorproces van de machine eindigde tijdens het kopiëren. Vóór de overschakeling naar de nieuwe schijven wordt de verplaatsing teruggedraaid; na de overschakeling wordt ze afgerond. De controller doet dit zelf zodra de host antwoordt.

Oplossing.

  1. Wacht tot de host weer verbonden is. De verplaatsing is dan afgerond of teruggedraaid; kyvernon vm relocation <id> toont haar als afgerond na een onderbreking.
  2. Zijn noch de oude noch de nieuwe schijfbestanden volledig, dan blijft de verplaatsing open en is een beheerder nodig. Neem contact op met de support en geef de id van de virtuele machine door.

error.storage_move.source_io

Tekst in de console
Een bestand van de schijf kon niet worden gelezen op de brondatastore ({path}). Er is niets veranderd. Controleer de brondatastore en verplaats opnieuw.
Betekenis voor API-clients
A file of the disk could not be read on the source datastore during the copy; nothing changed.
Code
UNAVAILABLE, HTTP 503
ArgumentInhoud
pathhet bestand dat niet kon worden gelezen.

Oorzaak. Een bestand van de schijf kon tijdens het kopiëren niet worden gelezen op de brondatastore: de opslag meldde een leesfout of reageerde niet meer. De verplaatsing eindigde vóór haar overschakeling; de virtuele machine is ongewijzigd en de kopieën zijn verwijderd.

Oplossing.

  1. Controleer de brondatastore: de gezondheid van haar schijven en, voor NFS of iSCSI, de opslagserver en het netwerkpad. Het argument path noemt het bestand.
  2. Start de verplaatsing opnieuw wanneer de datastore normaal leest. Is het bestand zelf beschadigd, herstel de schijf dan eerst vanuit een back-up.

error.storage_move.not_switched

Tekst in de console
Het verplaatsen is nog niet overgeschakeld naar de nieuwe schijven, dus de oude bestanden kunnen nog niet worden verwijderd.
Betekenis voor API-clients
The move has not reached its switch (and its verification) yet, so its old files cannot be deleted.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De host kreeg het verzoek de oude bestanden te verwijderen van een verplaatsing die nog niet naar de nieuwe schijven is overgeschakeld, of waarvan de verificatie nog niet is afgerond. De controller vraagt dit pas na de overschakeling, dus dit wijst op een onderbroken of herhaald verzoek.

Oplossing.

  1. Volg de verplaatsing: kyvernon vm relocation <id>. De oude bestanden worden door de verplaatsing zelf verwijderd zodra de overschakeling en de verificatie klaar zijn.

error.storage_move.unknown_job

Tekst in de console
De host kent deze opslagmigratie niet. Ze wordt op basis van de bestanden afgewerkt of ongedaan gemaakt zodra de controller controleert.
Betekenis voor API-clients
The host does not know the storage migration job (it ended and was forgotten, or the host lost its records).
Code
NOT_FOUND, HTTP 404

Oorzaak. De host kent de opslagmigratietaak niet waarnaar de controller vraagt. Ze is afgerond en vergeten, of de host is zijn records kwijtgeraakt (zijn statusmap is vervangen).

Oplossing.

  1. Meestal is niets nodig: de controller beslist aan de hand van de bestanden welke schijven actueel zijn en rondt de verplaatsing af of draait haar terug.
  2. Toont kyvernon vm relocation <id> de verplaatsing na enkele minuten nog steeds, controleer dan of de host verbonden is: kyvernon inventory host <host>.

error.storage_move.rolled_back

Tekst in de console
De virtuele machine is na een mislukte controle teruggezet op haar oude schijven. De nieuwe schijven zijn verwijderd; de schrijfacties sinds de overschakeling zijn verloren.
Betekenis voor API-clients
The administrator returned the VM to its old disks after a failed verification; the new disks were deleted and the writes since the switch are lost.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. Nadat de controle van een opslagmigratie mislukte, koos een beheerder ervoor de virtuele machine terug te zetten op haar oude schijven (returnToSource). De machine werd uitgeschakeld, haar records verwijzen weer naar de oude bestanden en de nieuwe schijven zijn verwijderd. Alles wat de gast sinds de overschakeling schreef, is verloren.

Oplossing.

  1. Schakel de virtuele machine opnieuw in: kyvernon vm power-on <id>.
  2. Controleer beide datastores voordat u de machine opnieuw verplaatst: de mislukte controle wijst op een fout in de opslag.

error.storage_move.cancelled

Tekst in de console
De opslagmigratie werd geannuleerd vóór de overschakeling. Er is niets veranderd.
Betekenis voor API-clients
The storage migration was cancelled before its switch; nothing changed.
Code
CANCELLED, HTTP 499

Oorzaak. De opslagmigratie is geannuleerd vóór haar overschakeling naar de nieuwe schijven. Er is niets gewijzigd: de virtuele machine gebruikt haar oude schijven en de kopieën zijn verwijderd.

Oplossing.

  1. Start de verplaatsing opnieuw wanneer u dat wilt: kyvernon vm relocate <id> --datastore <datastore>.

error.storage_move.verify_failed

Tekst in de console
De nieuwe schijven konden niet worden gecontroleerd. De oude bestanden blijven bewaard tot u kiest om de nieuwe schijven te houden of terug te keren naar de oude.
Betekenis voor API-clients
A copied file or block does not match its source. The old files are kept; an administrator keeps the new disks or returns to the old ones.
Code
INTERNAL, HTTP 500

Oorzaak. Na de overschakeling naar de nieuwe schijven vond de vergelijking met de oude bestanden een afwijkend blok dat niet uit het oude bestand kon worden hersteld, of de controlesom van een gekopieerd bestand kwam niet overeen. Dit wijst op een storing van de opslag. De oude bestanden blijven bewaard, het alarm alarm.vm.storage_move.verify gaat af en de verplaatsing wacht op een beslissing.

Oplossing.

  1. Bekijk de gebeurtenis van de virtuele machine voor de aantallen en controleer de gezondheid van beide datastores.
  2. Open in de console het overzicht van de virtuele machine. De kaart Opslagmigratie biedt De nieuwe schijven houden, dat de nieuwe schijven houdt en de oude bestanden verwijdert, en Uitschakelen en terugkeren naar de oude schijven, dat de machine uitschakelt en terugkeert naar de oude schijven. De schrijfacties sinds de overschakeling gaan bij terugkeren verloren.
  3. Houd met de CLI de nieuwe schijven en verwijder de oude bestanden: kyvernon vm relocation-resolve <id> --action keep-target.
  4. Of schakel de machine uit en keer terug naar de oude schijven: kyvernon vm relocation-resolve <id> --action return-to-source.

Versie 0.1. Laatst gewijzigd: 2026-11-14