配置 ArcGIS Data Store 时,需要将其与用作门户托管服务器的 GIS Server 站点关联。 可以从托管服务器的 ArcGIS Server 管理员目录中作为 ArcGIS Server 管理员执行更改或检查数据存储状态的操作。 (URL 格式为 https://gisserver.domain.com:6443/arcgis/admin。)您也可以从以主-备用模式运行的关系数据存储或切片缓存数据存储中移除备用计算机,并从 ArcGIS Server 管理员目录的 GIS Server 站点移除备用计算机。 以下章节概述了这些操作和 ArcGIS API 文档的链接。
如果您不是托管服务器的 ArcGIS Server 管理员,您需要与管理员合作完成此处描述的任务。
以下是 ArcGIS Server 管理员目录中的路径,您需要按照这些路径,访问每个数据存储类型的操作:
- 关系数据存储 - 单击数据 > 项目 > enterpriseDatabases > <数据存储名称> > 计算机 > <计算机名称>。
- 时空大数据存储 - 单击数据 > 项目 > nosqlDatabases > AGSDataStore_bigdata_<数据存储名称> > 计算机 > <计算机名称>。
- 切片缓存数据存储 - 单击数据 > 项目 > nosqlDatabases > AGSDataStore_bigdata_<数据存储名称> > 计算机 > <计算机名称>。
- 图谱存储 - 单击数据 > 项目 > nosqlDatabases > AGSDataStore_graph_<数据存储名称> > 计算机 > <计算机名称>。
- 对象存储 - 单击数据 > 项目 > objectStores > <数据存储名称> > 计算机 > <计算机名称>。
更改数据存储计算机的状态
您可以停止或重新启动数据存储中的各计算机。 您还可以将备用关系数据存储、切片缓存数据存储或图谱存储计算机升级为数据存储主要计算机。
由于您在执行维护任务(如临时离线使用数据存储)时可能不希望出现任何故障,所以请停止主数据存储计算机,因为这么做不会导致数据存储在预置部署上出现故障。
例如,将数据存储计算机状态作为以下升级场景的一部分进行更改:
- 停止备用计算机。
- 升级备用计算机。
- 启动备用计算机。
- 使用 makePrimary 命令将备用计算机升级为主要计算机。
- 停止以前的主要计算机。
- 升级以前的主要计算机。
- 启动以前的主要计算机。
- 将以前的主要计算机作为备用计算机再次添加到数据存储。
以 ArcGIS Server 站点管理员的身份登录到托管服务器 ArcGIS Server 管理员目录并转到特定计算机,以使用以下任意命令更改数据存储计算机的状态:
- stop
- start
- makePrimary(仅在主-备用模式下的关系数据存储、图谱存储或切片缓存数据存储中的备用计算机)
验证数据存储
您可以使用验证 ArcGIS Server REST 命令检查数据存储中的计算机状态。
以 ArcGIS Server 站点管理员的身份登录到 ArcGIS Server Administrator Directory,前往您希望检查的特定数据存储类型的其中一台计算机,然后单击验证,查看与此数据存储相关的信息。 与数据存储状态相关的重要信息包括以下内容:
- overallhealth - 值如下:
- Healthy - 所有成员计算机上的所有组件都可以访问并且工作正常。
- HealthyWithWarning - 此状态仅适用于关系数据存储、对象存储和图谱存储。 一个或多个组件不可用,但数据存储仍然可用。 当主计算机状态良好,备用计算机不可用时,会为图谱存储和关系数据存储返回此值。 此时,图谱存储或关系数据存储不具备高可用性。 对于包含多台计算机的对象存储,数据存储可能不具备高可用性,具体取决于集群中的计算机数量。
- Unhealthy - 如果数据存储中超过一半的计算机无法访问,则此数据存储将被视为不健康 ("datastore.overallhealth": "Unhealthy")。 如果计算机无法访问,则会被视为不健康 ("machine.overallhealth": "Unhealthy")。
- status - 对于关系或切片缓存数据存储,可能的值有:已开始或已停止。 停止时,您无法向您的门户发布托管要素图层或托管场景图层。
- clusterStatus - 对于时空大数据存储,有以下状态:
- green - 所有数据均可用。
- yellow - 数据可用,但是数据的部分或全部复本不可用,且您的时空大数据存储当前不处于高度可用状态。 如果您配置了单击时空大数据存储,将始终看见该状态。 如果计算机正在重新平衡数据,或者时空大数据存储中的一或多台计算机无法访问时,您也可能看见该状态。 如果您拥有多机时空大数据存储,并看到黄色状态,请通过验证每台计算机来确认所有计算机仍然可用。 如果计算机均可用,请等待几个小时,再重新检查。 如果状态仍然是黄色,请检查 ArcGIS Server 日志来查找错误。
- red - 部分或所有数据无法访问。 检查日志并纠正错误。
- role - 该状态仅应用到关系数据存储、图谱存储或主-备用切片缓存数据存储中的计算机,用于指示计算机为主计算机还是备用计算机。 对于对象存储,角色将为对应单个实例的主要角色,以及对应以聚类模式部署的对象存储的 cluster_member 角色。
- messages - 您可以在此处看到与数据存储状态相关的警告和错误消息。 例如,如果您验证一个多机切片缓存数据存储,那么若场景缓存数据目前不具有较高的可用性(换言之,其中一个或多个场景缓存只有一个副本),您将收到消息。
您可以使用验证进行以下操作:
- 确认数据存储计算机已停止或启动。
- 确认 makePrimary 命令已将备用计算机提升为主计算机。
- 确定切片缓存数据存储是否处于高可用状态。
- 作为初始故障排除步骤,如果无法发布或访问托管要素或场景图层、无法创建或访问知识图谱或者无法运行 GeoAnalytics Tools。
移除备用计算机
您可以使用移除 ArcGIS Server REST 命令从关系数据存储或主-备用切片缓存数据存储中移除备用计算机。 例如,如果您希望将其他计算机用于备用计算机,您可以从数据存储中移除旧的备用计算机,然后在新计算机上安装 ArcGIS Data Store 并将新计算机配置为备用计算机。
以 ArcGIS Server 站点管理员的身份登录到托管服务器 ArcGIS Server Administrator Directory 以使用移除命令。
管理托管要素图层的查询响应缓存
对于被频繁查询的托管要素图层,托管服务器的 ArcGIS Server 管理员可以在单个图层上启用查询响应缓存以帮助提升性能。 一旦启用,每次要素服务接收到唯一查询时,要素和范围都将缓存在对象存储中。 根据缓存在对象存储运行的一台或多台计算机上的存储时间(缓存有效期策略)和磁盘可用空间,对象存储可能填充并停止运行。
作为 ArcGIS Data Store 管理员,您必须在与其他软件分开的一台或多台计算机上配置对象存储,并确保有足够的磁盘空间来存储这些缓存。 您也必须监视 ArcGIS Data Store 日志以检测对象存储何时接近容量。 您可以验证对象存储以查看对象存储计算机上的磁盘使用空间百分比,以及运行实用程序以确定哪些图层缓存最大。 如果需要,与 ArcGIS Server 管理员合作更改缓存有效期策略或删除大图层缓存。
启用要素图层的查询响应缓存
要在托管要素图层(要素服务)中的一个或多个图层上启用缓存,托管服务器站点的 ArcGIS Server 管理员必须登录到托管服务器的 ArcGIS Server Administrator 目录并使用更新定义 REST 操作来提交以下请求:
{ "layerCache": { "enabled": true } }
如果数据频繁更新,请勿启用缓存;每次图层更新时,都必须重建缓存,因此在经常编辑的要素图层上使用缓存的查询时,您不会看到任何性能提升。
设置或更改缓存有效期策略
将根据每条唯一查询创建缓存。 如果对象存储计算机上有足够的磁盘空间并且很多客户端访问图层,请将缓存设置为不过期。 上一部分显示的示例请求将启用无有效期的缓存。
对于不能连续访问的图层,或者如果考虑磁盘空间,请设置将图层的查询响应缓存保留多长时间(以天为单位)。
{ "layerCache": { "enabled": true, "expiration": <duration_in_days> } }
请注意,缓存在 UTC 午夜时间到期。 如果将有效期策略设置为 1,则缓存最多可以保留两天,具体时间取决于创建缓存的时间。
例如,如果客户端在 4:00 UTC 访问要素图层,其缓存将保留至翌日的 24:00 UTC。
删除图层的缓存
如果对象存储的磁盘空间不足,您将在 ArcGIS Data Store 日志中看到警告,验证 REST 命令将显示已使用的磁盘空间。 您无法将磁盘空间或计算机添加到现有对象存储,因此您可能需要清理缓存以释放磁盘空间。 要执行此操作,托管服务器的 ArcGIS Server 管理员必须禁用该图层的缓存。
{ "layerCache": { "enabled": false } }