Administrar un catálogo de Nutanix
Administrar catálogos de máquinas describe los asistentes que administran un catálogo de máquinas. La siguiente información cubre detalles específicos de los entornos de Nutanix AHV Prism Central.
Nota:
Antes de administrar un catálogo de máquinas en Nutanix AHV Prism Central, debes terminar de crear un catálogo de máquinas en Nutanix AHV Prism Central. Consulta Crear un catálogo de Nutanix.
Puedes administrar un catálogo de máquinas en Nutanix AHV Prism Central usando:
Usar Studio
A continuación, se muestran las opciones para administrar un catálogo de máquinas en Nutanix AHV Prism Central usando Studio:
| Opción | Descripción |
|---|---|
| Agregar máquinas | Crea y agrega máquinas virtuales al catálogo de máquinas. |
| Eliminar catálogo de máquinas | Elimina un catálogo de máquinas. Puedes elegir eliminar las máquinas virtuales al mismo tiempo o dejar las máquinas virtuales persistentes intactas. |
| Cambiar imagen maestra | Cambia la imagen maestra utilizada como plantilla para todas las máquinas virtuales del catálogo. |
| Agregar o cambiar perfil de máquina | Cambia la versión de la plantilla del perfil de máquina o agrega un perfil de máquina a un catálogo existente. |
| Administrar conjunto de configuración | Vincula un catálogo a un conjunto de configuración de Workspace Environment Management™ o cambia a una configuración diferente. |
| Modificar catálogo de máquinas | Modifica las configuraciones del catálogo, como las NIC y las máquinas virtuales. |
| Ver máquinas | Ve al nodo Buscar para ver todas las máquinas virtuales que pertenecen al catálogo. |
| Cambiar nombre del catálogo de máquinas | Cambia el nombre del catálogo. |
| Actualizar VDAs | Actualiza los VDAs por catálogo. Esta función solo se aplica a máquinas persistentes estáticas. |
| Cambiar nivel funcional | Selecciona el nivel funcional mínimo para el catálogo. Establecer un nivel funcional hace que todas las funciones estén disponibles. |
| Probar catálogo de máquinas | Comprueba si el catálogo tiene errores o advertencias. |
| Administrar etiquetas | Crea, modifica y elimina etiquetas. Selecciona las etiquetas que se aplicarán al catálogo. |
| Mover catálogo de máquinas | Mueve el catálogo a otra carpeta. |
Nota:
Actualmente, la opción Clonar no está disponible.
Cambiar imagen maestra
Para cambiar la imagen maestra de un catálogo, sigue estos pasos:
- En la página Catálogos de máquinas, haz clic con el botón derecho en el catálogo de máquinas que quieres actualizar y selecciona Cambiar imagen maestra.
-
En la página Cambiar imagen maestra, haz clic en Seleccionar una imagen.
- En la página Seleccionar una imagen, expande una plantilla y selecciona una versión de plantilla para usarla como imagen maestra. Puedes filtrar las plantillas de máquinas por nombre.
- En la página Estrategia de implementación, elige cuándo quieres que se aplique la actualización.
Nota:
- Para un catálogo no persistente aprovisionado por MCS con el complemento de conexión de host de Nutanix AHV Prism Central, la actualización de la imagen maestra para cambiar la configuración de arranque entre Legacy y UEFI impide que las máquinas virtuales existentes se inicien en su próximo arranque.
- Cuando actualizas la imagen maestra, solo se actualiza el disco del sistema operativo. Las propiedades del hardware permanecen sin cambios. Para actualizar las propiedades del hardware, consulta Agregar o cambiar el perfil de máquina, Cambiar NIC y Cambiar la configuración de las máquinas virtuales.
Agregar o cambiar el perfil de máquina
Para agregar o cambiar un perfil de máquina para un catálogo, sigue estos pasos:
- En la página Catálogos de máquinas, haz clic con el botón derecho en el catálogo de máquinas que quieres modificar y selecciona Modificar catálogo de máquinas.
-
En la página Perfil de máquina,
- Si el catálogo de máquinas ya tiene un perfil de máquina, haz clic en el icono del lápiz para seleccionar una versión de plantilla de perfil de máquina diferente. Puedes filtrar por el nombre de la plantilla. Confirma la configuración del perfil de máquina.
- Si el catálogo de máquinas no tiene un perfil de máquina, selecciona Usar un perfil de máquina y selecciona un perfil de máquina. Confirma la configuración del perfil de máquina.
- La página Máquinas virtuales debe reflejar la configuración actualizada según la versión de plantilla de perfil de máquina seleccionada.
Cambiar NIC
Para cambiar las NIC de un catálogo, sigue estos pasos:
- En la página Catálogos de máquinas, haz clic con el botón derecho en el catálogo de máquinas que quieres modificar y selecciona Modificar catálogo de máquinas.
-
En la página NICs:
- Selecciona un tipo de NIC.
-
Si el catálogo seleccionado se creó con un perfil de máquina, el número de NIC es coherente con el número de NIC del perfil de máquina y no se puede cambiar. Selecciona una red virtual asociada para cada NIC.
-
Si el catálogo seleccionado se creó sin perfil de máquina, haz clic en Agregar NIC para aumentar el número de NIC o haz clic en Quitar para eliminar las NIC seleccionadas. Marca o desmarca las casillas para seleccionar las NIC y elige una red virtual asociada para cada NIC.
Cambiar la configuración de las máquinas virtuales
Para cambiar la configuración de las máquinas virtuales, incluida la memoria, el número de CPU y los núcleos por vCPU, sigue estos pasos:
- En la página Catálogos de máquinas, haz clic con el botón derecho en el catálogo de máquinas que quieres modificar y selecciona Modificar catálogo de máquinas.
-
En la página Máquinas virtuales, usa las flechas hacia arriba o hacia abajo, o introduce los valores directamente para ajustar la memoria, el número de CPU y los núcleos por vCPU de las máquinas virtuales.
Usar PowerShell
Cambiar imagen maestra
Los parámetros necesarios son:
-
ProvisioningSchemeName: Nombre del esquema de aprovisionamiento que se va a modificar. -
MasterImage: Ruta literal a la nueva imagen maestra.
Ejecuta el siguiente comando. Por ejemplo:
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:
Al actualizar la imagen maestra, solo se actualiza el disco del sistema operativo. Las propiedades de hardware permanecen sin cambios. Para actualizar las propiedades de hardware, consulta Agregar o cambiar el perfil de la máquina, Cambiar NIC y Cambiar la configuración de la NIC y la VM.
Agregar o cambiar el perfil de la máquina
Usa el comando Set-ProvScheme:
- Para actualizar un catálogo con un nuevo perfil de máquina, o
- Para actualizar un catálogo existente que no tiene un perfil de máquina para empezar a usar el perfil de máquina como origen de la especificación de hardware.
Nota:
Esto no actualiza la especificación de hardware de las VM existentes en el catálogo. Solo las nuevas VM agregadas al catálogo tienen la especificación de hardware del perfil de máquina dado.
Para cambiar el perfil de la máquina o convertir un catálogo existente para empezar a usar el perfil de la máquina:
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-->
El perfil de la máquina debe tener al menos una NIC, y el número de NIC en el perfil de la máquina debe coincidir con las asignaciones de subred en NetworkMapping
El número total de NIC para la versión de la plantilla se puede obtener de los AdditionalData de su elemento de inventario usando lo siguiente:
$tv = Get-Item -Path "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
$tv.AdditionalData.TotalNics
<!--NeedCopy-->
Para cambiar el perfil de la máquina con la especificación de hardware anulada:
Ciertas configuraciones se pueden configurar usando parámetros de línea de comandos específicos. Estos parámetros de línea de comandos, como VMCpuCount y VMMemoryMB, y CPUCores en las CustomProperties, tienen prioridad sobre los valores de la versión de la plantilla del perfil de la máquina.
$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-->
Cambiar la configuración de la NIC y la VM
Los parámetros necesarios son:
-
ProvisioningSchemeName: Nombre del esquema de aprovisionamiento que se va a modificar. -
NetworkMapping: Asignación de red actualizada.
Ejecuta el siguiente comando. Por ejemplo:
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-->
Migrar catálogos de máquinas a la conexión de host de Nutanix AHV Prism Central administrada por Citrix
Migra tus catálogos de máquinas Citrix y sus VM asociadas de las conexiones de host existentes de Nutanix AHV (para Prism Element) y Nutanix AHV PC (para NC2 en Azure) a la conexión de host de Nutanix AHV Prism Central administrada por Citrix. Para la migración, usa comandos de PowerShell, que también incluyen opciones de reversión rápida en caso de problemas y comandos para limpiar los recursos de origen después de la migración.
Ventajas
- Interrupción minimizada: Realizas una transición fluida al complemento de Nutanix AHV Prism Central. Esto tiene un impacto mínimo en tus implementaciones existentes.
- Ruta de actualización fluida: Proporciona una ruta clara y compatible para que actualices tu infraestructura y aproveches la nueva interfaz de administración.
- Integridad y seguridad de los datos: Las opciones de reversión garantizan que reviertas el entorno a su estado original en caso de problemas imprevistos. Esto reduce el riesgo.
- Eficiencia de recursos: Limpias los recursos de origen después de una migración exitosa. Esto optimiza el almacenamiento y la sobrecarga de administración.
- Flexibilidad: Admite la migración de catálogos aprovisionados tanto por MCS como por tecnologías de terceros. Esto ofrece una aplicabilidad más amplia.
Aplicabilidad
Esta característica es aplicable a los catálogos de máquinas bajo las conexiones de host de Nutanix AHV (para Prism Element) y Nutanix AHV PC (para NC2 en Azure):
- Catálogos de máquinas administrados por MCS, incluidos los tipos persistentes y no persistentes.
- Catálogos de máquinas solo administrados por energía que contienen VM aprovisionadas por tecnologías de terceros.
Requisitos del sistema
- Versión de AOS de Nutanix AHV Prism Element (PE): Se requiere un mínimo de 6.8.
- Versión de Nutanix Prism Central (PC): Se requiere un mínimo de 2024.3.
Nota:
Nutanix Prism Central 7.3 requiere AOS 7.3 debido a un problema conocido de Nutanix.
Limitaciones
- Los catálogos de PVS no son compatibles: Esta característica no es compatible con los catálogos de máquinas creados con el Asistente de configuración de Xendesktop de Citrix Provisioning Services (PVS).
-
Restricciones de reversión:
- Solo permite la reversión de un catálogo migrado si no has modificado el catálogo después de la migración inicial.
- Cuando ejecutas la operación “Limpiar recursos de origen”, esta borra el estado de la migración. Esto impide cualquier reversión posterior.
- No se permite la remigración: Un catálogo de máquinas que ya has migrado no es compatible con la remigración.
- Máquinas virtuales de conexión multihost: No se admite la migración de catálogos de máquinas solo administrados por energía que contengan máquinas virtuales importadas de varias conexiones de host.
Consideraciones importantes
- Administración de clústeres de Nutanix: Los clústeres de Nutanix AHV de alojamiento deben registrarse en un Nutanix Prism Central.
- Creación de plantillas de imagen maestra: Para los catálogos de máquinas de MCS, el comando de migración ofrece una opción para generar una versión de plantilla de máquina virtual en Prism Central a partir de la instantánea original de la imagen maestra del catálogo de máquinas. Esta versión de plantilla de máquina virtual se puede usar más adelante como imagen maestra de MCS de los catálogos de máquinas bajo la conexión de host de Prism Central. Por defecto, esta opción no está habilitada.
- Condiciones previas para la reversión:
Para que sea posible una reversión exitosa, el entorno de origen original —incluida la conexión de host y los discos base— debe permanecer sin cambios. También debes evitar realizar cambios de configuración en el catálogo de máquinas migrado y agregar o quitar máquinas virtuales hasta que se confirme que la migración se ha realizado correctamente. Después de esa confirmación, puedes realizar la operación final de Limpiar recursos de origen, pero ten en cuenta que este es un paso irreversible que hará imposible la reversión.
Permisos necesarios para la migración y la reversión
Para migrar catálogos o revertirlos, necesitas los siguientes permisos:
Administrador de Prism Element:
- Crear máquina virtual
Administrador de Prism Central:
- Crear plantillas de máquina virtual
- Eliminar plantillas de máquina virtual
- Eliminar punto de recuperación de máquina virtual
- Eliminar máquina virtual
Para obtener la lista completa de permisos específicos necesarios para la conexión de host de Nutanix AHV Prism Central administrada por Citrix, consulta Permisos necesarios.
Cómo migrar
Administras esta característica mediante cmdlets de PowerShell dedicados. El flujo de trabajo general implica tres operaciones principales: Migración, Reversión y Limpieza de recursos de origen.
Migrar un catálogo de máquinas
- Esta operación mueve un catálogo de máquinas y sus máquinas virtuales asociadas desde una conexión de host de origen de Nutanix AHV o Nutanix AHV PC a una conexión de host de Nutanix AHV Prism Central administrada por Citrix.
- Para los catálogos aprovisionados por MCS, este proceso crea nuevos discos base en la conexión de destino.
- Opcionalmente, puedes elegir crear un equivalente de máquina virtual maestra (versión de plantilla de máquina virtual) en la conexión de destino a partir de la instantánea de la imagen maestra original.
- Crear una nueva conexión de host de Nutanix AHV Prism Central: Antes de migrar, registra el clúster de Nutanix AHV de alojamiento en un Nutanix Prism Central y establece una nueva conexión de host de Nutanix AHV Prism Central que apunte a la instancia de Nutanix Prism Central de destino. Esta conexión sirve como destino para tus catálogos migrados. Para obtener más detalles, consulta Conexión de host de Nutanix AHV Prism Central.
-
Migrar un catálogo de máquinas existente: Para los catálogos de máquinas existentes, usa el cmdlet de PowerShell
Switch-ProvCatalogpara iniciar la migración a la conexión de host de Nutanix AHV Prism Central administrada por Citrix.c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination <!--NeedCopy-->- Reemplaza
<Catalog_UID>por el identificador único del catálogo de máquinas que deseas migrar. Usa el siguiente cmdlet de PowerShell para localizar elBrokerCatalogUidpor nombre de catálogoGet-BrokerCatalog -Name <Catalog Name>. -
DestinationConnectiones el nombre de la nueva conexión de host de Nutanix AHV Prism Central creada en el Paso 1. -
DestinationUnites el nombre que le das a la unidad de alojamiento dentro deDestinationConnectiondonde residirá el catálogo de máquinas. - El parámetro
-CreateMasterImageAtDestinationes opcional. Crea una versión de plantilla de máquina virtual de imagen maestra en el Prism Central de destino.
- Reemplaza
-
Verificar la finalización de la migración: Después de ejecutar el cmdlet de migración, supervisa el estado de la tarea en la ventana de PowerShell para asegurarte de que se complete correctamente. Cuando la migración finaliza, el catálogo se mueve a la conexión de host de destino creada en el paso 1. Debes ver un estado de finalizado con el tipo de tarea SwitchProvCatalog. Los siguientes son los pasos recomendados para verificar la finalización de la migración:
- Comprueba el estado del catálogo en Studio.
- Verifica que las máquinas virtuales dentro del catálogo ahora estén asociadas con la nueva conexión de hipervisor de destino.
- Verifica que las máquinas virtuales dentro del catálogo muestren el estado de energía correcto.
- Prueba la funcionalidad del catálogo de máquinas migrado agregando o quitando máquinas o emitiendo operaciones de energía para asegurarte de que el catálogo funcione correctamente.
Revertir un catálogo migrado
Esta operación revierte un catálogo de máquinas y sus máquinas virtuales a su conexión de host de origen original. Quita cualquier recurso que hayas creado durante el proceso de migración.
Importante:
Solo realizas la reversión si no has modificado el catálogo después de la migración y no has ejecutado la operación Limpiar recursos de origen. La conexión de origen original permanece sin cambios y aún contiene sus discos base.
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback
<!--NeedCopy-->
Limpiar recursos de origen
Después de una migración exitosa, esta operación quita los recursos de origen, por ejemplo, los discos base, de la conexión de hipervisor original.
Importante:
Cuando ejecutas este comando, borra el estado de la migración. Esto hace que las reversiones posteriores sean imposibles.
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources
<!--NeedCopy-->
Recibirás un mensaje de confirmación antes de continuar, ya que esta acción es irreversible. Confirma el mensaje para completar la limpieza.