Nutanix-Katalog verwalten
Maschinenkataloge verwalten beschreibt die Assistenten, die einen Maschinenkatalog verwalten. Die folgenden Informationen behandeln Details, die spezifisch für Nutanix AHV Prism Central-Umgebungen sind.
Hinweis:
Bevor Sie einen Maschinenkatalog in Nutanix AHV Prism Central verwalten, müssen Sie die Erstellung eines Maschinenkatalogs in Nutanix AHV Prism Central abgeschlossen haben. Siehe Einen Nutanix-Katalog erstellen.
Sie können einen Maschinenkatalog in Nutanix AHV Prism Central mit den folgenden Methoden verwalten:
Studio verwenden
Im Folgenden sind die Optionen zur Verwaltung eines Maschinenkatalogs in Nutanix AHV Prism Central mit Studio aufgeführt:
| Option | Beschreibung |
|---|---|
| Maschinen hinzufügen | VMs erstellen und zum Maschinenkatalog hinzufügen. |
| Maschinenkatalog löschen | Einen Maschinenkatalog löschen. Sie können wählen, ob Sie VMs gleichzeitig löschen oder persistente VMs intakt lassen möchten. |
| Masterimage ändern | Das Masterimage ändern, das als Vorlage für alle VMs im Katalog verwendet wird. |
| Maschinenprofil hinzufügen oder ändern | Die Vorlagenversion des Maschinenprofils ändern oder ein Maschinenprofil zu einem bestehenden Katalog hinzufügen. |
| Konfigurationssatz verwalten | Einen Katalog an einen Workspace Environment Management™-Konfigurationssatz binden oder zu einer anderen Konfiguration wechseln. |
| Maschinenkatalog bearbeiten | Konfigurationen für den Katalog ändern, z. B. NICs und virtuelle Maschinen. |
| Maschinen anzeigen | Zum Knoten Suchen springen, um alle VMs anzuzeigen, die zum Katalog gehören. |
| Maschinenkatalog umbenennen | Den Katalognamen ändern. |
| VDAs aktualisieren | VDAs pro Katalog aktualisieren. Diese Funktion gilt nur für statische persistente Maschinen. |
| Funktionsebene ändern | Die minimale Funktionsebene für den Katalog auswählen. Das Festlegen einer Funktionsebene macht alle Funktionen verfügbar. |
| Maschinenkatalog testen | Testen, ob der Katalog Fehler oder Warnungen enthält. |
| Tags verwalten | Tags erstellen, bearbeiten und löschen. Tags auswählen, die auf den Katalog angewendet werden sollen. |
| Maschinenkatalog verschieben | Den Katalog in einen anderen Ordner verschieben. |
Hinweis:
Derzeit ist die Option Klonen nicht verfügbar.
Masterimage ändern
Um das Masterimage für einen Katalog zu ändern, führen Sie die folgenden Schritte aus:
- Klicken Sie auf der Seite Maschinenkataloge mit der rechten Maustaste auf den Maschinenkatalog, den Sie aktualisieren möchten, und wählen Sie Masterimage ändern.
-
Klicken Sie auf der Seite Masterimage ändern auf Ein Image auswählen.
- Erweitern Sie auf der Seite Ein Image auswählen eine Vorlage und wählen Sie eine Vorlagenversion aus, die als Masterimage verwendet werden soll. Sie können Maschinenvorlagen nach Namen filtern.
- Wählen Sie auf der Seite Rollout-Strategie aus, wann das Update angewendet werden soll.
Hinweis:
- Bei einem mit MCS bereitgestellten nicht-persistenten Katalog mit dem Nutanix AHV Prism Central Hostverbindungs-Plug-in führt die Aktualisierung des Masterimages zum Wechsel der Startkonfiguration zwischen Legacy und UEFI dazu, dass vorhandene VMs beim nächsten Start nicht mehr starten können.
- Wenn Sie das Masterimage aktualisieren, wird nur die OS-Disk aktualisiert. Die Hardwareeigenschaften bleiben unverändert. Informationen zum Aktualisieren der Hardwareeigenschaften finden Sie unter Maschinenprofil hinzufügen oder ändern, NICs ändern und VM-Konfiguration ändern.
Maschinenprofil hinzufügen oder ändern
Um ein Maschinenprofil für einen Katalog hinzuzufügen oder zu ändern, führen Sie die folgenden Schritte aus:
- Klicken Sie auf der Seite Maschinenkataloge mit der rechten Maustaste auf den Maschinenkatalog, den Sie ändern möchten, und wählen Sie Maschinenkatalog bearbeiten.
-
Auf der Seite Maschinenprofil:
- Wenn der Maschinenkatalog bereits ein Maschinenprofil hat, klicken Sie auf das Bleistiftsymbol, um eine andere Maschinenprofil-Vorlagenversion auszuwählen. Sie können nach dem Vorlagennamen filtern. Bestätigen Sie die Einstellungen des Maschinenprofils.
- Wenn der Maschinenkatalog kein Maschinenprofil hat, wählen Sie „Maschinenprofil verwenden“ und wählen Sie ein Maschinenprofil aus. Bestätigen Sie die Einstellungen des Maschinenprofils.
- Die Seite Virtuelle Maschinen muss die aktualisierte Konfiguration gemäß der ausgewählten Maschinenprofil-Vorlagenversion widerspiegeln.
NICs ändern
Um NICs für einen Katalog zu ändern, führen Sie die folgenden Schritte aus:
- Klicken Sie auf der Seite Maschinenkataloge mit der rechten Maustaste auf den Maschinenkatalog, den Sie ändern möchten, und wählen Sie Maschinenkatalog bearbeiten.
-
Auf der Seite NICs:
- Wählen Sie einen NIC-Typ aus.
-
Wenn der ausgewählte Katalog mit einem Maschinenprofil erstellt wurde, ist die NIC-Nummer konsistent mit der NIC-Nummer des Maschinenprofils und kann nicht geändert werden. Wählen Sie ein zugeordnetes virtuelles Netzwerk für jede NIC aus.
-
Wenn der ausgewählte Katalog ohne Maschinenprofil erstellt wurde, klicken Sie auf NIC hinzufügen, um die Anzahl der NICs zu erhöhen, oder klicken Sie auf Entfernen, um ausgewählte NICs zu löschen. Aktivieren oder deaktivieren Sie die Kontrollkästchen, um NICs auszuwählen, und wählen Sie ein zugeordnetes virtuelles Netzwerk für jede NIC aus.
VM-Konfiguration ändern
Um die Konfiguration von VMs zu ändern, einschließlich Arbeitsspeicher, CPU-Anzahl und Kerne pro vCPU, führen Sie die folgenden Schritte aus:
- Klicken Sie auf der Seite Maschinenkataloge mit der rechten Maustaste auf den Maschinenkatalog, den Sie ändern möchten, und wählen Sie Maschinenkatalog bearbeiten.
-
Verwenden Sie auf der Seite Virtuelle Maschinen die Auf- oder Abwärtspfeile oder geben Sie Werte direkt ein, um Arbeitsspeicher, CPU-Anzahl und Kerne pro vCPU für die VMs anzupassen.
PowerShell verwenden
Masterimage ändern
Die erforderlichen Parameter sind:
-
ProvisioningSchemeName: Name des bereitzustellenden Schemas, das bearbeitet werden soll. -
MasterImage: Absoluter Pfad zum neuen Master-Image.
Führen Sie den folgenden Befehl aus. Zum Beispiel:
Set-ProvSchemeMetadata -Name "ImageManagementPrep_DoImagePreparation" -ProvisioningSchemeName "<ProvisioningSchemeName>" -Value "True"
Publish-ProvMasterVMImage -MasterImageVM "<Literal path to the new master image- template version> -ProvisioningSchemeName "<ProvisioningSchemeName>" -RunAsynchronously
<!--NeedCopy-->
Hinweis:
Wenn Sie das Master-Image aktualisieren, wird nur die Betriebssystemfestplatte aktualisiert. Die Hardwareeigenschaften bleiben unverändert. Informationen zum Aktualisieren der Hardwareeigenschaften finden Sie unter Maschinenprofil hinzufügen oder ändern, NICs ändern und NIC- und VM-Konfiguration ändern.
Maschinenprofil hinzufügen oder ändern
Verwenden Sie den Befehl Set-ProvScheme:
- Um einen Katalog mit einem neuen Maschinenprofil zu aktualisieren, oder
- Um einen vorhandenen Katalog zu aktualisieren, der kein Maschinenprofil hat, um das Maschinenprofil als Quelle der Hardwarespezifikation zu verwenden.
Hinweis:
Dies aktualisiert nicht die Hardwarespezifikation der vorhandenen VMs im Katalog. Nur die neuen VMs, die dem Katalog hinzugefügt werden, erhalten die Hardwarespezifikation des angegebenen Maschinenprofils.
Um das Maschinenprofil zu ändern oder einen vorhandenen Katalog so zu konvertieren, dass er ein Maschinenprofil verwendet:
Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
-MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
-NetworkMapping @{"0"="XDHyp:\HostingUnits\<Hosting unit name>\Clusters.folder\<Cluster Name>.cluster\<Network name>.network"}
<!--NeedCopy-->
Das Maschinenprofil muss mindestens eine NIC haben, und die Anzahl der NICs im Maschinenprofil muss mit den Subnetz-Mappings in NetworkMapping übereinstimmen.
Die Gesamtzahl der NICs für die Vorlagenversion kann aus den AdditionalData ihres Inventarelements wie folgt abgerufen werden:
$tv = Get-Item -Path "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
$tv.AdditionalData.TotalNics
<!--NeedCopy-->
Um das Maschinenprofil mit überschriebener Hardwarespezifikation zu ändern:
Bestimmte Konfigurationen können mithilfe spezifischer Befehlszeilenparameter konfiguriert werden. Diese Befehlszeilenparameter, wie VMCpuCount und VMMemoryMB sowie CPUCores in den CustomProperties, haben Vorrang vor den Werten in der Maschinenprofil-Vorlagenversion.
$customProperties = @"
<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<StringProperty Name="ClusterId" Value="00062c63-1fb0-58c9-4fc8-5c2573352378" />
<StringProperty Name="CPUCores" Value="2" />
</CustomProperties>
"@
Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
-MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion" `
-CustomProperties $customProperties `
-VMCpuCount 4 `
-VMMemoryMB 4096
<!--NeedCopy-->
NIC- und VM-Konfiguration ändern
Die erforderlichen Parameter sind:
-
ProvisioningSchemeName: Name des bereitzustellenden Schemas, das bearbeitet werden soll. -
NetworkMapping: Aktualisiertes Netzwerk-Mapping.
Führen Sie den folgenden Befehl aus. Zum Beispiel:
Set-ProvScheme -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ClusterId`" Value=`"000xxxx-1fb0-xxxxx-4fc8-5c257335xxxx`" /><Property xsi:type=`"StringProperty`" Name=`"CPUCores`" Value=`"1`" /></CustomProperties>" -NetworkMapping @{"6"="XDHyp:\HostingUnits\<Hosting Unit Name>\Clusters.folder\<Cluster Name>\<Network name>.network"} -ProvisioningSchemeName "<ProvisioningSchemeName>" -VMCpuCount 4
<!--NeedCopy-->
Maschinenkataloge zu Citrix-verwalteter Nutanix AHV Prism Central Hostverbindung migrieren
Migrieren Sie Ihre Citrix-Maschinenkataloge und die zugehörigen VMs von bestehenden Nutanix AHV (für Prism Element) und Nutanix AHV PC (für NC2 auf Azure) Hostverbindungen zur Citrix-verwalteten Nutanix AHV Prism Central Hostverbindung. Verwenden Sie für die Migration PowerShell-Befehle, die auch schnelle Rollback-Optionen im Falle von Problemen und Befehle zum Bereinigen von Quellressourcen nach der Migration enthalten.
Vorteile
- Minimale Unterbrechung: Sie wechseln reibungslos zum Nutanix AHV Prism Central Plug-in. Dies hat minimale Auswirkungen auf Ihre bestehenden Bereitstellungen.
- Nahtloser Upgrade-Pfad: Es bietet einen klaren und unterstützten Pfad, um Ihre Infrastruktur zu aktualisieren und die neue Verwaltungsoberfläche zu nutzen.
- Datenintegrität und -sicherheit: Rollback-Optionen stellen sicher, dass Sie die Umgebung im Falle unvorhergesehener Probleme in ihren ursprünglichen Zustand zurückversetzen können. Dies reduziert das Risiko.
- Ressourceneffizienz: Sie bereinigen Quellressourcen nach erfolgreicher Migration. Dies optimiert Speicher- und Verwaltungsaufwand.
- Flexibilität: Es unterstützt die Migration für Kataloge, die sowohl von MCS als auch von Drittanbietertechnologien bereitgestellt werden. Dies bietet eine breitere Anwendbarkeit.
Anwendbarkeit
Diese Funktion ist für Maschinenkataloge unter Nutanix AHV (für Prism Element) und Nutanix AHV PC (für NC2 auf Azure) Hostverbindungen anwendbar:
- Maschinenkataloge, die von MCS verwaltet werden, einschließlich persistenter und nicht-persistenter Typen.
- Nur-Power-verwaltete Maschinenkataloge, die VMs enthalten, die von Drittanbietertechnologien bereitgestellt werden.
Systemanforderungen
- Nutanix AHV Prism Element (PE) AOS Version: Sie benötigen mindestens Version 6.8.
- Nutanix Prism Central (PC) Version: Sie benötigen mindestens Version 2024.3.
Hinweis:
Nutanix Prism Central 7.3 erfordert AOS 7.3 aufgrund eines bekannten Nutanix-Problems.
Einschränkungen
- PVS-Kataloge werden nicht unterstützt: Diese Funktion unterstützt keine Maschinenkataloge, die mit dem Citrix Provisioning Services (PVS) Xendesktop Setup Wizard erstellt wurden.
-
Rollback-Einschränkungen:
- Ein Rollback eines migrierten Katalogs ist nur zulässig, wenn Sie den Katalog nach der ursprünglichen Migration nicht geändert haben.
- Wenn Sie den Vorgang „Quellressourcen bereinigen“ ausführen, wird der Migrationsstatus gelöscht. Dies verhindert jedes nachfolgende Rollback.
- Keine erneute Migration: Ein bereits migrierter Maschinenkatalog wird für eine erneute Migration nicht unterstützt.
- VMs mit mehreren Hostverbindungen: Die Migration von ausschließlich energieverwalteten Maschinenkatalogen, die VMs aus mehreren Hostverbindungen enthalten, wird nicht unterstützt.
Wichtige Überlegungen
- Nutanix-Clusterverwaltung: Hostende Nutanix AHV-Cluster müssen bei einem Nutanix Prism Central registriert sein. .
- Erstellung von Master-Image-Vorlagen: Für MCS-Maschinenkataloge bietet der Migrationsbefehl die Option, eine VM-Vorlagenversion auf Prism Central aus dem ursprünglichen Snapshot des Master-Images des Maschinenkatalogs zu generieren. Diese VM-Vorlagenversion kann später als MCS-Master-Image von Maschinenkatalogen unter der Prism Central-Hostverbindung verwendet werden. Standardmäßig ist diese Option nicht aktiviert.
-
Rollback-Voraussetzungen:
Damit ein erfolgreiches Rollback möglich ist, muss die ursprüngliche Quellumgebung – einschließlich der Hostverbindung und der Basisdatenträger – unverändert bleiben. Sie müssen auch vermeiden, Konfigurationsänderungen am migrierten Maschinenkatalog vorzunehmen und VMs hinzuzufügen/zu entfernen, bis die Migration als erfolgreich bestätigt wurde. Nach dieser Bestätigung können Sie den endgültigen Vorgang „Quellressourcen bereinigen“ ausführen, beachten Sie jedoch, dass dies ein irreversibler Schritt ist, der ein Rollback unmöglich macht.
Erforderliche Berechtigungen für Migration und Rollback
Um Kataloge zu migrieren oder ein Rollback durchzuführen, benötigen Sie die folgenden Berechtigungen:
Prism Element-Administrator:
- Virtuelle Maschine erstellen
Prism Central-Administrator:
- VM-Vorlagen erstellen
- VM-Vorlagen löschen
- VM-Wiederherstellungspunkt löschen
- Virtuelle Maschine löschen
Eine vollständige Liste der spezifischen Berechtigungen, die für die von Citrix verwaltete Nutanix AHV Prism Central-Hostverbindung erforderlich sind, finden Sie unter Erforderliche Berechtigungen.
So migrieren Sie
Sie verwalten diese Funktion über dedizierte PowerShell-Cmdlets. Der allgemeine Workflow umfasst drei Hauptvorgänge: Migration, Rollback und Bereinigung von Quellressourcen.
Maschinenkatalog migrieren
- Dieser Vorgang verschiebt einen Maschinenkatalog und die zugehörigen VMs von einer Quell-Nutanix AHV- oder Nutanix AHV PC-Hostverbindung zu einer von Citrix verwalteten Nutanix AHV Prism Central-Hostverbindung.
- Für MCS-bereitgestellte Kataloge erstellt dieser Prozess neue Basisdatenträger in der Zielverbindung.
- Optional können Sie eine Master-VM-Entsprechung (VM-Vorlagenversion) in der Zielverbindung aus dem ursprünglichen Master-Image-Snapshot erstellen.
- Neue Nutanix AHV Prism Central-Hostverbindung erstellen: Registrieren Sie vor der Migration den hostenden Nutanix AHV-Cluster bei einem Nutanix Prism Central und stellen Sie eine neue Nutanix AHV Prism Central-Hostverbindung her, die auf die Ziel-Nutanix Prism Central-Instanz verweist. Diese Verbindung dient als Ziel für Ihre migrierten Kataloge. Weitere Informationen finden Sie unter Nutanix AHV Prism Central-Hostverbindung.
-
Vorhandenen Maschinenkatalog migrieren: Verwenden Sie für vorhandene Maschinenkataloge das PowerShell-Cmdlet
Switch-ProvCatalog, um die Migration zur von Citrix verwalteten Nutanix AHV Prism Central-Hostverbindung zu initiieren.c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination <!--NeedCopy-->- Ersetzen Sie
<Catalog_UID>durch den eindeutigen Bezeichner des Maschinenkatalogs, den Sie migrieren möchten. Verwenden Sie das folgende PowerShell-Cmdlet, um dieBrokerCatalogUidanhand des KatalognamensGet-BrokerCatalog -Name <Catalog Name>zu finden. -
DestinationConnectionist der Name der neuen Nutanix AHV Prism Central-Hostverbindung, die in Schritt 1 erstellt wurde. -
DestinationUnitist der Name, den Sie der Hostingeinheit innerhalb derDestinationConnectiongeben, in der sich der Maschinenkatalog befinden wird. - Der Parameter
-CreateMasterImageAtDestinationist optional. Er erstellt eine Master-Image-VM-Vorlagenversion auf dem Ziel-Prism Central.
- Ersetzen Sie
-
Migration überprüfen: Nach der Ausführung des Migrations-Cmdlets überwachen Sie den Aufgabenstatus im PowerShell-Fenster, um sicherzustellen, dass er erfolgreich abgeschlossen wird. Wenn die Migration abgeschlossen ist, wird der Katalog in die in Schritt 1 erstellte Ziel-Hostverbindung verschoben. Sie müssen einen Status „Abgeschlossen“ mit dem Aufgabentyp „SwitchProvCatalog“ sehen. Im Folgenden sind empfohlene Schritte zur Überprüfung des Migrationsabschlusses aufgeführt:
- Überprüfen Sie den Status des Katalogs in Studio.
- Stellen Sie sicher, dass die VMs innerhalb des Katalogs jetzt der neuen Ziel-Hypervisor-Verbindung zugeordnet sind.
- Stellen Sie sicher, dass die VMs innerhalb des Katalogs den korrekten Energiezustand anzeigen.
- Testen Sie die Funktionalität des migrierten Maschinenkatalogs, indem Sie Maschinen hinzufügen oder entfernen oder Energieoperationen ausführen, um sicherzustellen, dass der Katalog ordnungsgemäß funktioniert.
Rollback eines migrierten Katalogs
Dieser Vorgang setzt einen Maschinenkatalog und seine VMs auf ihre ursprüngliche Quell-Hostverbindung zurück. Er entfernt alle Ressourcen, die Sie während des Migrationsprozesses erstellt haben.
Wichtig:
Ein Rollback führen Sie nur durch, wenn Sie den Katalog nach der Migration nicht geändert und den Vorgang „Quellressourcen bereinigen“ nicht ausgeführt haben. Die ursprüngliche Quellverbindung bleibt unverändert und enthält weiterhin ihre Basisdatenträger.
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback
<!--NeedCopy-->
Quellressourcen bereinigen
Nach einer erfolgreichen Migration entfernt dieser Vorgang Quellressourcen, z. B. Basisdatenträger, von der ursprünglichen Hypervisor-Verbindung.
Wichtig:
Wenn Sie diesen Befehl ausführen, wird der Migrationsstatus gelöscht. Dies macht nachfolgende Rollbacks unmöglich.
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources
<!--NeedCopy-->
Sie erhalten eine Bestätigungsaufforderung, bevor Sie fortfahren, da diese Aktion irreversibel ist. Bestätigen Sie die Aufforderung, um die Bereinigung abzuschließen.