Product Documentation

Cómo habilitar y ejecutar XenMobile Upgrade Tool

Mar 02, 2017

Si el entorno de XenMobile 9 cumple los requisitos siguientes, siga los pasos indicados en esta sección antes de actualizar. 

  • La edición XenMobile 9 MDM o Enterprise tiene una base de datos SQL Server externa.
  • Una base de datos SQL Server se ejecuta en una instancia no predeterminada con nombre.
  • La instancia SQL Server con nombre escucha en un puerto TCP estático o dinámico. Puede verificar este requisito consultando las direcciones IP del protocolo TCP/IP de la instancia con nombre, como se ven en las siguientes imágenes.

Nota

Citrix recomienda que la instancia de la base de datos de SQL Server se ejecute siempre en un puerto estático, porque el servidor XenMobile necesita acceso continuo a la base de datos. Esta conexión, por lo general, atraviesa un firewall. Como resultado de ello, necesita abrir el puerto correspondiente en el firewall; por lo tanto, necesita tener la instancia de la base de datos ejecutándose en un puerto estático.

localized image
localized image

Pasos previos a la actualización

1. Vaya al directorio de instalación de Device Manager y abra el archivo ew-config.properties. Este se encuentra en tomcat\webapps\zdm\WEB-INF\classes.

localized image

2. En el archivo ew-config.properties, busque las siguientes URL en la sección DATASOURCE Configuration:

pooled.datasource.url= jdbc:jtds:sqlserver:///;instance=

audit.datasource.url= jdbc:jtds:sqlserver:///;instance=

localized image

3. Quite el nombre de la instancia en las direcciones URL anteriores, y añada el puerto y el nombre de dominio completo (FQDN) del servidor SQL Server. En este caso, el puerto necesario es el 64940: 

pooled.datasource.url=jdbc:jtds:sqlserver:// :64940/

audit.datasource.url=jdbc:jtds:sqlserver:// :64940/

Nota

Citrix recomienda hacer una copia de seguridad, copiar o tomar nota de los cambios realizaos en el archivo ew-config.properties. Esta información puede servir de ayuda en caso de que falle la actualización.

localized image

4. Reinicie el servicio de Device Manager. Actualice la vista de las conexiones de dispositivos tras el reinicio de la instancia de Device Manager. 

localized image

5. Determine si el nuevo servidor XenMobile 10.x también necesita funcionar con la instancia SQL con nombre. En ese caso, identifique el puerto en el que se está ejecutando la instancia con nombre. Si el puerto es dinámico, Citrix recomienda que convierta que lo convierta en estático. Posteriormente, cuando llegue a la parte siguiente de la instalación de la base de datos durante la actualización, configure el puerto estático en el nuevo servidor XenMobile.

localized image

Puede proceder con la actualización.

Para actualizar implementaciones de XenMobile en clúster

Si el sistema está configurado en modo de clúster:

1. Apague todos los nodos salvo el que quiera actualizar primero. Para apagar un nodo, use Settings en la interfaz de línea de comandos.

2. Actualice el nodo que aún se está ejecutando como se describe en la sección siguiente, "Para habilitar y ejecutar la herramienta de actualización Upgrade Tool".

3. Tras comprobar que la actualización haya ocurrido según lo previsto, vuelva a unir cada uno de los nodos restantes, de uno en uno. Para volver a unir:

a. Reinicie el nodo.

b. No actualice el nodo si el sistema se lo solicita.

c. Una el nodo a la base de datos del clúster.

XenMobile actualizará automáticamente un nodo después de volver a unirlo al clúster.

4. Realice todas las tareas de requisitos posteriores en cada nodo después de volverlo a unir al clúster.

Para habilitar y ejecutar la herramienta de actualización Upgrade Tool

Habilite y ejecute la herramienta Upgrade Tool desde la interfaz de línea de comandos (CLI) la primera vez que instale XenMobile 10.4.

Important

Si quiere tomar una instantánea del sistema, hágalo después de la configuración inicial de XenMobile 10.4 y antes de acceder a la herramienta de actualización.

1. En la interfaz de línea de comandos, introduzca el nombre de usuario y la contraseña de administrador y especifique los parámetros de red.

2. Introduzca y para confirmar los parámetros.

localized image

3. Escriba y para actualizar.

Nota

Si no selecciona "y" aquí, deberá configurar una nueva instancia de XenMobile 10.4 en la consola de línea de comandos e iniciar la herramienta de actualización de nuevo. 

4. Seleccione si quiere generar una frase secreta aleatoria y si quiere habilitar FIPS. Introduzca la información de conexión de base de datos.

5. Introduzca y para confirmar los parámetros.

localized image

 XenMobile inicializa la base de datos.

localized image

6. Seleccione si quiere habilitar servidores en clúster. Introduzca el nombre de dominio completo (FQDN) de XenMobile. Tenga en cuenta lo siguiente:

  • Para implementaciones de XenMobile Enterprise Edition, el nombre FQDN el mismo que el nombre FQDN de XenMobile 9.0 MDM.
  • Para implementaciones de MAM, el nombre FQDN el mismo que el nombre FQDN de XenMobile 9.0 App Controller.
  • Para implementaciones de MDM, el nombre FQDN el mismo que el nombre FQDN de XenMobile 9.0 Device Manager.

Important

Debe coincidir el nombre de dominio completo (FQDN) de los entornos 9.0 y 10.4.

localized image

7. Escriba y para confirmar los parámetros.

8. Establezca los puertos de comunicación.

localized image

9. Escriba y para confirmar los parámetros.

10. Seleccione si utilizar la misma contraseña para todos los certificados y escriba la contraseña que se utilizará para los certificados.

11. Escriba y para confirmar los parámetros.

localized image

12. Introduzca el nombre de usuario y la contraseña del administrador de la consola de XenMobile.

13. Escriba y para confirmar los parámetros.

XenMobile 10.4 habilita la herramienta de actualización Upgrade Tool de un solo uso.

localized image

14. Acceda a la herramienta de actualización Upgrade Tool desde un explorador Web con https://<XenMobile-Server-IPAddress>/uw/ e inicie sesión con las credenciales que ha especificado en la interfaz de línea de comandos.

localized image

15. Ahora puede elegir entre una actualización de prueba y una actualización de producción. Estas instrucciones son para una actualización de producción. En la página Upgrading XenMobile, haga clic en Upgrade.

localized image

16. En la página Edition to Upgrade, seleccione la edición. En el ejemplo siguiente, aparece seleccionada la edición Enterprise.

localized image

17. Haga clic en Siguiente.

     Si actualiza una edición Enterprise o MDM, aparecerá la página Device Manager. Siga los pasos del 18 al 22 para completar esta página.

     Si actualiza una edición MAM, vaya al paso 23 para completar la página App Controller.

18. Recopile los archivos necesarios para migrar los datos existentes de XenMobile 9.0 Device Manager. También obtendrá acceso a la URL y nombre de usuario de la base de datos que copiará en la página Device Manager.

a. Haga clic en el enlace indicado en el paso 1 de la página Device Manager y guarde el archivo descargado help-upgrade.zip.

b.  Extraiga el archivo help-upgrade.jsp en <ruta de instalación de MDM>\tomcat\webapps\zdm en el XenMobile 9.0 Device Manager existente.

localized image

c. En una ventana del explorador, inicie sesión en el servidor XenMobile 9.0.

d. En un explorador Web, escriba la dirección URL: https://localhost/zdm/help-upgrade.jsp. Se abre la página XenMobile MDM Upgrade Helper, que recopila y comprime todos los archivos de XenMobile 9.0 necesarios para la actualización a XenMobile 10.4. A continuación, el archivo zip comprimido se guarda en la base de datos del servidor desde donde se extrae.

e. Haga clic en Zip it y luego siga las instrucciones en pantalla para reunir los archivos necesarios para la actualización.

localized image

19. En Result, copie la URL y péguela en el campo Database URL en la página Device Manager de la herramienta Upgrade Tool. A continuación, copie el nombre de usuario y péguelo en la página Device Manager.

localized image

20. En la herramienta Upgrade Tool:

a. Escriba la contraseña y, a continuación, haga clic en Validate Connection.

b. Escriba la contraseña para cada certificado y, a continuación, haga clic en Validate Password.

localized image

21. Haga clic en Siguiente.

22. Si cambió el archivo ew-config.properties, reinicie el servicio XDM en XenMobile 9 MDM y, a continuación, vaya a https://localhost/zdm/help-upgrade.jsp para comprimir de nuevo. Con ello, el archivo ew-config.properties vuelva a leerse y se guarda en la base de datos de XenMobile MDM 9 para prepararse a la migración.

23. A continuación, aplicará una revisión de actualización en App Controller. Luego, generará y cargará un paquete de asistencia. Empiece por seguir las instrucciones de la sección 1 de la página App Controller para actualizar App Controller.

localized image

25. Continúe con las instrucciones de la sección 2 de la página App Controller:

     a. En la consola de línea de comandos de App Controller, escriba 4 y, a continuación, presione ENTRAR para abrir el menú Troubleshooting.

localized image

b. En el menú Troubleshooting, escriba 3 y, a continuación, presione ENTRAR para abrir el menú Support Bundle.

localized image

c. En el menú Support Bundle, escriba 1 y, a continuación, presione ENTRAR y siga las instrucciones.

     Nota: Debe cifrar el paquete de asistencia.

localized image

26. En la sección 3 de la página App Controller, especifique el paquete de asistencia y luego haga clic en Upload.

La herramienta Upgrade Tool procesará los archivos recopilados (para las ediciones XenMobile Enterprise y MAM) y el paquete de asistencia. Este paso puede tardar más de 15 minutos si está migrando una gran cantidad de usuarios. 

27. Haga clic en Next. Aparecerá el cuadro de diálogo de confirmación Start.

localized image

28. Haga clic en Start. Aparecerá la página Upgrade Progress con indicadores de progreso para facilitar el seguimiento de la actualización de datos desde XenMobile 9.0. Cuando se complete la actualización, los indicadores de progreso estarán al 100 % y el botón Next se habilitará.

localized image

Nota

Si la actualización falla, consulte los registros para averiguar el motivo del error. A continuación, debe importar una nueva instancia de XenMobile 10.4 y reiniciar el proceso de actualización. No puede usar el botón Atrás del explorador Web para volver a las páginas anteriores y corregir información.

La página Upgrade Progress le notificará cuando la actualización se haya completado correctamente. 

29. Haga clic en Next. Aparecerá la página Upgrade Summary.

     Si actualiza una edición Enterprise o MAM, la página Upgrade Summary puede tener el siguiente aspecto:

localized image

     Si actualiza una edición MDM, la página Upgrade Summary puede tener el siguiente aspecto:

localized image

30. Haga clic en el icono Upgrade log para descargar los registros. Asegúrese de descargar los registros antes de abandonar esta página.

Citrix recomienda que revise el archivo de registros para determinar las directivas, las configuraciones y los datos de usuario, etc., que se han actualizado o no a XenMobile 10.4.

31. Después de descargar los registros de actualización, haga clic en Next. Aparecerá la página Next Steps.

localized image

Para obtener instrucciones relacionadas con estos pasos, consulte Requisitos posteriores de la herramienta de actualización.