Citrix DaaS™

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, consulta las preguntas frecuentes sobre solución de problemas en el artículo del Centro de conocimiento 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 te permite detectar errores durante el procesamiento, resolverlos y retomar el trabajo donde lo dejaste.

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. Una vez que hayas resuelto los errores, puedes volver a ejecutar los cmdlets con cualquier parámetro de continuación aplicado.

Parámetro OnErrorAction

Puedes 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 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 | Pausa al final del procesamiento y te pide que continúes o detengas. | | 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

Puedes 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 reanuda una operación después de que se pause o detenga debido a un error.

Puedes aplicar los parámetros de reanudación a los cmdlets de migración que incluyen uno de los siguientes valores del 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 verdadero. Se procesan varios componentes.
-Repeat Usa el componente de CurrentComponent.txt como punto de partida. Todos los restantes se establecen en falso. Solo se procesa un componente.

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

Configurar OnErrorAction en el archivo CustomerInfo.yml

También puedes establecer los valores de OnErrorAction en el archivo CustomerInfo.yml. Establece los valores usando 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 de 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, y 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 de 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 puedes usar el cmdlet New-CvadAcZipInfoForSupport para recopilar registros y enviarlos a Citrix para obtener asistencia. 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 hora. Este archivo zip también puede servir 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
  • Múltiples entradas para las acciones de cada componente y las notificaciones de éxito/fallo
  • Resumen de las acciones realizadas, incluidos varios recuentos de objetos creados
  • Soluciones 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 te 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. Incluye estos archivos al proporcionar información para la asistencia 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:

  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. Falta un RestrictToTag en los grupos de aplicaciones. 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. Faltan máquinas en los catálogos de máquinas y grupos de entrega. La causa habitual es que no se encontraron máquinas en Active Directory.
  7. Faltan usuarios en los grupos de entrega. La causa habitual es que no se encontraron usuarios en Active Directory.

Recomendaciones

  • No ejecutes 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, vuelve a ejecutar una instancia de Configuración automatizada para que el sitio vuelva al estado esperado.
  • No trabajes ni cambies datos en Studio mientras ejecutas Configuración automatizada.
  • Verifica siempre visualmente los resultados de la fusión, importación o restauración en Studio para asegurarte de que el sitio en la nube cumple las expectativas.

Carpetas

Ubicación de la carpeta raíz 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 del sitio local exportada más reciente. Cada subcarpeta Export contiene la exportación realizada en la fecha y hora indicadas, lo que mantiene un historial de exportaciones. Puedes 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/Combinar/Sincronizar/Comparar

Las operaciones de Importar, Combinar y Comparar 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 que cambian el sitio en la nube.

Restaurar

La operación Restaurar 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 nueva porque la operación Restaurar 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.

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

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