Migrar

Si tiene una configuración de Citrix Virtual Apps and Desktops Service y quiere moverla a otra región de implementación de CVAD Service, haga una copia de seguridad y restaure la configuración, o bien, si sus recursos han llegado a su límite de capacidad, ya puede migrar toda o parte de la configuración mediante la herramienta de configuración automatizada de Citrix.

Herramienta de configuración automatizada de Citrix (Tech Preview)

La herramienta de configuración automatizada de Citrix le permite automatizar el traslado de la configuración de Citrix Virtual Apps and Desktops a otra implementación de Citrix Virtual Apps and Desktops Service.

La herramienta exporta la información de la configuración a una colección de archivos YML que, si quiere, se pueden modificar (para preparar la migración) e importar en la implementación de Citrix Virtual Apps and Desktops Service.

Requisitos previos para migrar una configuración

  • Descargue e instale la herramienta de configuración automatizada de Citrix.
  • Para importar su configuración en Citrix Virtual Apps and Desktops Service:
    • Una máquina con acceso a Citrix Cloud.
    • Citrix Virtual Apps and Desktops Service aprovisionado con una ubicación de recursos activa con Connector instalado y unido al mismo dominio que el origen.

Importante

  • Debe tener su archivo CustomerInfo.yml con el ID del cliente, el ID de la máquina cliente y la información de la clave secreta. Para obtener más información sobre cómo obtener el ID del cliente, el ID de la máquina cliente y la clave secreta, consulte Generar el ID del cliente, el ID de la máquina cliente y la clave secreta. Para obtener información sobre cómo agregar esta información al archivo CustomerInfo.yml, consulte Archivo de información del cliente.
  • El archivo ZoneMapping.yml debe incluir información que asigne su zona de origen a ubicaciones de recursos en la nube. Para obtener más información sobre cómo asignar las zonas, consulte Archivo de asignación de zonas.
  • Si tiene conexiones de host o un catálogo de Provisioning Services, debe introducir la información correspondiente en HostSecurity.yml y CvadAcSecurity.yml.

Limitaciones conocidas

  • Las conexiones de host no son totalmente funcionales. Las conexiones de host deben habilitarse mediante un parámetro del archivo CustomerInfo.yml. Para obtener más información, consulte Conexiones de host.
  • Actualmente no se admiten catálogos de máquinas aprovisionados mediante Machine Creation Services.
  • Las asociaciones de tipos de archivo no se importan a menos que haya un VDA registrado de forma parcial o total.
  • Los iconos no se aplican a máquinas ni escritorios.

Objetos admitidos para la migración

La herramienta de configuración automatizada de Citrix admite los siguientes componentes y los traslada como parte del proceso automatizado.

  • Etiquetas
  • Conexiones de host
    • Un único grupo de recursos
    • Ámbitos de administración
  • Catálogos de máquinas
    • Ámbitos de administración
    • Máquinas
    • Acceso con Remote PC, físicas, agrupadas, aprovisionadas (excepto MCS), asignadas
  • Grupos de entrega
    • Directiva de acceso
    • Ámbitos de administración
    • Directiva de acceso a aplicaciones
    • Directiva de asignaciones
    • Directiva de derechos o de escritorio
    • Programaciones de energía
    • Persistencia de sesiones
    • Preinicio de sesiones
    • Programaciones de reinicio
    • Etiquetas
  • Grupos de aplicaciones
    • Ámbitos de administración
  • Aplicaciones
    • Carpetas de aplicaciones
    • Iconos
    • Aplicaciones
    • Asociaciones de tipos de archivo configuradas por un intermediario
    • Etiquetas
  • Directivas de grupo

Hacer una copia de seguridad de la configuración de Citrix Virtual Apps and Desktops Service

  1. Instale la herramienta de configuración automatizada de Citrix.
  2. Haga clic en el icono de configuración automática. Aparece una ventana de PowerShell.
  3. Ejecute el siguiente comando para realizar una copia de seguridad de referencia.

Backup-CvadAcToFile –All $true

Nota:

Se describen otros comandos disponibles aquí.

Después de ejecutar un cmdlet por primera vez, se crea una carpeta de exportación con los registros y archivos de configuración YML. La carpeta se encuentra en %HOMEPATH%\Documentos\Citrix\AutoConfig.

Si ve algún error o excepción, consulte la sección Fixups del archivo de registros. Para obtener más información sobre los registros y la información que contienen, consulte Registros.

Restaurar la configuración en Citrix Virtual Apps and Desktops Service

Ejecutar una restauración de referencia

  1. Haga clic en el icono de configuración automática. Aparece una ventana de PowerShell.
  2. Ejecute el siguiente comando para realizar una restauración de referencia.

Restore-CvadAcToSite -All $true -RestoreFolder <folder path of the backup files>

Nota:

Se describen otros comandos disponibles aquí.

Verifique el estado esperado y compárelo con el nuevo estado actual.

Después de ejecutar el cmdlet, se crea una carpeta de exportación con los registros y archivos de configuración YML. La carpeta se encuentra en %HOMEPATH%\Documentos\Citrix\AutoConfig.

Si ve algún error o excepción, consulte la sección Fixups del archivo de registros. Para obtener más información sobre los registros y la información que contienen, consulte Registros.

Orden de importación y dependencia de componentes

Los componentes siguientes se pueden seleccionar en los comandos Export, Import, Merge, New, Sync y Restore. Se enumeran en su orden de importación. Si la importación no está ordenada, es posible que se produzcan errores de dependencia y que la operación de importación falle.

  1. Etiquetas
  2. Conexiones de host
  3. Catálogos de máquinas
  4. Grupos de entrega
  5. Grupos de aplicaciones
  6. Aplicaciones
  7. Directivas de grupo

Los componentes deben importarse en un orden que cree dependencias en el orden necesario. La herramienta de configuración automatizada de Citrix ordena correctamente los componentes al importar, fusionar o restaurar varios componentes en una sola ejecución de cmdlets.

Al importar componentes individuales con varios comandos, es necesario ordenar los componentes para que las dependencias se importen en el orden requerido.

A continuación, se pueden hacer importaciones individuales para actualizaciones después de que se haya importado correctamente una configuración completa del sitio.

Generar el ID del cliente, el ID de la máquina cliente y la clave secreta

Los pasos siguientes le permiten crear el ID de la máquina cliente y la clave secreta necesarios para importar la configuración en Citrix Cloud.

  1. Inicie sesión en su cuenta de Citrix Cloud y seleccione el cliente.

    Imagen 1 de ID de cliente

  2. Haga clic en el menú de tres líneas y, a continuación, seleccione Administración de acceso e identidad en el menú desplegable.

    Imagen 2 de ID de cliente

  3. En la página Administración de acceso e identidad, haga clic en la ficha Acceso a API.

    Imagen 3 de ID de cliente

  4. Escriba un nombre en el cuadro. Este nombre se utiliza para diferenciar múltiples ID de máquinas cliente y claves secretas. Haga clic en Crear cliente para crear el ID de la máquina cliente y la clave secreta.

    Imagen 4 de ID de cliente

  5. El siguiente cuadro de diálogo aparece después de crear correctamente el ID de la máquina cliente y la clave secreta. Asegúrese de copiar los dos valores en una ubicación segura o descargue el archivo CSV que contiene esta información.

    Imagen 5 de ID de cliente

  6. El ID de la máquina cliente y la clave secreta se crean correctamente.

    Imagen 6 de ID de cliente

Coloque estos valores en una ubicación segura y compártalos solamente con miembros de confianza de la empresa que necesiten acceder a la herramienta o a las API de REST de la nube. El ID de la máquina cliente y la clave secreta no caducan. Si corren peligro, elimínelos inmediatamente con el icono de papelera y cree otros.

Nota:

No se puede obtener una clave secreta si se pierde o se olvida; debe crearse otro ID de máquina cliente y otra clave secreta.

Archivo de información del cliente

El uso del archivo CustomerInfo.yml elimina la necesidad de agregar información del cliente en parámetros de cmdlets. Cualquier información del cliente se puede reemplazar mediante parámetros de cmdlet.

Puede actualizar el archivo CustomerInfo.yml mediante el cmdlet Set-CvadAcCustomerInfoFile.

Nota:

El cmdlet solo cambia el ID del cliente, el ID de la máquina cliente o la clave secreta.

Set-CvadAcCustomerInfoFile -ClientId C80487EE-7113-49F8-85DD-2CFE30CC398E

A continuación se muestra un archivo CustomerInfo.yml de ejemplo.

---
#  Created/Updated on 2020/01/29 16:46:47
CustomerId: "markhof123"
CustomerId: "markhof123"
ClientId: "6713FEA6-46CC-4F8A-BC71-539F2DDK5384"
Secret: "TwBLaaabbbaaaaaaaaaaw=="
LogFileName: "CitrixLog"
Environment: Production
AltRootUrl: ""
StopOnError: False
AlternateFolder: ""
Locale: "en-us"
Editor: “C:\Program Files\Notepad++\notepad++.exe”
Confirm: True
DisplayLog: True

Archivo de asignación de zonas

La zona local equivale a la ubicación de recursos en la nube. A diferencia de otros componentes del sitio, no puede importar automáticamente la zona local en una ubicación de recursos en la nube. Debe asignarse mediante el archivo ZoneMapping.yml. Pueden producirse errores de importación si el nombre de la zona no coincide con un nombre de ubicación de recursos existente.

El archivo ZoneMapping.yml se crea manualmente después de exportar la configuración local, pero antes de importarla en la nube, y debe residir en %HOMEPATH%\Documentos\Citrix\AutoConfig. El contenido del archivo YML es un diccionario con el nombre de la zona como la clave y el nombre de la ubicación de recursos como el valor.

A continuación se muestra un ejemplo:

---

Primary: "My Primary Resource Location"
Zone2: "Second Resource Location"

Nota:

Debe haber un espacio entre los dos puntos y el nombre de la ubicación de recursos.

Si no se encuentra el archivo ZoneMapping.yml o la asignación correcta no está presente y el sitio en la nube solo tiene una zona, dicha zona se utiliza automáticamente para asignar todas las zonas locales.

Cmdlets de la herramienta de configuración automatizada de Citrix

Cmdlets de administración de sitios

  • Export-CvadAcToFile: Exporta la configuración desde su instalación local. Esta es la operación predeterminada de exportación para la herramienta de configuración automatizada de Citrix.
  • Merge-CvadAcToSite: Fusiona los archivos locales en la nube, pero no elimina ningún componente de la nube. Esto preserva los cambios ya realizados en la nube. Si existe un componente en Citrix Cloud con el mismo nombre, este comando puede modificarlo. Esta es la operación predeterminada de importación para la herramienta de configuración automatizada de Citrix.
  • Import-CvadAcToSite: Importa todos los archivos locales en la nube. Este comando garantiza que el estado final de la nube sea idéntico al estado local. Esta opción elimina los cambios que existan en la nube. Úsela con cuidado.
  • New-CvadAcToSite: Importa la configuración de un sitio local en la nube, pero solo agrega nuevos componentes. Los componentes existentes del sitio en la nube no se actualizan ni se eliminan. Utilice este comando si los componentes existentes del sitio en la nube deben permanecer sin cambios.
  • Sync-CvadAcToSite: Realiza exportaciones e importaciones en un solo paso.
  • Restore-CvadAcToSite: Restaura el sitio en la nube a la configuración anterior. Los archivos importados proceden de la carpeta especificada en el parámetro -RestoreFolder. Esto se puede utilizar para revertir su configuración a la anterior o para la recuperación ante desastres de su sitio en la nube.
  • Backup-CvadAcToFile: Exporta la configuración de la nube en archivos YML. Esta copia de seguridad se puede utilizar para revertir su configuración a una anterior o para la recuperación ante desastres.
  • Compare-CvadAcToSite: Compara los archivos YML locales con la configuración de la nube.
  • Remove-CvadAcFromSite: Puede restablecer todo el sitio o quitar elementos que haya en un componente (por ejemplo, quitar un catálogo de máquinas de la lista de catálogos). Esto se puede usar cuando se combina con el parámetro IncludeByName para quitar miembros específicos.

Parámetros de cmdlets de migración granular

Todos los cmdlets que terminen en ToSite, ToFile y FromSite permiten seleccionar uno o más componentes para los que realizar una acción. Estos parámetros le ofrecen una mayor granularidad para migrar solamente componentes específicos. Seleccione los parámetros que quiera mediante una o varias de las siguientes opciones de verdadero o falso.

Nota:

Al seleccionar All, los demás parámetros se ignoran. La opción All se selecciona automáticamente cuando no se selecciona ningún componente.

  • All
  • Tags
  • MachineCatalogs
  • DeliveryGroups
  • ApplicationGroups
  • Applications
  • GroupPolicies
  • IncludeByName y ExcludeByName: Consulte la sección siguiente para obtener más información sobre estos parámetros.

Incluir y excluir

Los parámetros IncludeByName y ExcludeByName permiten incluir y excluir por nombre miembros de componentes en cmdlets. Solo se puede elegir un componente (por ejemplo, grupos de entrega) en un momento dado en cualquiera de los cmdlets compatibles. Si un miembro de un componente se halla en las dos zonas, la exclusión supedita cualquier otro parámetro, y se crea una entrada en la lista Fixups del registro que identifica el componente y el nombre del miembro excluidos.

Los cmdlets que admiten la inclusión y la exclusión son:

  • Export-CvadAcToFile
  • Import-CvadAcToSite
  • Merge-CvadAcToSite
  • New-CvadAcToSite
  • Restore-CvadAcToSite
  • Sync-CvadAcSiteToSite
  • Compare-CvadAcToSite
  • Remove-CvadAcFromSite

IncludeByName y ExcludeByName toman una lista de nombres de miembros de componentes. Los nombres pueden contener comodines. Se admiten dos tipos de comodines.

  • Coincide con una cantidad de caracteres
  • Coincide con un solo carácter

Un ejemplo de fusión de todos los grupos de entrega cuyos nombres comiencen por DgSite1 y contengan Home2 se escribiría así:

Merge-CvadAcToSite –DeliveryGroups $true –IncludeByName DgSite1*,*Home2*

IncludeByName y ExcludeByName también pueden tomar un archivo que contenga una lista de miembros, donde cada miembro puede ser explícito o contener comodines. Cada línea del archivo puede contener un miembro. Los espacios del principio y del final se recortan del nombre del miembro. El nombre del archivo debe ir precedido por el signo @ y estar rodeado por comillas simples (un requisito de PowerShell para que no se reinterprete @). Se pueden enumerar varios archivos, además de mezclarse con nombres de miembros.

Parámetros de los modos de migración

Cmdlets que modifican la configuración del sitio en la nube (Import, Restore, Merge, New y Sync) admiten los siguientes parámetros adicionales para ofrecer una mayor flexibilidad.

  • CheckMode: Lleva a cabo la operación de importación pero NO realiza cambios. Todos los cambios esperados se notifican antes de que se complete la importación. Puede utilizar este comando para probar la importación antes de que esta se produzca.
  • Merge: Fusiona los datos de archivos en la nube, pero no elimina ningún componente. Nota: Esta opción está habilitada de forma predeterminada en el cmdlet Merge, pero es opcional en Import y Sync.
  • AddOnly: Solo agrega componentes, no actualiza ni elimina componentes existentes. AddOnly es opcional en todos los cmdlets excepto en New, donde está habilitado de forma predeterminada.
  • BackupFirst: Hace una copia de seguridad del contenido de la nube en archivos YML antes modificar la configuración de la nube. Esto está habilitado de forma predeterminada.
  • Confirm: Si el valor es true, solicita a los usuarios que confirmen si quieren efectuar cambios en la configuración del sitio en la nube. El cmdlet Remove muestra un mensaje debido a su naturaleza destructiva. Establézcalo en false si no quiere ningún mensaje, como en la ejecución en scripts automatizados. El valor predeterminado de Confirm es true.
  • AdminAddress: Se admite para cmdlets de exportación, lo que permite orientar cualquier DDC desde el que exportar. Los SDK de PowerShell adecuados de Citrix deben instalarse en la máquina que tenga la herramienta de configuración automatizada de Citrix, tal y como se explica en Requisitos previos para migrar una configuración. Las conexiones de host no se pueden exportar cuando la herramienta funciona en una máquina que no tenga DDC.
  • CheckAllMachines: Comprueba que todas las máquinas de los catálogos de máquinas estén presentes en Active Directory. Si una máquina no está presente, se quita del catálogo de máquinas y se agrega una nota sobre la eliminación a la lista Fixups del archivo de registros. Esto tiene la ventaja de evitar errores al agregar catálogos de máquinas por máquinas que no estén presentes. El valor predeterminado de CheckAllMachines es true.

Parámetros de acceso a la nube

Todos los cmdlets que acceden a la nube, que son cmdlets que terminan en ToSite o FromSite, admiten los siguientes parámetros adicionales.

Nota:

Estos parámetros no son necesarios si se agregan al archivo CustomerInfo.yml.

  • CustomerId: El ID del cliente utilizado en las API de REST. Es necesario para acceder a todas las API de REST. Su ID de cliente se encuentra en Citrix Cloud. Para obtener más información, consulte Generar el ID del cliente, el ID de la máquina cliente y la clave secreta.
  • ClientId: El parámetro ClientID creado en el sitio web de administración de acceso e identidad de Citrix Cloud. Esto es necesario para obtener el token de portador requerido para la autenticación de todas las API de REST. Para obtener más información, consulte Generar el ID del cliente, el ID de la máquina cliente y la clave secreta.
  • Secret: La clave secreta creada en el sitio web de administración de acceso e identidad de Citrix Cloud. Esto es necesario para obtener el token de portador requerido para la autenticación de todas las API de REST. Para obtener más información, consulte Generar el ID del cliente, el ID de la máquina cliente y la clave secreta.
  • CustomerInfoFileSpec: La especificación de archivo que apunta a un archivo de información del cliente para supeditar la ubicación y el nombre predeterminados.

Cmdlets de asistencia y solución de problemas

  • Find-CvadAcConnector: Ubica los conectores existentes y determina su estado de ejecución. Este cmdlet utiliza información del archivo YML de información del cliente o del parámetro del ID de la máquina cliente para ubicar los conectores del cliente.
  • Test-CvadAcConnectionWithSite: Prueba la conexión con el sitio en la nube para comprobar que la conexión de comunicación funciona. Este cmdlet emplea los parámetros de acceso a la nube o el archivo YML de información del cliente para especificar la información de conexión del cliente.
  • Initialize-CvadAcToSite: Restablece el sitio en la nube a su estado predeterminado. Úsela con cuidado.
  • Get-CvadAcCustomerSites: Devuelve la lista de todos los sitios del cliente. Este cmdlet emplea los parámetros de acceso a la nube o el archivo YML de información del cliente para especificar la información de conexión del cliente.
  • New-CvadAcTemplateToFile: Crea un archivo de plantilla para los componentes seleccionados, lo que le permite crear manualmente un archivo de importación.
  • Get-CvadAcStatus: Get Status devuelve la siguiente información sobre la herramienta y el entorno en el que se ejecuta, como la versión de la herramienta, si el usuario tiene privilegios de administrador del sitio para exportar, si la información del cliente (ID del cliente, ID de la máquina cliente y secreto) está presente, si se puede comunicar con el sitio y si hay uno o más conectores.

Parámetros de visualización del registro

Los cmdlets Export, Import, Sync, Restore, Backup, Compare y Remove muestran el archivo de registros cuando se completa la operación. Para suprimir la visualización, establezca el parámetro -DisplayLog en $false. Se utiliza Notepad.exe de forma predeterminada para mostrar el archivo de registros. Puede especificar otro editor en el archivo CustomerInfo.yml.

Editor: C:\Program Files\Notepad++\notepad++.exe

Resultados de estados derivados por comando

El estado derivado puede dar lugar a una de las tres combinaciones de acciones en el sitio en la nube:

  • Add, Update y Delete
  • Add y Update solamente
  • Add solamente

En la tabla siguiente se muestra el estado derivado de cada cmdlet y los parámetros opcionales que pueden cambiar el comportamiento del estado derivado del cmdlet.

Comando Add, Update, Delete Add, Update Add
Import -Merge $false Predeterminado -AddOnly $true
Merge N/A Predeterminado -AddOnly $true
New N/A N/A Predeterminado
Sync -Merge $false Predeterminado -AddOnly $true
Restore -Merge $false Predeterminado -AddOnly $true

Valores devueltos por cmdlets

ActionResult

Todos los cmdlets devuelven el siguiente valor.

public class ActionResult
{
    public bool                         Overall_Success;
    public Dictionary<string, string>   Individual_Success;
    public object                       CustomResult;
}

Overall_Success devuelve un único valor booleano que muestra el estado global del proceso del cmdlet en todos los componentes seleccionados: “true” significa que el proceso se completó correctamente y “false” significa que no se completó correctamente.

Individual_Success devuelve uno o tres valores para cada componente principal. El resultado de un componente puede ser Success (Correcto), Failure (Error) o Skipped (Omitido). Skipped indica que el cmdlet no seleccionó dicho componente para su ejecución.

CustomResult es específico de cada cmdlet.

CustomResult

Import, Merge, Restore, Sync, Compare, Compare File y Remove devuelven la siguiente información de resultados personalizados a una sola instancia de EvaluationResultData.

Nota:

Los cmdlets Export y Template no devuelven un resultado personalizado (CustomResult).

    public class EvaluationResultData
    {
        public Dictionary<string, Dictionary<string, ActionResultValues >> EvaluationResults;
        public int                  Added;
        public int                  Updated;
        public int                  Deleted;
        public int                  NoChange;
        public int                  TotalChanged;
        public EvaluationResults     OverallResult;
        public string               CloudBackupFolder;
        public string               SourceBackupFolder;
    }
    Where:
    public enum ActionResultValues
    {
        Add,
        Update,
        Delete,
        Identical,
        DoNothing
    }
    public enum EvaluationResults
    {
        Success,
        Failure,
        Skipped
    }

EvaluationResults muestra una lista con una entrada por componente seleccionado. La clave es el nombre del componente y el valor es una lista de cada miembro del componente y la acción realizada en el miembro correspondiente del componente. Las acciones pueden ser cualquiera de los valores de ActionResultValues.

Added, Updated, Deleted y NoChange indican la cantidad total de miembros de componentes agregados, actualizados, eliminados o que no se han realizado acciones, en ese orden.

TotalChanged es la suma de Added, Updated y Deleted.

OverallResult es un único valor booleano que indica el resultado del cmdlet. “True” indica que el proceso se completó correctamente en todos los componentes, y “false” indica un error en el procesamiento de uno o más componentes.

CloudBackupFolder es la especificación de archivo válido de la copia de seguridad de la configuración del sitio en la nube antes de que el cmdlet lleve a cabo acciones de modificación de la nube.

SourceBackupFolder es la especificación de archivo válido de la copia de seguridad del archivo de origen realizada después de que el cmdlet haya finalizado. De forma predeterminada, estos archivos se hallan en %HOMEPATH%\Documentos\Citrix\AutoConfig.

Help

La ayuda de PowerShell está disponible para cada cmdlet. Todos los parámetros se documentan con cada cmdlet, junto con una breve explicación del cmdlet. Para obtener acceso a la ayuda de un cmdlet, escriba Get-Help delante del cmdlet.

Get-Help Import-CvadAcToSite

Carpetas, copias de seguridad y registros

La herramienta de configuración automatizada de Citrix 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 herramienta utiliza un esquema de preservación para guardar este historial de cambios y ofrecer un método para restaurar estados anteriores.

Folders

Ubicación raíz predeterminada de la carpeta

Todas las operaciones de la herramienta de configuración automatizada de Citrix 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.

Export

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. La herramienta de la configuración automatizada de Citrix no elimina ni modifica las 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.

Se puede utilizar cualquier subcarpeta para configurar el sitio en la nube. La herramienta de la configuración automatizada de Citrix no elimina ni modifica las subcarpetas de exportación existentes.

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.

Backup

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. La herramienta de la configuración automatizada de Citrix no elimina ni modifica las 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 -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups $true -MachineCatalogs $true

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 -RestoreFrom %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
  • HostSecurity.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 -RestoreFrom.

Captura de registros

La ejecución de cualquier cmdlet da como resultado la creación de un archivo de registros y una entrada en el archivo maestro 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 maestro del historial se encuentra en %HOMEPATH%\Documentos\Citrix\AutoConfig, en el archivo denominado History.Log. Cada ejecución de cmdlets genera una entrada en el registro maestro 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.

Detalles de los registros

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 maestro
  • 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.

Export

PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1

Este archivo enumera 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.

Otra información

Ámbitos de administrador

Los procesos de exportación e importación permiten el uso de ámbitos de administrador. Sin embargo, el proceso de importación solo puede asociar el ámbito, no crearlo. Siga estos pasos para exportar e importar correctamente los ámbitos de administrador en el sitio de la nube.

  1. Exporte el sitio local.
  2. En la instancia local de Citrix Studio, vaya a la ficha Configuración > Administradores > Ámbitos y tome nota de todos los ámbitos presentes. No es necesario anotar sus asociaciones, ya que estas se crean al importar los componentes.
  3. En la consola de configuración completa de Citrix Cloud, vaya a la ficha Configuración > Administradores > Ámbitos y cree manualmente cada ámbito registrado en el paso anterior.
  4. Aplique las acciones Import, Merge, Restore, New o Sync en la exportación del paso 1.
  5. Los ámbitos creados manualmente se asocian a los componentes correctos.

Si los ámbitos de administrador no se crean manualmente primero, la operación de importación los quita de los componentes. Una vez creados manualmente los ámbitos, al volver a ejecutar la operación de importación, los ámbitos se asocian a los componentes.

Conexiones de host

Las conexiones de host y sus hipervisores asociados se pueden exportar e importar mediante la herramienta, pero esta función debe habilitarse manualmente y, a continuación, deben tomarse medidas de seguridad especiales.

Para habilitar la exportación o la importación de conexiones de host, agregue esta línea al archivo CustomerInfo.yml:

HostConnections: True

Nota:

Compruebe que haya un espacio entre los dos puntos y “True”.

Agregar un hipervisor a una conexión de host requiere información de seguridad específica del tipo de hipervisor. Esta información no se puede exportar desde el sitio local por motivos de seguridad. Debe proporcionar la información manualmente para que la herramienta de configuración automatizada de Citrix pueda importar correctamente las conexiones de host y los hipervisores al sitio en la nube.

El proceso de exportación crea el archivo HostSecurity.yml en %HOMEPATH%\Documentos\Citrix\AutoConfig y contiene marcadores de posición para cada elemento de seguridad que necesita el tipo de hipervisor específico. Debe actualizar el archivo HostSecurity.yml antes de realizar la importación en el sitio de la nube. Las actualizaciones de administrador se conservan en varias exportaciones con nuevos marcadores de posición de seguridad agregados según sea necesario. Los elementos de seguridad nunca se eliminan.

---

HostConn1:
ConnectionType: XenServer
UserName: root
PasswordKey: rootPassword
HostCon2:
ConnectionType: AWS
ApiKey: 78AB6083-EF60-4D26-B2L5-BZ35X00DA5CH
SecretKey: TwBLaaaaaaaaaaaaaaaaaw==
Region: East

Información de seguridad por hipervisor

A continuación se muestra la información de seguridad necesaria para cada tipo de hipervisor.

  • XenServer, Hyper-V, VMware
    • Nombre de usuario
    • Contraseña de texto no cifrado
  • Microsoft Azure
    • ID de suscripción
    • ID de aplicación
    • Secreto de la aplicación
  • Amazon Web Services
    • ID de cuenta de servicio
    • Secreto de la aplicación
    • Región

Consideraciones especiales sobre seguridad

Toda la información de seguridad se introduce como texto no cifrado. Las conexiones de host y los hipervisores asociados se pueden crear manualmente mediante el panel de control Configuración completa de Citrix Cloud. Las conexiones de host y los nombres de hipervisor deben coincidir exactamente con sus homólogos locales para que los catálogos de máquinas que utilizan las conexiones de host se importen correctamente.

Compatibilidad con catálogos de máquinas de PVS

La herramienta de configuración automatizada de Citrix permite el uso de catálogos de máquinas de PVS, pero requiere información adicional de seguridad para permitir que la nube se ponga en contacto con el servidor de PVS. Se crea una entrada en el archivo CvadAcSecurity.yml para cada servidor de PVS de los catálogos de máquinas exportados.

Cada entrada del servidor de PVS contiene el tipo de conexión establecido en PVS, nombre de usuario del servidor de PVS con el prefijo de dominio y la contraseña, todo en texto no cifrado. Las entradas existentes del servidor de PVS no se superponen ni se eliminan durante las exportaciones subsiguientes.

---
Pvs1Server:
ConnectionType: PVS
UserName: xd1\administrator
Password: adminPassword

Nota:

La cuenta de servicio que ejecuta la herramienta debe tener derechos de administrador total en el sitio y de administrador en PVS para que funcione.

Automatización

Para que los cmdlets de la herramienta de configuración automatizada de Citrix 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

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

Confirm: False

DisplayLog: False

Exportaciones desde PC que no tengan DDC

La herramienta de configuración automatizada de Citrix 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 DDC, lo que permite que la herramienta se ejecute en el DDC sin tener que hacer nada más. En máquinas que no tienen DDC, 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:

Las conexiones de host no se pueden exportar desde máquinas que no tengan DDC.

La herramienta de configuración automatizada de Citrix no se puede ejecutar en el Cloud Connector.

Solución de problemas y recomendaciones

El sitio en la nube está vacío

Un sitio vacío indica que no se ha completado una operación correcta de importación, fusión o restauración. Si se ha intentado realizar una operación, revise los registros de la operación.

El sitio en la nube contiene más elementos de lo previsto

Puede suceder si se realizaron mejoras en la configuración del sitio en la nube y se ejecutó una operación Merge. También puede suceder si la configuración del sitio en la nube tenía valores anteriores y una operación de importación, fusión o restauración tuvo problemas. Intente volver a ejecutar la operación.

El sitio en la nube contiene menos elementos de lo previsto

Puede suceder si se realizaron mejoras en la configuración del sitio en la nube y una operación Import con el parámetro Merge establecido en $false, lo que da como resultado un estado derivado idéntico (Identical Derived State). Se realiza una copia de seguridad del estado original en la carpeta Automated Fail-Safe Cloud Site Backup asociada a la operación de importación. Para corregir:

  1. Restaure Automated Fail-Safe Cloud Site Backup mediante la operación Restore. Para ello, establezca el parámetro RestoreFolder en la carpeta Automated Fail-Safe Cloud Site Backup.

  2. Utilice la operación Merge en lugar de la operación Import.

Se han perdido las modificaciones del sitio en la nube después de la importación

Puede ocurrir si se realizó una operación Import con el parámetro –Merge establecido en $false, lo que da como resultado una importación de estado derivado idéntico (Identical Derived State). Se realiza una copia de seguridad del estado original en la carpeta Automated Fail-Safe Cloud Site Backup asociada a la operación de importación. Para corregir:

  1. Restaure Automated Fail-Safe Cloud Site Backup mediante la operación Restore. Para ello, establezca el parámetro RestoreFolder en la carpeta Automated Fail-Safe Cloud Site Backup.

  2. Utilice la operación Merge en lugar de la operación Import.

El sitio en la nube no coincide con el sitio local actual

Puede ocurrir si se realizó una operación Merge con el resultado un estado derivado fusionado (Merged Derived State), en lugar de Import con el parámetro Merge establecido en $false, lo que da como resultado un estado derivado idéntico (Identical Derived State). Repita la operación Import con el parámetro Mergeestablecido en $false.

Recomendaciones

  • No ejecute más de una instancia de la herramienta de configuración automatizada de Citrix a la vez. Ejecutar varias instancias simultáneas produce resultados impredecibles en el sitio de Citrix Cloud. Si eso ocurre, vuelva a ejecutar una instancia de la herramienta de configuración automatizada de Citrix para llevar el sitio al estado esperado.
  • No trabaje en Estudio web ni en Configuración completa mientras la herramienta de configuración automatizada de Citrix está activa. Realizar cambios en Estudio web o en Configuración completa mientras la herramienta está activa puede producir resultados impredecibles en el sitio de Citrix Cloud. Si eso ocurre, vuelva a ejecutar una instancia de la herramienta de configuración automatizada de Citrix para llevar el sitio al estado esperado.
  • Compruebe siempre visualmente los resultados de las operaciones Merge, Import y Restore en Estudio web o en Configuración completa para asegurarse de que el sitio en la nube cumple con las expectativas.