6 DIVAnet 管理

本章讨论 DIVAnet 的管理。

使用 DIVAnetAdmin 实用程序

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

要启动此实用程序，请打开命令窗口，然后从 DIVAnet 主目录导航到 Program/divanet/bin 子目录。键入以下命令之一将启动此实用程序：

Windows：

DIVAnetAdmin.bat ClientAdapterWebUrl DbSyncWebUrl

Linux：

DIVAnetAdmin.sh 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 请求排队

通过请求队列，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 可能会在其他站点上重试请求。如果未配置重试，则请求将终止。