Solucionar problemas de configuración automatizada e información adicional

Importante:

Para ver los mensajes de error más comunes de la configuración automatizada y sus soluciones correspondientes, consulte las preguntas frecuentes sobre solución de problemas en el artículo de Knowledge Center CTX277730.

Errores de la herramienta de configuración automatizada

Las operaciones de la herramienta de configuración automatizada a veces pueden producir errores. Cuando esto ocurre, pueden producirse fallos al procesar componentes como catálogos de máquinas, grupos de entrega o directivas de grupo, por ejemplo. El uso de OnErrorAction y los parámetros de continuación le permiten detectar errores a mitad del procesamiento, resolverlos y retomar el trabajo donde lo dejó.

El valor predeterminado de OnErrorAction es StopCompEnd. Cuando se produce un error, la herramienta termina de procesar el componente actual. No se procesan componentes adicionales y los errores no se trasladan a los componentes dependientes posteriores. Después de resolver los errores, puede volver a ejecutar los cmdlets con cualquier parámetro de continuación aplicado.

Parámetro OnErrorAction

Puede definir los valores del parámetro OnErrorAction en los comandos de migración para controlar cómo responde la herramienta a los errores que encuentra al procesar los componentes.

Esta tabla muestra los valores de los parámetros y sus descripciones:

Cmdlets de migración

Puede aplicar el parámetro OnErrorAction a los siguientes comandos de migración:

• Compare-CvadAcToSite
• Import-CvadAcToSite
• Merge-CvadAcToSite
• New-CvadAcToSite
• Restore-CvadAcToSite

Ejemplo: Merge-CvadAcToSite -OnErrorAction StopImmediately

Parámetros de reanudación

Estos parámetros definen cómo la herramienta se reanuda después de que una operación se pausa o se detiene debido a un error.

Puede aplicar parámetros de reanudación a los cmdlets de migración que incluyen uno de los siguientes valores de parámetro OnErrorAction:

• Pause
• StopCompEnd
• StopImmediately

Esta tabla muestra los valores de los parámetros y sus descripciones:

El último componente procesado se almacena en el archivo CurrentComponent.txt de la carpeta AutoConfig. No se recomienda editar este archivo. Si especifica -Resume o -Repeat, y CurrentComponent.txt falta o no es válido, el procesamiento se detiene y se le pide que seleccione un componente.

Configuración de OnErrorAction en el archivo CustomerInfo.yml

También puede establecer los valores de OnErrorAction en el archivo CustomerInfo.yml. Establezca los valores mediante los siguientes cmdlets:

• Para un archivo nuevo: New-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
• Para un archivo existente: Set-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately

Registros

La ejecución de cualquier cmdlet da como resultado la creación de un archivo de registro y una entrada en el archivo de registro del historial principal. Todos los archivos de registro de operaciones se colocan en una carpeta de copia de seguridad. Todos los nombres de archivo de registro comienzan con CitrixLog, luego muestran la operación de configuración automática y la fecha y hora de ejecución del cmdlet. Los registros no se eliminan automáticamente.

El registro del historial principal se encuentra en *%HOMEPATH%\Documents\Citrix\AutoConfig*, en el archivo llamado History.Log. Cada ejecución de cmdlet da como resultado una entrada de registro principal que contiene la fecha, la operación, el resultado, la copia de seguridad y las ubicaciones de los archivos de registro de la ejecución.

También puede usar el cmdlet New-CvadAcZipInfoForSupport para recopilar registros y enviarlos a Citrix para obtener soporte. Este cmdlet comprime todos los archivos de registro y .yml en un único archivo zip. La información confidencial del cliente (CustomerInfo.yml y CvadAcSecurity.yml) no se incluye en el archivo zip. El archivo Icon.yml también se excluye debido a su tamaño. El archivo zip se coloca en %HOMEPATH%\Documents\Citrix\AutoConfig y se denomina CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip, según la fecha y la marca de tiempo. Este archivo zip también puede actuar como copia de seguridad.

Cada archivo de registro incluye lo siguiente:

• El nombre de la operación y si el modo de comprobación está habilitado
• La fecha y hora de inicio y fin
• Varias entradas para las acciones de cada componente y notificaciones de éxito/error
• Resumen de las acciones realizadas, incluidos varios recuentos de objetos creados
• Correcciones sugeridas cuando corresponda
• Ubicación de la carpeta de copia de seguridad cuando corresponda
• Ubicación del registro principal
• Duración

Archivos de diagnóstico

Los archivos de diagnóstico le ayudan a determinar y resolver problemas. Los siguientes archivos se crean cuando se ejecuta su operación. Se encuentran en la subcarpeta específica de la acción en %HOMEPATH%\Documents\Citrix\AutoConfig. Incluya estos archivos al proporcionar información para el soporte de resolución de problemas.

Exportar

PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1

Este archivo cuenta todas las llamadas al SDK de PowerShell de Broker realizadas para exportar la configuración del sitio a archivos.

Importar, fusionar, restaurar, sincronizar, hacer copia de seguridad, comparar

Transaction_yyyy_mm_dd_hh_mm_ss.txt

Este archivo documenta cada llamada a la API REST e información relacionada.

RestApiContent_yyyy_mm_dd_hh_mm_ss.txt

Este archivo contiene todo el contenido de la API REST de Add, Update y Delete.

Problemas derivados de dependencias

Las importaciones y fusiones pueden fallar debido a dependencias faltantes. Algunos problemas comunes son:

1. Faltan filtros de grupos de entrega en las directivas de grupo. Las causas habituales son grupos de entrega que no se han importado.
2. Las aplicaciones no se importan o fusionan. La causa habitual es la falta de grupos de entrega o grupos de aplicaciones que no se han importado.
3. A los grupos de aplicaciones les falta una RestrictToTag. Las causas habituales son etiquetas que no se han importado.
4. Las conexiones de host fallan. La causa habitual es la falta de información de seguridad en el archivo CvadAcSecurity.yml.
5. Los catálogos de máquinas fallan. La causa habitual son las conexiones de host que no se importaron.
6. Máquinas que faltan en los catálogos de máquinas y grupos de entrega. La causa habitual son las máquinas que no se encontraron en Active Directory.
7. Usuarios que faltan en los grupos de entrega. La causa habitual son los usuarios que no se encontraron en Active Directory.

Recomendaciones

• No ejecute más de una instancia de Configuración automatizada a la vez. La ejecución de varias instancias simultáneas produce resultados impredecibles en el sitio en la nube. Si esto ocurre, vuelva a ejecutar una instancia de Configuración automatizada para llevar el sitio al estado esperado.
• No trabaje ni cambie datos en Studio mientras se ejecuta la Configuración automatizada.
• Verifique siempre visualmente los resultados de la fusión, importación o restauración en Studio para asegurarse de que el sitio en la nube cumple las expectativas.

Carpetas

Ubicación raíz predeterminada de la carpeta

Todas las operaciones de la herramienta de configuración automatizada se realizan en la carpeta raíz o en subcarpetas dentro de ella. La carpeta raíz se encuentra en %HOMEPATH%\Documents\Citrix\AutoConfig.

Exportar

Todos los archivos exportados se colocan en dos ubicaciones de carpeta, lo que facilita su uso y proporciona un historial de exportaciones. Las exportaciones siempre se colocan en la carpeta raíz. Las copias se colocan en una subcarpeta llamada Export con la fecha y hora de la exportación.

La carpeta raíz siempre contiene la configuración más reciente del sitio local exportado. Cada subcarpeta Export contiene la exportación realizada en la fecha y hora indicadas, lo que mantiene un historial de exportaciones. Puede utilizar cualquier subcarpeta Export para configurar el sitio en la nube. La configuración automatizada no elimina ni modifica las subcarpetas de exportación existentes.

Importar/Fusionar/Sincronizar/Comparar

Las operaciones Import, Merge y Compare siempre se originan en archivos ubicados en la carpeta raíz. Cada operación da como resultado la creación de una subcarpeta a la que se copian los archivos de la carpeta raíz, lo que proporciona un historial de los archivos de origen cambiantes del sitio en la nube.

Restaurar

La operación Restore utiliza una subcarpeta existente para configurar el sitio en la nube. La carpeta de origen se especifica en el parámetro -RestoreFolder obligatorio. A diferencia de otros comandos, no se crea ninguna subcarpeta nueva porque la operación Restore utiliza una subcarpeta existente. La carpeta de restauración puede ser la carpeta raíz, pero aun así debe especificarse en el parámetro -RestoreFolder.

Copias de seguridad

La Configuración automatizada inicializa, actualiza y realiza copias de seguridad de la configuración de un sitio en la nube. Con el tiempo, muchas configuraciones diferentes pueden cambiar en el sitio en la nube. Para facilitar el uso a largo plazo y preservar los cambios del historial, la Configuración automatizada utiliza un esquema de preservación para guardar este historial de cambios y proporcionar un método para restaurar estados anteriores.

Las copias de seguridad de la configuración del sitio en la nube siempre se realizan en una subcarpeta llamada Backup con la fecha y hora de la copia de seguridad. La Configuración automatizada no elimina ni modifica las subcarpetas de exportación existentes.

Puede usar las copias de seguridad para restaurar componentes específicos o toda la configuración. Para restaurar todo el grupo de entrega y los componentes del catálogo de máquinas, utilice el cmdlet:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs

Nota:

La información del archivo de copia de seguridad en el cmdlet anterior se basa en sus propias copias de seguridad.

Para restaurar toda la configuración del sitio en la nube, utilice el cmdlet:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Nota:

La información del archivo de copia de seguridad en el cmdlet anterior se basa en sus propias copias de seguridad.

Cambiar la carpeta raíz predeterminada

Las operaciones Export, Import, Merge, Sync y Compare pueden cambiar la carpeta raíz predeterminada mediante el parámetro –AlternateFolder. La creación y administración de subcarpetas por operación sigue siendo la misma que se describió anteriormente.

Archivos copiados en subcarpetas

Todos los archivos con extensión “.yml” se copian en las subcarpetas de operaciones, excepto los siguientes:

• CustomerInfo.yml
• ZoneMapping.yml
• CvadAcSecurity.yml

Copias de seguridad automáticas a prueba de fallos del sitio en la nube

Se realiza una copia de seguridad de la configuración actual del sitio en la nube antes de ejecutar operaciones que cambien la configuración. Esto incluye los parámetros Import, Merge, Sync y Restore. La copia de seguridad siempre se encuentra en una subcarpeta debajo de la subcarpeta operativa.

En el caso de Restore, la carpeta de copia de seguridad es una subcarpeta de la carpeta especificada en el parámetro -RestoreFolder.

Automatización

Los cmdlets de la herramienta de configuración automatizada se pueden ejecutar en scripts de automatización sin intervención del administrador, suprimiendo las solicitudes y la visualización de los resultados del registro al finalizar el cmdlet. También puede configurar parámetros para hacer lo mismo mediante el archivo CustomerInfo.yml.

Agregue el siguiente parámetro a los cmdlets de modificación de la nube para suprimir la visualización de las solicitudes.

-Confirm $false

Agregue el siguiente parámetro a los cmdlets para suprimir la visualización del registro al finalizar el cmdlet.

-DisplayLog $false

Agregue el siguiente parámetro a los cmdlets para suprimir el registro en la ventana de comandos de PowerShell.

-Quiet

Como método alternativo, los siguientes parámetros se pueden colocar en el archivo CustomerInfo.yml.

Confirm: False

DisplayLog: False

Exportación desde equipos que no son Delivery Controller™

La herramienta de configuración automatizada utiliza varios SDK de PowerShell de Citrix para exportar la configuración del sitio local a archivos. Estos SDK se instalan automáticamente en el Delivery Controller, lo que permite que la herramienta se ejecute en el Delivery Controller sin acciones adicionales. Cuando se ejecuta en máquinas que no son Delivery Controller, es necesario instalar el conjunto de SDK de PowerShell de Citrix que necesita la herramienta. Este conjunto de SDK forma parte de Citrix Studio, que se puede instalar desde el medio de instalación de Citrix Virtual Apps and Desktops™.

Nota:

La configuración automatizada no se puede ejecutar en Cloud Connector.

Migración a Citrix Cloud™ Government y Japan Control Plane

Los entornos de Citrix Cloud Government y Japan Control Plane utilizan diferentes puntos de acceso para autenticar y asignar tokens de acceso. Este requisito único se aplica a cualquier herramienta de configuración automatizada que acceda a la nube. Siga estos pasos para usar la configuración automatizada en estos entornos.

1. En la carpeta %HOMEPATH%\Documents\Citrix\AutoConfig, edite CustomerInfo.yml.

2. Agregue una de las siguientes líneas, según el entorno al que quiera conectarse, a CustomerInfo.yml (o cámbiela, si ya está presente).

   Environment: 'ProductionGov'

   o

   Environment: 'ProductionJP'

La configuración automatizada ya se puede utilizar en estos entornos.

Recopilación de datos de Citrix Cloud

Para obtener información sobre los datos que recopila Citrix Cloud, consulte Citrix Cloud Services Customer Content and Log Handling.

Recursos adicionales

Foro de debate

Visite el foro de debate de Citrix sobre la configuración automatizada.

Vídeo

Vea Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops en YouTube.

Formación

El Cloud Learning Center contiene guías de vídeo paso a paso para crear una implementación de servicio, incluidas las tareas descritas en este artículo. Consulte Migrating Citrix Virtual Apps and Desktops to Citrix Cloud Learning Path.