Migrar XenApp 6.x

NOTA: No puede usar el producto Citrix Smart Migrate con esta versión de XenApp y XenDesktop. Sin embargo, la herramienta de migración está disponible.

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 de XenApp 7.6 a una versión LTSR compatible o a la versión actual de Citrix Virtual Apps and Desktops.

Herramienta de migración de XenApp 6.x

La herramienta de migración de XenApp 6.x es una colección de scripts de PowerShell que contienen cmdlets que migran datos de directivas y de la granja de XenApp 6.x (6.0 o 6.5). En el servidor del controlador de XenApp 6.x, se ejecutan cmdlets de exportación que recopilan esos datos en archivos XML. Luego, desde el controlador de XenApp 7.6, se ejecutan cmdlets de importación que crean objetos utilizando 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 controlador 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 directivas y de la granja a archivos XML.
   3. Copie los archivos XML (y la carpeta de iconos si eligió no incrustarlos en los archivos XML durante la exportación) en el controlador de XenApp 7.6.
2. En el controlador de XenApp 7.6:
   1. Importe los módulos de importación de PowerShell.
   2. Ejecute los cmdlets de importación para importar datos de directivas y de la granja (aplicaciones), utilizando los archivos XML como entrada.
3. Complete los pasos posteriores a la migración.

Antes de ejecutar una migración real, puede exportar la configuración de XenApp 6.x y luego realizar una importación de vista previa en el sitio de XenApp 7.6. La vista previa identifica posibles puntos de fallo para que pueda resolver los problemas antes de ejecutar la importación real. Por ejemplo, una vista previa podría 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 registro generados a partir de la vista previa como guía de migración.

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

Novedades de esta versión

Esta versión de diciembre de 2014 (versión 20141125) contiene las siguientes actualizaciones:

• Si encuentra problemas al usar la herramienta de migración en una granja de XenApp 6.x, infórmelos a https://discussions.citrix.com/forum/1411-xenapp-7x/.
• Nuevo empaquetado: el archivo XAMigration.zip ahora contiene dos paquetes separados e independientes: ReadIMA.zip y ImportFMA.zip. Para exportar desde un servidor XenApp 6.x, solo necesita ReadIMA.zip. Para importar a un servidor XenApp 7.6, solo necesita ImportFMA.zip.
• El cmdlet Export-XAFarm admite un nuevo parámetro (EmbedIconData) que elimina la necesidad de copiar datos de iconos en archivos separados.
• El cmdlet Import-XAFarm admite tres nuevos parámetros:
  • MatchServer: importa aplicaciones de servidores cuyos nombres coinciden con una expresión
  • NotMatchServer: importa aplicaciones de servidores cuyos nombres no coinciden con una expresión
  • IncludeDisabledApps: importa aplicaciones deshabilitadas
• Las aplicaciones precargadas no se importan.
• El cmdlet Export-Policy funciona en XenDesktop 7.x.

Paquete de la herramienta de migración

La herramienta de migración está disponible en el sitio de descarga de Citrix XenApp 7.6. El archivo XAMigration.zip contiene dos paquetes separados e independientes:

• ReadIMA.zip: contiene los archivos utilizados para exportar datos de su granja de XenApp 6.x, además de módulos compartidos.

• ImportFMA.zip - contiene los archivos utilizados para importar datos a su conjunto de servidores XenApp 7.6, además de módulos compartidos.

Limitaciones

• No se importan todas las configuraciones de directivas. Consulte Configuración de directivas no importadas. La configuración no admitida se ignora y se anota en el archivo de registro.
• Aunque todos los detalles de la aplicación se recopilan en el archivo XML de salida durante la operación de exportación, solo las aplicaciones instaladas en el servidor se importan en el sitio de XenApp 7.6. Los escritorios publicados, el contenido y la mayoría de las aplicaciones transmitidas no son compatibles (consulte los parámetros del cmdlet Import-XAFarm en Paso a paso: importar datos para ver las excepciones).
• Los servidores de aplicaciones no se importan.
• Muchas propiedades de aplicación no se importan debido a las diferencias entre las tecnologías Independent Management Architecture (IMA) de XenApp 6.x y FlexCast Management Architecture (FMA) de XenApp 7.6. Consulte Asignación de propiedades de aplicación.
• Se crea un grupo de entrega durante la importación. Consulte Uso avanzado para obtener detalles sobre el uso de parámetros para filtrar lo que se importa.
• Solo se importan las configuraciones de directivas de Citrix creadas con la consola de administración de AppCenter. Las configuraciones de directivas de Citrix creadas con objetos de directiva de grupo (GPO) de Windows no se importan.
• Los scripts de migración están destinados únicamente a migraciones de XenApp 6.x a XenApp 7.6.
• Las carpetas anidadas con más de cinco niveles de profundidad no son compatibles con Studio y no se importarán. Si la estructura de carpetas de su aplicación incluye carpetas con más de cinco niveles de profundidad, considere reducir el número de niveles de carpetas anidadas antes de la importación.

Consideraciones de seguridad

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

Revise cuidadosamente los archivos XML antes de utilizarlos como entrada al importar directivas y aplicaciones, para asegurarse de que no contienen modificaciones no autorizadas.

Las asignaciones de objetos de directiva (anteriormente conocidas como filtros de directiva) controlan cómo se aplican las directivas. Después de importar las directivas, revise cuidadosamente las asignaciones de objetos para cada directiva para asegurarse de que no haya vulnerabilidades de seguridad resultantes de la importación. Es posible que se apliquen diferentes conjuntos de usuarios, direcciones IP o nombres de cliente a la directiva después de la importación. La configuración de permitir y denegar puede tener significados diferentes después de la importación.

Registro y gestión de errores

Los scripts proporcionan un registro exhaustivo que rastrea todas las ejecuciones de cmdlets, mensajes informativos, resultados de ejecución de cmdlets, advertencias y errores.

• La mayoría del uso de cmdlets de Citrix PowerShell se registra. Todos los cmdlets de PowerShell en los scripts de importación que crean nuevos objetos de sitio se registran.
• El progreso de la ejecución del script se registra, incluidos los objetos que se están procesando.
• Las acciones principales que afectan el estado del flujo se registran, incluidos los flujos dirigidos desde la línea de comandos.
• Todos los mensajes impresos en la consola se registran, incluidas las advertencias y los errores.
• Cada línea tiene una marca de tiempo al milisegundo.

Citrix recomienda especificar un archivo de registro al ejecutar cada uno de los cmdlets de exportación e importación.

Si no especifica un nombre de archivo de registro, el archivo de registro se guarda en la carpeta de inicio del usuario actual (especificada en la variable de PowerShell $HOME) si esa carpeta existe. De lo contrario, el archivo se coloca en la carpeta de ejecución actual del script. El nombre de registro predeterminado es XFarmYYYYMMDDHHmmSS-xxxxxx, donde los últimos seis dígitos son un número aleatorio.

De forma predeterminada, se muestra toda la información de progreso. Para suprimir la visualización, especifique el parámetro NoDetails en el cmdlet de exportación e importación.

Generalmente, un script detiene la ejecución cuando se encuentra un error, y puede volver a ejecutar el cmdlet después de corregir 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 admitidos se notifican como advertencias y no se importan. Las aplicaciones que ya existen en el sitio de XenApp 7.6 no se importan. La configuración de directivas obsoletas en XenApp 7.6 no se importa.

Los scripts de migración utilizan muchos cmdlets de PowerShell, y es posible que no se registren todos los errores posibles. Para una mayor cobertura de registro, utilice las funciones de registro de PowerShell. Por ejemplo, las transcripciones de PowerShell registran todo lo que se imprime en la pantalla. Para obtener más información, consulte la ayuda de los cmdlets Start-Transcript y Stop-Transcript.

Requisitos, preparación y prácticas recomendadas

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.

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

Debe comprender los conceptos básicos de PowerShell. Aunque no se requiere una amplia experiencia en scripting, debe comprender los cmdlets que ejecuta. Utilice el cmdlet Get-Help para revisar la ayuda de cada cmdlet de migración antes de ejecutarlo. Por ejemplo: Get-Help -full Import-XAFarm.

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

Es bueno saberlo:

• Para facilitar la entrega de aplicaciones mientras se ejecutan dos implementaciones (la granja de XenApp 6.x y el nuevo sitio de XenApp 7.6), puede agregar ambas implementaciones en StoreFront o Web Interface. Consulte la documentación del producto para su versión de StoreFront o Web Interface (Administrar > Crear un almacén).
• Los datos de los iconos de aplicación se gestionan de dos maneras:
• Si especifica el parámetro EmbedIconData en el cmdlet Export-XAFarm, los datos de los iconos de aplicación exportados se incrustan en el archivo XML de salida.

• Si no especifica el parámetro EmbedIconData en el cmdlet Export-XAFarm, los datos de los iconos de aplicación exportados se almacenan en una carpeta cuyo nombre se forma añadiendo la cadena -icons al nombre base del archivo XML de salida. Por ejemplo, si el parámetro XmlOutputFile es FarmData.xml, se crea la carpeta FarmData-icons para almacenar los iconos de aplicación.

  Los archivos de datos de iconos de esta carpeta son archivos .txt que se nombran utilizando el nombre del explorador de la aplicación publicada. Aunque los archivos son archivos .txt, los datos almacenados son datos de iconos binarios codificados, que pueden ser leídos por el script de importación para recrear 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 utilizan iconos genéricos para cada aplicación importada.

• Los nombres de los módulos de script, los archivos de manifiesto, el módulo compartido y los cmdlets son similares. Utilice la función de autocompletar con precaución 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, la mayoría de los valores de los parámetros <string> muestran comillas. Estas son opcionales para cadenas de una sola 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 de controlador y host de sesión (comúnmente conocido como controlador).
• Para ejecutar los cmdlets de exportación, debe ser un administrador de XenApp® con permiso para leer objetos. También debe tener permisos de Windows suficientes para ejecutar scripts de PowerShell. Los procedimientos paso a paso contienen instrucciones.

• Asegúrese de que la granja de XenApp 6.x esté en un estado saludable antes de iniciar una exportación. Realice una copia de seguridad de la base de datos de la granja. Verifique la integridad de la granja utilizando la utilidad Citrix IMA Helper (CTX133983): desde la pestaña IMA Datastore, ejecute una comprobación maestra (y luego use la opción DSCheck para resolver entradas no válidas). La reparación de problemas antes de la migración ayuda a prevenir fallos en la exportación.

  Por ejemplo, si un servidor se eliminó incorrectamente de la granja, sus datos podrían permanecer en la base de datos; esto podría hacer que los cmdlets del script de exportación fallen (por ejemplo, Get-XAServer -ZoneName). Si los cmdlets fallan, el script falla.

• Puede ejecutar los cmdlets de exportación en una granja activa que tenga conexiones de usuario activas. Los scripts de exportación solo leen la configuración estática de la granja y los datos de la política.

Para importar al servidor XenApp 7.6:

• Puede importar datos a implementaciones de XenApp 7.6 (y versiones posteriores compatibles). Debe instalar un Controller y Studio de XenApp 7.6, y crear un sitio antes de importar los datos que exportó de la granja de XenApp 6.x. Aunque los VDA no son necesarios para importar la configuración, permiten que los tipos de archivo de aplicación estén disponibles.
• Para ejecutar los cmdlets de importación, debe ser un administrador de XenApp con permiso para leer y crear objetos. Un administrador completo tiene estos permisos. También debe tener permisos de Windows suficientes para ejecutar scripts de PowerShell. Los procedimientos paso a paso contienen instrucciones.
• No tenga otras conexiones de usuario activas durante una importación. Los scripts de importación crean muchos objetos nuevos, y podrían producirse interrupciones si otros usuarios están cambiando la configuración al mismo tiempo.

Recuerde que puede exportar datos y luego usar el parámetro -Preview con los cmdlets de importación para ver qué sucedería durante una importación real, sin importar nada. Los registros indican exactamente lo que sucedería durante una importación real. Si ocurren errores, puede resolverlos antes de iniciar una importación real.

Paso a paso: exportar datos

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

1. Descargue el paquete de la herramienta de migración XAMigration.zip del sitio de descargas de Citrix. Para mayor comodidad, colóquelo en un recurso compartido de red al que puedan acceder tanto la granja de XenApp 6.x como el sitio de XenApp 7.6. Descomprima XAMigration.zip en el recurso compartido de red. Hay dos archivos zip: ReadIMA.zip y ImportFMA.zip.

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

3. Copie ReadIMA.zip del recurso compartido de red al controlador de XenApp 6.x. Descomprima y extraiga ReadIMA.zip en el controlador a una carpeta (por ejemplo: C:\XAMigration).

4. Abra una consola de PowerShell y establezca el directorio actual en la ubicación del script (por ejemplo: cd C:\XAMigration).

5. Compruebe la política de ejecución de scripts ejecutando Get-ExecutionPolicy.

6. Establezca la política de ejecución de scripts en al menos RemoteSigned para permitir que se ejecuten los scripts (por ejemplo: Set-ExecutionPolicy RemoteSigned).

7. Importe los archivos de definición de módulo ExportPolicy.psd1 y ExportXAFarm.psd1:

   Import-Module .\ExportPolicy.psd1

   Import-Module .\ExportXAFarm.psd1

   Es bueno saberlo:

   • Si solo desea exportar datos de directivas, puede importar solo el archivo de definición de módulo ExportPolicy.psd1. Del mismo modo, si solo desea exportar datos de la granja, importe solo ExportXAFarm.psd1.
   • La importación de los archivos de definición de módulo también añade los complementos de PowerShell necesarios.
   • No importe los archivos de script .psm1.

8. Para exportar datos de directivas, ejecute el cmdlet Export-Policy.

   Parámetro	Descripción
   -XmlOutputFile “.xml"	Nombre del archivo de salida XML. Este archivo contiene los datos exportados. Debe tener una extensión .xml. El archivo no debe existir, pero si se especifica una ruta, la ruta principal debe existir. Predeterminado: Ninguno. Este parámetro es obligatorio.
   -ArchivoRegistro “"	Nombre del archivo de registro. La extensión es opcional. El archivo se crea si no existe. Si el archivo existe y también se especifica el parámetro NoClobber, se genera un error. De lo contrario, el contenido del archivo se sobrescribe. Predeterminado: Consulte Registro y gestión de errores.
   -NoLog	No generar salida de registro. Esto anula el parámetro LogFile si también se especifica. Predeterminado: Falso. Se genera la salida de registro.
   -NoClobber	No sobrescribir un archivo de registro existente especificado en el parámetro LogFile. Si el archivo de registro no existe, este parámetro no tiene ningún efecto. Predeterminado: Falso. Se sobrescribe un archivo de registro existente.
   -NoDetails	No enviar informes detallados sobre la ejecución del script a la consola. Predeterminado: Falso. Se envían informes detallados a la consola.
   -SuppressLogo	No imprimir el mensaje XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# en la consola. Este mensaje, que identifica la versión del script, puede ser útil durante la resolución de problemas. Por lo tanto, Citrix recomienda omitir este parámetro. Predeterminado: Falso. El mensaje se imprime en la consola.

   Ejemplo: El siguiente cmdlet exporta información de directivas al archivo XML llamado MyPolicies.xml. La operación se registra en el archivo llamado MyPolicies.log.

   Export-Policy -XmlOutputFile ".\MyPolicies.XML" -LogFile ".\MyPolicies.Log"
   <!--NeedCopy-->
   

9. Para exportar datos de la granja, ejecute el cmdlet Export-XAFarm, especificando un archivo de registro y un archivo XML.

Example: The following cmdlet exports farm information to the XML file named MyFarm.xml. The operation is logged to the file MyFarm.log. A folder named "MyFarm-icons" is created to store the application icon data files. This folder is at the same location as MyFarm.XML.

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

Una vez completados los scripts de exportación, los archivos XML especificados en las líneas de comandos contienen la directiva y los datos de la granja de XenApp. Los archivos de iconos de aplicación contienen archivos de datos de iconos, y el archivo de registro indica lo que ocurrió durante la exportación.

Paso a paso: importar datos

Recuerde que puede ejecutar una importación de vista previa (ejecutando el cmdlet Import-Policy o Import-XAFarm con el parámetro Preview). A continuación, puede revisar los archivos de registro antes de realizar una importación real.

Siga los pasos a continuación para importar datos a un sitio de XenApp 7.6, utilizando los archivos XML generados a partir de la exportación.

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

2. Si no ha descomprimido el paquete de la herramienta de migración XAMigration en el recurso compartido de red, hágalo ahora. Copie ImportFMA.zip del recurso compartido de red al Controller de XenApp 7.6. Descomprima y extraiga 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) del Controller de XenApp 6.x a la misma ubicación en el Controller de XenApp 7.6 donde extrajo los archivos ImportFMA.zip.

   Si optó por no incrustar los datos del icono de la aplicación en el archivo de salida XML cuando ejecutó Export-XAFarm, copie la carpeta y los archivos de datos del icono en la misma ubicación en el Controller de XenApp 7.6 que el archivo XML de salida que contiene los datos de la aplicación y los archivos ImportFMA.zip extraídos.

4. Abra una consola de PowerShell y establezca el directorio actual en la ubicación del script (por ejemplo: cd C:\XAMigration).

5. Compruebe la directiva de ejecución de scripts ejecutando Get-ExecutionPolicy.

6. Establezca la directiva de ejecución de scripts en al menos RemoteSigned para permitir que se ejecuten los scripts (por ejemplo: Set-ExecutionPolicy RemoteSigned).

7. Importe los archivos de definición del módulo de PowerShell ImportPolicy.psd1 y ImportXAFarm.psd1:

   Import-Module .\ImportPolicy.psd1

   Import-Module .\ImportXAFarm.psd1

   Es bueno saber:

   • Si tiene la intención de importar solo datos de directivas, puede importar solo el archivo de definición del módulo ImportPolicy.psd1. Del mismo modo, si tiene la intención de importar solo datos de la granja, importe solo ImportXAFarm.psd1.
   • La importación de los archivos de definición de módulo también añade los complementos de PowerShell necesarios.
   • No importe los archivos de script .psm1.

8. Para importar datos de directiva, ejecute el cmdlet Import-Policy, especificando el archivo XML que contiene los datos de directiva exportados.

   Parámetro	Descripción
   -XmlInputFile “.xml"	Nombre del archivo de entrada XML. Este archivo contiene los datos recopilados al ejecutar el cmdlet Export-Policy. Debe tener una extensión .xml. Predeterminado: Ninguno. Este parámetro es obligatorio.
   -XsdArchivo “"	Nombre del archivo XSD. Los scripts de importación utilizan este archivo para validar la sintaxis del archivo de entrada XML. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: PolicyData.XSD
   -RegistroArchivo “"	Nombre del archivo de registro. Si copió los archivos de registro de exportación a este servidor, considere la posibilidad de usar un nombre de archivo de registro diferente con el cmdlet de importación. Predeterminado: Consulte Registro y gestión de errores.
   -NoLog	No generar salida de registro. Esto anula el parámetro LogFile, si también se especifica. Predeterminado: False. Se genera la salida de registro.
   -NoClobber	No sobrescribir un archivo de registro existente especificado en el parámetro LogFile. Si el archivo de registro no existe, este parámetro no tiene ningún efecto. Predeterminado: False. Se sobrescribe un archivo de registro existente.
   -NoDetails	No enviar informes detallados sobre la ejecución del script a la consola. Predeterminado: Falso. Los informes detallados se envían a la consola.
   -SuppressLogo	No imprimir el mensaje XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# en la consola. Este mensaje, que identifica la versión del script, puede ser útil durante la solución de problemas. Por lo tanto, Citrix recomienda omitir este parámetro. Predeterminado: Falso. El mensaje se imprime en la consola.
   -Preview	Realizar una importación de vista previa: leer datos del archivo de entrada XML, pero no importar objetos al sitio. El archivo de registro y la consola indican lo que ocurrió durante la importación de vista previa. Una vista previa muestra a los administradores lo que sucedería durante una importación real. Predeterminado: Falso. Se produce una importación real.

   Ejemplo: El siguiente cmdlet importa datos de directivas del archivo XML llamado MyPolcies.xml. La operación se registra en el archivo llamado MyPolicies.log.

   Import-Policy -XmlInputFile ".\MyPolicies.XML"
   -LogFile ".\MyPolicies.Log"
   <!--NeedCopy-->
   

9. Para importar aplicaciones, ejecute el cmdlet Import-XAFarm, especificando un archivo de registro y el archivo XML que contiene los datos de la granja exportados.

   Parámetro	Descripción
   -XmlInputFile “.xml"	Nombre del archivo de entrada XML. Este archivo contiene datos recopilados al ejecutar el cmdlet Export-XAFarm. Debe tener una extensión .xml. Predeterminado: Ninguno. Este parámetro es obligatorio.
   -ArchivoXsd “"	Nombre del archivo XSD. Los scripts de importación utilizan este archivo para validar la sintaxis del archivo de entrada XML. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: XAFarmData.XSD
   -ArchivoDeRegistro “"	Nombre del archivo de registro. Si copió los archivos de registro de exportación a este servidor, considere usar un nombre de archivo de registro diferente con el cmdlet de importación. Predeterminado: Consulte Registro y gestión de errores.
   -NoLog	No generar salida de registro. Esto anula el parámetro LogFile, si también se especifica. Predeterminado: Falso. Se genera la salida de registro.
   -NoClobber	No sobrescribir un archivo de registro existente especificado en el parámetro LogFile. Si el archivo de registro no existe, este parámetro no tiene efecto. Predeterminado: Falso. Se sobrescribe un archivo de registro existente.
   -NoDetails	No enviar informes detallados sobre la ejecución del script a la consola. Predeterminado: Falso. Se envían informes detallados a la consola.
   -SuppressLogo	No imprimir el mensaje XenApp 6.x to XenApp/XenDesktop 7.6 Migration Tool Version #yyyyMMdd-hhmm# en la consola. Este mensaje, que identifica la versión del script, puede ser útil durante la resolución de problemas. Por lo tanto, Citrix recomienda omitir este parámetro. Predeterminado: Falso. El mensaje se imprime en la consola.
   -Preview	Realizar una importación de vista previa: leer datos del archivo de entrada XML, pero no importar objetos al sitio. El archivo de registro y la consola indican lo que ocurrió durante la importación de vista previa. Una vista previa muestra a los administradores lo que sucedería durante una importación real. Predeterminado: Falso. Se produce una importación real.
   -DeliveryGroupName “"	Nombre del grupo de entrega para todas las aplicaciones importadas. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: “ -Delivery Group”
   -MatchFolder “"	Importar solo aquellas aplicaciones en carpetas con nombres que coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: No se produce ninguna coincidencia.
   -NoCoincidirCarpeta “"	Importar solo aquellas aplicaciones en carpetas cuyos nombres no coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: No se produce ninguna coincidencia.
   -CoincidirServidor “"	Importar solo aquellas aplicaciones de servidores cuyos nombres coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo.
   -NoCoincidirServidor “"	Importar solo aquellas aplicaciones de servidores cuyos nombres no coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: No se produce ninguna coincidencia.
   -CoincidirGrupoDeTrabajo “"	Importar solo aquellas aplicaciones publicadas en grupos de trabajadores cuyos nombres coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: No se produce ninguna coincidencia.
   -NoCoincidirGrupoDeTrabajo “"	Importar solo aquellas aplicaciones publicadas en grupos de trabajadores cuyos nombres no coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: No se produce ninguna coincidencia.
   -CoincidirCuenta “"	Importar solo aquellas aplicaciones publicadas en cuentas de usuario cuyos nombres coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: No se produce ninguna coincidencia.
   -NoCoincidirCuenta “"	Importar solo aquellas aplicaciones publicadas en cuentas de usuario cuyos nombres no coincidan con la cadena. Consulte Uso avanzado para obtener información sobre cómo usarlo. Predeterminado: No se produce ninguna coincidencia.
   -IncludeStreamedApps	Importar aplicaciones de tipo StreamedToClientOrServerInstalled. (No se importan otras aplicaciones transmitidas). Predeterminado: Las aplicaciones transmitidas no se importan.
   -IncludeDisabledApps	Importar aplicaciones que se han marcado como deshabilitadas. Predeterminado: Las aplicaciones deshabilitadas no se importan.

   Ejemplo: El siguiente cmdlet importa aplicaciones del archivo XML denominado MyFarm.xml. La operación se registra en el archivo denominado MyFarm.log.

   Import-XAFarm -XmlInputFile ".\MyFarm.XML"
   -LogFile ".\MyFarm.Log"
   
   <!--NeedCopy-->
   

10. Una vez que la importación se complete correctamente, realice las tareas posteriores a la migración.

Tareas posteriores a la migración

Después de importar correctamente las directivas y la configuración de la granja de XenApp 6.x a un sitio de XenApp 7.6, utilice la siguiente guía para asegurarse de que los datos se han importado correctamente.

Directivas y configuraciones de directiva

La importación de directivas es esencialmente una operación de copia, excepto para las configuraciones y directivas obsoletas, que no se importan. La comprobación posterior a la migración implica esencialmente comparar ambos lados.

1. El archivo de registro enumera todas las directivas y configuraciones importadas e ignoradas. Primero, revise el archivo de registro e identifique qué configuraciones y directivas no se importaron.

2. Compare las directivas de XenApp 6.x con las directivas importadas a XenApp 7.6. Mantenga los mismos valores de configuración (excepto para las configuraciones de directiva obsoletas, como se indica en el siguiente paso).

   • Si tiene pocas directivas, puede realizar una comparación visual lado a lado de las directivas que se muestran en XenApp 6.x AppCenter y las directivas que se muestran en XenApp 7.6 Studio.
   • Si tiene muchas directivas, una comparación visual podría no ser factible. En tales casos, utilice 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, utilice una herramienta de comparación de texto (como windiff) para comparar los datos de ese archivo con los datos del archivo XML utilizado durante la exportación de directivas desde XenApp 6.x.

3. Utilice la información de la sección Configuraciones de directiva no importadas para determinar qué podría haber cambiado durante la importación. Si una directiva de XenApp 6.x contiene solo configuraciones obsoletas, como directiva completa, no se importa. Por ejemplo, si una directiva de XenApp 6.x contiene solo configuraciones de prueba HMR, esa directiva se ignora porque no hay una configuración equivalente compatible en XenApp 7.6.

   Algunas configuraciones de directiva de XenApp 6.x ya no son compatibles, pero la funcionalidad equivalente se implementa en XenApp 7.6. Por ejemplo, en XenApp 7.6, puede configurar una programación de reinicio para máquinas con SO de servidor editando un grupo de entrega. Esta funcionalidad se implementaba anteriormente a través de configuraciones de directiva.

4. Revise y confirme cómo se aplican los filtros a su sitio de XenApp 7.6 en comparación con su uso en XenApp 6.x. Las diferencias significativas entre la granja de XenApp 6.x y el sitio de XenApp 7.6 podrían cambiar el efecto de los filtros.

Filtros

Examine cuidadosamente los filtros de cada directiva. Es posible que se requieran cambios para garantizar que sigan funcionando en XenApp 7.6 según lo previsto originalmente en XenApp 6.x.

En resumen, los filtros que implican cambios de usuario de dominio requieren la mayor atención si la granja de XenApp 6.x y el sitio de XenApp 7.6 están en dominios diferentes. Dado que el script de importación utiliza solo cadenas de nombres de dominio y de usuario para resolver usuarios en el nuevo dominio, es posible que solo se resuelvan algunas cuentas. Aunque hay pocas posibilidades de que diferentes dominios y usuarios tengan el mismo nombre, revise cuidadosamente estos filtros para asegurarse de que contienen los valores correctos.

Aplicaciones

Los scripts de importación de aplicaciones no solo importan aplicaciones. También crean objetos como los grupos de entrega. Si la importación de aplicaciones implica varias iteraciones, las jerarquías de carpetas de aplicaciones originales pueden cambiar significativamente.

1. Primero, lea los archivos de registro de migración que contienen detalles sobre qué aplicaciones se importaron, cuáles se ignoraron y los cmdlets que se utilizaron para crear las aplicaciones.
2. Para cada aplicación:
   • Compruebe visualmente que las propiedades básicas se conservaron durante la importación. Utilice la información de la sección (/es-es/xenapp-and-xendesktop/7-15-ltsr/upgrade-migrate/xenapp-worker-upgrade.html) para determinar qué propiedades se importaron sin cambios, no se importaron o se inicializaron utilizando los datos de la 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 a la lista de visibilidad limitada de la aplicación en XenApp 7.6. Compruebe que la lista sigue siendo la misma.
3. Los servidores de aplicaciones no se importan. Esto significa que aún no se puede acceder a ninguna de las aplicaciones importadas. Los grupos de entrega que contienen estas aplicaciones deben tener asignados catálogos de máquinas que contengan las máquinas con las imágenes ejecutables de las aplicaciones publicadas. Para cada aplicación:
   • Asegúrese de que el nombre del ejecutable y el directorio de trabajo apuntan 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 el nombre de un archivo, una variable de entorno o el nombre de un ejecutable). Verifique que el parámetro sea válido para todas las máquinas de los catálogos de máquinas asignados al grupo de entrega.

Archivos de registro

Los archivos de registro son los recursos de referencia más importantes para una importación y exportación. Por este motivo, los archivos de registro existentes no se sobrescriben de forma predeterminada y los nombres de los archivos de registro predeterminados son únicos.

Como se indica en Registro y control de errores, si utiliza una cobertura de registro adicional con los cmdlets de PowerShell Start-Transcript y Stop-Transcript (que registran todo lo que se escribe e imprime en la consola), esa salida, junto con el archivo de registro, proporciona una referencia completa de la actividad de importación y exportación.

Mediante las marcas de tiempo de los archivos de registro, puede diagnosticar ciertos problemas. Por ejemplo, si una exportación o importación se ejecutó durante mucho tiempo, puede determinar si una conexión de base de datos defectuosa o la resolución de cuentas de usuario ocupó la mayor parte del tiempo.

Los comandos registrados en los archivos de registro también le indican cómo se leen o crean algunos objetos. Por ejemplo, para crear un Grupo de entrega, varios comandos no solo crean el objeto Grupo de entrega, sino también otros objetos, como las reglas de directiva de acceso que permiten asignar objetos de aplicación al Grupo de entrega.

El archivo de registro también se puede utilizar para diagnosticar una exportación o importación fallida. Normalmente, las últimas líneas del archivo de registro indican la causa del error. El mensaje de error del fallo también se guarda en el archivo de registro. Junto con el archivo XML, el archivo de registro se puede utilizar para determinar qué objeto estuvo implicado en el fallo.

Después de revisar y probar la migración, puede:

1. Actualizar los servidores de trabajo de XenApp 6.5 a los Virtual Delivery Agents (VDA) actuales ejecutando el instalador 7.6 en el servidor, lo que elimina el software de XenApp 6.5 y, a continuación, instala automáticamente un VDA actual. Consulte Actualizar un trabajador de XenApp 6.5 a un nuevo VDA para SO de Windows Server para obtener instrucciones.

   Para los servidores de trabajo de XenApp 6.0, debe desinstalar manualmente el software de XenApp 6.0 del servidor. A continuación, puede utilizar el instalador 7.6 para instalar el VDA actual. No puede utilizar el instalador 7.6 para eliminar automáticamente el software de XenApp 6.0.

2. Desde Studio en el nuevo sitio de XenApp, cree catálogos de máquinas (o edite los catálogos existentes) para los trabajadores actualizados.

3. Agregue las máquinas actualizadas del catálogo de máquinas a los Grupos de entrega que contienen las aplicaciones instaladas en esos VDA para SO de Windows Server.

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 la granja a un archivo XML. Puede utilizar parámetros de línea de comandos para controlar con mayor precisión lo que se exporta e importa.

Exportar aplicaciones parcialmente

Si tiene muchas aplicaciones y desea controlar cuántas se exportan al archivo XML, utilice los siguientes parámetros:

• AppLimit: especifica el número de aplicaciones que se van a exportar.
• SkipApps - Especifica el número de aplicaciones que se deben omitir antes de exportar las aplicaciones subsiguientes.

Puede utilizar ambos parámetros para exportar grandes cantidades de aplicaciones en bloques manejables. Por ejemplo, la primera vez que ejecute Export-XAFarm, si desea exportar solo las primeras 200 aplicaciones, especifique ese valor en el parámetro AppLimit.

Export-XAFarm -XmlOutputFile "Apps1-200.xml"
-AppLimit "200"
<!--NeedCopy-->

La próxima vez que ejecute Export-XAFarm, si desea exportar las siguientes 100 aplicaciones. Utilice el parámetro SkipApps para ignorar las aplicaciones que ya ha exportado (las primeras 200) y el parámetro AppLimit para exportar las siguientes 100 aplicaciones.

Export-XAFarm -XmlOutputFile "Apps201-300.xml"
-AppLimit "100" -SkipApps "200"
<!--NeedCopy-->

No exportar ciertos objetos

Algunos objetos se pueden ignorar y, por lo tanto, no es necesario exportarlos, especialmente aquellos objetos que no se importan. Consulte Configuración de directivas no importadas y Asignación de propiedades de aplicación. Utilice los siguientes parámetros para evitar la exportación de objetos innecesarios:

• IgnoreAdmins - No exportar objetos de administrador
• IgnoreServers - No exportar objetos de servidor
• IgnoreZones - No exportar objetos de zona
• IgnoreOthers - No exportar objetos de registro de configuración, evaluador de carga, directiva de equilibrio de carga, controlador de impresora y grupo de trabajadores
• IgnoreApps - No exportar aplicaciones. Este parámetro le permite exportar otros datos a un archivo de salida XML y, a continuación, ejecutar la exportación de nuevo para exportar aplicaciones a un archivo de salida XML diferente.

También puede utilizar estos parámetros para solucionar problemas que podrían provocar un error en 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 grupos de entrega

Si no desea colocar todas sus aplicaciones en un solo Grupo de entrega (por ejemplo, porque son accedidas por diferentes conjuntos de usuarios y publicadas en diferentes conjuntos de servidores), puede ejecutar Import-XAFarm varias veces, especificando diferentes aplicaciones y un Grupo de entrega diferente cada vez. Aunque puede utilizar cmdlets de PowerShell para mover aplicaciones de un Grupo de entrega a otro después de la migración, la importación selectiva a Grupos de entrega únicos puede reducir o eliminar el esfuerzo de mover las aplicaciones más tarde.

• Utilice el parámetro DeliveryGroupName con el cmdlet Import-XAFarm. El script crea el Grupo de entrega especificado si no existe.

• Utilice los siguientes parámetros con expresiones regulares para filtrar las aplicaciones que se importarán en el Grupo de entrega, según los nombres de carpeta, grupo de trabajadores, cuenta de usuario y servidor. Se recomienda encerrar la expresión regular entre comillas simples o dobles. Para obtener información sobre las expresiones regulares, consulte https://docs.microsoft.com/es-es/dotnet/standard/base-types/regular-expressions.

  • MatchWorkerGroup y NotMatchWorkerGroup - Por ejemplo, para las aplicaciones publicadas en grupos de trabajadores, el siguiente cmdlet importa las aplicaciones del grupo de trabajadores 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
     <!--NeedCopy-->
    

  • MatchFolder y NotMatchFolder - Por ejemplo, para las aplicaciones organizadas en carpetas de aplicaciones, el siguiente cmdlet importa las aplicaciones de la carpeta llamada 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’
     <!--NeedCopy-->
    

    Por ejemplo, el siguiente cmdlet importa las aplicaciones de cualquier carpeta cuyo nombre contenga MS Office Apps al grupo de entrega predeterminado.

     Import-XAFarm -XmlInputFile .\THeFarmApps.XML -MatchFolder ".*/MS Office Apps/.*"
     <!--NeedCopy-->
    

  • MatchAccount y NotMatchAccount - Por ejemplo, para las aplicaciones publicadas para usuarios o grupos de usuarios de Active Directory, el siguiente cmdlet importa las aplicaciones publicadas para el grupo de usuarios llamado 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’
     <!--NeedCopy-->
    

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

     Import-XAFarm -XmlInputFile XAFarm.xml -LogFile XAFarmImport.log -NotMatchServer 'Current' -DeliveryGroupName 'Legacy'
     <!--NeedCopy-->
    

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 seguimiento de los cambios en una granja de 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 puede modificar los archivos de script para cumplir con requisitos de migración específicos o avanzados, el soporte se limita a los scripts en su estado sin modificar. El Soporte técnico de Citrix recomienda volver a los scripts sin modificar para determinar el comportamiento esperado y proporcionar soporte, si es necesario.

Solución de problemas

• Si utiliza PowerShell versión 2.0 y agregó el complemento del proveedor de PowerShell de directivas de grupo de Citrix o el complemento de comandos comunes de Citrix mediante el cmdlet Add-PSSnapIn, es posible que vea el mensaje de error Object reference not set to an instance of an object al ejecutar los cmdlets de exportación o importación. Este error no afecta la ejecución del script y se puede ignorar de forma segura.

• Evite agregar o quitar el complemento del proveedor de PowerShell de directivas de grupo de Citrix en la misma sesión de consola donde se utilizan los módulos de script de exportación e importación, ya que esos módulos de script agregan automáticamente el complemento. Si agrega o quita el complemento por separado, es posible que vea uno de los siguientes errores:

  • A drive with the name 'LocalGpo' already exists. Este error aparece cuando el complemento se agrega dos veces. El complemento intenta montar la unidad LocalGpo cuando se carga y luego informa del error.
  • A parameter cannot be found that matches parameter name 'Controller'. Este error aparece cuando el complemento no se ha agregado, pero el script intenta montar la unidad. El script no sabe que el complemento se eliminó. Cierre la consola e inicie una nueva sesión. En la nueva sesión, importe los módulos de script. No agregue ni quite el complemento por separado.
• Al importar los módulos, si hace clic con el botón derecho en un archivo .psd1 y selecciona Abrir o Abrir con PowerShell, la ventana de la consola de PowerShell se abrirá y cerrará rápidamente hasta que detenga el proceso. Para evitar este error, introduzca el nombre completo del módulo de script 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 ser un administrador de XenApp con permiso para leer objetos (para exportación) o leer y crear objetos (para importación). También debe tener permisos de Windows suficientes para ejecutar scripts de PowerShell.
• Si una exportación falla, compruebe que la granja de XenApp 6.x está en un estado correcto ejecutando las utilidades DSMAINT y DSCHECK en el servidor controlador de XenApp 6.x.
• Si ejecuta una importación de vista previa y luego vuelve a ejecutar los cmdlets de importación para una migración real, pero descubre que no se importó nada, verifique que eliminó el parámetro Preview de los cmdlets de importación.

Configuración de directivas no importada

La siguiente configuración de directivas de equipo y de usuario no se importa porque ya no es compatible. Las directivas sin filtrar nunca se importan. Las funciones y los componentes que admiten esta configuración han sido reemplazados por nuevas tecnologías y componentes, o la configuración no se aplica debido a cambios arquitectónicos y de plataforma.

Configuración de directivas de equipo no importada

• Control de acceso a la conexión
• Nivel de servidor de administración de CPU
• Resolución de direcciones DNS
• Nombre de la granja
• Almacenamiento en caché completo de iconos
• Supervisión del estado, Pruebas de supervisión del estado
• Nombre de host del servidor de licencias, Puerto del servidor de licencias
• Limitar sesiones de usuario, Límites en sesiones de administrador
• Nombre del evaluador de carga
• Registro de eventos de límite de inicio de sesión
• Porcentaje máximo de servidores con control de inicio de sesión
• Optimización de memoria, lista de exclusión de aplicaciones de optimización de memoria, intervalo de optimización de memoria, programación de optimización de memoria: día del mes, programación de optimización de memoria: día de la semana, programación de optimización de memoria: hora
• Confianza del cliente de la aplicación sin conexión, registro de eventos de la aplicación sin conexión, período de licencia de la aplicación sin conexión, usuarios de la aplicación sin conexión
• Solicitar contraseña
• Advertencia personalizada de reinicio, texto de advertencia personalizada de reinicio, hora de deshabilitación de inicio de sesión de reinicio, frecuencia de programación de reinicio, intervalo de aleatorización de programación de reinicio, fecha de inicio de programación de reinicio, hora de programación de reinicio, intervalo de advertencia de reinicio, hora de inicio de advertencia de reinicio, advertencia de reinicio a usuarios, reinicios programados
• Sombreado *
• Confiar en las solicitudes XML (configurado en StoreFront™)
• Filtrado de direcciones de adaptador IP virtual, lista de programas de compatibilidad IP virtual, compatibilidad mejorada IP virtual, lista de programas de direcciones de adaptador de filtro IP virtual
• Nombre de la carga de trabajo
• Edición del producto XenApp, modelo del producto XenApp
• Puerto de servicio XML

* Sustituido por Asistencia remota de Windows

Configuración de directivas de usuario no importadas

• Puertos COM de cliente de conexión automática, puertos LPT de cliente de conexión automática
• Redirección de puertos COM de cliente, redirección de puertos LPT de cliente
• Nombres de impresoras de cliente
• Límite de inicio de sesión simultáneo
• Entrada de conexiones en la sombra *
• Intervalo del temporizador de desconexión de permanencia, Intervalo del temporizador de terminación de permanencia
• Registrar intentos de sombra *
• Notificar al usuario sobre conexiones en la sombra pendientes *
• Intervalo del temporizador de desconexión de prelanzamiento, Intervalo del temporizador de terminación de prelanzamiento
• Importancia de la sesión
• Inicio de sesión único, Almacén central de inicio de sesión único
• Usuarios que pueden hacer sombra a otros usuarios, Usuarios que no pueden hacer sombra a otros usuarios *

* Reemplazado por Asistencia remota de Windows

Tipos de aplicaciones no importados

Los siguientes tipos de aplicaciones no se importan.

• Escritorios de servidor
• Contenido
• Aplicaciones transmitidas (App-V es el nuevo método utilizado para la transmisión de aplicaciones)

Asignación de propiedades de la aplicación

El script de importación de datos de la granja importa solo aplicaciones. Las siguientes propiedades de aplicación se importan sin cambios.

IMA y FMA tienen diferentes restricciones en la longitud del nombre de la carpeta. En IMA, el límite de longitud del nombre de la carpeta es de 256 caracteres. El límite de FMA es de 64 caracteres. Al importar, las aplicaciones con una ruta de carpeta que contenga un nombre de carpeta de más de 64 caracteres se omiten. El límite se aplica solo al nombre de la carpeta dentro de la ruta de la carpeta. La ruta de la carpeta completa puede ser más larga que los límites indicados. Para evitar que las aplicaciones se omitan durante la importación, Citrix recomienda comprobar la longitud del nombre de la carpeta de la aplicación y acortarla, si es necesario, antes de exportar.

Las siguientes propiedades de aplicación se inicializan o no se inicializan de forma predeterminada, o se establecen en 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: