8 故障排除

以下错误是 DIVAnet 安装中出现的常见错误。例如，尽管配置文件中的标记名称不区分大小写，但是值（例如，站点名称）通常区分大小写，因此可能会产生错误。

• DIVAnet 常见错误

• DIVAnetUI 常见错误

表 8-1 DIVAnet 常见错误

问题	可行解决方案
DIVAnet 服务不启动	在安装服务时，确保传递适配器 wrapper.conf 文件的名称（而不是适配器配置文件的名称）。 确保将该配置文件放在模板文件夹的父目录中并删除 .ini 扩展名。 如果在读取配置文件时出现错误，则这些错误将记录在包装器日志中。这些日志放在 DIVAnet 主目录的 Program/log/divanet 文件夹中，其命名方式与 Wrapper.conf 文件类似，但是具有 .log 文件扩展名。 在尝试启动 ClientAdapter 或 DbSync 之前，必须运行 addSites 脚本。 数据库和配置文件中的站点名称是否一致？如果不一致，则服务可能无法启动和（或）无法正常运行。
DIVAnet 请求返回“访问被拒绝”	确保您要连接的端口配置了正确的工作流配置文件。确保工作流配置文件的有效消息列表部分允许该请求。 如果要使用访问规则，确保 ApiConnect 出现在 Include 规则中。如果要使用 DIVAnetUI，确保 WebConnect 出现。
站点间复制操作因出现错误而失败，并指出源和目标名称包含 MISSING_MAPPING_TO	确保通过检查配置来将请求分配给所需的工作流配置文件。 ClientAdapter 站点间传输配置可能缺少“自源”或“至目标”。
任何请求都未能成功发送到 DIVA 站点，即使这些请求可以在 DIVAnet 中查看也是如此	确保 ManagerAdapter 配置文件中的 localSitename 正确反映它所服务的站点（而不是从其他位置剪切粘贴而来）。确认 ClientAdapter 和 DbSync 配置中的 localSitename 正确无误。确认所使用的站点名称与 DIVAnet 数据库中定义的站点名称一致。 确认您要向其发送请求的 DIVArchive Manager 在 ClientAdapter 配置中的网络地址和端口正确。
在访问规则中，定义了 Exclude 规则之后，某个操作在所有情况下都将被拒绝。	请注意，为了让操作成功，有问题的操作必须至少存在一个 Include 规则。 检查 Ruleset 中使用默认值的参数（例如 WorkflowProfile）并进行相应的更改。

表 8-2 DIVAnetUI 常见错误

问题	可行解决方案
无法连接到 DIVAnet	确保为 DIVAnet 指定了正确的 URL。默认情况下，这是运行 ClientAdapter 的计算机的端口地址，该端口是在 ClientAdapter 配置的 WebServicePort 参数中定义的。 确保在 URL 中指定端口（如果适用的话）并指定 https（如果启用了安全连接）。
UI 不再更新现有请求的进度或者不显示新请求。	检查 DIVAnet GUI 的右下角以确定是否出现了连接错误。如果出现了连接错误，单击 Requests 或Assets 按钮以重新显示连接对话框。 您或许在请求查询中提供了一个结束时间。这会指示 DIVAnetUI 不应当显示实时更新，对于当前的请求不应当更新任何进度。要启用实时更新，只需删除结束时间过滤器。 最后，检查 Request Filters 窗格以确保未启用任何请求类型或请求状态过滤器（对于开始时间和结束时间同样如此）。
资产视图中未显示新归档的对象	确认 DbSync 服务正在运行。检查配置，确保网络地址正确。您可能需要确保要同步的站点上已配置而且正在运行 ManagerAdapter。 如果配置正确而且问题依然存在，建议通过 DIVAnet Admin 实用程序针对该站点启动重新同步。
UI 中的复制、删除和取消操作返回“访问被拒绝”。	确保在 ClientAdapter 中的 WebDefaultWorkflowProfile 中配置了正确的工作流配置文件。确保工作流配置文件的有效消息列表部分允许该请求。 如果要使用访问规则，确保 WebConnect 出现在 Include 规则中。