Product Documentation

启用和运行 XenMobile 升级工具

Nov 29, 2016

If your XenMobile 9 environment meets the following prerequisites, follow the steps in this section before proceeding with the upgrade. 

  • XenMobile 9 MDM Edition or Enterprise Edition has an external SQL Server database.
  • SQL Server database runs on a non-default named instance.
  • SQL Server named instance listens on a static or dynamic TCP port. You can confirm this prerequisite by looking at the IP addresses of the TCP/IP protocol of the named instance as shown in the following figures.

注意

Citrix recommends that the SQL server database instance always runs on a static port, because the XenMobile server needs continuing access to the database. This connection generally traverses through a firewall. As a result, you need to open the appropriate port in the firewall; therefore, you the need to have the database instance running on a static port.

localized image
localized image

Pre-upgrade steps

1. Go to the Device Manager installation directory and open the ew-config.properties file. This file is available in tomcat\webapps\zdm\WEB-INF\classes.

localized image

2. In the ew-config.properties file, search for the following URLs in the DATASOURCE Configuration section:

pooled.datasource.url= jdbc:jtds:sqlserver://<SQLserver_FQDN>/<DB_Name>;instance=<Instance_Name>

audit.datasource.url= jdbc:jtds:sqlserver://<SQLserver_FQDN>/<DB_Name>;instance=<Instance_Name>

localized image

3. Remove the instance name in the preceding URLs, then add the port and SQL Server FQDN. In this case, 64940 is the required port. 

pooled.datasource.url=jdbc:jtds:sqlserver:// <SQLserver_FQDN>:64940/<DB_Name>

audit.datasource.url=jdbc:jtds:sqlserver:// <SQLserver_FQDN>:64940/<DB_Name>

注意

Citrix recommends that you make a backup, copy, or note of the changes you make in the ew-config.properties file. This information is helpful in case the upgrade fails.

localized image

4. Restart the Device Manager service. Refresh the device connections after the Device Manager instance restarts. 

localized image

5. Determine if the new XenMobile 10.x server also needs to work with named SQL instance. If so, identify the port on which the named instance is running. If the port is a dynamic port, Citrix recommends that you convert the port to a static port. Later, when you reach the following portion of the database setup during the upgrade, configure the static port on the new XenMobile server.

localized image

You can now proceed with the upgrade.

升级群集 XenMobile 部署

If your system is configured in cluster mode:

1. Shut down all nodes other than the one you will upgrade first. To shut down a node, use Settings in the command-line interface.

2. Upgrade the node that's still running, as described in the next section, "To enable and run the Upgrade Tool."

3. After you've ensured that the first upgrade has upgraded as expected, rejoin each of the remaining nodes, one at a time. To rejoin:

a. Restart the node.

b. Do not upgrade the node if prompted.

c. Join the node to the cluster's database.

XenMobile will automatically upgrade a node after you rejoin it to the cluster.

4. Perform all post-requisite tasks on each node after you rejoin it to the cluster.

启用和运行升级工具

首次安装 XenMobile 10.4 时,请通过命令行接口 (CLI) 启用升级工具。

Important

如果要生成系统快照,请在 XenMobile 10.4 初始配置之后、访问升级工具之前进行。

1. 在 CLI 中,键入您的管理员用户名和密码,然后输入网络设置。

2. 键入 y 提交设置。

localized image

3. 键入 y 进行升级。

注意

如果您不在此处选择 y,则必须在命令行控制台配置新的 XenMobile 10.4 实例并重新启动升级工具。 

4. 选择生成随机密码,以及启用 FIPS(可选)。 输入数据库连接信息。

5. 键入 y 提交设置。

localized image

 XenMobile 初始化数据库。

localized image

6. 选择是否启用群集服务器。 键入 XenMobile 的完全限定域名 (FQDN)。 请注意以下问题:

  • 对于 XenMobile Enterprise Edition 部署,FQDN 与 XenMobile 9.0 MDM FQDN 相同。
  • 对于 MAM 部署,FQDN 与 XenMobile 9.0 App Controller FQDN 相同。
  • 对于 MDM 部署,FQDN 与 XenMobile 9.0 Device Manager FQDN 相同。

Important

用于 9.0 环境和 10.4 环境的 FQDN 必须匹配。

localized image

7. 键入 y 提交设置。

8. 设置通信端口。

localized image

9. 键入 y 提交设置。

10. 选择是否为所有证书使用相同的密码,然后键入要对证书使用的密码。

11. 键入 y 提交设置。

localized image

12. 键入 XenMobile 控制台管理员的用户名和密码。

13. 键入 y 提交设置。

XenMobile 10.4 启用一次性升级工具。

localized image

14. 在 Web 浏览器中键入 https://<XenMobile 服务器 IP 地址>/uw/ 访问升级工具,然后使用在 CLI 中指定的凭据进行登录。

localized image

15. 现在可以在试用与生产升级之间进行选择。 这些说明适用于生产升级。 在 Upgrading XenMobile(升级 XenMobile)页面上,单击 Upgrade(升级)。

localized image

16. 在 Edition to Upgrade(要升级的版本)页面中,选择您的版本。 下面的屏幕示例显示了选择 Enterprise Edition 时的情况。

localized image

17. 单击下一步

     如果正在升级 Enterprise 或 MDM Edition,则会显示 Device Manager 页面。 按照步骤 18 至 22 完成此页面上的操作。

     如果正在升级 MAM Edition,请跳到步骤 23 完成 App Controller 页面上的操作。

18. 收集迁移现有 XenMobile 9.0 Device Manager 数据所需的文件。 您还将获得访问数据库 URL 的权限以及要复制到 Device Manager 页面的用户名。

a. 单击 Device Manager 页面的步骤 1 中的链接并保存下载的 help-upgrade.zip 文件。

b.  将 help-upgrade.jsp 文件解压到现有 XenMobile 9.0 Device Manager 上的 <MDM-Install-Path>\tomcat\webapps\zdm。

localized image

c. 在浏览器窗口中,登录到 XenMobile 9.0 服务器。

d. 在单独的浏览器选项卡中,输入以下 URL:https://localhost/zdm/help-upgrade.jsp。 此时将打开 XenMobile MDM Upgrade Helper(XenMobile MDM 升级帮助程序)页面,用于收集并打包从 XenMobile 9.0 升级到 XenMobile 10.4 所需的所有文件。 zip 文件随后将存储到服务器数据库中,将从该位置解压。

e. 单击 Zip it(打包),然后按照屏幕上显示的步骤进行操作,收集升级所需的文件。

localized image

19. 在 Result(结果)下,复制 URL 并将其粘贴到升级工具的 Device Manager 页面的 Database URL(数据库 URL)字段中。 然后复制用户名并将其复制到 Device Manager 页面。

localized image

20. 在升级工具中:

a. 输入密码,然后单击 Validate Connection(验证连接)。

b. 输入每个证书的密码,然后单击 Validate Password(验证密码)。

localized image

21. 单击下一步

22. 如果更改了 ew-config.properties 文件,请在 XenMobile 9 MDM 上重新启动 xdm 服务,然后访问 https://localhost/zdm/help-upgrade.jsp 以重新打包文件。 这样会重新读取 ew-config.properties 文件,并将其保存至 XenMobile MDM 9 数据库以准备迁移。

23. 下一步,您将对 App Controller 应用升级修补程序,然后生成并上载一个支持包。 首先,请按照 App Controller 页面第 1 部分的说明升级 App Controller。

localized image

25. 继续按照 App Controller 页面第 2 部分的说明执行操作:

     a. 在 App Controller 命令行控制台中,键入 4,然后按 Enter 键打开“Troubleshooting”(故障排除)菜单。

localized image

b. 在“Troubleshooting”(故障排除)菜单中,键入 3,然后按 Enter 键打开“Support Bundle”(支持包)菜单。

localized image

c. 在“Support Bundle”(支持包)菜单中,键入 1,按 Enter 键,然后按命令提示进行操作。

     注意:必须加密支持包。

localized image

26. 在 App Controller 页面的第 3 部分中,指定支持包,然后单击 Upload(上载)。

升级工具处理收集的文件(针对 XenMobile Enterprise 和 MAM Edition)和支持包。 如果要迁移大量用户,此步骤可能需要 15 分钟以上的时间。 

27. 单击下一步。 此时将显示 Start(开始)确认对话框。

localized image

28. 单击 Start(开始)。 此时将显示包含进度指示条的 Upgrade Progress(升级进度)页面,让您可以跟踪从 XenMobile 9.0 进行的数据升级。 升级完成时,进度指示条将指示 100%,并启用 Next(下一步)按钮。

localized image

注意

如果升级失败,可以查看日志以了解失败的原因。 然后,需要导入新的 XenMobile 10.4 实例并重新启动升级过程。 不能使用浏览器的“返回”按钮返回到之前的页面并更正信息。

“Upgrade Progress”(升级进度)页面可以显示升级成功完成的时间。 

29. 单击下一步。 此时将显示 Upgrade Summary(升级摘要)页面。

     如果正在升级 Enterprise 或 MAM Edition,Upgrade Summary(升级摘要)页面可能类似如下内容所示:

localized image

     如果正在升级 MDM Edition,Upgrade Summary(升级摘要)页面可能类似如下内容所示:

localized image

30. 单击 Upgrade log(升级日志)图标下载日志。 请务必在离开此页面之前下载日志。

Citrix 建议您查看日志以确定已升级或未升级到 XenMobile 10.4 的策略、设置、用户数据等信息。

31. 下载升级日志后,单击 Next(下一步)。 此时将显示 Next Steps(后续步骤)页面。

localized image

有关这些步骤的相关说明,请参阅升级工具后续条件