Umbenennen einer virtuellen Maschine und deren Dateien in VMware ESXi und ESX
search cancel

Umbenennen einer virtuellen Maschine und deren Dateien in VMware ESXi und ESX

book

Article ID: 344133

calendar_today

Updated On:

Products

VMware vCenter Server VMware vSphere ESXi

Issue/Introduction

Dieser Artikel enthält eine Anleitung zum Umbenennen einer virtuellen Maschine und deren Dateien über SSH, die Systemverwaltungsschnittstelle oder direkt über die Konsole der Maschine.

Beim Umbenennen einer virtuellen Maschine im vSphere Client wird nur der Anzeigename geändert, nicht die entsprechenden Dateien im Datenspeicher. Möglicherweise ist es sinnvoll, zur Wahrung der Konsistenz auch die Dateien der virtuellen Maschinen umzubenennen.


Symptoms:

Haftungsausschluss: Dieser Artikel ist eine Übersetzung des zugrundeliegenden Artikels Renaming a virtual machine and its files in VMware ESXi and ESX (1029513). Die Übersetzung des Artikels erfolgt auf einer Minimalbasis („Best Effort“), übersetzter Inhalt der Artikel kann veraltet oder inkorrekt sein. Schadenersatzansprüche sind vollständig ausgeschlossen.


Environment

VMware ESXi 3.5.x Installable
VMware vCenter Server Appliance 5.0.x
VMware vSphere ESXi 5.5
VMware vCenter Server 5.5.x
VMware ESX Server 3.5.x
VMware VirtualCenter 2.5.x
VMware vCenter Server 5.0.x
VMware vCenter Server 5.1.x
VMware vSphere ESXi 5.1
VMware vCenter Server 4.0.x
VMware ESXi 4.1.x Installable
VMware ESX 4.0.x
VMware vSphere ESXi 5.0
VMware ESX 4.1.x
VMware ESXi 4.0.x Embedded
VMware vCenter Server Appliance 5.1.x
VMware vCenter Server Appliance 5.5.x
VMware vCenter Server 4.1.x
VMware ESXi 4.1.x Embedded
VMware ESXi 4.0.x Installable
VMware ESX Server 3.0.x
VMware ESXi 3.5.x Embedded

Resolution

Hinweis: Wenn Storage/Cold Storage vMotion oder die Konsole verwendet wird, werden nur die Ordnernamen und nicht die Dateien in ESXi 5.0 umbenannt. Dieses Verhalten wurde geändert, sodass jetzt auch Speicher-DRS auf ESXi 5.0 unterstützt wird. Weitere Informationen finden Sie unter vSphere 5 Storage vMotion does not rename virtual machine files on completing migration (2008877).

Die Dateien einer virtuellen Maschine können während eines Festplatten-Migrationsvorgangs, beispielsweise einer Cold-Speichermigration oder durch manuelles Umbenennen der Dateien direkt in der ESXi/ESX-Konsole, umbenannt werden. Wählen Sie Ihre bevorzugte Methode aus.

Alternativ kann eine virtuelle Maschine mit der Methode zum Klonen in vCenter Server oder mithilfe von vCenter Converter und durch Löschen der alten virtuellen Maschine in eine neue virtuelle Maschine geklont werden.

Umbenennen von Dateien virtueller Maschinen mithilfe von Storage vMotion

Die Dateien einer virtuellen Maschine können während eines vom vSphere Client eingeleiteten Storage vMotion-Vorgangs sofort umbenannt werden. Die Umbenennung erfolgt ohne Ausfallzeit.

So benennen Sie die Dateien auf ESXi/ESX 4.x- und ESXi/ESX 3.5-Hosts um:
  1. Melden Sie sich beim VMware vSphere Client an.
  2. Ermitteln Sie die virtuelle Maschine im Bestand des Hosts.
  3. Klicken Sie mit der rechten Maustaste auf die virtuelle Maschine und klicken Sie auf Umbenennen.
  4. Ändern Sie den Namen der virtuellen Maschine nach Bedarf.
  5. Starten Sie einen Storage vMotion-Vorgang oder führen Sie offline eine Speichermigration der virtuellen Maschine durch. Weitere Informationen finden Sie unter:


    Hinweis: Durch den Storage vMotion-Vorgang werden die Namen der Dateien der virtuellen Maschine nur dann geändert, wenn sich der Zieldatenspeicher vom ursprünglichen Datenspeicher unterscheidet.

    Nach Abschluss der Migration stimmen die Dateien der virtuellen Maschine mit dem im Schritt 4 konfigurierten Namen der virtuellen Maschine überein.
Hinweis: Wenn im Datenspeicher bereits ein Verzeichnis der virtuellen Maschine mit demselben Namen existiert, wird die virtuelle Zielmaschine in ein neues Verzeichnis übernommen, wobei _1 angehängt wird.


Umbenennen von Dateien virtueller Maschinen mithilfe der Cold-Speichermigration

Die Dateien der virtuellen Maschine können sofort umbenannt werden, wenn eine Cold-Migration auf dem vSphere Client in ESX/ESXi 4.x gestartet wird. In ESXi 5.x wird nur der Ordner der virtuellen Maschine umbenannt.

So benennen Sie die Dateien um:
  1. Melden Sie sich beim VMware vSphere Client an.
  2. Ermitteln Sie die virtuelle Maschine im Bestand des Hosts.
  3. Klicken Sie mit der rechten Maustaste auf die virtuelle Maschine und klicken Sie auf Umbenennen.
  4. Ändern Sie den Namen der virtuellen Maschine nach Bedarf.
  5. Führen Sie die Cold-Migration zu einem neuen Datenspeicher der virtuellen Maschine durch.

    Weitere Informationen finden Sie unter:


    Nach Abschluss der Migration stimmen die Dateien der virtuellen Maschine mit dem im Schritt 4 konfigurierten Namen der virtuellen Maschine überein.
Hinweis: Wenn im Datenspeicher bereits ein Verzeichnis der virtuellen Maschine mit demselben Namen existiert, wird die virtuelle Zielmaschine in ein neues Verzeichnis übernommen, wobei _1 angehängt wird.


Direktes Umbenennen der Dateien der virtuellen Maschine über die Konsole

Warnung: Stellen Sie Folgendes sicher, bevor Sie den Vorgang fortsetzen:
  • Für die virtuelle Maschine ist eine aktuelle Sicherung vorhanden und die virtuelle Maschine wurde ausgeschaltet.
  • Die virtuelle Maschine verfügt nicht über mit anderen virtuellen Maschinen gemeinsam genutzte Snapshots oder virtuelle Festplatten.
So können Sie Dateien der virtuellen Maschine manuell umbenennen:
  1. Melden Sie sich beim VMware vSphere Client an.
  2. Ermitteln Sie die virtuelle Maschine im Bestand des Hosts.
  3. Schalten Sie die virtuelle Maschine aus.
  4. Klicken Sie mit der rechten Maustaste auf die virtuelle Maschine und klicken Sie auf Aus Bestandsliste entfernen.
  5. Öffnen Sie eine Konsole auf dem ESXi/ESX-Host. Weitere Informationen finden Sie unter Unable to connect to an ESX host using Secure Shell (SSH) (1003807) oder Using Tech Support Mode in ESXi 4.1 and ESXi 5.x (1017910).
  6. Navigieren Sie zum Verzeichnis, das die virtuelle Maschine enthält.

    Beispiel:

    # cd /vmfs/volumes/DatastoreName/originalname

  7. Benennen Sie die virtuellen Festplattendateien (VMDK-Dateien) mit dem Befehl vmkfstools -E um:

    # vmkfstools -E "originalname.vmdk" "newname.vmdk"


    Weitere Informationen finden Sie unter Renaming a virtual machine disk (VMDK) via the vSphere Management Assistant (vMA) or vSphere CLI (vCLI) (1002491).


    Hinweise:
    • In manchen Fällen kann es erforderlich sein, eine virtuelle Festplatte zu klonen (kopieren). Führen Sie den folgenden Befehl aus, um eine virtuelle Festplatte in eine neue virtuelle Festplatte zu klonen:

      # vmkfstools -i "originalname.vmdk" "newname.vmdk"

      Dadurch bleibt die ursprüngliche virtuelle Festplatte unverändert. Es muss ausreichend Speicherplatz vorhanden sein, um die virtuelle Festplatte in das Zielverzeichnis zu klonen. Mit dem vorherigen Befehl wird die neue virtuelle Festplatte im aktuellen Verzeichnis erstellt. Es kann aber auch ein anderes Verzeichnis angegeben werden.

    • Sie müssen die Datei originalname-flat.vmdk nach der Ausführung des Befehls vmkfstools nicht umbenennen. Mit dem Befehl vmkfstools werden beide VMDK-Dateien umbenannt, und der Verweis wird innerhalb des Deskriptors aktualisiert.

    • Verwenden Sie den Befehl cp oder mv nicht zum Umbenennen von virtuellen Festplattendateien. Verwenden Sie stattdessen VMware-Dienstprogramme wie vmkfstools.

  8. Kopieren Sie die Konfigurationsdatei der virtuellen Maschine (.vmx) mit dem folgenden Befehl:

    # cp "originalname.vmx" "newname.vmx"

  9. Öffnen Sie die neue Konfigurationsdatei der virtuellen Maschine (zum Beispiel newname.vmx) in einem Texteditor.

    Weitere Informationen finden Sie unter Editing configuration files in VMware ESXi and ESX (1017022).

    Beispiel:

    # vi "newname.vmx"

  10. Ändern Sie in der Konfigurationsdatei alle alten Instanzen der Dateinamen der virtuellen Maschine in die neuen Dateinamen. Ändern Sie mindestens die folgenden Werte (möglicherweise gibt es noch mehr Werte):

    nvram = " newname.nvram"
    displayName = " newname "
    extendedConfigFile = " newname .vmxf"
    scsi0:0.fileName = " newname .vmdk"
    [...]
    migrate.hostlog = "./ newname -UUID.hlog"

    Wiederholen Sie diesen Vorgang für jede Festplatte der virtuellen Maschine. Beispiel:

    scsi0:1.fileName = " newname _1.vmdk"
    scsi0:2.fileName = " newname _2.vmdk"

    Korrigieren Sie den Verweis auf die VMkernel-Auslagerungsdatei.

    Beispiel:

    sched.swap.derivedName = "/vmfs/volumes/DatastoreUUID/ newname/ newname-UUID.vswp

    Hinweis: Stellen Sie sicher, dass sowohl die .vswp-Datei als auch der fett formatierte Verzeichnisname der Auslagerungsdatei umbenannt wird.

  11. Korrigieren Sie alle übrigen Zeilen, die auf den ursprünglichen Pfad oder die Dateinamen verweisen.
  12. Speichern Sie die Datei und beenden Sie den Editor.
  13. Benennen Sie alle verbleibenden Dateien außer der .vmx-Konfigurationsdatei mit den neuen Namen um.

    Beispiel:

    # mv "originalname.nvram" "newname.nvram"
  14. Ändern Sie das Verzeichnis in das übergeordnete Verzeichnis:

    # cd ..

  15. Benennen Sie das Verzeichnis für die virtuelle Maschine um:

    # mv "originalname" "newname"

  16. Navigieren Sie im VMware vSphere Client zum Datenspeicher und navigieren Sie dann zum umbenannten Verzeichnis der virtuellen Maschine.
  17. Klicken Sie mit der rechten Maustaste auf die neue Konfigurationsdatei der virtuellen Maschine (zum Beispiel newname.vmx) und wählen Sie Zur Bestandsliste hinzufügen aus.

    Alternativ können Sie den folgenden Befehl verwenden, um die virtuelle Maschine im Bestand hinzuzufügen:

    Für ESX:

    # vmware-cmd -s register "/vmfs/volumes/DatastoreName/newname/newname.vmx"

    Für ESXi:

    # vim-cmd solo/registervm /vmfs/volumes/DatastoreName/newname/newname.vmx

  18. Schalten Sie die virtuelle Maschine ein.
  19. Während des Einschaltvorgangs wird auf der Registerkarte Übersicht eine Frage für die virtuelle Maschine angezeigt. So überprüfen Sie die Frage:

    • Klicken Sie auf die Registerkarte Übersicht.
    • Klicken Sie in der Bestandsliste mit der rechten Maustaste auf die virtuelle Maschine und wählen Sie Frage beantworten aus.

      Wenn Sie dazu aufgefordert werden, wählen Sie Ich habe sie verschoben aus und klicken Sie dann auf OK.

      Warnung: Wenn Sie Ich habe sie kopiert auswählen, führt dies zu einer Änderung der UUID und der MAC-Adresse der virtuellen Maschine. Dies kann sich negativ auf Gastanwendungen auswirken, die sensibel auf Änderungen der MAC-Adresse reagieren, und auf Sicherungen virtueller Maschinen, die UUIDs nutzen.

  20. Optional können Sie die ursprüngliche Konfigurationsdatei der virtuellen Maschine löschen.

    Beispiel:

    # rm /vmfs/volumes/DatastoreName/newname/originalname.vmx


Additional Information

Der Befehlszeilen-Interpreter für ESX unterscheidet zwischen Groß- und Kleinschreibung und erfordert die Maskierung von Sonderzeichen, die in einigen Namen der Dateien der virtuellen Maschine verwendet werden. In den obigen Beispielen empfiehlt es sich, die Befehlsargumente in Anführungszeichen einzuschließen, um sicherzustellen, dass Leerzeichen und Sonderzeichen richtig interpretiert werden und keine Maskierungssequenzen vorhanden sind.

Beispiel: Eine virtuelle Maschine namens "Original VM" wird entweder als "Original VM" (mit Anführungszeichen) oder als Original\ VM referenziert.

Für Sonderzeichen, wie öffnende und schließende Klammern, müssen ebenfalls Maskierungszeichen angegeben werden. Eine virtuelle Maschine namens "Original VM (1)" wird entweder als "Original VM (1)" (mit Anführungszeichen) oder als Original\ VM\ \(1\) referenziert.

Die genannte Anführungsmethode vereinfacht den Prozess ganz erheblich und verbessert die Lesbarkeit.

Weitere Informationen zu Maskierungszeichen finden Sie im Bash Reference Manual.

Hinweis: Der obige Link war am Dienstag, 22. Dezember 2015 korrekt. Sollte dieser Link fehlerhaft sein, melden Sie uns dies, damit der Link durch einen Mitarbeiter von VMware aktualisiert werden kann.

Weitere Informationen zu Zeichenbeschränkungen bei den Namen virtueller Maschinen finden Sie unter Troubleshooting issues with virtual machines or datastore names containing special characters (2046088).
Renaming a virtual machine and its files in VMware ESXi and ESX

Powered by Wolken Software