Migrar XenApp 6.x

Importante:

La migración mueve los datos de una implementación a una versión más reciente. El proceso incluye la instalación de nuevos componentes y la creación de un sitio, la exportación de datos desde la comunidad de servidores original y la importación de esos datos en el sitio nuevo.

Los scripts de migración en código abierto están disponibles en https://github.com/citrix/xa65migrationtool. Sin embargo, Citrix no admite estos scripts.

El resto de este artículo contiene información que se puede utilizar como referencia con los scripts de migración en código abierto.

Introducción

Puede usar la herramienta de migración descrita en este artículo para migrar de XenApp 6.x a XenApp 7.6. Luego, puede actualizar XenApp 7.6 a una versión LTSR compatible o la versión actual de Citrix Virtual Apps and Desktops; consulte Actualizar una implementación.

Para obtener información sobre los cambios de arquitectura, componentes y características que se han introducido en las versiones 7.x, consulte Cambios en 7.x.

XenApp 6.x Migration Tool

La herramienta de migración de XenApp 6.x (Migration Tool) es una colección de scripts de PowerShell que contienen cmdlets para migrar los datos de las comunidades y las directivas de XenApp 6.x (6.0 o 6.5). En el servidor del Controller de XenApp 6.x, ejecute los cmdlets de exportación que recopilan dichos datos en archivos XML. A continuación, desde el Controller de XenApp 7.6, ejecute los cmdlets de importación, que crean objetos mediante los datos recopilados durante la exportación.

La siguiente secuencia resume el proceso de migración, los detalles se proporcionan más adelante.

1. En un Controller de XenApp 6.0 o 6.5:
   1. Importe los módulos de exportación de PowerShell.
   2. Ejecute los cmdlets de exportación para exportar datos de la comunidad y/o de directivas en archivos XML.
2. Copie los archivos XML (y la carpeta de iconos si eligió no incrustarlos en los archivos XML durante la exportación) en el Controller de XenApp 7.6.
3. En el Controller de XenApp 7.6:
   1. Importe los módulos de importación de PowerShell.
   2. Ejecute los cmdlets de importación para importar los datos de la comunidad (aplicaciones) y/o de directivas, mediante los archivos XML como entrada.
4. Complete los pasos posteriores a la migración.

Antes de iniciar una migración real, puede exportar la configuración de XenApp 6.x y, a continuación, realizar una vista previa de la importación en el sitio de XenApp 7.6. La vista previa puede identificar posibles puntos de fallo para que usted pueda resolver los problemas antes de ejecutar la importación en sí. Por ejemplo, una vista previa puede detectar que ya existe una aplicación con el mismo nombre en el nuevo sitio de XenApp 7.6. También puede usar los archivos de registros generados a partir de la vista previa como guía para la migración.

A menos que se indique lo contrario, el término 6.x hace referencia a XenApp 6.0 o 6.5.

Paquete de herramienta de migración

La herramienta de migración contiene dos paquetes separados:

• ReadIMA: Contiene los archivos utilizados para exportar datos desde las comunidades de XenApp 6.x, además de módulos compartidos.

  Módulo o archivo	Descripción
  ExportPolicy.psm1	Módulo de script de PowerShell para exportar las directivas de XenApp 6.x a un archivo XML.
  ExportXAFarm.psm1	Módulo de scripts de PowerShell para exportar la configuración de la comunidad de XenApp 6.x a un archivo XML.
  ExportPolicy.psd1	Archivo de manifiesto de PowerShell para el módulo de script ExportPolicy.psm1.
  ExportXAFarm.psd1	Archivo de manifiesto de PowerShell para el módulo de script ExportXAFarm.psm1.
  LogUtilities.psm1	Módulo de script compartido de PowerShell que contiene las funciones de registro.
  XmlUtilities.psd1	Archivo de manifiesto de PowerShell para el módulo de script XmlUtilities.psm1.
  XmlUtilities.psm1	Módulo de script compartido de PowerShell que contiene las funciones de XML.

• ImportFMA: Contiene los archivos utilizados para importar datos en las comunidades de XenApp 7.6, además de módulos compartidos.

  Módulo o archivo	Descripción
  ImportPolicy.psm1	Módulo de scripts de PowerShell para importar las directivas en XenApp 7.6.
  ImportXAFarm.psm1	Módulo de scripts de PowerShell para importar las aplicaciones en XenApp 7.6.
  ImportPolicy.psd1	Archivo de manifiesto de PowerShell para el módulo de script ImportPolicy.psm1.
  ImportXAFarm.psd1	Archivo de manifiesto de PowerShell para el módulo de script ImportXAFarm.psm1.
  PolicyData.xsd	Esquema XML para datos de directivas.
  XAFarmData.xsd	Esquema XML para datos de la comunidad XenApp.
  LogUtilities.psm1	Módulo de script compartido de PowerShell que contiene las funciones de registro.
  XmlUtilities.psd1	Archivo de manifiesto de PowerShell para el módulo de script XmlUtilities.psm1.
  XmlUtilities.psm1	Módulo de script compartido de PowerShell que contiene las funciones de XML.

Limitaciones

• No se importan todas las configuraciones de directivas; consulte Configuraciones de directivas que no se importan. Las configuraciones que no son compatibles se ignoran y esto se indica en el archivo de registros.
• Aunque se recopilan detalles de todas las aplicaciones en el archivo XML de salida durante la operación de exportación, solo se importan en el sitio de XenApp 7.6 las aplicaciones instaladas en el servidor. Los escritorios publicados, el contenido y la mayoría de las aplicaciones distribuidas por streaming no están disponibles (consulte los parámetros del cmdlet Import-XAFarm en Importar datos: paso a paso para ver las excepciones).
• Los servidores de aplicaciones no se importan.
• Muchas de las propiedades de aplicación no se importan debido a diferencias entre la arquitectura IMA (Independent Management Architecture) de XenApp 6.x y las tecnologías FlexCast Management Architecture (FMA) de XenApp 7.6; consulte Asignación de propiedades de aplicaciones.
• Se crea un grupo de entrega durante la importación. Consulte Uso avanzado para obtener más información sobre cómo usar los parámetros para filtrar lo que se importa.
• Solo se importan las configuraciones de directiva de Citrix creadas con la consola de administración de AppCenter; las configuraciones de directiva de Citrix creadas con objetos de directiva de grupo (GPO) de Windows no se importan.
• Los scripts de migración están diseñados para las migraciones desde XenApp 6.x a XenApp 7.6 únicamente.
• Studio no admite el uso de carpetas anidadas a más de cinco niveles de profundidad, por lo que no se importarán. Si la estructura de carpetas de aplicaciones incluye carpetas a más de cinco niveles de profundidad, considere la posibilidad de reducir la cantidad de niveles de anidación de carpetas antes de realizar la importación.

Consideraciones sobre seguridad

Los archivos XML creados por los scripts de exportación pueden contener información confidencial acerca de su entorno y organización, como nombres de usuario, nombres de servidor, y otros datos de configuración de directivas, comunidades y aplicaciones de XenApp. Almacene y gestione estos archivos en entornos seguros.

Repase cuidadosamente los archivos XML antes de usarlos como material para la importación de directivas y aplicaciones, y compruebe que no contienen modificaciones no autorizadas.

Las asignaciones de objeto de directiva (antes conocidas como filtros de directivas) son las que gestionan la forma en que se aplican las directivas. Después de importar las directivas, revise meticulosamente las asignaciones de objeto de cada directiva para comprobar que no haya vulnerabilidades de seguridad a raíz de la importación. Tras la importación, se pueden aplicar a la directiva diferentes conjuntos de usuarios, direcciones IP o nombres de cliente. Después de la importación, es posible que los parámetros “Permitir” o “Denegar” tengan implicaciones diferentes.

Capturar registros y controlar errores

Los scripts ofrecen gran cantidad de registros que hacen un rastreo de todas las ejecuciones de cmdlets, mensajes informativos, resultados de la ejecución de cmdlets, advertencias y errores.

• Queda registrada la mayor parte del uso de cmdlets de PowerShell de Citrix. Se registran todos los cmdlets de PowerShell en los scripts de importación que crean nuevos objetos del sitio.
• Se registra el progreso de la ejecución de scripts, incluidos los objetos procesados.
• Se registran las principales acciones que afectan al flujo de trabajo, incluidos flujos dirigidos desde la línea de comandos.
• Se registran todos los mensajes que se imprimen en la consola, incluidas las advertencias y los errores.
• Cada línea recibe una marca de hora, con precisión de milésima de segundo.

Citrix recomienda especificar un archivo de registros cuando se ejecute cada uno de los cmdlets de importación y exportación.

Si no se especifica un nombre de archivo de registros, el archivo de registros se almacena en la carpeta principal del usuario (especificada por la variable $HOME de PowerShell) si dicha carpeta existe; de lo contrario, se coloca en la carpeta de ejecución del script actual. El nombre predeterminado de los registros es “XFarmAAAAMMDDHHmmSS-xxxxxx” donde los últimos seis dígitos son un número aleatorio.

De forma predeterminada, se muestra toda la información de progreso. Para evitar que se muestre, especifique el parámetro NoDetails en los scripts de exportación e importación.

Por lo general, la ejecución de un script se detiene cuando se encuentra un error, y se puede ejecutar el cmdlet de nuevo después de eliminar las condiciones de error.

Las condiciones que no se consideran errores se registran; muchas se notifican como advertencias, y la ejecución del script continúa. Por ejemplo, los tipos de aplicación no compatibles se notifican como advertencias y no se importan. Las aplicaciones que ya existen en el sitio de XenApp 7.6 no se importan. Las configuraciones de directiva retiradas de XenApp 7.6 no se importan.

Los scripts de migración usan muchos cmdlets de PowerShell y puede ser que no se registren todos los errores posibles. Para ver información adicional sobre la cobertura de registros, use la funcionalidad de registros de PowerShell. Por ejemplo, las transcripciones de PowerShell registran todo lo que se imprime en pantalla. Para obtener más información, consulte la ayuda de los cmdlets Start-Transcript y Stop-Transcript.

Requisitos, preparación y procedimientos recomendados

Para migrar, debe usar el SDK de Citrix XenApp 6.5. Descargue ese SDK desde https://www.citrix.com/downloads/xenapp/sdks/powershell-sdk.html.

Consulte este artículo antes de iniciar una migración.

Es necesario comprender los conceptos básicos de PowerShell sobre directiva de ejecución, módulos, cmdlets y scripts. Aunque no es necesario tener una amplia experiencia en creación de scripts, es conveniente entender los cmdlets que hay que ejecutar. Use el cmdlet Get-Help para consultar la ayuda de cada cmdlet de migración antes de ejecutarlo. Por ejemplo: Get-Help -full Import-XAFarm.

Especifique un archivo de registros en la línea de comandos y consulte siempre el archivo de registros después de ejecutar el cmdlet. Si un script falla, compruebe y corrija el error identificado en el archivo de registros y, a continuación, ejecute el cmdlet de nuevo.

Información útil

• Para facilitar la entrega de aplicaciones mientras hay dos implementaciones ejecutándose (la comunidad de XenApp 6.x y el nuevo sitio de XenApp 7.6), puede realizar un agregado de ambas implementaciones en StoreFront o la Interfaz Web. Consulte la documentación de la versión de StoreFront o la Interfaz Web que esté utilizando.

• Los datos de iconos de las aplicaciones se pueden gestionar de dos formas:

  • Si especifica el parámetro EmbedIconData en el cmdlet Export-XAFarm, los datos de iconos de aplicaciones se incrustan en el archivo XML.

  • Si no especifica el parámetro EmbedIconData en el cmdlet Export-XAFarm, los datos de iconos de aplicaciones exportados se almacenan en una carpeta cuyo nombre se forma al agregar la cadena “-icons” al nombre básico del archivo XML de salida. Por ejemplo, si el parámetro XmlOutputFile es “FarmData.xml”, se creará la carpeta “FarmData-icons” para almacenar los iconos de aplicaciones.

    Los archivos de datos de iconos de esta carpeta son archivos .txt nombrados mediante el nombre de explorador de la aplicación publicada (aunque los archivos son .txt, los datos guardados son datos de icono binarios codificados que el script de importación puede leer para volver a crear el icono de la aplicación). Durante la operación de importación, si la carpeta de iconos no se encuentra en la misma ubicación que el archivo XML de importación, se usan iconos genéricos para cada aplicación importada.

• Los nombres de los módulos de script, archivos de manifiesto, módulo compartido y cmdlets son similares. Ponga cuidado al utilizar el procedimiento de completar con tabulador, para evitar errores. Por ejemplo, Export-XAFarm es un cmdlet. ExportXAFarm.psd1 y ExportXAFarm.psm1 son archivos que no se pueden ejecutar.
• En las secciones paso a paso siguientes, la mayoría de los valores de parámetro de <cadena> van entre comillas. Estas son optativas si la cadena solo es de una palabra.

Para exportar desde el servidor XenApp 6.x

• La exportación debe ejecutarse en un servidor XenApp 6.x configurado con el modo de servidor Controller y host de sesión (comúnmente llamado Controller).
• Para ejecutar los cmdlets de exportación, hay que ser un administrador XenApp con permisos para leer objetos. También hay que tener suficientes permisos de Windows para ejecutar scripts de PowerShell; los procedimientos paso a paso siguientes contienen instrucciones.
• Asegúrese de que el estado de integridad de la comunidad XenApp 6.x es correcto antes de comenzar una exportación. Haga una copia de seguridad de la base de datos de la comunidad. Verifique la integridad de la comunidad con la utilidad Citrix IMA Helper (CTX133983). En la ficha IMA Datastore, ejecute Master Check. A continuación, use la opción DSCheck para resolver las entradas no válidas. Repare cualquier problema que haya en la comunidad, antes de realizar la migración, para evitar fallos de exportación. Por ejemplo, si un servidor no se quitó correctamente de la comunidad, es posible que sus datos sigan existiendo en la base de datos; esto puede hacer que fallen los cmdlets del script de exportación (por ejemplo, Get-XAServer -ZoneName). Si los cmdlets fallan, el script falla.
• Puede ejecutar los cmdlets de exportación en una comunidad de servidores en ejecución, con conexiones de usuario activas, ya que los scripts de exportación solo leen los datos estáticos de directivas y configuración de la comunidad.

Para importar en el servidor XenApp 7.6

• Puede importar datos a las implementaciones de XenApp 7.6 (y versiones posteriores admitidas). Debe instalar un Controller de XenApp 7.6 y Studio, y crear un sitio, antes de importar los datos exportados desde la comunidad XenApp 6.x. Aunque los VDA no son necesarios para importar configuraciones, permiten que los tipos de archivo de las aplicaciones estén disponibles.
• Para ejecutar los cmdlets de importación de XenApp, debe ser un administrador XenApp con permisos para leer y crear objetos. Un administrador total tiene estos permisos. También hay que tener suficientes permisos de Windows para ejecutar scripts de PowerShell; los procedimientos paso a paso siguientes contienen instrucciones.
• No debe haber otras conexiones de usuario activas durante una importación. Los scripts de importación crean muchos objetos nuevos y pueden producirse interrupciones si hay otros usuarios cambiando la configuración al mismo tiempo.

Recuerde que puede exportar datos y, a continuación, usar el parámetro -Preview con los cmdlets de importación para tener una vista previa de lo que sucedería durante una importación real, sin importar nada todavía. Los registros indicarán exactamente lo que sucedería durante la importación; si se producen errores, resuélvalos antes de iniciar la importación real.

Exportar datos: paso a paso

Complete los siguientes pasos para exportar datos desde un Controller de XenApp 6.x a archivos XML.

1. Descargue el paquete de la herramienta de migración XAMigration.zip desde el sitio de descargas de Citrix. Para mayor comodidad, colóquelo en un recurso compartido de archivos en la red, al que tengan acceso tanto la comunidad XenApp 6.x como el sitio XenApp 7.6. Descomprima XAMigration.zip en el recurso compartido de archivos en la red. Se descomprimirá en otros dos archivos zip: ReadIMA.zip e ImportFMA.zip.

2. Inicie la sesión en el Controller de XenApp 6.x como un administrador de XenApp con, al menos, permiso de solo lectura y permisos de Windows para ejecutar scripts de PowerShell.

3. Copie ReadIMA.zip desde el recurso compartido de archivos de la red al Controller de XenApp 6.x. Descomprima y extraiga el contenido de ReadIMA.zip en el Controller en una carpeta (por ejemplo: C:\XAMigration).

4. Abra una consola de PowerShell y establezca como directorio actual el directorio donde se encuentran los scripts. Por ejemplo: cd C:\XAMigration.

5. Ejecute Get-ExecutionPolicy para consultar la directiva de ejecución de scripts.

6. Establezca la directiva de ejecución de scripts como, al menos, RemoteSigned para permitir que los scripts se ejecuten. Por ejemplo: Set-ExecutionPolicy RemoteSigned.

7. Importe los archivos de definición de módulos ExportPolicy.psd1 y ExportXAFarm.psd1: Import-Module .\\ExportPolicy.psd1 y Import-Module .\\ExportXAFarm.psd1.

   Información útil

   • Si va a exportar solo datos de directivas, importe solo el archivo de definición de módulos ExportPolicy.psd1. Del mismo modo, si va a importar solo los datos de la comunidad, importe solo ExportXAFarm.psd1.
   • Al importar los archivos de definición de módulos también se agregan los complementos de PowerShell requeridos.
   • No importe los archivos de script .psm1.

8. Para exportar datos de directiva y datos de comunidad, ejecute los siguientes cmdlets.

Datos de directiva: ejecute Export-Policy.

Ejemplo: El cmdlet siguiente exporta la información sobre directivas al archivo XML denominado MyPolicies.xml. La operación genera registros que se guardan en el archivo MyPolicies.log.

Export-Policy -XmlOutputFile ".\MyPolicies.XML" -LogFile ".\MyPolicies.Log"

Datos de comunidad: ejecute Export-XAFarm.

Ejemplo: El cmdlet siguiente exporta la información sobre la comunidad al archivo XML denominado MyFarm.xml. La operación genera registros que se guardan en el archivo MyFarm.log. Se crea una carpeta denominada “MyFarm-icons” para almacenar los archivos de datos de iconos de las aplicaciones; esta carpeta está en la misma ubicación que MyFarm.XML.

Export-XAFarm -XmlOutputFile ".\MyFarm.XML" -LogFile ".\MyFarm.Log"

Una vez ejecutados los scripts de exportación, los archivos XML especificados en las líneas de comandos contienen los datos de la comunidad XenApp y las directivas. Los archivos de iconos de aplicaciones contienen archivos de datos de icono, y el archivo de registros indica qué ocurrió durante la exportación.

Importar datos: paso a paso

Recuerde que puede ejecutar una vista previa de la importación (mediante los comandos Import-Policy o Import-XAFarm con el parámetro Preview) y consultar los archivos de registros antes de realizar la importación propiamente dicha.

Complete los siguientes pasos para importar datos a un sitio de XenApp 7.6, mediante los archivos XML generados en la exportación.

1. Inicie una sesión en el Controller de XenApp 7.6 como administrador con permisos de lectura/escritura y con permisos Windows para ejecutar scripts de PowerShell.

2. Si aún no ha descomprimido el paquete de la herramienta de migración XAMigration en el recurso compartido de archivos de la red, descomprímalo ahora. Copie ImportFMA.zip desde el recurso compartido de archivos de la red al Controller de XenApp 7.6. Descomprima y extraiga el contenido de ImportFMA.zip en el Controller en una carpeta (por ejemplo: C:\XAMigration).

3. Copie los archivos XML (los archivos de salida generados durante la exportación) desde el Controller de XenApp 6.x a la misma ubicación del Controller de XenApp 7.6 donde extrajo los archivos de ImportFMA.zip.

   Si eligió no incrustar los datos de iconos de aplicaciones en el archivo XML de salida al ejecutar el cmdlet Export-XAFarm, asegúrese de que copia la carpeta y los archivos de los datos de iconos en la misma ubicación del Controller de XenApp 7.6 donde ya se encuentra el archivo XML de salida que contiene los datos de aplicaciones y los archivos extraídos de ImportFMA.zip.

4. Abra una consola de PowerShell y establezca como directorio actual el directorio donde se encuentran los scripts: cd C:\XAMigration.
5. Ejecute Get-ExecutionPolicy para consultar la directiva de ejecución de scripts.
6. Establezca la directiva de ejecución de scripts como, al menos, RemoteSigned para permitir que los scripts se ejecuten. Por ejemplo: Set-ExecutionPolicy RemoteSigned.

7. Importe los archivos de definición de módulos ImportPolicy.psd1 y ImportXAFarm.psd1 de PowerShell: Import-Module .\\ImportPolicy.psd1 y Import-Module .\\ImportXAFarm.psd1.

   Información útil:

   • Si va a importar solo datos de directivas, importe solo el archivo de definición de módulos ImportPolicy.psd1. Del mismo modo, si va a importar solo los datos de la comunidad, importe solo ImportXAFarm.psd1.
   • Al importar los archivos de definición de módulos también se agregan los complementos de PowerShell requeridos.
   • No importe los archivos de script .psm1.
8. Para importar datos de directiva y datos de comunidad, ejecute los siguientes cmdlets.

Datos de directiva: Ejecute Import-Policy. Deberá especificar el archivo XML que contiene los datos exportados de las directivas.

Ejemplo: El cmdlet siguiente importa la información sobre directivas desde el archivo XML denominado MyPolicies.xml. La operación genera registros que se guardan en el archivo MyPolicies.log.

Import-Policy -XmlInputFile ".\MyPolicies.XML" -LogFile ".\MyPolicies.Log"

Aplicaciones: Ejecute Import-XAFarm. Deberá especificar un archivo de registros y el archivo XML que contiene los datos exportados de la comunidad de servidores.

Ejemplo: El cmdlet siguiente importa aplicaciones desde el archivo XML denominado MyFarm.xml. La operación genera registros que se guardan en el archivo MyFarm.log.

Import-XAFarm -XmlInputFile ".\MyFarm.XML" -LogFile ".\MyFarm.Log"

Una vez completada correctamente la migración, hay que realizar las tareas posteriores a la migración.

Tareas posteriores a la migración

Una vez importadas las directivas y la configuración de la comunidad de XenApp 6.x en un sitio de XenApp 7.6, siga las siguientes instrucciones para asegurarse de que los datos se han importado correctamente.

Directivas y configuraciones de directivas

La importación de directivas es fundamentalmente una operación de copia, con la excepción de las directivas y configuraciones que se han retirado y, por tanto, no se importan. La comprobación posterior a la migración consiste en comparar ambas partes.

1. El archivo de registros enumera todas las directivas y las configuraciones de directiva que se han importado y que se han omitido. Primero, revise el archivo de registros e identifique qué configuraciones y directivas no se importaron.

2. Compare las directivas de XenApp 6.x con las directivas importadas en XenApp 7.6. Los valores de las configuraciones deben quedar igual (excepto en el caso de las configuraciones retiradas, como se indica en el paso siguiente).

   • Si la cantidad de directivas es pequeña, puede realizar una comparación visual entre las directivas que aparecen en AppCenter en XenApp 6.x y las directivas que aparecen en Studio en XenApp 7.6.
   • Si cuenta con una gran cantidad de directivas, puede que no sea posible hacer una comparación visual. En estos casos, use el cmdlet de exportación de directivas (Export-Policy) para exportar las directivas de XenApp 7.6 a un archivo XML diferente y, a continuación, use una herramienta de comparación de texto (como windiff) para comparar los datos de ese archivo con los datos que aparecen en el archivo XML usado durante la exportación de directivas desde XenApp 6.x.

3. Use la información de la sección Configuraciones de directivas que no se importan para determinar qué puede haber cambiado durante la importación. Si una directiva de XenApp 6.x solo contiene configuraciones retiradas, la directiva no se importará. Por ejemplo, si una directiva de XenApp 6.x solo contiene configuraciones de pruebas de HMR, dicha directiva se omitirá por completo porque no hay ninguna configuración equivalente admitida en XenApp 7.6.

   Algunas configuraciones de directiva de XenApp 6.x ya no se admiten, pero la funcionalidad equivalente está implementada en XenApp 7.6. Por ejemplo, en XenApp 7.6, puede configurar una programación de reinicios para las máquinas con sistema operativo de servidor mediante la modificación de un grupo de entrega; esta funcionalidad se implementaba antes mediante configuraciones de directiva.

4. Revise y confirme cómo se aplicarán los filtros al sitio de XenApp 7.6 frente a cómo se usaban en XenApp 6.x; las diferencias significativas entre la comunidad XenApp 6.x y el sitio XenApp 7.6 pueden cambiar el efecto de los filtros.

Filtros

Examine con cuidado los filtros para cada directiva. Puede que sea necesario hacer cambios para asegurarse de que funcionen en XenApp 7.6 como funcionaban originalmente en XenApp 6.x.

En resumen, los filtros relacionados con cambios de usuarios de dominio necesitan más atención si la comunidad XenApp 6.x y el sitio XenApp 7.6 están en dominios diferentes. Debido a que el script de importación solo utiliza cadenas de nombres de dominio y de nombres de usuario para resolver los usuarios en el nuevo dominio, algunas de las cuentas pueden resolverse correctamente y otras no. Aunque solo exista una pequeña posibilidad de que los distintos dominios y usuarios tengan los mismos nombres, debe revisar cuidadosamente estos filtros para asegurarse de que contienen los valores correctos.

Aplicaciones

Los scripts de importación de aplicaciones no solo importan aplicaciones, sino que también crean objetos como por ejemplo, grupos de entrega. Si la importación de aplicaciones se realiza en varias iteraciones, la jerarquía de las carpetas de aplicaciones original puede cambiar considerablemente.

1. Primero, lea los archivos de registros de la migración, que contienen detalles sobre qué aplicaciones se importaron y cuáles se omitieron, y los cmdlets que se usaron para crear las aplicaciones.

2. Para cada aplicación:

   • Compruebe visualmente que se conservaron sus propiedades básicas durante la importación. Use la información de Asignación de propiedades de aplicaciones para determinar qué propiedades se importaron sin cambios, cuáles no se importaron y cuáles se inicializaron con los datos de aplicación de XenApp 6.x.
   • Compruebe la lista de usuarios. El script de importación importa automáticamente la lista explícita de usuarios en la lista “Limitar visibilidad” de la aplicación en XenApp 7.6. Compruebe que la lista queda igual.

3. Los servidores de aplicaciones no se importan. Esto significa que no se puede acceder todavía a ninguna de las aplicaciones importadas. Es necesario asignar catálogos de máquinas a los grupos de entrega que contienen estas aplicaciones. Los catálogos contienen las máquinas que tienen las imágenes ejecutables de las aplicaciones publicadas. Para cada aplicación:

   • Asegúrese de que el nombre del archivo ejecutable y el directorio de trabajo hacen referencia a un ejecutable que existe en las máquinas asignadas al grupo de entrega (a través de los catálogos de máquinas).
   • Compruebe un parámetro de línea de comandos (que puede ser cualquier cosa como, por ejemplo, un nombre de archivo, una variable de entorno, o el nombre del ejecutable). Verifique que el parámetro es válido para todas las máquinas de los catálogos de máquinas asignadas al grupo de entrega.

Archivos de registros

Los archivos de registros son el recurso de referencia más importante durante las operaciones de importación y exportación. Esta es la razón por la cual los archivos de registros existentes no se sobrescriben de forma predeterminada y los nombres de los archivos de registros predeterminados son únicos.

Como se indica en Capturar registros y controlar errores, si se quiere usar una captura de registros adicional con los cmdlets de PowerShell Start-Transcript y Stop-Transcript (que graban todo lo que se escribe y se imprime en la consola), sus resultados, junto con el archivo de registros, ofrecen una referencia completa de toda la actividad de importación y exportación.

Gracias a las marcas de hora incluidas en los archivos de registros se pueden diagnosticar ciertos problemas. Por ejemplo, si una exportación o importación tardó mucho tiempo en ejecutarse, se puede averiguar si la causa fue una conexión de base de datos defectuosa o algún problema al resolver las cuentas de usuario.

Los comandos grabados en los archivos de registros también indican cómo se leen o se crean algunos objetos. Por ejemplo, para crear un grupo de entrega, se ejecutan varios comandos no solo para crear el grupo de entrega propiamente dicho, sino también otros objetos tales como reglas de directivas de acceso que permiten asignar objetos de aplicación al grupo de entrega.

El archivo de registros se puede usar también para diagnosticar un fallo de importación o exportación. Por lo general, las últimas líneas del archivo de registros indican la causa del fallo; el mensaje de error del fallo también se guarda en el archivo de registros. Junto con el archivo XML, el archivo de registros se puede usar para determinar qué objeto estuvo implicado en el fallo.

Después de revisar y hacer pruebas en la migración:

1. Actualice sus servidores de trabajo XenApp 6.5 con los VDA (Virtual Delivery Agent) actuales ejecutando el instalador de la versión 7.6 en el servidor, lo que quitará el software de XenApp 6.5 e instalará automáticamente el VDA actualizado. Para obtener instrucciones al respecto, consulte Actualización de un servidor de trabajo de XenApp 6.5 a un nuevo VDA para SO de servidor Windows.

   En el caso de servidores de trabajo con XenApp 6.0, es necesario desinstalar manualmente el software de XenApp 6.0 del servidor. A continuación, puede usar el instalador de la versión 7.6 para instalar el VDA actual. No se puede usar el instalador de la versión 7.6 para quitar automáticamente el software de XenApp 6.0.

2. En Studio, en el nuevo sitio de XenApp, cree catálogos de máquinas (o modifique los catálogos existentes) para los servidores de trabajo actualizados.

3. Agregue las máquinas actualizadas desde el catálogo de máquinas a los grupos de entrega que contengan las aplicaciones instaladas en los VDA para SO de servidor Windows.

Uso avanzado

De forma predeterminada, el cmdlet Export-Policy exporta todos los datos de directiva a un archivo XML. Del mismo modo, Export-XAFarm exporta todos los datos de comunidad a un archivo XML. Se pueden usar parámetros de línea de comandos para controlar con más detalle qué se exporta y se importa.

Exportar aplicaciones parcialmente

Si tiene una gran cantidad de aplicaciones y quiere controlar cuántas de ellas se exportan al archivo XML, use los parámetros siguientes:

• AppLimit: Especifica la cantidad de aplicaciones a exportar.
• SkipApps: Especifica la cantidad de aplicaciones a omitir antes de exportar las aplicaciones subsiguientes.

Puede usar ambos parámetros para exportar una gran cantidad de aplicaciones en fragmentos más manejables. Por ejemplo, supongamos que la primera vez que ejecuta Export-XAFarm, quiere exportar solo las primeras 200 aplicaciones; para ello, especifique ese valor en el parámetro AppLimit.

Export-XAFarm -XmlOutputFile "Apps1-200.xml"

La siguiente vez que ejecute Export-XAFarm, quiere exportar las 100 aplicaciones siguientes; para ello, use el parámetro SkipApps para descartar las aplicaciones que ya exportó antes (las primeras 200) y el parámetro AppLimit para exportar las 100 aplicaciones siguientes.

Export-XAFarm -XmlOutputFile "Apps201-300.xml" -AppLimit "100" -SkipApps "200"

No exportar determinados objetos

Algunos objetos pueden omitirse y no es necesario exportarlos, como es el caso, en particular, de los objetos que no se importan. Consulte Configuraciones de directivas que no se importan y Asignación de propiedades de aplicaciones. Utilice los siguientes parámetros para evitar que se exporten objetos innecesarios:

• IgnoreAdmins: No exportar los objetos de administrador
• IgnoreServers: No exportar los objetos de servidor
• IgnoreZones: No exportar los objetos de zona
• IgnoreOthers: No exportar objetos de registro de configuración, patrones de carga, directivas de equilibrio de carga, controladores de impresora y grupos de trabajo
• IgnoreApps: No exportar aplicaciones. Permite exportar otros datos a un archivo XML de salida y, a continuación, ejecutar de nuevo la exportación para exportar las aplicaciones a otro archivo XML de salida distinto.

También se puede usar estos parámetros para solucionar los problemas que podrían provocar el fallo de la exportación. Por ejemplo, si tiene un servidor defectuoso en una zona, la exportación de la zona podría fallar; si incluye el parámetro IgnoreZones, la exportación continúa con otros objetos.

Nombres de grupo de entrega

Si no quiere incluir todas las aplicaciones en un mismo grupo de entrega (por ejemplo, porque acceden a ellas diferentes conjuntos de usuarios y están publicadas en diferentes conjuntos de servidores), puede ejecutar Import-XAFarm varias veces, especificando distintas aplicaciones y un grupo de entrega diferente cada vez. Aunque se pueden usar cmdlets de PowerShell para mover las aplicaciones desde un grupo de entrega a otro después de la migración, la importación selectiva en grupos de entrega determinados puede reducir o eliminar el esfuerzo de mover las aplicaciones más tarde.

• Use el parámetro DeliveryGroupName con el cmdlet Import-XAFarm. El script crea el grupo de entrega especificado si éste no existe.

• Utilice los siguientes parámetros con expresiones regulares para filtrar las aplicaciones que se importan en el grupo de entrega, en función de carpetas, grupos de trabajo, cuentas de usuario y/o nombres de servidores. Se recomienda poner la expresión regular entre comillas simples o dobles. Para obtener información sobre expresiones regulares, consulte https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expressions?redirectedfrom=MSDN.

  • MatchWorkerGroup y NotMatchWorkerGroup: Por ejemplo, para aplicaciones publicadas en grupos de trabajo, el siguiente cmdlet importa las aplicaciones del grupo de trabajo llamado “Productivity Apps” a un grupo de entrega de XenApp 7.6 con el mismo nombre:

    Import-XAFarm –XmlInputFile XAFarm.xml –LogFile XAFarmImport.log –MatchWorkerGroup ‘Productivity Apps’ –DeliveryGroupName ‘Productivity Apps’

  • MatchFolder y NotMatchFolder: Por ejemplo, para aplicaciones organizadas en carpetas, el siguiente cmdlet importa las aplicaciones de la carpeta “Productivity Apps” a un grupo de entrega de XenApp 7.6 con el mismo nombre.

    Import-XAFarm –XmlInputFile XAFarm.xml –LogFile XAFarmImport.log –MatchFolder ‘Productivity Apps’ –DeliveryGroupName ‘Productivity Apps’

    Por ejemplo, el siguiente cmdlet importa en el grupo de entrega predeterminado todas aquellas aplicaciones de cualquier carpeta cuyo nombre contenga “MS Office Apps”.

    Import-XAFarm -XmlInputFile .\TheFarmApps.XML -MatchFolder ".*/MS Office Apps/.*"

  • MatchAccount y NotMatchAccount: Por ejemplo, para aplicaciones publicadas para usuarios y grupos de usuarios de Active Directory, el siguiente cmdlet importa las aplicaciones publicadas para el grupo de usuarios “Finance Group” a un grupo de entrega de XenApp 7.6 llamado “Finance”.

    Import-XAFarm –XmlInputFile XAFarm.xml –LogFile XAFarmImport.log –MatchAccount ‘DOMAIN\\Finance Group’ –DeliveryGroupName ‘Finance’

  • MatchServer y NotMatchServer: Por ejemplo, para las aplicaciones organizadas en servidores, el siguiente cmdlet importa las aplicaciones asociadas al servidor no llamado “Current” a un grupo de entrega de XenApp llamado “Legacy”.

    Import-XAFarm -XmlInputFile XAFarm.xml -LogFile XAFarmImport.log -NotMatchServer 'Current' -DeliveryGroupName 'Legacy'

Personalización

Los programadores de PowerShell pueden crear sus propias herramientas. Por ejemplo, puede usar el script de exportación como una herramienta de inventario para realizar un rastreo de los cambios en una comunidad XenApp 6.x. También puede modificar los archivos XSD (o crear sus propios archivos XSD) para almacenar datos adicionales o datos en diferentes formatos en los archivos XML. Puede especificar un archivo XSD no predeterminado con cada uno de los cmdlets de importación.

Aunque se pueden modificar los archivos de scripts para ajustarse a requisitos de migración específicos o avanzados, la funcionalidad ofrecida se limita a los scripts no modificados. El servicio de asistencia técnica (Citrix Support) le recomendará utilizar los scripts sin modificaciones, para determinar cuál es el comportamiento esperado y ofrecer asistencia técnica, si es necesario.

Solución de problemas

• Si usa PowerShell 2.0 y agregó el complemento Citrix Group Policy PowerShell Provider o el complemento Citrix Common Commands mediante el cmdlet Add-PSSnapIn, puede que aparezca un mensaje de error como el siguiente: “Referencia a objeto no establecida como instancia de un objeto” cuando ejecute los cmdlets de importación o exportación. Este error no afecta a la ejecución del script y puede ignorarse.
• Evite agregar o quitar el complemento Citrix Group Policy PowerShell Provider en la misma sesión de consola donde se usan los módulos de scripts de exportación e importación, porque esos módulos agregan automáticamente el complemento. Si agrega o quita el complemento por separado, puede que vea uno de los siguientes errores:
  • “Ya existe una unidad llamada ‘LocalGpo’”. Este error aparece cuando el complemento se agrega dos veces; el complemento intenta montar la unidad LocalGpo cuando se ha cargado y luego notifica el error.
  • “Un parámetro que no se puede encontrar coincide con el nombre de parámetro ‘Controller’”. Este error aparece cuando el complemento no ha sido agregado pero el script intenta montar la unidad. El script no tiene constancia de que el complemento se quitó. Cierre la consola e inicie una nueva sesión. En la nueva sesión, importe los módulos de scripts, no agregue ni quite el complemento por separado.
• Al importar los módulos, si hace clic con el botón secundario en un archivo PSD1 y selecciona Abrir o Abrir con PowerShell, la ventana de la consola de PowerShell se abrirá y se cerrará rápidamente hasta que detenga el proceso. Para evitar este error, introduzca el nombre completo del módulo de scripts de PowerShell directamente en la ventana de la consola de PowerShell (por ejemplo, Import-Module .\\ExportPolicy.psd1)).
• Si recibe un error de permisos al ejecutar una exportación o importación, asegúrese de que usted es un administrador de XenApp con permisos para leer objetos (para poder exportar), o para leer y crear objetos (para poder importar). También debe tener suficientes permisos de Windows para ejecutar scripts de PowerShell.
• Si la exportación falla, compruebe si la comunidad de XenApp 6.x se encuentra en un estado correcto, ejecutando las utilidades DSMAINT y DSCHECK en el servidor de Controller de XenApp 6.x.
• Si ejecuta una vista previa de la importación y luego ejecuta los cmdlets de importación de nuevo para una migración real, pero descubre que no se ha importado nada, compruebe si quitó el parámetro Preview de los cmdlets de importación.

Configuraciones de directivas que no se importan

Las siguientes configuraciones de directiva de usuario y de equipo no se importan porque ya no se admiten. Las directivas sin filtrar nunca se importan. Las funciones y los componentes que admiten estas configuraciones han sido reemplazadas por otras tecnologías y componentes nuevos, o estas configuraciones ya no se aplican debido a cambios de arquitectura y plataforma.

Configuraciones de directiva de equipo que no se importan

• Control de acceso de las conexiones
• Nivel de administración de CPU de servidor
• Resolución de direcciones DNS
• Farm name
• Almacenamiento completo de iconos en caché
• Supervisión de estado, Pruebas de supervisión de estado
• Nombre de host del servidor de licencias, Puerto del servidor de licencias
• Límite de sesiones de usuario, Límites de sesiones de administrador
• Nombre del patrón de carga
• Registro de sucesos de límites de inicios de sesión
• Porcentaje máximo de servidores con control de inicio de sesión
• Optimización de memoria, Lista de aplicaciones excluidas de la optimización de memoria, Intervalo de optimización de memoria, Programación de la optimización de memoria: día del mes, Programación de la optimización de memoria: día de la semana, Programación de la optimización de memoria: hora
• Confianza en clientes de aplicaciones sin conexión, Registro de sucesos de aplicaciones sin conexión, Periodo de licencias de aplicaciones sin conexión, Usuarios de aplicaciones sin conexión
• Pedir contraseña
• Advertencia personalizada de reinicio, Texto personalizado de advertencia de reinicio, Hora de inhabilitación de inicios de sesión por reinicio, Frecuencia de reinicio programado, Intervalo de selección de hora de reinicio programado, Fecha de comienzo del reinicio programado, Hora del reinicio programado, Intervalo de advertencias de reinicio, Comienzo de advertencias de reinicio, Advertencia de reinicios para los usuarios, Reinicios programados
• Remedo
• Confiar en solicitudes XML (configurada en StoreFront)
• Filtrado de direcciones de adaptador de IP virtual, Lista de programas para compatibilidad con IP virtual, Compatibilidad mejorada de IP virtual, Lista de programas para filtrado de direcciones de adaptador de IP virtual
• Nombre de la carga de trabajo
• Edición del producto XenApp, Modelo del producto XenApp
• Puerto de XML Service

* Reemplazada por Asistencia remota de Windows

Configuraciones de directiva de usuario que no se importan

• Conectar automáticamente puertos COM del cliente, Conectar automáticamente puertos LPT del cliente
• Redirección de puertos COM del cliente, Redirección de puertos LPT del cliente
• Nombres de impresora del cliente
• Límite de sesiones simultáneas
• Entradas de conexiones de remedo *
• Intervalo de temporizador de desconexión de sesión persistente, Intervalo de temporizador de fin de sesión persistente
• Registrar intentos de remedo *
• Notificar al usuario sobre conexiones de remedo pendientes *
• Intervalo de temporizador de desconexión de sesión de preinicio, Intervalo de temporizador de fin de sesión de preinicio
• Importancia de la sesión
• Single Sign-On, almacén central de Single Sign-On
• Usuarios que pueden remedar a otros usuarios, Usuarios que no pueden remedar a otros usuarios *

* Reemplazada por Asistencia remota de Windows

Tipos de aplicaciones no importados

Los siguientes tipos de aplicación no se importan.

• Escritorios de servidor
• Contenido
• Aplicaciones distribuidas por streaming (App-V es el nuevo método utilizado para la distribución de aplicaciones por streaming)

Asignación de propiedades de aplicaciones

El script para importar datos de comunidad solo importa aplicaciones. Las siguientes propiedades de aplicación se importan sin cambios.

IMA y FMA tienen restricciones diferentes en cuanto a la longitud de nombre de carpeta. En IMA, el límite para los nombres de carpeta es de 256 caracteres. El límite en FMA es de 64 caracteres. Al realizar la importación, las aplicaciones cuya ruta de acceso contenga un nombre de carpeta de más de 64 caracteres se omitirán. El límite se aplica solamente al nombre de cada carpeta dentro de la ruta de carpetas; la ruta de carpetas entera puede ser más larga que los límites indicados. Para evitar que se omitan aplicaciones durante la importación, Citrix recomienda comprobar la longitud del nombre de las carpetas de las aplicaciones, y acortarlos si es necesario antes de realizar la exportación.

Las siguientes propiedades de aplicación están inicializadas o no inicializadas de forma predeterminada, o están definidas con los valores proporcionados en los datos de XenApp 6.x:

Las siguientes propiedades de aplicación se migran parcialmente:

Las siguientes propiedades de XenApp 6.x no se importan: