Solución de problemas de la configuración automatizada e información adicional
Importante:
Para ver los mensajes de error comunes de la configuración automatizada y las 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 sucede, 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 permite detectar errores durante el procesamiento, resolverlos y continuar 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 cualquier error, 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:
| Valor | Descripción |
|---|---|
Continue |
Intenta procesar tantos componentes como sea posible. |
Pause |
Se detiene al final del procesamiento y le pide que continúe o se detenga. |
StopCompEnd |
Intenta procesar la mayor parte posible del componente. Se detiene una vez finalizado el componente. (Predeterminado) |
StopImmediately |
El procesamiento se detiene cuando se encuentra un error. |
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 se reanuda la herramienta después de que una operación se detiene o se pausa 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:
| Valor | Descripción |
|---|---|
-AllRemaining |
Requiere un componente inicial. El procesamiento comienza en el componente inicial y procesa todos los componentes restantes. Se procesan varios componentes. |
-Resume |
Usa el componente de CurrentComponent.txt como punto de partida. Todos los restantes se establecen en true. Se procesan varios componentes. |
-Repeat |
Usa el componente de CurrentComponent.txt como punto de partida. Todos los restantes se establecen en false. Solo se procesa un componente. |
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 denominado 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_aaaa_mm_dd_hh_mm_ss.zip, según la fecha y la hora. 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 finalización
-
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 de Rest y la información relacionada.
RestApiContent_yyyy_mm_dd_hh_mm_ss.txt
Este archivo contiene todo el contenido de la API de Rest de
Add, Update y Delete.
Problemas derivados de dependencias
Las importaciones y fusiones pueden fallar debido a dependencias que faltan. Algunos problemas comunes son:
-
Faltan filtros de grupos de entrega en las directivas de grupo. Las causas habituales son grupos de entrega que no se han importado.
-
Las aplicaciones no se importan ni se fusionan. La causa habitual es la falta de grupos de entrega o grupos de aplicaciones que no se han importado.
-
A los grupos de aplicaciones les falta una etiqueta RestrictToTag. Las causas habituales son etiquetas que no se han importado.
-
Las conexiones de host fallan. La causa habitual es la falta de información de seguridad en el archivo CvadAcSecurity.yml.
-
Los catálogos de máquinas fallan. La causa habitual son las conexiones de host que no se importaron.
-
Máquinas que faltan en los catálogos de máquinas y los grupos de entrega. La causa habitual son las máquinas que no se encontraron en Active Directory.
-
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 que el sitio vuelva al estado esperado.
-
No trabaje ni cambie datos en Studio mientras se ejecuta la Configuración automatizada.
-
Siempre verificar 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 de la carpeta predeterminada
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 usar 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 obtienen de 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 una configuración de 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 la 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 su configuración. Para restaurar todo el grupo de entrega y los componentes del catálogo de máquinas, use 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 del cmdlet anterior se basa en sus propias copias de seguridad.
Para restaurar toda la configuración del sitio en la nube, use 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 del 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 gestión de subcarpetas por operación sigue siendo la misma que se describió anteriormente.
Archivos copiados a subcarpetas
Todos los archivos con extensión ".yml" se copian en las subcarpetas de operación, 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 establecer parámetros para hacer lo mismo utilizando el archivo CustomerInfo.yml.
Agregue el siguiente parámetro a los cmdlets que modifican 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 PC que no son el 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 el 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 los pasos que se indican a continuación para utilizar la configuración automatizada en estos entornos.
-
En la carpeta %HOMEPATH%\Documents\Citrix\AutoConfig, edite CustomerInfo.yml.
-
Agregue una de las siguientes líneas, según el entorno al que desee conectarse, a CustomerInfo.yml (o cámbiela, si ya está presente).
Environment: 'ProductionGov'oEnvironment: 'ProductionJP'
La configuración automatizada ya se puede utilizar en estos entornos.
Recopilación de datos de Citrix Cloud
Para obtener información sobre qué datos recopila Citrix Cloud, consulte Administración de registros y contenido de clientes de los servicios de Citrix Cloud.
Recursos adicionales
Foro de debate
Visite el foro de debate de Citrix sobre la configuración automatizada.
Vídeo
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 Ruta de aprendizaje para migrar Citrix Virtual Apps and Desktops a Citrix Cloud.