PoC Guide: Automated Configuration Tool

Información general

La herramienta de configuración automatizada facilita la migración y exportación de configuraciones al servicio Citrix Virtual Apps and Desktop Service (CVADS). Esta guía de prueba de concepto ilustra las instrucciones paso a paso sobre cómo utilizar esta herramienta.

Los administradores pueden probar y explorar fácilmente las funciones y ventajas de Citrix Virtual Apps and Desktop Service (CVADS), mientras ejecutan simultáneamente entornos locales existentes e incluso facilitar los desplazamientos entre regiones de nube, realizar copias de seguridad de las configuraciones existentes y otros casos de uso. El enlace de descarga de Configuración automatizada también contiene información adicional y documentación detallada sobre dichos casos de uso y personalizaciones.

¿Qué es la herramienta de configuración automatizada para Citrix Virtual Apps and Desktops?

Esta herramienta está diseñada para ayudar a automatizar la migración de la configuración de CVAD (directivas, aplicaciones, catálogos, funciones de administración, ámbitos y otros) de uno o más sitios locales al servicio Citrix Virtual Apps and Desktop (CVADS) alojado en Citrix Cloud. También se puede utilizar para migrar información entre diferentes regiones de la nube o arrendatarios.

La migración se puede realizar en etapas ejecutando la herramienta varias veces, lo que permite a los administradores alcanzar fácilmente el estado de configuración deseado. Hay un vídeo de 2 minutos que ofrece un recorrido rápido por la herramienta de configuración automatizada:

 

¿Por qué usar esta herramienta?

Los administradores de TI encargados de entornos grandes o complejos suelen encontrar que las migraciones son un proceso tedioso. Con frecuencia terminan escribiendo sus propias herramientas para llevar a cabo esta tarea con éxito, ya que tiende a ser específica para sus casos de uso.

Citrix quiere ayudar a facilitar este proceso proporcionando una herramienta que aborde los casos de uso mediante la automatización. Los administradores pueden probar fácilmente las configuraciones actuales en Citrix Cloud y aprovechar las ventajas que ofrece CVADS mientras mantienen intactos sus entornos actuales. Estos beneficios incluyen una reducción de la sobrecarga administrativa cuando Citrix administra parte del back-end y del plano de control, actualizaciones automáticas y personalizables de componentes de Citrix Cloud, entre otros.

¿Cómo se implementa esta herramienta?

Citrix utiliza la configuración estándar del sector como código para proporcionar un mecanismo que ayude a automatizar los procesos de migración. Esta herramienta detecta y exporta uno o más sitios locales como una colección de archivos de configuración, que los administradores pueden modificar de forma opcional. La configuración de estos archivos se puede importar a CVADS.

Este código no se limita a las migraciones, sino que es el futuro para crear la configuración para los sitios de Citrix y, como tal, es aplicable para muchos casos de uso diferentes. Se admite la recuperación ante desastres, la sincronización de desarrollo/pruebas/ensayo a la producción, los movimientos geográficos (GEO) y varios otros escenarios. Para los administradores que utilizan proveedores de nube pública, esto puede ayudar a crear una combinación de objetos automáticamente (paralela a las plantillas ARM de Microsoft Azure y AWS CloudFormation).

La herramienta también permite a los administradores combinar varios sitios locales en un solo sitioy, al mismo tiempo, evitar colisiones de nombres. Los administradores pueden controlar si On-Premises o Cloud controlan los recursos. Los archivos ahora se pueden colocar en un recurso compartido de archivos de red seguro que requiere autenticación cuando se usa el parámetro SecurityFileFolder que apunta al archivo CVADACSecurity.yml .

Requisitos previos

Entorno local

  • Entorno local de Citrix Virtual Apps and Desktops (CVAD) con al menos un VDA registrado.
  • Entorno local de CVAD que se ejecuta en una de las siguientes versiones: Cualquier versión de Long Term Service Release (LTSR) con su CU más reciente (7.6, 7.15, 1912); o una de las dos versiones más recientes (CR) correspondientes (por ejemplo: 2003, 2006).
  • El equipo unido a un dominio en el que planea ejecutar los comandos de la herramienta Configuración automatizada debe ejecutar la versión de.NET 4.7.2 o superior.
  • Una máquina con Citrix PowerShell SDK, que se instala automáticamente en el DDC. Nota: Si se ejecuta la herramienta en un equipo diferente, debe estar unida a un dominio y Studio debe tener instalados los complementos de PowerShell correctos. Este instalador se encuentra en los medios de instalación ISO del productode la versión correspondiente, que se pueden obtener en el sitio web Descargas de Citrix > Citrix Virtual Apps and Desktops .
  • Descargue la herramienta de configuración automatizada MSI del sitio web de descargas oficiales

Componentes relacionados con la nube

Nota: Si va a migrar entre sitios en la nube (migración de nube a nube), consulte la Documentación oficial para conocer los pasos detallados.

  • Licencias CVADS o Workspace Premium Plus válidas.
  • El administrador debe poder iniciar sesión en Cloud Portal y obtener: el nombre de la ubicación del recurso, el ID del clientey el secreto del cliente (ID de la aplicación y clave secreta)
  • La ubicación de recursos existente de Citrix Cloud tiene al menos un Cloud Connector, que está marcado como verde (saludable) y forma parte del mismo dominio que la configuración local. Nota: Citrix recomienda tener dos o más Cloud Connectors (para redundancia y alta disponibilidad). Para obtener información sobre cómo configurar los Cloud Connectors, consulte esta guía.

Esta guía de prueba de concepto demuestra cómo

  1. Complete los requisitos previos locales
  2. Exporte la configuración de su sitio local a archivos YAML (.yml)
  3. Complete los requisitos previos de la nube
  4. Complete los requisitos para importar la configuración del sitio cuando utilice diferentes métodos de aprovisionamiento (Machine Creation Services (MCS) para catálogos agrupados y estáticos)
  5. Importar la configuración del sitio a la nube (editando los archivos necesarios)
  6. Consejos para la solución de problemas y dónde encontrar más información

Requisitos previos completos para exportar desde un sitio local

Estos pasos deben ejecutarse en el DDC o en el equipo unido al dominio donde quiere ejecutar la herramienta de configuración automatizada.

  1. Descargue la última herramienta de configuración automatizada MSIen su DDC local o en una máquina unida a un dominio. Nota: Consulte la sección Requisitos previos para obtener más información sobre cómo ejecutarlo desde otro equipo. La herramienta se puede descargar desde aquí. Nota: Consulte la sección Requisitos previos para obtener más información sobre cómo ejecutarlo desde otro equipo.
  2. Ejecute el MSI en su DDC local, haciendo clic con el botón secundario en el instalador AutoConfig_PowerShell_x64.msi y haciendo clic en Instalar. Requisitos previos
  3. Lea el Contrato de licencia y marque la casilla si acepta los términos. A continuación, haga clic en Instalar: requisitos previos
  4. Los archivos se copian y la barra de progreso sigue moviéndose hasta que finaliza la instalación. Requisitos previos

  5. Después de que se ejecute el MSI, aparece una ventana que indica que se ha completado correctamente. Haga clic en Finalizar para cerrar la ventana de configuración de MSI. Requisitos previos
  • Nota: Una vez ejecutado correctamente, el MSI crea la estructura de carpetas correspondiente, ubicada en C:\Users\<username>\Documents\Citrix\AutoConfig, y también un icono de escritorio llamado Auto Config, que inicia un símbolo del sistema de PowerShell. Esta herramienta es la que se utiliza en los pasos posteriores.

Exportar la configuración del sitio local

Mediante un comando de export PowerShell, puede exportar la configuración local existente y obtener los archivos.yml necesarios. Estos archivos se utilizan para importar la configuración deseada a Citrix Cloud.

  1. Después de ejecutar el instalador de MSI en el paso anterior, obtendrá un acceso directo de configuración automática creado automáticamente en el escritorio. Haga clic con el botón derecho en este acceso directo y seleccione Ejecutar como administrador.
  2. Ejecute el comando Export-CvadAcToFile. Este comando exporta directivas, catálogos aprovisionados manualmente y grupos de entrega. También exporta aplicaciones, carpetas de aplicaciones, iconos, asignaciones de zonas, etiquetas, roles y ámbitos de administración y otros elementos. Nota: Para los catálogos de máquinas de MCS y los grupos de entrega, consulte los pasos de la sección Requisitos para importar la configuración del sitio con diferentes métodos de aprovisionamiento de esta guía. Exportación de configuración

  3. Una vez que la herramienta termine de ejecutarse, el estado general se muestra como True y el proceso de exportación se ha completado (las líneas de salida mostradas coinciden con la siguiente ilustración). Nota: Si hay algún error, los archivos de diagnóstico se crean en las subcarpetas específicas de acción (Export, Import, Merge, Restore, Sync, Backup, Compare), que se pueden encontrar en %HOMEPATH%\Documents\Citrix\AutoConfig. Consulte la sección Consejos para la solución de problemas si encuentra algún error. Exportación de configuración

  4. Los archivos .yml resultantes están ahora en la Documents\Citrix\AutoConfig ruta de acceso del usuario actual: Exportación de configuración
  • Nota: Consulte la siguiente imagen para ver un ejemplo del contenido de un archivo.yml (Application.yml)

Exportación de configuración

  • Nota: Si es necesario, copie los archivos.yml en el equipo que quiere utilizar para importar la configuración a su entorno de Citrix Cloud. La exportación e importación se puede hacer desde la misma máquina.

Requisitos previos completos en la nube

Vaya a su ubicación de recursos y asegúrese de que sus Cloud Connectors aparezca verde (Disponible). Nota: Si necesita instrucciones sobre cómo configurar los Cloud Connectors, consulte esta guía.

  1. Para verificar el estado de sus Cloud Connectors, primero inicie sesión en el portal de la nube con sus credenciales de administrador de Citrix (o sus credenciales de Azure AD, cuando corresponda). Requisitos previos para la nube

  2. Si tiene más de un Id. de organización (Id. de organización), seleccione el arrendatario correspondiente. Requisitos previos para la nube

  3. Al iniciar sesión, vaya al menú hamburguesa en la esquina superior izquierda y, a continuación, haga clic en Ubicaciones de recursos: requisitos previos de la nube

  4. Acceda a la ventana Cloud Connector (s) bajo su ubicación de recursos. Requisitos previos para la nube

  • Nota: Los Cloud Connectors deben mostrarse en verde, indicando el estado Saludable, tal y como se muestra en la siguiente imagen. Citrix recomienda tener más de un Cloud Connector por ubicación de recursos, por motivos de redundancia.

Requisitos previos para la nube

Requisitos para importar la configuración del sitio mediante diferentes métodos de aprovisionamiento

Gestión de catálogos de máquinas, grupos y directivas de entrega y aplicaciones de Provisioning Services (PVS)

Por el momento, no se requieren pasos adicionales para importar sus catálogos de PVS y sus aplicaciones correspondientes. Siga los pasos mencionados en la sección Importar la configuración de su sitio en la nube de esta guía.

Manejo de Machine Creation Services (MCS): catálogos de máquinas RDS y multisesión de VDI agrupados (aleatorios)

Nota: Hay disponible una sección independiente con instrucciones para máquinas virtuales asignadas estáticas. Consulte los pasos mencionados en la sección MCS Static Assigned VDI de esta guía.

Los comandos de importación y exportación ahora son compatibles con esta tarea. Tanto la imagen dorada como la configuración de Catálogos con datos de usuario: Descarte se pueden migrar. Sin embargo, las máquinas virtuales de estos catálogos no se migran, ya que el sitio desde el que se importa es responsable de mantener el ciclo de vida de la máquina virtual.

Cuando las máquinas están encendidas, su estado puede cambiar, lo que afecta a los datos de importación para la sincronización de las máquinas virtuales. Por lo tanto, al migrar estos catálogos con la herramienta, crea metadatos de catálogo e inicia la creación de imágenes maestras. Sin embargo, no se importan máquinas.

Consideraciones importantes:

  • El proceso de importación del catálogo de MCS puede tardar un par de horas en función del tamaño de la imagen maestra. Por lo tanto, 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 finalizada la importación, el progreso de la creación del catálogo se puede supervisar a través de Studio en la implementación en la nube.
  • Una vez creada la imagen maestra, puede aprovisionar máquinas. Tenga en cuenta la capacidad actual de su hipervisor, ya que tiene el consumo de su uso en las instalaciones.
  • Todos los demás objetos (incluidos el grupo de entrega, las aplicaciones, las políticas y todo lo que utilice el catálogo) se pueden importar sin tener que esperar a la creación de la imagen maestra. Los mismos comandos disponibles en la herramienta se pueden usar para migrar catálogos y todos los demás objetos.
  • Cuando el catálogo haya terminado de crearse, las máquinas se pueden agregar al catálogo importado y, a continuación, los usuarios pueden iniciar sus recursos.

Nota: Después de estas consideraciones, siga la sección Importar la configuración del sitio en la nube de esta guía para combinar la configuración según sea necesario.

Tratar con servicios de creación de máquinas (MCS): Máquinas asignadas estáticas

Nota: Hay disponible una sección separada con instrucciones para máquinas agrupadas y RDS. Consulte los pasos mencionados en las máquinas MCS Pooled VDI y RDS

Los comandos de importación y exportación ahora son compatibles con esta tarea. Este proceso importa algunos detalles de bajo nivel que se almacenan en la base de datos, por lo que debe ejecutarse desde una máquina con acceso a la base de datos. El proceso de importación de herramientas migra la configuración, la imagen maestra y las máquinas también. Es una operación rápida, ya que no se crean imágenes.

Consideraciones importantes:

  • Los VDA deben dirigirse a los Cloud Connectors para que se registren en Citrix Cloud.
  • Consulte la documentación Activación de sitios para activar su sitio en la nube y controlar así la programación de reinicios, la administración de energía y otros, a través de Citrix Cloud.
  • Una vez completada la migración, si desea eliminar el catálogo correspondiente de su sitio local, debe seleccionar la opción para dejar la cuenta de VM y AD. De lo contrario, se eliminarán ambos registros y el sitio en la nube se dejará apuntando a la máquina virtual eliminada.

Nota: Después de estas consideraciones, siga la sección Importar la configuración del sitio en la nube de esta guía para combinar la configuración según sea necesario.

Importar la configuración del sitio a la nube

Durante este paso, obtendrá los detalles de conexión del cliente, cree manualmente las asignaciones de zona e importe la configuración a su arrendatario de Cloud. Nota: Para MCS, primero siga las subsecciones correspondientes de la sección Importar la configuración de su sitio en la nube de esta guía.

Obtención de Detalles de la Conexión

Los administradores deben modificar el archivo CustomerInfo.yml y agregarle los valores CustomerName, CustomerID y SecretKey correspondientes. Estos valores se pueden obtener y generar desde el portal Cloud, como se muestra en los siguientes pasos.

  1. Primero, abra el archivo CustomerInfo.yml con una aplicación de editor de texto, como el Bloc de notas. La siguiente captura de pantalla muestra los valores de CustomerInfo.yml archivo que se deben modificar (subrayados en rojo): Importación de configuración

  2. En el portal de la nube, vuelva a hacer clic en el menú hamburguesa y vaya a Administración de acceso e identidad: importación de configuración

  3. Vaya a la pestaña Acceso a API y copie el valor de ID de cliente, que se encuentra junto al customer ID texto como se muestra en la siguiente captura de pantalla (rectángulo rojo): Importación de configuración

  4. Pegue el valor recuperado entre las cotizaciones que siguen al campo CustomerID del archivo CustomerInfo.yml, entre las “” (comillas): Importación de configuración

  5. De vuelta en el portal de la nube, vaya al portal de administración de acceso e identidad y a la pestaña Acceso a API . Introduzca el nombre con el que desea identificar esta clave de API en el cuadro Asigne un nombre a su cliente seguro . A continuación, haga clic en el botón Crear cliente. Nota: Esta acción genera el Client ID y el Secret Key. Importación de configuración

  6. Copie los valores ID y Secret, uno por uno (péguelos en el archivo CustomerInfo.yml como se muestra en el siguiente paso). A continuación, haga clic en Descargar para guardar el archivo para su posterior referencia. Importación de configuración

  7. Pegue los Secret valores ID y en los campos correspondientes del archivo CustomerInfo.yml: Importación de configuración

Crear manualmente el archivo de asignación de zonas (ZoneMapping.yml)

Las zonas locales no se pueden migrar automáticamente a una ubicación de recursos en la nube, por lo que deben asignarse mediante el archivo ZoneMapping.yml. Nota: Los errores de migración se producen si la zona no está asignada con una ubicación de recursos homónima (una ubicación de recursos con exactamente el mismo nombre).

  1. De vuelta en el mismo directorio donde los archivos .yml residen (Documents\Citrix\AutoConfig), abra el ZoneMapping.yml con el Bloc de notas o su editor de texto preferido. Nota: El valor Primary debe reemplazarse por el nombre de la zona correspondiente desde la que quiere migrar objetos (en el entorno local). Mapeo de zonas

  2. Puede encontrar este nombre en la consola local de Citrix Studio > Configuración > Zonas. Nota: si la zona se denomina Primary en el entorno local, no es necesario cambiar este valor del archivo ZoneMapping.yml: Asignación de zonas

  3. Aún en el archivo ZoneMapping.yml, el valor Name_Of_Your_Resource_Zone debe reemplazarse por su nombre de ubicación de recursos en la nube. Puede encontrar este valor en el portal de la nube en el menú Hamburguesa > Ubicaciones de recursos: mapeo de zonas

  4. Copie su nombre de ubicación de recursos (se muestra My Resource Location en la siguiente captura de pantalla): Asignación de zona.

  5. Pegue este valor en el archivo ZoneMapping.yml en lugar del Name_Of_Your_Resouce_Zone valor: Asignación de zona

  • Nota: Varias zonas del entorno local también pueden asignarse a una ubicación de recursos en la nube. Sin embargo, siempre debe haber una fila en el archivo para cada zona del entorno local. Para varias zonas locales y una ubicación de recursos, el formato de este archivo tendría el siguiente aspecto:

Mapeo de zonas

Al asignar zonas a diferentes ubicaciones de recursos, el archivo debe tener este aspecto en su lugar:

Mapeo de zonas

Combinación de configuración

  1. De nuevo en la consola de PowerShell de la herramienta de migración, ejecute el siguiente comando: Merge-CvadAcToSite para combinar la configuración de nube existente (si existe alguna) con la configuración exportada desde el sitio local. Combinación de la configuración

  2. Cuando cada tarea se ejecuta correctamente, la salida se ve de color verde a medida que se importan los archivos.yml y se agregan los componentes correspondientes al sitio en la nube: Fusión de configuración

  3. Los archivos resultantes se muestran en el siguiente directorio: <This PC>\Documents\Citrix\AutoConfig\Import_<YYYY_MM_DD_HH_mm_ss> Merging Configuration

  4. En esta misma carpeta, puede encontrar una Backup_YYYY_MM_DD_HH_mm_ss carpeta. Nota: Copie esta carpeta en algún lugar seguro ya que es una copia de seguridad de la configuración.

  5. La Backup carpeta contiene los siguientes archivos, que son útiles para revertir los cambios, si es necesario: Combinar configuración

Verificar la configuración creada en Cloud Studio

  1. Accede a la pestaña Administrar del Virtual Apps and Desktops Service a través de Cloud Console > Mis servicios > Virtual Apps and Desktops Service > pestaña Administrar). Verificación de la configuración

  2. Actualice para asegurarse de que los catálogos de máquinas, los grupos de entrega, las directivas, las etiquetas y las aplicaciones se muestran como se esperaba. Nota: Dependiendo de lo que importe, los resultados varían ya que son específicos de su propia configuración única. Revise cada sección para asegurarse de que se enumeran los elementos esperados.

  • Ejemplo de lista de catálogos de máquinas:

Verificación de la configuración

Si todo se ve como se esperaba, la migración de CVADS está completa.

Sugerencias para solucionar problemas

Información general para la solución de averías:

  • Al ejecutar cualquier cmdlet, se crea un archivo de registro y una entrada en el archivo de registro del historial maestro. Las entradas contienen la fecha, la operación, el resultado, la copia de seguridad y las ubicaciones del archivo de registro de la ejecución. Este registro proporciona soluciones potenciales y correcciones a errores comunes.
  • El registro del historial maestro se encuentra en %HOMEPATH%\Documents\Citrix\AutoConfig, en el archivo denominado History.Log.* Todos los archivos de registro de operaciones se colocan en una carpeta de copia de seguridad.
  • Todos los nombres de archivo de registro comienzan por y CitrixLog, a continuación, muestran la auto-config operación y la fecha y la marca de hora de la ejecución del cmdlet.
  • Los registros no se eliminan automáticamente.
  • El registro de la consola se puede suprimir mediante el -quiet parámetro
  • Nuevo cmdlet de soporte para comprimir todos los archivos de registro para transferirlos a Citrix para obtener soporte. Ejecute el Backup-CvadAcToFile comando para realizar una copia de seguridad del estado actual de la nube. Luego, reúna todos los registros y *.yml archivos en un solo zip ejecutando New-CvadAcZipInfoForSupport. No se incluye información de seguridad del cliente. Reenvíe el archivo zip a la siguiente ubicación %HOMEPATH%\Documents\Citrix\AutoConfig\CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zipNew-CvadAcZipInfoForSupport.

Para obtener más información:

  1. Consulte el artículo Preguntas frecuentes sobre solución de problemas de la Herramienta de configuración automatizada

  2. También puede comunicarte a través del foro de soporte

  3. Lea la documentación de la Herramienta de configuración automatizada

  4. Descargue las nuevas versiones desde el enlace directo al sitio web de descargas

  5. Consulte nuestra grabación del seminario web a petición del 19 de agosto : “Por qué la migración a Citrix Cloud es más fácil que nunca”. Compartimos más información sobre la herramienta y organizamos una sesión de preguntas y respuestas en vivo con un panel de expertos de Citrix.

  6. Consulte la sección Migración del servicio Citrix Virtual Apps and Desktosp Service a la nube para obtener más información y la documentación oficial.

  7. Si después de consultar la información enumerada anteriormente, sigue necesitando ayuda, póngase en contacto con sus representantes de Citrix, Customer Success Manager o Soporte técnico.

PoC Guide: Automated Configuration Tool