Migrar la configuración a Citrix Cloud™
La Herramienta de Configuración Automatizada (ACT) permite la migración de la configuración de Citrix Virtual Apps and Desktops™ (directivas, aplicaciones, catálogos, roles de administrador, ámbitos y otros) desde uno o varios sitios locales a Citrix DaaS alojado en Citrix Cloud. También se puede usar para migrar información entre diferentes regiones o inquilinos de la nube.
Esta herramienta detecta y exporta uno o varios sitios locales como una colección de archivos de configuración, que puedes editar opcionalmente. La configuración de estos archivos se puede importar luego a Citrix DaaS. La migración se realiza por etapas ejecutando la herramienta varias veces, lo que te permite lograr fácilmente el estado de configuración deseado.
ACT no es solo una herramienta de migración de un solo uso. Puedes usarla para administrar tus operaciones diarias en la nube, como:
- Automatizar la transferencia de cuentas de nube de prueba o de ensayo a cuentas de nube de producción
- Hacer copias de seguridad y restaurar tu configuración
- Dividir un entorno de nube en varias nubes
El siguiente vídeo de 2 minutos ofrece un recorrido rápido por la Configuración Automatizada.
Para obtener información adicional sobre la Configuración Automatizada, consulta Prueba de concepto: Herramienta de configuración automatizada en Tech Zone.
Para una mirada más profunda a cómo mover tu implementación y preparar tu configuración local para la migración, consulta Guía de implementación: Migración de Citrix Virtual Apps and Desktops de local a Citrix Cloud en Tech Zone.
Limitaciones conocidas
- Los catálogos de máquinas aprovisionados a través de Machine Creation Services™ tienen consideraciones especiales. Para obtener más información sobre MCS, consulta Comprender la migración de catálogos aprovisionados por Machine Creation Services.
Requisitos previos para migrar tu configuración
Para exportar tu configuración desde Citrix Virtual Apps and Desktops, necesitas:
- Citrix Virtual Apps and Desktops: la versión actual y su predecesora inmediata o Citrix Virtual Apps and Desktops, XenApp y XenDesktop® LTSR: todas las versiones
- Una máquina unida a un dominio con .NET Framework 4.7.2 o posterior y el SDK de Citrix PowerShell. Esto se instala automáticamente en el Delivery Controller. (Para ejecutar en una máquina que no sea el Delivery Controller local, debe instalarse Citrix Studio, ya que Studio instala los complementos de PowerShell correctos. El instalador de Studio se puede encontrar en los medios de instalación de Citrix Virtual Apps and Desktops).
Para importar tu configuración a Citrix DaaS, necesitas:
- Una máquina con acceso a Citrix Cloud. No tiene por qué ser un Delivery Controller™ ni una máquina unida a un dominio.
- Citrix DaaS aprovisionado.
- Una ubicación de recursos activa con Connector instalado y unida al mismo dominio que la configuración local.
- La conectividad a los sitios que acceden a Citrix Cloud debe estar permitida y disponible. Para obtener más información, consulta Requisitos del sistema y de conectividad.
Nota:
La Configuración Automatizada no se puede instalar en un sistema Cloud Connector.
Pasos clave
- Descarga la Herramienta de Configuración Automatizada y revisa los requisitos del sistema. Consulta Descargar Configuración Automatizada.
- Rellena el archivo
CustomerInfo.ymlcon tus valores deCustomerName,CustomerIDySecretKeygenerados desde el portal de Citrix Cloud. Consulta Generar el ID de cliente, el ID de cliente y la clave secreta y Rellenar el archivo de información del cliente. - Si el sitio local contiene varias zonas, actualiza el archivo
ZoneMapping.ymlpara asignar zonas a las ubicaciones de recursos de Citrix DaaS. Consulta Rellenar el archivo de asignación de zonas. - Si el sitio contiene varias conexiones de alojamiento, actualiza el archivo
CvadAcSecurity.ymlcon la información de conexión para cada tipo de host que migra a Citrix DaaS. Si solo hay una conexión de host, actualiza el archivoCvadACSecurity.ymlcon la información de conexión para esa conexión de host. Consulta Actualizar el archivo de seguridad para conexiones de host. - Abre ACT y exporta tu sitio local usando el comando
Export-CvadAcToFile. Consulta Objetos de migración admitidos para ver la lista de componentes admitidos para la migración. Para obtener información sobre los pasos para exportar, consulta Exportar la configuración local. - Importa componentes por etapas usando el comando
Merge-CvadAcToSite. Alternativamente, migra todo el sitio a la vez. Asegúrate de migrar los componentes en el orden que se indica en Orden de migración de componentes. Para obtener información sobre los pasos para importar, consulta Ejecutar una importación. - Activa el sitio en la nube. Consulta Activar sitios.
Descargar Configuración Automatizada
Descarga e instala la herramienta de Configuración Automatizada desde Descargas de Citrix.
Actualizar Configuración Automatizada
Para evitar errores de funcionalidad, usa siempre la última versión disponible de ACT.
Para saber la versión de tu herramienta, haz lo siguiente:
- Haz doble clic en el icono de Configuración automática. Aparece una ventana de PowerShell.
- Ejecuta el siguiente comando para comprobar tu número de versión.
Genera el ID de cliente, el ID de cliente de API y la clave secreta
Para migrar el sitio local a Citrix DaaS, rellena el archivo CustomerInfo.yml con el ID de cliente, el ID de cliente de API y la clave secreta del portal de Citrix Cloud.
Para recuperar el ID de cliente:
- Inicia sesión en tu cuenta de Citrix Cloud y selecciona el cliente.
- Haz clic en el icono de cuadrícula y selecciona Administración de identidades y accesos.
- Ve a Acceso a la API > Clientes seguros. El ID de cliente se muestra en la página.
Para recuperar el ID de cliente de API y la clave secreta:
- En la página Clientes seguros, introduce un nombre en el cuadro. Este nombre se usa para diferenciar entre varios ID de cliente de API y claves secretas.
- Haz clic en Crear cliente para crear el ID de cliente de API y la clave secreta.
- Copia el ID de cliente de API y la clave secreta en una ubicación segura y descarga el archivo
.csvque contiene esta información. Usa el archivo.csvpara rellenar el archivoCustomerInfo.yml.
Nota:
- El ID de cliente de API y la clave secreta no caducan. Si se ven comprometidos, quítalos inmediatamente usando el icono de Papelera y crea otros nuevos.
- La clave secreta no se puede recuperar si se pierde u olvida; se deben crear un nuevo ID de cliente de API y una nueva clave secreta.
Rellena el archivo de información del cliente
El archivo CustomerInfo.yml elimina la necesidad de proporcionar parámetros de información del cliente cada vez que ejecutas el cmdlet. Cualquier información del cliente se puede anular usando los parámetros del cmdlet.
Usa el cmdlet New-CvadAcCustomerInfoFile para crear el archivo CustomerInfo.yml.
Importante:
No edites manualmente el archivo
CustomerInfo.yml. Hacerlo puede causar errores de formato involuntarios.
El cmdlet New-CvadAcCustomerInfoFile tiene los siguientes parámetros obligatorios.
- CustomerId – ID del cliente.
- ClientId – ID de cliente de API del cliente creado en Citrix Cloud.
- Secret – clave secreta del cliente creada en Citrix Cloud.
Ejemplo:
Nota:
Agrega un espacio entre los dos puntos y el nombre de la ubicación del recurso. Si se usan espacios en el nombre de la zona o de la ubicación del recurso, encierra el nombre entre comillas.
Actualizar el archivo de seguridad para las conexiones de host
Las conexiones de host y sus hipervisores asociados se pueden exportar e importar mediante ACT.
Agregar un hipervisor a una conexión de host requiere información de seguridad específica del tipo de hipervisor. Esta información no se puede exportar desde el sitio local por motivos de seguridad. Debes proporcionar manualmente la información para que la Configuración automatizada pueda importar correctamente las conexiones de host y los hipervisores al sitio en la nube.
El proceso de exportación crea el archivo CvadAcSecurity.yml en %HOMEPATH%\Documents\Citrix\AutoConfig que contiene marcadores de posición para cada elemento de seguridad necesario para el tipo de hipervisor específico. Debes actualizar el archivo CvadAcSecurity.yml antes de importar al sitio en la nube. Las actualizaciones del administrador se conservan en varias exportaciones y se agregan nuevos marcadores de posición de seguridad según sea necesario. Los elementos de seguridad nunca se quitan. Para obtener más información, consulta Actualizar manualmente el archivo CvadAcSecurity.yml
HostConn1:
ConnectionType: XenServer®
UserName: root
PasswordKey: rootPassword
HostCon2:
ConnectionType: AWS
ApiKey: 78AB6083-EF60-4D26-B2L5-BZ35X00DA5CH
SecretKey: TwBLaaaaaaaaaaaaaaaaaw==
Region: East
Información de seguridad por hipervisor
A continuación se enumera la información de seguridad necesaria para cada tipo de hipervisor.
- XenServer, Hyper-V, VMware
- Nombre de usuario
- Contraseña de texto sin formato
- Microsoft Azure
- ID de suscripción
- ID de aplicación
- Secreto de aplicación
- AWS
- ID de cuenta de servicio
- Secreto de aplicación
- Región
Consideraciones especiales de seguridad
Toda la información de seguridad se introduce como texto sin formato. Si no se recomienda el texto sin formato, las conexiones de host y los hipervisores asociados se pueden crear manualmente mediante Studio. Los nombres de las conexiones de host y de los hipervisores deben coincidir exactamente con sus equivalentes locales para que los catálogos de máquinas que usan las conexiones de host se puedan importar correctamente.
Exportar tu configuración local de Citrix Virtual Apps and Desktops
Mediante un comando de PowerShell export, puedes exportar tu configuración local existente y obtener los archivos .yml necesarios. Estos archivos se usan para importar la configuración deseada a Citrix Cloud.
Objetos de migración admitidos
La Configuración automatizada admite la migración de la configuración de los siguientes componentes:
- Etiquetas
- Administración delegada
- Ámbitos
- Roles
- Conexiones de host
- Un único grupo de recursos
- Ámbitos de administración
- Catálogos de máquinas
- Ámbitos de administración
- Máquinas
- Acceso con PC remoto, Físicas, Agrupadas, Aprovisionadas, MCS, Asignadas
- StoreFront™
- Grupos de entrega
- Directiva de acceso
- Asociación de ámbito de administración
- Directiva de acceso a aplicaciones
- Directiva de asignación
- Directiva de derechos/escritorio
- Programaciones de energía
- Persistencia de sesión
- Inicio previo de sesión
- Programaciones de reinicio
- Etiquetas
- Grupos de aplicaciones
- Asociación de ámbito de administración
- Grupos de entrega
- Usuarios y grupos
- Aplicaciones
- Carpetas de aplicaciones
- Iconos
- Aplicaciones
- FTA configuradas por Broker
- Etiquetas
- Directivas de grupo
- Preferencias de zona de usuario
Exportar la configuración local
- Haz doble clic en el icono de Configuración automática. Aparece una ventana de PowerShell.
- Ejecuta el siguiente comando para exportar todos los componentes. Exportar tu configuración local no la cambia de ninguna manera.
Comprender la migración de catálogos aprovisionados por Machine Creation Services
Nota:
Esta característica solo está disponible en las versiones 3.0 y posteriores. Comprueba tu versión usando
Get-CvadAcStatusdentro de Automated Configuration.
Los catálogos de Machine Creation Services (MCS) crean dos tipos diferentes de catálogos:
- Cuando los cambios realizados en una máquina se pierden o se revierten (comúnmente en sistemas operativos de servidor, donde se publican aplicaciones); este es un caso de uso de VDI agrupado/multisesión.
- Cuando los cambios realizados en una máquina se conservan después de un reinicio (comúnmente en sistemas operativos de cliente con un usuario dedicado); este es un caso de uso de VDI estático.
El tipo de catálogo se puede confirmar en el nodo del catálogo en Citrix Studio y consultando el valor “Datos de usuario:” del catálogo.
Nota:
MCS no se puede respaldar desde la nube mediante Automated Configuration.
Catálogos de VDI agrupados/multisesión
Los catálogos con “Datos de usuario: Descartar” son catálogos de VDI agrupados y solo pueden migrar la imagen principal y la configuración. Las máquinas virtuales de estos catálogos no se migran. Esto se debe a que el ciclo de vida de la máquina virtual lo mantiene el sitio desde el que se importa, lo que significa que cada vez que se encienden las máquinas, su estado puede cambiar. Esto hace que la importación sea imposible, ya que los datos de importación de las máquinas virtuales se desincronizan rápidamente.
Cuando migras estos catálogos con la herramienta, esta crea los metadatos del catálogo e inicia la creación de la imagen principal, pero no se importa ninguna máquina.
Dado que este proceso puede tardar un tiempo en crearse en función del tamaño de la imagen principal, el comando de importación de la herramienta solo inicia la creación del catálogo de MCS y no espera a que finalice. Una vez completada la importación, supervisa el progreso de la creación del catálogo mediante Studio en la implementación en la nube.
Una vez creada la imagen principal, puedes aprovisionar máquinas. Ten en cuenta las consideraciones de capacidad, ya que tendrías capacidad consumida de tu uso local.
Todos los demás objetos (grupos de entrega, aplicaciones, directivas, etc.) que utilizan ese catálogo se pueden importar y no tienen que esperar a la creación de la imagen principal. Cuando el catálogo haya terminado de crearse, se pueden agregar máquinas al catálogo importado y, a continuación, los usuarios pueden iniciar sus recursos.
Nota:
Usa los mismos comandos disponibles en la herramienta para migrar catálogos y todos los demás objetos.
Catálogos de VDI estáticos
Nota:
Dado que esta operación importa detalles de bajo nivel que se almacenan en la base de datos, este proceso debe ejecutarse desde una máquina con acceso a la base de datos.
Los catálogos de VDI estáticos migran la imagen principal, las configuraciones y todas las máquinas virtuales. A diferencia del caso de uso de VDI agrupado, no es necesario crear imágenes.
Los VDA deben apuntar al conector para que se registren en la nube.
Consulta la sección Activación de sitios para activar el sitio en la nube, de modo que la programación de reinicios, la administración de energía y otros elementos sean controlados por la nube.
Una vez completada la migración, si quieres quitar este catálogo de tu sitio local, debes seleccionar dejar la VM y la cuenta de AD. De lo contrario, se eliminarán y el sitio en la nube quedaría apuntando a la VM eliminada.
Actualizar las etiquetas de MCS para detectar recursos huérfanos después de la migración
Después de migrar de una configuración local a un sitio en la nube, o de tu configuración en la nube a otro sitio en la nube, debes actualizar las etiquetas de ID de sitio de MCS en el caso de las VM persistentes para que los recursos huérfanos se puedan detectar correctamente. Para ello, usa el comando de PowerShell Set-ProvResourceTags. Actualmente, esta característica es aplicable a Azure.
Los pasos detallados son los siguientes:
- Actualiza las etiquetas de ID de sitio de MCS desde el nuevo sitio de Citrix usando el comando de PowerShell
Set-ProvResourceTags. Por ejemplo:
En este artículo
- Limitaciones conocidas
- Requisitos previos para migrar tu configuración
- Pasos clave
- Descargar Configuración Automatizada
- Actualizar Configuración Automatizada
- Genera el ID de cliente, el ID de cliente de API y la clave secreta
- Actualizar el archivo de seguridad para las conexiones de host
- Exportar tu configuración local de Citrix Virtual Apps and Desktops
- Comprender la migración de catálogos aprovisionados por Machine Creation Services
- Actualizar las etiquetas de MCS para detectar recursos huérfanos después de la migración