迁移升级
安装 ThingWorx Foundation
升级到
ThingWorx Navigate 9.x 之前,请确保您已安装兼容的
ThingWorx Foundation 版本。通过
ThingWorx Navigate Product Compatibility Matrix (《ThingWorx Navigate 产品兼容性一览表》) 确定兼容的
ThingWorx Foundation 版本。有关安装的帮助,请参阅 ThingWorx 帮助中心的
ThingWorx Foundation 安装程序主题。
准备迁移升级
在开始迁移升级之前,请为您的系统做好升级准备,并从源系统导出文件。以下各部分提供了执行这些导出的操作说明。
更新配置管理器扩展
1. 首先,删除配置管理的扩展。
a. 在
ThingWorx Composer 中,单击
“管理”,然后单击
“安装的扩展”。
b. 选择
thingworx-navigate-configuration-manager,然后单击
![](../../ThingWorx_Navigate/images/Navigate.1.041.2.jpg)
。
2. 重新启动 Apache Tomcat。
3. 现在,请导入用于配置管理的 ThingWorx Navigate 扩展,位于 ThingWorx-Navigate-Supplemental-Files-<版本>-bundle.zip 解压缩后得到的 upgrade 文件夹中。
a. 在
ThingWorx Composer 中,选择
![](../../ThingWorx_Navigate/images/Navigate.1.041.3.jpg)
> 。
b. 在“导入”窗口中,单击“浏览”并选择 thingworx-navigate-configuration-manager-upgrade<版本>.zip。
c. 单击“导入”。
4. 重新启动 Apache Tomcat。
导出所有非 Navigate 实体
接下来,我们将从 ThingWorx 导出所有实体:
1. 在 ThingWorx Composer 中,搜索并打开 DataConfigurationAPI。“常规信息”页面随即打开。
2. 单击“服务”。
3. 对于
ExportEntities,请单击
![](../../ThingWorx_Navigate/images/Navigate.1.041.4.jpg)
。
“执行服务: ExportEntities”窗口随即打开。
4. 对于“输入”,在“文件名”下,输入用于存储导出实体的文件名称。
5. 单击“执行”。系统将弹出一则成功消息,并在下列位置导出实体:$<installdir>\ThingWorxStorage\repository\NavigateFileRepository\。
导出配置
从源系统导出 ThingWorx Navigate 配置。稍后您需要将它们导入目标系统。
要将文件导出到 ThingWorx,请完成以下步骤:
1. 在 ThingWorx Composer 中,搜索并打开 DataConfigurationAPI。“常规信息”页面随即打开。
2. 单击“服务”。
3. 对于
ExportDataToFile,请单击
![](../../ThingWorx_Navigate/images/Navigate.1.041.5.jpg)
。
“执行服务: ExportDataToFile”窗口随即打开。
4. 对于“输入”,在“文件名”下,输入用于存储导出配置的文件的名称。
5. 单击“执行”。系统将弹出一则成功消息,并在下列位置导出实体:$<installdir>\ThingWorxStorage\repository\NavigateFileRepository\。
导出“我的任务”的相应配置
| 此步骤仅适用于从 ThingWorx Navigate 8.5.x 升级到 9.x 的情形。 |
从源系统中导出“我的任务”的相应配置。稍后您需要将它们导入目标系统。
要将文件导出到 ThingWorx Composer,请完成以下步骤:
1. 在 ThingWorx Composer 中,搜索并打开 DataConfigurationAPI。“常规信息”页面随即打开。
2. 单击“服务”。
3. 对于
ExportDBEntries,请单击
![](../../ThingWorx_Navigate/images/Navigate.1.041.6.jpg)
。
“执行服务: ExportDBEntries”窗口随即打开。
4. 对于“输入”,在“文件名”下,输入用于存储导出配置的文件的名称。
5. 单击“执行”。系统将弹出一则成功消息,并在下列位置导出实体:$<installdir>\ThingWorxStorage\repository\NavigateFileRepository\。
备份自定义任务
如果您的自定义任务是通过修改预装
ThingWorx Navigate 扩展来构建的,请进行备份,以便在升级后重新部署它们。这可防止在升级过程中覆盖这些自定义任务。有关详细信息,请参阅
ThingWorx 帮助中心中的
开发解决方案的最佳做法。
如果要从 ThingWorx Navigate 9.0.0 升级到 9.1.0,则使用组件创建的自定义任务会自动升级。无需备份您的自定义任务。不过,最好在升级后备份您的自定义任务并查看这些任务。如果需要,可以重新部署您备份的自定义任务。
| 升级到 ThingWorx Navigate 9.x 时,自定义混搭中使用的所有测试版组件都将被移除。将这些组件升级为 9.x 版本后,计划更新您的混搭。 |
备份已列入黑名单的属性
| 此步骤仅适用于从 ThingWorx Navigate 8.5.x 升级到 9.x 的情形。 |
如果已对列入黑名单的属性进行了某些更改,请对其进行备份,以便您可以在升级后应用这些更改。有关列入黑名单的属性的详细信息,请参阅
黑名单属性主题。
备份和卸载 ThingWorx Navigate
如果现有的 ThingWorx Navigate 是使用安装程序进行安装的,则在对同一系统执行迁移升级之前,请按照以下步骤来备份和卸载现有 ThingWorx Navigate:
| 如果在不同的系统上执行迁移升级,则无需卸载现有的 ThingWorx Navigate。 |
1. 备份以下文件夹:
◦ ThingworxPlatform
◦ ThingworxStorage
◦ <Tomcat Home>\webapps\Thingworx
2. 卸载现有的 ThingWorx Navigate。有关卸载的帮助,请参阅下列说明。
b. 在 ThingWorx Navigate 帮助中心中,搜索“卸载 ThingWorx Navigate”,然后按照所提供的步骤进行操作。