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