就地升级
“ThingWorx Navigate 安装”工具可标识先前的 ThingWorx Navigate 安装并指导您完成升级过程。
在开始升级之前，请确保您已完成本主题中的步骤。
准备就地升级
在开始升级之前，请备份您的自定义任务，并保存对拒绝列表 (以前称为黑名单) 所做的任何更改的副本。以下各部分提供了执行这些步骤的相关说明。
备份自定义任务
如果您的自定义任务是通过修改预装 ThingWorx Navigate 扩展来构建的，请进行备份，以便在升级后重新部署它们。这可防止在升级过程中覆盖这些自定义任务。有关详细信息，请参阅 ThingWorx 帮助中心的开发解决方案的最佳做法。
系统会自动升级您已使用组件创建的自定义任务。无需备份您的自定义任务。不过，最好在升级后备份您的自定义任务并查看这些任务。如果需要，可以重新部署您备份的自定义任务。
 | 升级到 ThingWorx Navigate 9.5.0 时，自定义混搭中使用的所有测试版组件都将被移除。将这些组件升级为 9.5.0 版本后，请计划更新您的混搭。 |
保存对拒绝列表所做的更改
如果对拒绝列表进行了更改，请保存所做更改的副本，以便可在升级后重新应用这些更改。有关详细信息，请参阅向拒绝列表中添加属性主题。
就地升级的先决条件
升级 ThingWorx Foundation
升级到 ThingWorx Navigate 9.5.0 之前，请确保您已使用安装程序升级到兼容的 ThingWorx Foundation 版本。请参阅下列步骤：
| | ThingWorx Foundation 9.3.x 及更高版本需要 JAVA 11。如果要从使用 JAVA 8 部署的版本进行升级，请先安装 JAVA 11，将 JAVA 8 中的相关证书导入到 JAVA 11 中，然后继续升级 ThingWorx Foundation。 |
审阅 Windchill 要求
请确保满足 Windchill 要求，之后才能开始升级 ThingWorx Navigate。
有关详细信息，请参阅先决条件主题下的“Windchill 要求”部分。
SSO 身份验证的先决条件
如果要从 ThingWorx Navigate 9.2.0 进行升级并使用 SSO 身份验证，请在开始升级之前先执行以下步骤：
1. 建议：Windchill 已启动且正在运行。如果 Windchill 关闭，则不会保留定制数据。
2. 在 sso-settings.json 文件中，将 ThingWorx Flow URL 替换为的 ThingWorx URL：
◦ 打开 sso-settings.json 文件，该文件位于 $<安装目录>\ThingworxPlatform\ssoSecurityConfig 文件夹。
◦ 在 BasicSettings 下，对于以下键，将 ThingWorx Flow URL 替换为 ThingWorx URL："clientBaseUrl" 和 "metadataEntityBaseUrl"。
以下代码片段可供参考：
{
"BasicSettings":
{
"clientBaseUrl": "ThingWorx URL",
"metadataEntityBaseUrl": "ThingWorx URL",
"idpMetadataFilePath": "C:\\PROGRA~2\\ThingWorxFoundation\\ThingworxPlatform\\ssoSecurityConfig\\sso-idp-metadata.xml",
"metadataEntityId": "NAVIGATE_SP_8443",
"webSSOProfileConsumerResponseSkew": "300",
"webSSOProfileConsumerReleaseDOM": "true",
"webSSOProfileResponseSkew": "300",
"retriggerOnScopesRemoval": "true",
"samlAssertionUserNameAttributeName": "uid",
"samlAssertionMaxAuthenticationAge": "28800"
},
"BasicSettings":
{
"clientBaseUrl": "ThingWorx URL",
"metadataEntityBaseUrl": "ThingWorx URL",
"idpMetadataFilePath": "C:\\PROGRA~2\\ThingWorxFoundation\\ThingworxPlatform\\ssoSecurityConfig\\sso-idp-metadata.xml",
"metadataEntityId": "NAVIGATE_SP_8443",
"webSSOProfileConsumerResponseSkew": "300",
"webSSOProfileConsumerReleaseDOM": "true",
"webSSOProfileResponseSkew": "300",
"retriggerOnScopesRemoval": "true",
"samlAssertionUserNameAttributeName": "uid",
"samlAssertionMaxAuthenticationAge": "28800"
},
◦ 保存 sso-settings.json 文件。
◦ 重新启动 Apache Tomcat 和 ThingWorx Integration Runtime。
固定身份验证和 Windchill 身份验证的先决条件
建议：Windchill 已启动且正在运行。如果 Windchill 关闭，则不会保留定制数据。