6 DIVAnet 管理

本章讨论 DIVAnet 的管理。

使用 DIVAnetAdmin 实用程序

DIVAnetAdmin 是一个简单的命令行工具,它具有用于管理 DIVAnet 的选项。此实用程序只能在 ClientAdapter 和 DbSync 服务正在运行的服务器上运行。

要启动此实用程序,请打开命令窗口,然后从 DIVAnet 主目录导航到 Program\divanet\bin 子目录。键入以下命令以启动此实用程序:

DIVAnetAdmin.bat ClientAdapterWebUrl DbSyncWebUrl

注:

如果未提供 URL 参数,则此实用程序将假定 ClientAdapter 和 DbSync 服务正在本地运行,并将提示您输入 ClientAdapter 和 DbSync 服务端口。

表 6-1显示了 DIVAnetAdmin 选项,可通过菜单系统进行选择。

表 6-1 DIVAnetAdmin 选项

类别
选项
说明

资产数据库同步

列出同步的站点

生成同步其资产信息的站点的列表。它还将显示每个站点的同步状态。如果站点处于初始同步状态,则还将显示完成百分比。

资产数据库同步

重新同步站点

将特定站点中的所有对象记录重新同步到 DIVAnet 数据库。

警告:在重新同步之前,此选项将删除 DIVAnet 数据库中的所有资产记录(对于选定的站点)。

资产数据库同步

重新同步对象

更新特定站点上特定对象的对象记录。不对删除项进行同步。

API 连接

列出 API 连接

列出所有的客户机 DIVAnet API 连接,包括直接模式下的连接。

API 连接

结束 API 连接

提供用于结束由 ID 标识的特定 API 连接的选项。

重新加载工作流配置文件

重新加载工作流配置文件

此选项将导致重新加载所有的工作流配置文件。它还将重新加载已定义的任何访问规则。

如果已定义访问规则,则此选项要求访问 ChangeConfig 操作。

站点参数

显示站点参数

此选项显示 DIVA 站点参数,包括站点的排队请求数、在每个站点上运行的请求数(由 DIVAnet 发送)、上次与站点通信的日期和限制参数。

站点参数

设置站点参数

此选项允许用户设置 DIVA 限制参数:

  • SubmittedThrottleThreshold 控制在等待(其中一个请求完成)之前 DIVA 应该发送到站点的请求数。

  • TotalThrottleThreshold 与此类似,但是它基于在 DIVA 站点上运行的总请求数。DIVAnet 将一直等待,直到总 DIVA 请求数降至此数值之下(在发送下一个请求之前)。

如果已定义访问规则,则此选项要求访问 ChangeConfig 操作。

运行时统计信息

显示运行时统计信息:ClientAdapter

此选项显示 ClientAdapter 服务的有用运行时统计信息。

运行时统计信息

显示运行时统计信息:DbSync

此选项显示 DbSync 服务的有用运行时统计信息。

日志级别

设置日志级别:ClientAdapter

此选项列出 ClientAdapter 服务的日志级别(有效值为 ERROR、WARN、INFO、DEBUG、TRACE),并提供用于动态更改日志级别的选项。

日志级别

设置日志级别:DbSync

此选项列出 DbSync 服务的日志级别(有效值为 ERROR、WARN、INFO、DEBUG、TRACE),并提供用于动态更改日志级别的选项。


DIVAnet 创建以下类型的日志文件:

  • 跟踪日志-位于 DIVAnet 主目录内的 Program\log\divanet 子文件夹中。每个 DIVAnet 服务(ManagerAdapter、DbSync 和 ClientAdapter)都在 Program\log\divanet 文件夹下面创建其各自的一个子文件夹,并在该子目录中生成其日志文件。

  • 包装器服务日志-这些日志输出与 Windows 服务的启动和关闭相关的消息。如果服务未正确启动,可在此处进行查看。这些日志位于 DIVAnet 主目录内的 Program\log\divanet 子文件夹中。其命名类似于 Wrapper.conf 文件,但是具有 .log 文件扩展名(例如,ManagerAdapterWrapper.log)。

  • GUI 日志-在 DIVAnetUI 中出现的错误将显示在客户机计算机上,而不是在服务器端上。日志将显示在 Program\log\divanet\gui 子文件夹中。

DIVAnet 将存在时间超过一小时的日志打包到 zip 文件中,并保留相当于两天的日志以供查看。

请求处理和排队

本节讨论请求排队和处理。

DIVAnet 请求排队

通过请求队列,DIVAnet 接受的请求数可以大于下游 DIVArchive 系统可以处理的请求数。使用 <GlobalDivanetRequestLimit> 参数,DIVAnet 强制实施可以排队的和(或)在内部运行的最大请求数(默认值为 5000)。如果达到此限制,DIVAnet 将开始拒绝请求。DIVAnet ClientAdapter 服务维护每个站点的队列。可以将 DIVAnet 配置为将请求缓慢传入站点,或者一次将所有请求都发送到站点(在此它们很可能由 DIVArchive 进行排队)。

如果将请求排队到 DIVArchive,且 DIVA 系统重新启动,则正在运行的所有请求都将终止。DIVAnet 的行为方式则不同-DIVAnet 将每个请求存储在数据库中。如果 ClientAdapter 服务重新启动,DIVAnet 将读取暂挂的和正在运行的请求并重新启动它们。但是,并非所有请求都将这样重新启动。例如,在服务重新启动后,决不会重新发出删除请求。如果不需要在启动时恢复请求,则可以将 ClientAdapter <AbortAllOnStartup> 参数设置为在启动时终止队列中的所有请求。

DIVAnet 请求限制

默认情况下,DIVAnet 将一百个请求发送到站点,之后停止并等待其中一个请求完成。控制限制的参数是 <SubmittedThrottleThreshold>,可基于每个站点在 ClientAdapter 中进行配置。也可以在运行时通过 DIVAnetAdmin 实用程序进行更改。此外,DIVAnet 可以基于在 DIVArchive 站点上运行的请求总数来限制请求(使用 <TotalThrottleThreshold> 参数)。可以将任一参数设置为 -1,表示不应执行限制。也可以将值设置为 0,表示队列中的请求都不应发送到 DIVArchive。在某些情况下,这样做可能很有用。

如果某个 DIVAnet 请求排队到特定的站点几秒钟以上,DIVAnetUI 将显示该请求在队列中的位置。如果排队的另一个请求的优先级高于第一个请求,则前者很可能在队列中具有更高的位置。如果某请求失败并进行了重试,则将该请求重新排队(然而,由于它在系统中存在很长时间,因此它将获得优先级提升)。

DIVAnet 请求重试

有些请求可在 DIVAnet 内自动重试。复制、恢复、部分文件恢复和删除等请求可重试。恢复 & 部分文件恢复请求可以按可配置的次数进行重试,而复制和删除请求按可配置的时间间隔进行重试。可以基于每个工作流配置文件指定重试,并且可以在不重新启动 ClientAdapter 的情况下在运行时进行修改(有关更多信息,请参见配置工作流配置文件)。

如果某站点已关闭,并且请求已排队到该站点,则 DIVAnet 将等待 <SiteDownRequeueWaitMins> 分钟,以便站点变为可操作。如果配置的该时间段已过,并且已配置重试,则 DIVAnet 将可能在其他站点上尝试重试请求。如果配置重试,则请求将终止。