Gestire un catalogo Nutanix
Gestire i cataloghi macchine descrive le procedure guidate che gestiscono un catalogo macchine. Le seguenti informazioni riguardano i dettagli specifici degli ambienti Nutanix AHV Prism Central.
Nota:
Prima di gestire un catalogo macchine su Nutanix AHV Prism Central, è necessario completare la creazione di un catalogo macchine su Nutanix AHV Prism Central. Vedere Creare un catalogo Nutanix.
È possibile gestire un catalogo macchine su Nutanix AHV Prism Central utilizzando:
Usare Studio
Di seguito sono riportate le opzioni per gestire un catalogo macchine su Nutanix AHV Prism Central utilizzando Studio:
| Opzione | Descrizione |
|---|---|
| Aggiungi macchine | Crea e aggiungi VM al catalogo macchine. |
| Elimina catalogo macchine | Elimina un catalogo macchine. È possibile scegliere di eliminare le VM contemporaneamente o di lasciare intatte le VM persistenti. |
| Cambia immagine master | Cambia l’immagine master utilizzata come modello per tutte le VM nel catalogo. |
| Aggiungi o modifica profilo macchina | Cambia la versione del modello del profilo macchina o aggiungi un profilo macchina a un catalogo esistente. |
| Gestisci set di configurazione | Associa un catalogo a un set di configurazione di Workspace Environment Management™ o passa a una configurazione diversa. |
| Modifica catalogo macchine | Modifica le configurazioni per il catalogo, come NIC e macchine virtuali. |
| Visualizza macchine | Passa al nodo Cerca per visualizzare tutte le VM che appartengono al catalogo. |
| Rinomina catalogo macchine | Cambia il nome del catalogo. |
| Aggiorna VDA | Aggiorna i VDA per catalogo. Questa funzionalità si applica solo alle macchine persistenti statiche. |
| Cambia livello funzionale | Seleziona il livello funzionale minimo per il catalogo. L’impostazione di un livello funzionale rende disponibili tutte le funzionalità. |
| Testa catalogo macchine | Verifica se il catalogo presenta errori o avvisi. |
| Gestisci tag | Crea, modifica ed elimina tag. Seleziona i tag da applicare al catalogo. |
| Sposta catalogo macchine | Sposta il catalogo in un’altra cartella. |
Nota:
Attualmente, l’opzione Clona non è disponibile.
Cambia immagine master
Per cambiare l’immagine master per un catalogo, seguire questi passaggi:
- Nella pagina Cataloghi macchine, fare clic con il pulsante destro del mouse sul catalogo macchine che si desidera aggiornare e selezionare Cambia immagine master.
-
Nella pagina Cambia immagine master, fare clic su Seleziona un’immagine.
- Nella pagina Seleziona un’immagine, espandere un modello e selezionare una versione del modello da utilizzare come immagine master. È possibile filtrare i modelli di macchina per nome.
- Nella pagina Strategia di implementazione, scegliere quando si desidera applicare l’aggiornamento.
Nota: - > - > - Per un catalogo non persistente con provisioning MCS con il plug-in di connessione host Nutanix AHV Prism Central, l’aggiornamento dell’immagine master per cambiare la configurazione di avvio tra Legacy e UEFI impedisce alle VM esistenti di avviarsi al riavvio successivo.
- Quando si aggiorna l'immagine master, viene aggiornato solo il disco del sistema operativo. Le proprietà hardware rimangono invariate. Per aggiornare le proprietà hardware, vedere [Aggiungi o modifica il profilo macchina](#add-or-change-machine-profile), [Cambia NIC](#change-nics) e [Cambia configurazione VM](#change-vms-configuration).
Aggiungi o modifica il profilo macchina
Per aggiungere o modificare un profilo macchina per un catalogo, seguire questi passaggi:
- Nella pagina Cataloghi macchine, fare clic con il pulsante destro del mouse sul catalogo macchine che si desidera modificare e selezionare Modifica catalogo macchine.
-
Nella pagina Profilo macchina,
- Se il catalogo macchine ha già un profilo macchina, fare clic sull’icona della matita per selezionare una versione diversa del modello di profilo macchina. È possibile filtrare per nome del modello. Confermare le impostazioni del profilo macchina.
- Se il catalogo macchine non ha un profilo macchina, selezionare Usa un profilo macchina e selezionare un profilo macchina. Confermare le impostazioni del profilo macchina.
-
- La pagina Macchine virtuali deve riflettere la configurazione aggiornata in base alla versione del modello di profilo macchina selezionata.
Cambia NIC
Per cambiare le NIC per un catalogo, seguire questi passaggi:
- Nella pagina Cataloghi macchine, fare clic con il pulsante destro del mouse sul catalogo macchine che si desidera modificare e selezionare Modifica catalogo macchine.
-
Nella pagina NIC:
- Selezionare un tipo di NIC.
- Se il catalogo selezionato è stato creato con un profilo macchina, il numero di NIC è coerente con il numero di NIC del profilo macchina e non può essere modificato. Selezionare una rete virtuale associata per ogni NIC.
-
-
Se il catalogo selezionato è stato creato senza profilo macchina, fare clic su Aggiungi NIC per aumentare il numero di NIC o fare clic su Rimuovi per eliminare le NIC selezionate. Selezionare o deselezionare le caselle per selezionare le NIC e scegliere una rete virtuale associata per ogni NIC.
-
Cambia configurazione VM
Per cambiare la configurazione delle VM, inclusi Memoria, numero di CPU e Core per vCPU, seguire questi passaggi:
- Nella pagina Cataloghi macchine, fare clic con il pulsante destro del mouse sul catalogo macchine che si desidera modificare e selezionare Modifica catalogo macchine.
-
Nella pagina Macchine virtuali, utilizzare la freccia su o giù, o inserire i valori direttamente per regolare Memoria, numero di CPU e Core per vCPU per le VM.
Usare PowerShell
Cambia immagine master
I parametri richiesti sono:
-
ProvisioningSchemeName: Nome dello schema di provisioning da modificare. -
MasterImage: Percorso letterale della nuova immagine master.
Eseguire il comando seguente. Ad esempio:
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-->
Nota:
Quando si aggiorna l’immagine master, viene aggiornato solo il disco del sistema operativo. Le proprietà hardware rimangono invariate. Per aggiornare le proprietà hardware, vedere Aggiungere o modificare il profilo della macchina, Modificare le NIC e Modificare la configurazione di NIC e VM.
Aggiungere o modificare il profilo della macchina
Utilizzare il comando Set-ProvScheme:
- Per aggiornare un catalogo con un nuovo profilo della macchina, o
-
Per aggiornare un catalogo esistente che non dispone di un profilo della macchina per iniziare a utilizzare il profilo della macchina come origine delle specifiche hardware.
-
Nota:
-
-
Questo non aggiorna le specifiche hardware delle VM esistenti nel catalogo. Solo le nuove VM aggiunte al catalogo avranno le specifiche hardware dal profilo della macchina specificato.
- Per modificare il profilo della macchina o convertire un catalogo esistente per iniziare a utilizzare il profilo della macchina:
- 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-->
Il profilo della macchina deve avere almeno una NIC e il numero di NIC nel profilo della macchina deve corrispondere alle mappature delle subnet in NetworkMapping.
Il numero totale di NIC per la versione del modello può essere ottenuto da AdditionalData del suo elemento di inventario utilizzando quanto segue:
- $tv = Get-Item -Path "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
- $tv.AdditionalData.TotalNics
<!--NeedCopy-->
- Per modificare il profilo della macchina con specifiche hardware sovrascritte:
- Certe configurazioni possono essere configurate utilizzando parametri specifici della riga di comando. Questi parametri della riga di comando, come
VMCpuCounteVMMemoryMB, eCPUCoresinCustomProperties, hanno la precedenza sui valori nella versione del modello del profilo della macchina.
$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-->
Modificare la configurazione di NIC e VM
-
I parametri richiesti sono:
-
ProvisioningSchemeName: Nome dello schema di provisioning da modificare. -
NetworkMapping: Mappatura di rete aggiornata.
Eseguire il comando seguente. Ad esempio:
- 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-->
Migrare i cataloghi di macchine alla connessione host Nutanix AHV Prism Central gestita da Citrix
- Migrare i cataloghi di macchine Citrix e le VM associate dalle connessioni host Nutanix AHV (per Prism Element) e Nutanix AHV PC (per NC2 su Azure) esistenti alla connessione host Nutanix AHV Prism Central gestita da Citrix. Per la migrazione, utilizzare i comandi PowerShell, che includono anche opzioni di rollback rapido in caso di problemi e comandi per pulire le risorse di origine dopo la migrazione.
- ### Vantaggi
-
Interruzione minimizzata: Si passa senza problemi al plug-in Nutanix AHV Prism Central. Ciò ha un impatto minimo sulle distribuzioni esistenti.
- Percorso di aggiornamento senza interruzioni: Fornisce un percorso chiaro e supportato per aggiornare l’infrastruttura e sfruttare la nuova interfaccia di gestione.
- Integrità e sicurezza dei dati: Le opzioni di rollback garantiscono il ripristino dell’ambiente allo stato originale in caso di problemi imprevisti. Ciò riduce i rischi.
- Efficienza delle risorse: Si puliscono le risorse di origine dopo una migrazione riuscita. Ciò ottimizza lo storage e l’overhead di gestione.
- Flessibilità: Supporta la migrazione per i cataloghi forniti sia da MCS che da tecnologie di terze parti. Ciò offre un’applicabilità più ampia.
Applicabilità
Questa funzionalità è applicabile ai cataloghi di macchine sotto connessioni host Nutanix AHV (per Prism Element) e Nutanix AHV PC (per NC2 su Azure):
- Cataloghi di macchine gestiti da MCS, inclusi i tipi persistenti e non persistenti.
- Cataloghi di macchine gestiti solo dall'alimentazione che contengono VM fornite da tecnologie di terze parti.
Requisiti di sistema
- **Versione AOS di Nutanix AHV Prism Element (PE)**: È richiesta una versione minima di 6.8.
- **Versione di Nutanix Prism Central (PC)**: È richiesta una versione minima di 2024.3.
-
Nota:
-
-
Nutanix Prism Central 7.3 richiede AOS 7.3 a causa di un problema noto di Nutanix.
-
Limitazioni
- I cataloghi PVS non sono supportati: Questa funzionalità non supporta i cataloghi di macchine creati utilizzando la procedura guidata di configurazione Xendesktop di Citrix Provisioning Services (PVS).
-
Restrizioni di rollback:
- Consente il rollback di un catalogo migrato solo se non è stato modificato il catalogo dopo la migrazione iniziale.
- Quando si esegue l’operazione “Pulizia risorse di origine”, lo stato di migrazione viene cancellato. Ciò impedisce qualsiasi rollback successivo.
- Nessuna nuova migrazione: Un catalogo di macchine già migrato non è supportato per una nuova migrazione.
- VM con connessione multi-host: La migrazione di cataloghi di macchine gestiti solo dall’alimentazione che contengono VM importate da più connessioni host non è supportata.
Considerazioni importanti
- Gestione dei cluster Nutanix: I cluster Nutanix AHV di hosting devono essere registrati a un Nutanix Prism Central.
- Creazione del modello di immagine master: Per i cataloghi di macchine MCS, il comando di migrazione offre un’opzione per generare una versione del modello di VM su Prism Central dallo snapshot originale dell’immagine master del catalogo di macchine. Questa versione del modello di VM può essere successivamente utilizzata come immagine master MCS dei cataloghi di macchine sotto la connessione host di Prism Central. Per impostazione predefinita, questa opzione non è abilitata.
- Precondizioni per il rollback: Affinché un rollback abbia successo, l’ambiente di origine originale, incluse la connessione host e i dischi di base, deve rimanere invariato. È inoltre necessario evitare di apportare modifiche alla configurazione del catalogo di macchine migrato e di aggiungere/rimuovere VM fino a quando la migrazione non è confermata come riuscita. Dopo tale conferma, è possibile eseguire l’operazione finale di Pulizia risorse di origine, ma tenere presente che si tratta di un passaggio irreversibile che renderà impossibile il rollback.
Autorizzazioni richieste per la migrazione e il rollback
Per migrare cataloghi o eseguire il rollback, sono necessarie le seguenti autorizzazioni:
Amministratore di Prism Element:
- Creare macchine virtuali
Amministratore di Prism Central:
- Creare modelli di VM
- Eliminare modelli di VM
- Eliminare punti di ripristino VM
- Eliminare macchine virtuali
Per l’elenco completo delle autorizzazioni specifiche necessarie per la connessione host di Nutanix AHV Prism Central gestita da Citrix, vedere Autorizzazioni richieste.
Come eseguire la migrazione
Questa funzionalità viene gestita tramite cmdlet PowerShell dedicati. Il flusso di lavoro generale prevede tre operazioni principali: Migrazione, Rollback e Pulizia delle risorse di origine.
Migrare un catalogo di macchine
- Questa operazione sposta un catalogo di macchine e le VM associate da una connessione host di origine Nutanix AHV o Nutanix AHV PC a una connessione host di destinazione Nutanix AHV Prism Central gestita da Citrix.
- Per i cataloghi con provisioning MCS, questo processo crea nuovi dischi di base nella connessione di destinazione.
- È possibile scegliere facoltativamente di creare un equivalente VM master (versione del modello VM) nella connessione di destinazione dallo snapshot dell’immagine master originale.
- Creare una nuova connessione host Nutanix AHV Prism Central: Prima della migrazione, registrare il cluster Nutanix AHV di hosting a un Nutanix Prism Central e stabilire una nuova connessione host Nutanix AHV Prism Central che punti all’istanza Nutanix Prism Central di destinazione. Questa connessione funge da destinazione per i cataloghi migrati. Per i dettagli, vedere Connessione host Nutanix AHV Prism Central.
-
Migrare un catalogo di macchine esistente: Per i cataloghi di macchine esistenti, utilizzare il cmdlet PowerShell
Switch-ProvCatalogper avviare la migrazione alla connessione host Nutanix AHV Prism Central gestita da Citrix.c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination <!--NeedCopy-->- Sostituire
<Catalog_UID>con l’identificatore univoco del catalogo di macchine che si desidera migrare. Utilizzare il seguente cmdlet PowerShell per individuare ilBrokerCatalogUidper nome del catalogoGet-BrokerCatalog -Name <Catalog Name>. -
DestinationConnectionè il nome della nuova connessione host Nutanix AHV Prism Central creata nel passaggio 1. -
DestinationUnitè il nome assegnato all’unità di hosting all’interno dellaDestinationConnectionin cui risiederà il catalogo di macchine. - Il parametro
-CreateMasterImageAtDestinationè facoltativo. Crea una versione del modello VM dell’immagine master sul Prism Central di destinazione.
- Sostituire
-
Verificare il completamento della migrazione: Dopo aver eseguito il cmdlet di migrazione, monitorare lo stato dell’attività nella finestra di PowerShell per assicurarsi che venga completata con successo. Al completamento della migrazione, il catalogo viene spostato nella connessione host di destinazione creata nel passaggio 1. È necessario visualizzare uno stato “finished” con il tipo di attività “SwitchProvCatalog”. Di seguito sono riportati i passaggi consigliati per verificare il completamento della migrazione:
- Controllare lo stato del catalogo in Studio.
- Verificare che le VM all’interno del catalogo siano ora associate alla nuova connessione hypervisor di destinazione.
- Verificare che le VM all’interno del catalogo mostrino lo stato di alimentazione corretto.
- Testare la funzionalità del catalogo di macchine migrato aggiungendo o rimuovendo macchine o eseguendo operazioni di alimentazione, assicurandosi che il catalogo funzioni correttamente.
Rollback di un catalogo migrato
Questa operazione ripristina un catalogo di macchine e le relative VM alla connessione host di origine originale. Rimuove tutte le risorse create durante il processo di migrazione.
Importante:
È possibile eseguire il rollback solo se non è stato modificato il catalogo dopo la migrazione e non è stata eseguita l’operazione Pulizia risorse di origine. La connessione di origine originale rimane invariata e contiene ancora i suoi dischi di base.
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback
<!--NeedCopy-->
Pulizia delle risorse di origine
Dopo una migrazione riuscita, questa operazione rimuove le risorse di origine, ad esempio i dischi di base, dalla connessione hypervisor originale.
Importante:
Quando si esegue questo comando, lo stato di migrazione viene cancellato. Ciò rende impossibili i rollback successivi.
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources
<!--NeedCopy-->
Viene visualizzato un prompt di conferma prima di procedere, poiché questa azione è irreversibile. Confermare il prompt per completare la pulizia.