Solucionar problemas con Configuración automatizada e información adicional
Importante:
Para ver mensajes de error habituales para Configuración automatizada y las soluciones correspondientes, consulte las preguntas frecuentes sobre la solución de problemas en el artículo CTX277730 de Knowledge Center.
Errores de la herramienta de Configuración automatizada
Las operaciones de la herramienta de Configuración automatizada a veces pueden generar errores. Cuando esto ocurre, pueden producirse errores 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 durante el procesamiento, resolverlos y reanudar el proceso.
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 transfieren a los componentes dependientes posteriores. Tras resolver los errores, puede ejecutar de nuevo los cmdlets con los parámetros de continuación aplicados que quiera.
Parámetro OnErrorAction
Puede definir valores del parámetro OnErrorAction en los comandos de la migración para controlar la forma en que la herramienta responde a los errores que encuentra al procesar los componentes.
En esta tabla se muestran los valores de los parámetros y sus descripciones:
| Valor | Descripción |
|---|---|
Continue |
Intenta procesar cuantos componentes le sea posible. |
Pause |
Se detiene al final del procesamiento y le pregunta si continuar o parar. |
StopCompEnd |
Intenta procesar la mayor parte posible del componente. Se detiene cuando el componente ha terminado. (valor predeterminado) |
StopImmediately |
El procesamiento se detiene cuando se detecta un error. |
Cmdlets de migración
Puede aplicar el parámetro OnErrorAction a estos comandos de migración:
Compare-CvadAcToSiteImport-CvadAcToSiteMerge-CvadAcToSiteNew-CvadAcToSiteRestore-CvadAcToSite
Ejemplo:Merge-CvadAcToSite -OnErrorAction StopImmediately
Parámetros de Reanudar
Estos parámetros definen cómo se reanuda la herramienta después de que una operación se ponga en pausa o se detenga debido a un error.
Puede aplicar parámetros de reanudación a cmdlets de migración que incluyan uno de estos valores del parámetro OnErrorAction:
PauseStopCompEndStopImmediately
En esta tabla se muestran 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. Todo el resto está establecido en true. Se procesan varios componentes. |
-Repeat |
Usa el componente de CurrentComponent.txt como punto de partida. Todo el resto está establecido en false. Solo se procesa un componente. |
El último componente procesado se almacena en el archivo CurrentComponent.txt en la carpeta AutoConfig. No se recomienda modificar 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.
Configurar OnErrorAction en el archivo CustomerInfo.yml
También puede establecer valores de OnErrorAction en el archivo CustomerInfo.yml. Defina los valores mediante estos 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 registros y una entrada en el archivo principal de registros del historial. Todos los archivos de registros de operaciones se colocan en una carpeta de copia de seguridad. Todos los nombres de archivos de registros comienzan por CitrixLog y, a continuación, muestran la operación de configuración automática junto con la fecha y la hora de la ejecución de los cmdlets. 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 cmdlets genera una entrada en el registro principal que contiene las ubicaciones de los archivos de registros, la fecha, la operación, el resultado y la copia de seguridad de la ejecución.
También puede usar el cmdlet New-CvadAcZipInfoForSupport para recopilar registros y enviarlos a Citrix para obtener asistencia. Este cmdlet comprime todos los archivos de registros 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%\Documentos\Citrix\AutoConfig y se denomina CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip, según la fecha y la marca de hora. Este archivo ZIP también puede servir de copia de seguridad.
Cada archivo de registros incluye lo siguiente:
- El nombre de la operación y si el modo de comprobación está habilitado
- La fecha y la hora de inicio y finalización
- Varias entradas para las acciones de cada componente y notificaciones para indicar que el proceso se completó correctamente o no se completó
- Resumen de las acciones realizadas, incluido un recuento de los objetos creados
- Correcciones sugeridas donde corresponda
- Ubicación de la carpeta de copia de seguridad donde 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 archivos siguientes se crean al ejecutar la operación relacionada. Se encuentran en la subcarpeta específica de cada acción, en %HOMEPATH%\Documentos\Citrix\AutoConfig. Incluya estos archivos cuando proporcione información para la asistencia en la resolución de problemas.
Exportar
PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1
Este archivo cuenta todas las llamadas del SDK de Broker PowerShell realizadas para exportar la configuración del sitio en archivos.
Import, Merge, Restore, Sync, Backup, Compare
Transaction_yyyy_mm_dd_hh_mm_ss.txt
Este archivo documenta cada llamada de la API de REST y la información relacionada.
RestApiContent_yyyy_mm_dd_hh_mm_ss.txt
Este archivo alberga todo el contenido de Add, Update y Delete de la API de REST.
Problemas resultantes de dependencias
Es posible que las importaciones y las fusiones fallen debido a las dependencias que faltan. Algunos problemas comunes son:
- Faltan filtros de grupo de entrega en las directivas de grupo. Las causas habituales son grupos de entrega que no se importaron.
- Las aplicaciones no se pueden importar o fusionar. La causa habitual es que faltan grupos de entrega o grupos de aplicaciones que no se importaron.
- A los grupos de aplicaciones les falta un parámetro RestrictToTag. Las causas habituales son etiquetas que no se importaron.
- Las conexiones de host fallan. La causa habitual es falta de información de seguridad en el archivo CvadAcSecurity.yml.
- Los catálogos de máquinas fallan. La causa habitual son conexiones de host que no se importaron.
- Faltan máquinas en catálogos de máquinas y grupos de entrega. La causa habitual son máquinas que no se encontraron en Active Directory.
- Faltan usuarios 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. Ejecutar varias instancias simultáneas produce resultados impredecibles en el sitio de Citrix Cloud. Si eso ocurre, ejecute de nuevo una instancia de Configuración automatizada para llevar el sitio al estado esperado.
- No trabaje ni modifique los datos de la ficha Administrar de Configuración completa mientras Configuración automatizada está activa.
- Verifique siempre visualmente los resultados de las operaciones de fusión, importación y restauración en Configuración completa para asegurarse de que el sitio en la nube cumple con las expectativas.
Carpetas
Ubicación raíz predeterminada de la carpeta
Todas las operaciones de la herramienta de Configuración automatizada se llevan a cabo en la carpeta raíz o en subcarpetas dentro de ella. La carpeta raíz se halla en %HOMEPATH%\Documentos\Citrix\AutoConfig.
Exportar
Todos los archivos exportados se colocan en dos carpetas, 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 denominada Export con la fecha y la hora de la exportación.
La carpeta raíz siempre contiene la configuración del sitio local que se ha exportado más recientemente. Cada subcarpeta Export contiene la exportación realizada en la fecha y la hora indicadas, que mantiene un historial de exportaciones. Puede utilizar cualquier subcarpeta Export para configurar el sitio en la nube. Configuración automatizada no elimina ni modifica subcarpetas de exportación existentes.
Import/Merge/Sync/Compare
Las operaciones Import, Merge y Compare siempre proceden de archivos ubicados en la carpeta raíz. Cada operación da como resultado la creación de una subcarpeta en la que se copian los archivos de la carpeta raíz, lo que proporciona un historial los archivos de origen que han cambiado en el sitio en la nube.
Restore
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 requerido. A diferencia de otros comandos, no se crea ninguna subcarpeta porque la operación Restore utiliza una subcarpeta existente. La carpeta de restauración puede ser la carpeta raíz, pero aún 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. Al utilizarse en el tiempo, muchas configuraciones diferentes pueden cambiar en el sitio en la nube. Para facilitar el uso a largo plazo y conservar los cambios del historial, la Configuración automatizada utiliza un esquema de preservación para guardar este historial de cambios y ofrecer un método para restaurar estados anteriores.
Las copias de seguridad de la configuración de los sitios en la nube siempre se llevan a cabo en una subcarpeta denominada Backup con los datos y el momento de la copia de seguridad. Configuración automatizada no elimina ni modifica subcarpetas de exportación existentes.
Puede utilizar las copias de seguridad para restaurar componentes específicos o toda la configuración. Para restaurar todos los componentes de los grupos de entrega y los catálogos 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 la 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, utilice el cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
Nota:
La información del archivo de la 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 administración de subcarpetas por operación sigue siendo la misma que la descrita anteriormente.
Archivos copiados en subcarpetas
Todos los archivos que tengan una extensión “YML” se copian en subcarpetas de operación, excepto los siguientes:
- CustomerInfo.yml
- ZoneMapping.yml
- CvadAcSecurity.yml
Copias de seguridad automatizadas de sitios en la nube a prueba de fallos
Se realiza una copia de seguridad de la configuración del sitio en la nube actual antes de ejecutar operaciones que cambien la configuración. Esto incluye los parámetros Import, Merge, Sync y Restore. La copia de seguridad siempre está en una subcarpeta debajo de la subcarpeta operativa.
En el caso de Restore, la carpeta de la copia de seguridad es una subcarpeta de la carpeta especificada en el parámetro -RestoreFolder.
Automatización
Para que los cmdlets de la herramienta de Configuración automatizada se puedan ejecutar en scripts de automatización sin intervención del administrador, suprima los mensajes emergentes; los resultados del registro se mostrarán al finalizar el cmdlet. También puede establecer 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 no ver mensajes emergentes.
-Confirm $false
Agregue el siguiente parámetro a los cmdlets para no mostrar el 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 otro método, los siguientes parámetros se pueden colocar en el archivo CustomerInfo.yml.
Confirm: False
DisplayLog: False
Exportaciones desde equipos que no tengan Delivery Controllers
La herramienta de Configuración automatizada utiliza varios SDK de PowerShell de Citrix para exportar la configuración del sitio local en archivos. Estos SDK se instalan automáticamente en el Delivery Controller, lo que permite que la herramienta se ejecute en el Delivery Controller sin tener que hacer nada más. En máquinas que no tienen Delivery Controllers, es necesario instalar el conjunto de SDK de PowerShell de Citrix que necesita la herramienta. Este conjunto de SDK forma parte de Citrix Studio, y se puede instalar desde los medios de instalación de Citrix Virtual Apps and Desktops.
Nota:
Configuración automatizada no se puede ejecutar en el Cloud Connector.
Pasar al plano de control de Citrix Cloud Government y Citrix Cloud Japan
Los entornos del plano de control de Citrix Cloud Government y Citrix Cloud Japan 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 utilizar Configuración automatizada en estos entornos.
- En la carpeta %HOMEPATH%\Documents\Citrix\AutoConfig, modifique CustomerInfo.yml.
-
Agregue una de estas líneas, según el entorno al que quiera conectarse, a CustomerInfo.yml (o cámbiela, si ya está presente).
Environment: 'ProductionGov'o bien
Environment: 'ProductionJP'
Ahora la Configuración automatizada se puede utilizar en estos entornos.
Recopilación de datos de Citrix Cloud
Para obtener información sobre los datos que Citrix Cloud recopila, consulte Gestión de registros y contenido para clientes de Citrix Cloud Services.
Recursos adicionales
Foro de debate
Visite el foro de debate de Citrix Discussions para la Configuración automatizada.
Vídeo
Consulte Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops en YouTube.
Aprendizaje
El centro de aprendizaje de Cloud contiene guías detalladas en vídeo para crear una implementación de servicios, incluidas las tareas descritas en este artículo. Consulte Migrating Citrix Virtual Apps and Desktops to Citrix Cloud Learning Path.
En este artículo
- Errores de la herramienta de Configuración automatizada
- Registros
- Archivos de diagnóstico
- Problemas resultantes de dependencias
- Recomendaciones
- Carpetas
- Copias de seguridad
- Automatización
- Exportaciones desde equipos que no tengan Delivery Controllers
- Pasar al plano de control de Citrix Cloud Government y Citrix Cloud Japan
- Recopilación de datos de Citrix Cloud
- Recursos adicionales