Skip To Content

使用 ArcGIS Video Server 管理员操作

ArcGIS 11.4 (Windows)  | |  帮助归档

下面介绍了可供 ArcGIS Video Server 管理员使用的属性。 可通过浏览到 URL https://machine.domain.com:21443/arcgis/admin 查看每个属性的说明及其在 ArcGIS Video Server 管理站点中的路径。

指定 ArcGIS Video Server 账户

默认 ArcGIS Video Server 账户名称为 arcgis。 对于大多数非生产部署,接受此默认值便已足够;但是,对于生产系统,建议您在安装 ArcGIS Video Server 之前创建域账户或 Active Directory 账户。

可指定本地账户或域账户。 在站点的第一台计算机上安装 ArcGIS Video Server 时,您可以导出安装程序配置文件,在站点的其他计算机上安装 ArcGIS Video Server 时,可以使用该配置文件。 这可以确保站点中所有计算机上的 ArcGIS Video Server 账户配置均相同。

域账户

使用域账户可以访问远程系统中的数据。 出于安全考虑,最好使用域账户,因为域账户采用集中管理。

在指定域账户时使用格式 DOMAIN\username。 如果未指定域,则 ArcGIS Video Server 安装向导将使用您指定的用户名创建一个本地账户。 如果指定的域账户不存在,安装程序将返回错误。

如果登录设置拒绝您登录安装 ArcGIS Video Server 的计算机,在安装时会出现错误。 您不需要使用 ArcGIS Video Server 账户的本地登录组策略设置。

本地账户

如果指定了本地账户,则 ArcGIS Video Server 站点中的每台计算机都必须具有本地账户和密码,并且必须完全相同。 安装 ArcGIS Video Server 之前,您可以在每台计算机上使用相同的密码创建本地账户,或者可以使用 ArcGIS Video Server 安装向导创建本地账户。 必须在站点中的每台计算机上使用相同的用户名和密码。

如果您在安装过程中创建了本地账户,则为该账户指定的密码必须符合您操作系统的本地安全策略。 如果密码不满足操作系统的最小强度要求,将出现错误。 要了解如何访问和查看计算机上的安全策略,请参阅您正在使用的 Windows 版本的 Microsoft 文档。

组托管服务账户

组托管服务账户 (gMSA) 是一个可提供自动密码管理的 Active Directory 域账户。 该账户不能用于交互式登录,仅限用于预定义的服务器组。

当一个服务账户管理多台计算机上的软件(例如在多机 ArcGIS Video Server 站点中)时,使用 gMSA 尤其有用。 由于 gMSA 是在域级别运行的,它可以定期更改每台计算机上的服务账户密码,且无需手动步骤。

您可以使用如下所述的 configureserviceaccount 命令行工具来配置 ArcGIS Video Server 服务以在 gMSA 下运行。 此工具位于 <Video_Install>\tools\ConfigUtility 目录中。 对于 username 参数,可以指定组托管服务账户末尾是否有 $ 符号。 不需要 password 参数。 readconfigwriteconfig 参数均使用组托管服务账户达到相同效果。

以下是将 gMSA 配置为 ArcGIS Video Server 账户的示例命令:

configureserviceaccount.bat --username mydomain\enterprise-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml

导入根证书

要导入根证书,请单击主页 > 计算机 > 计算机名称 > ssl 证书 > 导入根证书或中间证书

此操作会将 CA 根证书或中间证书导入 keystore。 要创建生产质量 CA 签名证书,请将 CA 证书添加到 keystore 以使 SSL 机制信任 CA(及其签名的证书)。 尽管 keystore 提供大多数常见的 CA 证书,但是如果您拥有自定义 CA 或特定的中间证书,则可以使用此操作。

更新安全配置

要更新安全配置,请单击主页 > 安全 > 配置 > 更新

此操作可更新 ArcGIS Video Server 站点的安全配置,包括 TLS 协议和密码套件。 此操作会导致 REST 服务端点重新部署在站点中的所有服务器计算机上。 如果您更新了通信协议作为此操作的一部分,则 ArcGIS Web Adaptor 需要花费一分钟时间才能识别对站点的通信协议所做的更改。

编辑系统属性

管理员可根据组织编辑 ArcGIS Video Server 属性。 可以在 https://machine.domain.com:21443/arcgis/admin/system/properties/update 中设置自定义属性值。 设置自定义系统属性时,属性必须设置为有效的 JSON 对象。 可以同时设置多个系统属性,只要这些属性连在一起构成有效的 JSON。 以下为示例:


{
"maxFrameCount": 1000,
"maxFileUploadSize": 5000
}
以下部分描述了管理员可以使用的常见系统属性。

定义最大帧计数

最大帧计数确定帧集创建操作可以返回的最大帧数。 允许的最小最大帧计数为 100。

默认为 1000 帧,例如,{"maxFrameCount": 1000}

定义最大文件上传大小

最大文件上传大小设置发布视频文件时可以上传到视频服务器的单个文件大小的最大阈值。 如果在发布过程中上传的文件超过此最大大小,则该过程将失败。 该属性可设置的最高值为 10 GB (10000)。 如果此属性设置为 0 GB,将禁用视频文件的发布。

默认值为 5 GB,例如,{"maxFileUploadSize":"5000"}

定义高程源

管理员可以定义用于正射校正每个图像轮廓线的计算多边形的高程数据源。 可以将高程影像服务项目 ID 设置为源。 如果未定义高程源,则使用常量高程 = 0。 使用高程源可以提高图像轮廓线的准确性。

默认设置为使用常量高程 = 0,但可以使用现有高程影像服务项目 ID 进行设置,例如,{"elevationSource":"a08984c643a24bfd8f8d2eb0d192357d"}

配置 ArcGIS Web Adaptor

要配置 ArcGIS Web Adaptor,请单击主页 > 系统 > Web Adaptor > Web Adaptor 配置

ArcGIS Web Adaptor 配置是所有配置参数的资源,跨站点中的 Web Adaptor 共享。 该资源用于确定共享密钥,以供所有 Web Adaptor 用于加密服务器的传入请求中的密钥数据位。

编辑日志设置

要编辑日志设置,请单击主页 > 日志 > 设置 > 编辑

此程序可更新整个服务器站点的日志设置,例如日志输出位置、级别和格式以及日志文件期限。

设置默认项目数据存储

要编辑默认项目数据存储,请单击主页 > 数据 > 项目 > 设置默认项目

默认项目数据存储是成功发布操作后存储原始视频文件及其相应元数据文件以及输出编码视频文件及其相应元数据文件的位置。 默认设置为 FILESYSTEM

注册数据存储

要注册现有数据存储,请单击主页 > 数据 > 配置企业数据存储 > 提交

默认情况下,ArcGIS Video Server 存储文件系统中的所有视频和元数据文件。 组织可以注册现有对象数据存储以用作视频和元数据的输出位置。 该程序搜索现有对象数据存储并将其注册到视频服务器。 然后可以使用设置默认项目数据存储工作流将该数据存储设置为默认数据存储。

删除站点

要删除站点,请单击主页 > 删除站点

此操作可删除站点配置并释放所有服务器资源。 该操作适用于需要定期清理的开发或测试服务器,也可以在卸载之前执行。 谨慎使用此选项,因为该操作会删除所有设置和其他配置且不可恢复。

此操作可执行以下任务:

  • 停止参与站点的所有服务器计算机。
  • 从站点中取消注册所有服务器计算机。
  • 删除配置存储。

备份站点

建议您经常通过管理员 API 导出站点设置。 您可以通过浏览到主页 > 导出站点来执行此操作。 为导出站点定义 destination 属性时,请提供网络驱动器或 ArcGIS Video Server 计算机以外的位置作为位置。 目标位置必须是 ArcGIS Video Server 计算机可以访问的位置。 如果发生站点故障,可以通过创建新服务器站点并浏览到主页 > 导入站点来恢复站点。

导入站点

警告:

通过 Web Adaptor 访问时,此管理操作不适用。 此操作需要通过直接访问站点中某个 GIS 服务器的 URL 进行。

它将站点配置导入到当前运行的站点中。 导入站点操作会用您提供的输入站点配置文件中的内容替换当前站点的所有配置(包括 GIS 服务、安全配置等)。 输入的站点配置文件可以通过 exportSite 操作获取。

该操作将恢复备份中包含的所有信息,具体参阅 exportSite 说明。 操作完成后,将返回一份报告作为响应。 您应仔细查看报告,解决列出的任何问题,确保站点恢复正常运行。

此操作可以通过 importSite 操作生成的备份文件来恢复站点。 请注意,importSite 操作依赖于导出配置中的服务器目录路径。 因此,importSite 操作成功进行时,这些路径必须是可访问的。

警告:

该操作计算量大,可能需要较长时间才能完成。 操作结束时,可能需要手动干预以解决报告中提到的问题。 由于此操作会完全替换站点配置,强烈建议在操作期间不要访问 GIS 服务或进行站点管理。

请求参数

参数详细信息
location

输入参数可以是导出的配置文件路径,或服务器上存储的配置 ID。

示例

location=i5fad5582-80bc-4155-a21c-62f326354aba
validate

ArcGIS Enterprise 11.1 中引入。 此参数用于验证 location 参数中指定的文件路径,确保在执行 importSite 操作之前路径是可访问的。 如果设置为 true,路径会被验证,操作将返回成功或错误信息。 默认值为 false。 取值范围:true | false

f

响应格式。 默认响应格式为 html

取值范围:html | json | pjson

示例用法

以下是 importSite 的 POST 请求示例:


POST /arcgis/admin/importSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

location=\\server\share\backup\Jan-15-2023_11-50-33.agssite&validate=true&f=pjson

导出站点

将站点配置导出到指定的位置。 导出的文件包含和排除以下内容:

警告:

在备份进行中时,不允许进行其他站点管理操作。 在执行 exportSite 操作前,请确保所有需要的站点配置已完成。

备份中不包含保护信息

如上所述,某些信息不包含在您站点的备份中。 建议在运行备份实用程序时,手动备份这些信息。 还原站点时,手动复制这些信息或将它们移回站点,例如:

  • 服所数据 - 如果在发布时您的服务所使用的数据没有被复制到服务器上的一个文件夹中,它不会包含在备份中。 手动备份您的数据目录、地理数据库、数据库、源表以及您的服务所使用的任何其他信息。 还原站点时,验证 ArcGIS Video Server 是否拥有对数据位置的访问权限。 有关详细信息,请参阅使数据可供 ArcGIS Video Server 访问
  • 日志消息 - 站点运行时,日志会自动创建并分散在参与 Server 站点的所有 ArcGIS Video Server 计算机上。 还原站点时,将信息移动或复制回原始日志目录。
  • 主站点管理员用户名和密码 - 还原站点后,继续使用在执行还原时适合的主站点管理员用户名和密码。 即使所还原站点的主站点管理员已被禁用,也是如此。 建议记录用户名和密码,并将其存储在一个安全的位置,然后再进行还原。
  • 统计数据 - 运行站点时,记录各种服务统计数据。 还原站点时,将信息移动或复制回原始统计数据目录。
  • ArcGIS Web Adaptor 配置 - 如果站点中包括一个或多个 ArcGIS Web Adaptor,需在进行还原后使用站点重新配置它们。 有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的配置主题。

请求参数

参数详细信息
location

(可选)

一个 ArcGIS Video Server 可以访问的文件夹路径,用于存储导出的站点配置。 如果未指定 location 参数,服务器会将导出的站点配置文件存储在服务器目录中,并返回该目录的虚拟路径 (HTTPS URL)。 您可以通过访问返回的 URL 下载导出的站点配置。

示例

location=\\videoserver\share\backup
validate

在 ArcGIS Enterprise 11.1 中引入。 此参数用于验证 location 参数中指定的文件路径,确保在执行 importSite 操作之前路径是可访问的。 如果设置为 true,路径会被验证,操作将返回成功或错误信息。 默认值为 false。 取值范围:true | false

f

响应格式。 默认响应格式为 html

取值范围:html | json | pjson

示例用法

以下是定义了 location 参数的 exportSite 操作的示例 POST 请求:


POST /webadaptor/admin/exportSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

location=\\server\share\backup&f=json

以下是未定义 location 参数的 exportSite 操作的示例 POST 请求:


POST /webadaptor/admin/exportSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

location=&validate=false&f=pjson

JSON 响应示例

以下是指定 location 参数的请求响应示例:


{
  status: "success",
  location: "\\videoserver\share\backup\Jan-15-2013_11-50-33.agssite"
}

以下是未指定 location 参数的请求响应示例:


{
  status: "success",
  location: "https://machine.domain.com/webadaptor/admin/uploads/i33d579b6-d8a8-4886-a1bc-671ae52e7a00"
}

带有验证的示例

以下是设置了 location 参数并将 validate 设置为 true 的请求响应示例。 该示例展示了成功响应,表示路径可被 ArcGIS Server 访问:


{
  status: "success",
}

以下是设置了 location 参数并将 validate 设置为 true 的请求响应示例。 该示例展示了失败响应,表示路径不可被 ArcGIS Server 访问:


{
  "status": "error",
  "messages": ["Unable to write to \\videoserver\share\backup. Verify the location is accessible and the service account running ArcGIS Video Server can write to it."],
  "code": 500
}

ArcGIS Video Server 本地文件系统的导入和导出

未发现明显差异。 服务账户需要在输入/输出文件夹中具备读写权限。 在 Linux 系统中,服务账户通常是安装 ArcGIS Video Server 的用户。 您应确保在所有相关目录中拥有完全的读、写和执行权限,包括导入/导出目录。

ArcGIS Video Server 对象存储或数据存储的导入和导出

如果使用共享网络目录或对象存储,建议使用域账户运行 Video Server Windows 服务。 服务账户在选定的位置中需要拥有完全的读写权限。 在 Linux 中,服务账户通常是安装 ArcGIS Video Server 的用户。