Product Documentation

启用和运行 XenMobile 升级工具

Feb 27, 2017

如果您的 XenMobile 9 环境满足以下必备条件,请按照本部分中的步骤进行升级。

  • XenMobile 9 MDM Edition 或 Enterprise Edition 带有一个外部 SQL Server 数据库。
  • SQL Server 数据库在非默认命名实例上运行。
  • SQL Server 命名实例在静态或动态 TCP 端口上侦听。可以通过查看命名实例的 TCP/IP 协议的 IP 地址来确认此必备条件,如下图所示。

注意

Citrix 建议 SQL Server 数据库实例始终在静态端口上运行,因为 XenMobile 服务器需要继续访问该数据库。此连接通常通过防火墙遍历。因此,您需要在防火墙中打开恰当的端口,并且需要在静态端口上运行数据库实例。

localized image
localized image

升级前步骤

1. 转至 Device Manager 安装目录并打开 ew-config.properties 文件。此文件位于 tomcat\webapps\zdm\WEB-INF\classes 中。

localized image

2. 在 ew-config.properties 文件中,在“DATASOURCE Configuration”部分中搜索以下 URL:

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

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

localized image

3. 删除上述 URL 中的实例名称,然后添加端口以及 SQL Server FQDN。在这种情况下,必需端口为 64940。

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

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

注意

Citrix 建议您先备份、复制或记录在 ew-config.properties 文件中所做的更改。此信息在升级失败时非常有用。

localized image

4. 重新启动 Device Manager 服务。Device Manager 实例重新启动后刷新设备连接。

localized image

5. 确定新 XenMobile 10.x 服务器是否需要与命名 SQL 实例一起运行。如果需要,请识别运行命名实例的端口。如果该端口为动态端口,Citrix 建议您将该端口转换为静态端口。稍后,在升级过程中执行到数据库设置的以下部分时,请在新 XenMobile 服务器上配置该静态端口。

localized image

现在,您可以继续升级。

升级群集 XenMobile 部署

如果将系统配置为群集模式:

1. 关闭除要先升级的节点以外的所有节点。要关闭节点,请在命令行接口中使用设置

2. 升级仍在运行的节点,如下一节“启用和运行升级工具”中所述。

3. 确保第一个升级按预期完成后,逐个重新加入其余的每个节点。重新加入节点:

a. 重新启动节点。

b. 请勿升级节点(如果提示)。

c. 将节点加入群集数据库。

将节点重新加入群集后,XenMobile 将自动升级节点。

4. 在将节点重新加入群集后,在每个节点上执行所有后续任务。

启用和运行升级工具

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

Important

如果要生成系统快照,请在完成最新版本的 XenMobile 的初始配置之后、使用升级工具之前进行。

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

2. 键入 y 提交设置。

localized image

3. 键入 y 进行升级。

注意

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

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 环境和新环境的 FQDN 必须匹配。

localized image

7. 键入 y 提交设置。

8. 设置通信端口。

localized image

9. 键入 y 提交设置。

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

11. 键入 y 提交设置。

localized image

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

13. 键入 y 提交设置。

XenMobile 启用一次性升级工具。

localized image

14. 在 Web 浏览器中键入 https:///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 上的 \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 所需的所有文件。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 实例并重新启动升级过程。不能使用浏览器的“返回”按钮返回到之前的页面并更正信息。

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

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

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

localized image

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

localized image

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

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

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

localized image

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