PoC Guide: Automated Configuration Tool

Overview

La herramienta de configuración automatizada facilita la migración y exportación de configuraciones a Citrix DaaS . 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 DaaS, al mismo tiempo que ejecutan entornos locales existentes e incluso facilitan los traslados entre regiones de la nube, respaldan 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.

Requisitos previos

Entorno local

  • Entorno local Citrix Virtual Apps and Desktops (CVAD) con al menos un VDA registrado.
  • Entorno local de Citrix Virtual Apps and Desktops que se ejecute en una de las siguientes versiones: cualquier versión Long Term Service Release (LTSR) con su CU más reciente (1912, 2203); o una de las dos últimas versiones actuales (CR) correspondientes (por ejemplo: 2308, 2311) .
  • 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 posterio.
  • Una máquina con Citrix PowerShell SDK, que se instala automáticamente en el DDC.

Nota:

Si se ejecuta la herramienta en una máquina diferente, debe estar unida a un dominio y Studio debe tener instalados los complementos de PowerShell correctos. Este instalador se encuentra en el medio de instalación ISO del productocorrespondiente, que puede obtener en el sitio web Descargas > Citrix Virtual Apps and Desktops .

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.

  • Licencia Citrix DaaS válida.
  • 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 (por 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 (modificando 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. Pre-requisites
  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. Pre-requisites

  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. Pre-requisites
  • Nota: Tras la ejecución correcta, se crea un icono de escritorio denominado Configuración automática. Cuando se inicia, se crea la estructura de carpetas correspondiente ubicada en C:\Users\<username>\Documents\Citrix\AutoConfig. 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 secundario 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 se encuentran ahora en la ruta Documents\Citrix\AutoConfig del usuario actual: Exportación de configuración

  5. Consulte la imagen de abajo 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 la máquina que quiere usar 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 Connector deben mostrarse en verde, lo que indica que están en buen estado, como se ve 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 una sección independiente disponible con instrucciones para las máquinas virtuales asignadas de forma estática. 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 directivas 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, consulta la sección Importar la configuración de tu sitio a la nube de esta guía para combinar tu 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 independiente con instrucciones para las máquinas agrupadas y RDS. Consulte los pasos mencionados en las máquinas MCS Pooled VDI y RDS

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 quiere 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, consulta la sección Importar la configuración de tu sitio a la nube de esta guía para combinar tu 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 archivo CustomerInfo.yml 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 ficha Acceso a API y copie el valor de ID de cliente, que se encuentra junto al texto customer ID 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 ficha Acceso a API. Introduzca el nombre con el que quiere 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 valores ID y Secret en los campos correspondientes del archivo CustomerInfo.yml: Importación de configuración

Actualice manualmente el archivo de mapeo 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 ZoneMapping.yml archivo. 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 su zona se llama Primary en su entorno local, no es necesario cambiar este valor del archivo ZoneMapping.yml: Asignación de zonas

  3. Aún en el ZoneMapping.yml archivo, 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 valor Name_Of_Your_Resouce_Zone: Asignación de zona

  6. Varias zonas de su 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 sería el siguiente: Asignación de zonas

  7. Al asignar zonas a diferentes ubicaciones de recursos , el archivo debe tener el siguiente aspecto: Asignación de zonas](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_zone-mapping-007.png)

Actualice manualmente el archivo CvadAcSecurity.yml

Las conexiones de host y sus hipervisores asociados se pueden migrar a Citrix DaaS. Para agregar las conexiones de host, se requiere información de seguridad para el hipervisor específico. Esta información debe agregarse manualmente al archivo CvadAcSecurity.yml. Nota: Para este ejemplo, utilizamos Citrix Hypervisor. Para obtener información sobre la información de seguridad necesaria para otros tipos de hipervisores, visite el sitio de documentación del producto Citrix DaaS.

  1. De vuelta en el mismo directorio donde los archivos .yml residen (Documents\Citrix\AutoConfig), abra el CvadAcSecurity.yml con el Bloc de notas o su editor de texto preferido. Seguridad de hipervisores

  2. En el archivo CvadAcSecurity.yml, introduzca el username y password de la conexión del hipervisor y, a continuación, guarde el archivo. Seguridad de hipervisores

Combinación de la 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 carpeta Backup 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 ficha Administrar DaaS de Citrix a través de la ficha Consola de la nube > Mis servicios > Citrix DaaS > 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 parece como se espera, la migración de Citrix DaaS ha finalizado.

Migración del entorno de nube entre ubicaciones de recursos

Para obtener orientación sobre cómo migrar entre regiones de nube o entornos de DaaS, consulte la documentación sobre migración de DaaS de Citrix DaaS de la nube a la nube.

Sugerencias para solucionar problemas

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

  • Consulte el artículo Preguntas frecuentes sobre solución de problemas de la Herramienta de configuración automatizada
  • Antes de abrir el tíquet de asistencia con Citrix, ejecute New-CvadAcZipInfoForSupport para recopilar todos los registros y archivos de *.yml en un solo zip. 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.
  • 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 llamadoHistory.Log.* Todos los archivos de registro de operaciones se encuentran en una carpeta de respaldo .
  • Todos los nombres de archivo de registro comienzan por CitrixLog y, a continuación, muestran la operación auto-config y la fecha y la marca de hora de la ejecución del cmdlet.
  • Los registros no se borran automáticamente.
  • El registro de la consola se puede suprimir mediante el parámetro -quiet
PoC Guide: Automated Configuration Tool