升级 ArcGIS Knowledge Server 可为组织提供软件的最新功能和增强功能。
您必须将升级 ArcGIS Knowledge Server 作为升级 ArcGIS Enterprise 部署过程的一部分。
按照建议的顺序升级部署。
- 升级 ArcGIS Enterprise 门户。
- 针对 ArcGIS Enterprise 门户升级 ArcGIS Web Adaptor。
- 升级作为门户托管服务器的 ArcGIS Server 站点。
- 针对门户托管服务器升级 ArcGIS Web Adaptor。
- 升级 ArcGIS Data Store。 将在此步骤中升级 ArcGIS Data Store 图谱存储。
- 升级部署中的任何其他 ArcGIS Server 站点,包括 ArcGIS Knowledge Server 站点。 对于 ArcGIS Knowledge Server 站点,请遵循与升级任何联合 ArcGIS Server 站点(例如门户的托管服务器)时相同的说明。 确保将该站点重新权限为 ArcGIS Knowledge Server。
ArcGIS Enterprise 部署、ArcGIS Data Store 知识图谱存储和 ArcGIS Knowledge Server 站点必须全部具有相同的软件版本。
客户端与 ArcGIS Enterprise 的兼容性
为了支持创建可访问 NoSQL 数据库中现有数据的知识图谱,已在 ArcGIS Enterprise 11.1 中引入了重大更改。 由此会在客户端应用程序(包括 ArcGIS Pro)和您的 ArcGIS Enterprise 部署之间引入兼容性问题。
ArcGIS Pro
下表介绍了 ArcGIS Pro 和 ArcGIS Enterprise 的特定组合,这些组合可用于创建知识图谱以及在调查、地图、链接图表以及搜索和过滤窗格中显示、查询和搜索知识图谱数据。
活动门户 | ArcGIS Enterprise 11.3 | ArcGIS Enterprise 11.2 | ArcGIS Enterprise 11.1 | ArcGIS Enterprise 11.0 | ArcGIS Enterprise 10.9.1 |
---|---|---|---|---|---|
ArcGIS Pro 3.3 | |||||
ArcGIS Pro 3.2 | |||||
ArcGIS Pro 3.1 | |||||
ArcGIS Pro 3.0 | |||||
ArcGIS Pro 2.9 |
如果您的工程通过先前版本的 ArcGIS Pro 创建,且该工程使用来自先前版本的 ArcGIS Enterprise 的知识图谱数据,则您必须注意确保您能够继续使用您的工程。
- 请仅将现有工程用于受支持的 ArcGIS Pro 和 ArcGIS Enterprise 版本组合。
- 请勿更新 ArcGIS Pro 或 ArcGIS Enterprise,除非可以同时对两者进行更新,且可以升级 ArcGIS Knowledge Server 站点上现有的所有知识图谱。 请等到所有更新完成后再使用现有工程。
如果未同时升级 ArcGIS Pro 和 ArcGIS Enterprise,则可能会出现以下行为:
- 如果工程包含相应调查,该调查将访问 ArcGIS Enterprise 11.1 或更高版本门户上的知识图谱,并且您使用 ArcGIS Pro 3.0 或更早版本打开该工程,则无法在该工程中使用知识图谱中的数据。 如果在已保存的工程中打开任何显示知识图谱数据的调查、地图或链接图表,则您可能根本无法打开该工程。
- 如果您的工程包含相应调查,该调查将访问 ArcGIS Enterprise 11.0 或更早版本门户上的知识图谱,并且您在 ArcGIS Pro 3.1 或更高版本中打开该工程,则无法在该工程中使用知识图谱中的数据。 任何调查、链接图表以及搜索和过滤窗格都将显示消息:服务器不兼容。 地图中的任何知识图谱图层都将显示已损坏数据源按钮 。 在 ArcGIS Enterprise 部署升级至 11.1 或更高版本之前,请在先前版本的 ArcGIS Pro 中使用工程。 对于 ArcGIS Pro 3.2,如果您在新的或已升级 11.1 或更高版本的 ArcGIS Enterprise 部署上新建知识图谱,则可以在地图或链接图表中修复知识图谱图层的数据源。
使用开发人员 API 的应用程序
如果您使用其中一个可用的开发人员 API 创建了可与 ArcGIS Knowledge Server 站点进行通信的自定义应用程序,则您的应用程序将具有与 ArcGIS Pro 相同的兼容性问题。 现有客户端应用程序只能与 ArcGIS Enterprise 10.9.1 和 11.0 部署中可用的知识图谱进行通信。
您必须更新您的客户端应用程序以使用更新版本的开发人员 API,该 API 支持与 ArcGIS Enterprise 11.1 或更高版本部署中可用的 ArcGIS Knowledge Server 站点进行通信。
- ArcGIS REST API - ArcGIS REST API 中的许多操作通过以 Protocolbuffer Binary Format (PBF) 格式发送请求和接收响应来与知识图谱进行通信。 每个 PBF 请求和响应的格式由相应的 .proto 文件定义。 必须使用不同版本的 .proto 文件相应地构建请求或响应,具体取决于 ArcGIS Enterprise 部署的版本。 用于与 ArcGIS Enterprise 11.1 或更高版本部署进行通信的 PBF 格式不同于 ArcGIS Enterprise 10.9.1 和 11.0 部署。 必须更新现有应用程序,才能在 ArcGIS Enterprise 11.1 或更高版本部署中与知识图谱进行通信。
- ArcGIS API for Python - 基于 ArcGIS API for Python 2.0.1 版本的应用程序只能在 ArcGIS Enterprise 10.9.1 或 11.0 部署中与知识图谱进行通信。 只有基于 ArcGIS API for Python 2.1.0 或更高版本的应用程序才能在 ArcGIS Enterprise 11.1 或更高版本部署中与知识图谱进行通信。
- ArcGIS API for JavaScript - 基于 ArcGIS API for JavaScript 4.25 版本的应用程序只能在 ArcGIS Enterprise 10.9.1 或 11.0 部署中与知识图谱进行通信。 只有基于 ArcGIS API for JavaScript 4.26 或更高版本的应用程序才能在 ArcGIS Enterprise 11.1 或更高版本部署中与知识图谱进行通信。
从 ArcGIS Enterprise 11.0 进行升级
升级 ArcGIS Enterprise 11.0 部署后,您可能会注意到已升级的知识图谱和新知识图谱报告自身正在进行托管的方式以及相关知识图谱服务在 ArcGIS Knowledge Server 站点上的存储位置将有所不同。
在 ArcGIS Enterprise 10.9.1 和 11.0 部署中,所有知识图谱均显示为托管项目。 此外,与每个知识图谱关联的知识图谱服务器服务将存储在 ArcGIS Knowledge 站点上的 Hosted 文件夹中。 将部署升级至 11.1 或更高版本时,所有现有知识图谱服务器服务将保留在站点上的 Hosted 文件夹中。 但是,使用 NoSQL 数据存储的知识图谱不再显示为正在进行托管。
在 ArcGIS Enterprise 11.1 或更高版本部署中,专门使用 ArcGIS Data Store 图谱存储的新知识图谱服务的处理方式与以前相同。 知识图谱将显示为已托管,其关联的知识图谱服务器服务将存储在 ArcGIS Knowledge 站点上的 Hosted 文件夹中。 但是,使用 NoSQL 数据存储的新知识图谱将不会显示为正在进行托管,并且其关联的知识图谱服务器服务将存储在 ArcGIS Knowledge 站点上的新 Knowledge 文件夹中。 所有使用 NoSQL 数据存储的知识图谱均以相同的方式进行处理。
将部署升级至 11.1 或更高版本时,与现有知识图谱关联的 ArcGIS Enterprise 11.0 部署中的所有 NoSQL 数据存储都会成功升级。 但是,如果未创建知识图谱以使用 NoSQL 数据存储,或者如果知识图谱已删除,并且 NoSQL 数据存储仍然存在,则无法将数据存储升级。 您必须删除任何未使用的 NoSQL 数据存储,并在 11.1 或更高版本部署中重新创建这些数据存储,然后才能将其与新知识图谱配合使用。
从 ArcGIS Enterprise 10.9.1 进行升级
ArcGIS Enterprise 10.9.1 和 11.0 版本之间的 ArcGIS Knowledge 许可发生了变化。 对于 ArcGIS Enterprise 10.9.1,通过在 Enterprise 门户中为授权用户分配用户类型扩展模块来对 ArcGIS Knowledge 进行许可。 需要利用用户类型扩展模块来访问、分析、更新和创建知识图谱。
但是,自 ArcGIS Enterprise 11.0 版本起,可将联合服务器许可为 ArcGIS Knowledge 站点。 个人用户必须登录到 Enterprise 门户,才能在与该门户联合的 ArcGIS Knowledge 站点上访问、分析、更新和创建知识图谱。 您必须在 Enterprise 门户中分别为每位用户分配足够的权限以完成其工作。
使用上述工作流将 ArcGIS Enterprise 10.9.1 部署升级至更新版本后,请以门户管理员身份登录到 Enterprise 门户以移除之前已分配的 ArcGIS Knowledge 用户类型扩展模块,因为其不再适用。 当您登录到门户后,将显示一条消息,指示分配给您组织成员的许可数量超过可用的许可数量。
单击组织选项卡上,然后单击许可选项卡。 用户类型扩展模块标题下将显示一条警告,指示 ArcGIS Knowledge 用户类型扩展模块已过期。
对于所有拥有 ArcGIS Knowledge 用户类型扩展模块的用户,取消分配该扩展模块。 如果您未对组织的可用许可进行任何其他更改,则下次登录到 Enterprise 门户时,不应显示许可警告。