ArcGIS Data Pipelines Server 管理员操作
以下部分介绍了 ArcGIS Data Pipelines Server 管理员可使用的工具和属性。 所介绍的每个工具或属性都带有路径。 可在 <ArcGIS Data Pipelines Server install directory>\tools 中找到安装目录中的可用工具,并且可以通过浏览到 URL https://machine.domain.com:14443/arcgis/admin 找到位于 ArcGIS Data Pipelines Server 管理站点中的操作。
更新系统属性
管理员可以根据组织要求编辑 ArcGIS Data Pipelines Server 属性。 可以在 https://machine.domain.com:14443/arcgis/admin/system/properties/update 中设置自定义属性值。 以下属性可用于配置:
maxWorkersPerMachine- 使用此属性可增加或减少可同时处于活动状态的工作器数量。 工作器是分配给支持 Data Pipelines 编辑器、计划任务运行和独立数据管道运行的计算资源。maxMemoryPerWorkerInMiB- 使用此属性可增加或减少每个工作器可以使用的内存数量。 例如,如果处理大量数据,则可能需要增加此值才能成功完成运行。reservedInteractiveWorkersPerMachine- 使用此属性可增加或减少在 Data Pipelines 编辑器中为交互式创作保留的工作器数量。 例如,如果您有一个单机 ArcGIS Data Pipelines Server 站点,并且maxWorkersPerMachine设置为6,则默认情况下,其中两个工作器将专门保留用于在 Data Pipelines 编辑器中工作,四个将用于计划任务运行和独立数据管道运行。allowedHosts- 使用此属性可指定在使用 URL 输入时可用于读入数据的主机。 默认值为 none ("")。 建议指定允许读取访问的主机列表。 例如,如下所示指定列表中的主机:
"allowedHosts": "exampleHost.com, mydata.org, www.test.ca"
要允许用户从所有主机读取数据,指定通配符值 `(.*)`。 谨慎使用通配符 (`*`),因为它使用户能够从任何主机读取数据。 例如,要允许从所有主机读取,请指定以下内容:
`"allowedHosts": "(.*)"`
如果 URL 重定向到另一个主机,必须在允许的主机列表中指定这两个主机。
allowedFileSharePaths- 使用该属性指定文件共享输入可访问的文件共享路径。 默认情况下,所有可通过 ArcGIS Data Pipelines Server 账户访问的文件共享都将用于文件共享输入。 有些目录始终受限,包括安装目录和系统托管或操作系统保护的目录。例如,要允许访问两个不同的网络共享,请指定以下属性:
"allowedFileSharePaths": [ "\\\\network_path\\my_data", "\\\\other_network_path\\my_other_data"]"allowedFileSharePaths": [ "/net/my_network/my_data", "/other_network_path/my_other_data"]要阻止访问所有文件共享,请指定一个空列表 (
[]),如下所示:"allowedFileSharePaths": []注:
对于单机 ArcGIS Data Pipelines Server 站点,支持
c:\等本地驱动器。 对于多机站点,不支持本地驱动器。 必须使用站点内所有计算机都能访问的共享网络路径。
导入现有服务器证书
要导入现有服务器证书,请单击主页 > 计算机 > 计算机名称 > ssl 证书 > 导入现有服务器证书。
此操作会将现有服务器证书导入 keystore。 如果证书为证书颁发机构 (CA) 签名证书,则必须先使用“导入根证书或中间证书”操作导入 CA 根证书或中间证书。
导入根证书
要导入根证书,请单击主页 > 计算机 > 计算机名称 > ssl 证书 > 导入根证书或中间证书。
此操作会将 CA 根证书或中间证书导入 keystore。 要创建生产质量 CA 签名证书,请将 CA 证书添加到 keystore 以使 SSL 机制信任 CA(及其签名的证书)。 尽管 keystore 提供大多数常见的 CA 证书,但是如果您拥有自定义 CA 或特定的中间证书,则可以使用此操作。
更新安全配置
要更新安全配置,单击主页 > 安全性 > 安全配置 > 更新安全配置。
此操作可更新 ArcGIS Data Pipelines Server 站点的安全配置,包括 TLS 协议和密码套件。 此操作会导致 REST 服务端点重新部署在站点中的所有服务器计算机上。 如果您更新了通信协议作为此操作的一部分,则 ArcGIS Web Adaptor 需要花费一分钟时间才能识别对站点的通信协议所做的更改。
从站点取消注册计算机
在从站点移除 ArcGIS Data Pipelines Server 计算机之前,请考虑以下几点:
如果要移除的计算机上存在激活的计算资源,它们会被终止,所有正在运行的数据管道进度也会丢失。 建议您等待所有进程完成或主动终止它们,然后再从站点中移除计算机。 要主动终止 Data Pipelines 应用程序中的计算资源,所有用户必须断开编辑器连接并取消所有激活的任务运行。
要使用 REST API 主动终止计算资源,请导航至
https://machine.domain.com:14443/arcgis/rest/services/datapipelines/computeresources/<compute resource id>并单击terminate。 对于MODE值为INTERACTIVE的计算资源,终止将断开与该计算资源关联的所有已连接编辑器。 对于MODE值为JOB的计算资源,终止将取消相关运行。在从站点中移除计算机后,建议停止 ArcGIS Data Pipelines Server 服务,然后关闭或重启计算机。 上述步骤确保不会剩下正在运行的 ArcGIS Data Pipelines Server 进程。
如果已将 Web Adaptor 注册到站点,则 Web Adaptor 可能需要一些时间来识别已被删除的计算机。 默认情况下,Web Adaptor 每分钟都会检查一次,以查看站点中是否添加或删除了计算机。 例如,Web Adaptor 在下次检查站点时才会识别已删除的计算机,具体取决于您删除计算机的时机。 在此间隔期间,仍将请求转发到已删除的计算机。 这可能会导致请求失败,并将该事件写入服务器日志。
要缓解此潜在问题,您可以通过重新配置 Web Adaptor 来强制 Web Adaptor 识别已删除的计算机。 有关说明,请参阅安装和配置适用于 ArcGIS Data Pipelines Server 的 ArcGIS Web Adaptor。
如果站点中只有一台 ArcGIS Data Pipelines Server 计算机且已删除,则也会删除该站点并返回到将会询问您是否要创建站点或连接现有站点的页面。 请记住,已经在配置存储中保留了现有服务和设置。 如果要在另一台计算机上重新创建站点,可以在创建站点时引用现有的配置存储。
要从站点取消注册计算机,请单击主页 > 计算机 > 计算机名称 > 取消注册。
删除站点
要删除站点,单击主页 > 删除站点。
此操作可删除站点配置并释放所有服务器资源。 该操作适用于需要定期清理的开发或测试服务器,也可以在卸载之前执行。 谨慎使用此选项,因为该操作会删除所有设置和其他配置且不可恢复。
此操作可执行以下任务:
停止参与站点的所有服务器计算机。
从站点中取消注册所有服务器计算机。
删除配置存储。
配置 ArcGIS Web Adaptor
要配置 ArcGIS Web Adaptor,单击主页 > 系统 > Web Adaptor > 配置。
ArcGIS Web Adaptor 配置是跨站点中 Web Adaptor 共享的所有配置参数的资源。 该资源用于确定共享密钥,以供所有 Web Adaptor 用于加密服务器的传入请求中的密钥数据位。
备份站点
建议您经常通过管理员 API 导出站点设置。 您可以通过浏览到主页 > 导出站点执行此操作。 为导出站点定义 destination 属性时,建议将位置设置为网络驱动器或非 ArcGIS Data Pipelines Server 计算机本身的位置。 目标必须是 ArcGIS Data Pipelines Server 计算机可以访问的位置。 如果发生站点故障,可以通过创建新服务器站点并浏览到主页 > 导入站点来恢复站点。
注:
如果您拥有多机 ArcGIS Data Pipelines Server 站点并且站点出现故障,则只需将站点如上所述导入一次,然后将其他 ArcGIS Data Pipelines Server 计算机正常连接到站点。
编辑日志设置
要编辑日志设置,请单击主页 > 日志 > 设置 > 编辑。
此程序可更新整个服务器站点的日志设置,例如日志输出位置、级别和格式以及日志文件期限。