Data Domain:启用 DD Boost API 日志记录 — 预认证日志

Résumé: 本文介绍如何在对与 Boost 和 BoostFS 相关的问题进行故障处理时启用 Data Domain Boost (DD Boost) 插件日志记录。这称为预认证日志。

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet article.

Instructions

注意: 默认情况下,DD Boost 插件不会记录详细的 API 活动。使用 启用预认证日志记录 ddboost_precert.ini 文件便于进行更深入的诊断。文件放置不正确、缺少权限或配置错误可能会阻止日志生成。

启用 API 级 (precert) 日志记录的原因:

  • DD Boost 或 BoostFS 操作失败或行为异常。
  • 工程部门或支持部门请求详细的 API 级日志进行分析。
  • 尽管有预期的 Boost 活动,但未生成日志。

通用说明

  • 仅当工程部门或支持人员明确要求时,才启用预认证日志记录。
  • 密切监视磁盘空间;日志可能会快速增长。
  • 确保正确的权限和文件放置。
  • .ini 要禁用日志记录:
  • 必须卸载并重新装载 BoostFS 才能使更改生效。

文件位置(按操作系统)

操作系统 ddboost_precert.ini 位置 ddboost_precert.log 位置
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows C:\ddboost_precert.ini C:\DDLog\ddboost_precert.log

对于 7.0 之前的 BOOST 和 BoostFS 版本

创建空文件 ddboost_precert.ini 在适当的位置(请参见上表)。这将启用日志记录到默认路径。


对于 BOOST 和 BoostFS 版本 7.0 及更高版本

创建已配置的 ddboost_precert.ini 文件,其中包含以下内容:

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
  • 此配置创建四个日志文件,每个日志文件 512 MB(总共 2 GB)。
  • 可调整性 num_log_fileslog_file_size (根据需要):
  • 如果磁盘空间有限,则可以将日志重定向到其他位置。

Linux BOOSTFS 客户端设置

  1. 创建 /DDLog 日志文件:

mkdir /DDLog

chmod 777 /DDLog

  1. 创建 /ddboost_precert.ini 使用上面的配置。

 

  1. 确保 卸载并重新装载 BoostFS:

mount -o log-level=debug <mount_point>

 


Windows BOOSTFS 客户端设置

  1. 创建 C:\ddboost_precert.ini 具有以下内容:
precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
  1. 创建 C:\DDLog 并分配完整的读/写权限。
  2. 卸载和重新装载 启用调试日志记录的 BoostFS。

清理和禁用日志记录

  1. 删除。 ddboost_precert.ini 文件中包含空格。
  2. 删除。 DDLog 目录及其内容。
  3. 重新装载 BoostFS 以应用更改。
  4. 从以下位置收集 BoostFS 日志 /opt/emc/boostfs/log

Informations supplémentaires

常见问题 (FAQ)

    问题: 什么是 DD Boost 预认证日志记录?DD Boost 预认证日志记录是一项诊断日志记录功能,用于记录 DD Boost 客户端与 Data Domain 系统之间的 DD Boost API 事务。
    答: 它通常用于对性能问题、故障、延迟和通信问题进行故障处理。

    问题: 预认证日志记录捕获什么?预认证日志记录捕获 DD Boost API 活动,包括读取操作、写入操作、备份活动、恢复活动、DD Boost 库交互、API 调用计时信息和客户端延迟指示器。
    答: 它提供了有关 DD Boost API 行为的详细可见性,以便进行故障处理和性能分析。

    问题: 为什么不生成预认证日志?验证ddboost_precert.ini文件是否存在、位于操作系统根目录、日志目录是否存在、日志目录是否可写,以及新的备份或恢复操作已启动。
    答: 缺少配置、放置不正确、权限问题或缺少新的 DD Boost 活动是最常见的原因。

    问题: 启用预认证日志记录是否会立即生成日志?该配置仅启用日志记录功能。
    答: 否,仅当收到新的 DD Boost API 请求时,才会生成日志文件。

    问题: 为什么我当前正在运行的备份不生成预认证日志?预认证日志记录仅捕获在检测到配置后启动的 API 活动。
    答: 现有备份或还原作业将继续,而不生成预认证日志。

    问题: 我是否需要重新启动备份或还原作业?如果启用日志记录时作业已在运行,请启动新操作。
    答: 是的,需要新的备份或还原作业才能生成预认证日志。

    问题: 预认证日志记录不起作用的最常见原因是什么?常见原因包括 ddboost_precert.ini 不在根级别,意外命名 ddboost_precert.ini.txt、缺少日志目录或权限不足。
    答: 配置和文件系统问题是最常见的原因。

    问题: 应将ddboost_precert.ini文件放在哪里? 

    Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.

    答: 该文件必须驻留在操作系统根目录中。

    问题: ddboost_precert.ini文件是否可以存储在另一个文件夹中?DD Boost 插件仅检查操作系统根目录。
    答: 否,文件必须存储在根目录。

    问题: 如何验证文件实际上不是

    ddboost_precert.ini.txt

    打开文件资源管理器,启用文件扩展名,然后验证文件名。
    答: 确保将文件命名为 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    问题: 为什么 DDLog 启用日志记录后目录为空?可能的原因包括无新的 DD Boost 活动、权限问题或未检测到配置文件。
    答: 运行新的备份、还原或 DDPCONNCHK 测试以生成活动。

    问题: 什么是 DDPCONNCHK 为什么它有用? DDPCONNCHK 是 DD Boost 连接验证工具。
    答: 它可以生成 DD Boost API 活动,并快速确认预认证日志记录是否正常工作。

    问题:DDPCONNCHK 是否用于测试我的配置?工程师经常运行 DDPCONNCHK 启用日志记录之后。
    答: 是的,这是一种在重现问题之前验证是否正在生成日志的常见方法。

    问题: 为什么我的预认证日志增长如此之快?预认证日志记录会记录每个 DD Boost API 调用。
    答: 大型备份环境可能会在短时间内生成大量日志。

    问题: 我应该分配多少磁盘空间?常见的建议是 

    num_log_files=3 and log_file_size=500.

    答: 这可在轮换发生之前提供大约 1.5 GB 的日志存储空间。

    问题: 预认证日志是否可以填充文件系统?如果不加以监视,日志记录可能会占用大量磁盘空间。
    答: 是,完整的文件系统可能会导致备份失败、中断和服务中断。

    问题: num_log_files的目的是什么?此参数控制保留的轮换日志文件数。
    答: 例如, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2

    问题: log_file_size的目的是什么?此参数定义每个日志文件的最大大小(以 MB 为单位)。
    答: 例如,log_file_size=500 允许每个文件在轮换之前增长到 500 MB。

    问题: 什么 does ddcl_logs_include=true 执行它会在预认证日志中启用 DD Boost 客户端库日志记录信息。
    答: 建议的设置是 ddcl_logs_include=true.

    问题: 什么 ddcl_logs_sev=4 含义此参数控制日志记录的严重性。
    答: 严重性级别 4 提供了详细的故障处理和调试信息。

    问题: 我是否需要 BoostFS 除了预认证日志记录之外,还需要调试日志记录?并非总是需要额外的日志记录。
    答: 对于 BoostFS-specific 问题,同时启用这两者通常可提供更全面的诊断情况。

    问题: 对于 BoostFS,我是否需要卸载并重新装载?卸载和重新装载会重新初始化 BoostFS 活动。
    答: 在许多情况下,是的,这有助于启动新的 DD Boost 活动。

    问题: 正确的 BoostFS 调试日志记录语法是什么?正确的语法是 -o log-level=debug
    答: 请勿使用 --o log-level=debug 因为只有一个破折号是有效的。

    问题: 为什么重新装载 BoostFS 会突然出现预认证日志?重新装载将为 BoostFS 创建新的初始化周期。
    答: 当发生新的 DD Boost API 活动并且插件程序检测到配置文件时,将开始进行日志记录。

    问题: 重新启动应用程序是否等同于重新装载 BoostFS?任何创建新 DD Boost API 活动的操作都可以触发日志记录。
    答: 通常情况下是的,示例包括重新启动 RMAN、备份软件或正在运行 DDPCONNCHK

    问题: RMAN 是否在不卸载 BoostFS 的情况下生成预认证日志? RMAN 可以直接发起新的 DD Boost API 请求。
    答: 是,开始新的 RMAN 操作通常就足够了。

    问题: 如何禁用预认证日志记录?删除ddboost_precert.ini或将其重命名为 ddboost_precert.ini.disabled。
    答: 只有在使用确切文件名时,日志记录才会激活 ddboost_precert.ini

    问题: 删除 ini 文件后是否需要重新启动主机?插件程序会在未来的操作中检查配置文件。
    答: 否,不需要重新启动。

    问题: 在 Linux 上应使用哪些权限?权限示例包括 

    mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.

    答: DD Boost 进程必须能够读取配置文件并写入日志目录。

    问题: 默认情况下,BoostFS 日志存储在哪里? 

    Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.

    答: 这些位置独立于 DD Boost 预认证日志。

    问题: BoostFS 日志和预认证日志是同一回事吗?BoostFS 日志包含装载活动、文件系统操作和应用程序事件。
    答: 否,预认证日志包含 DD Boost API 事务、库通信和 I/O 计时数据。

    问题: 我应该向支持部门提供哪些日志?根据问题,收集ddboost_precert.log、轮换预认证日志、BoostFS 日志、 DDPCONNCHK 输出、应用程序日志和请求的支持包。
    答: 提供所有相关日志有助于加快故障处理速度。

    问题: 如果按照此 KB 操作后仍未生成日志,我该怎么办?收集证据,例如ddboost_precert.ini位置、日志目录列表、 DDPCONNCHK 输出、BoostFS 装载命令和权限信息。
    答: 将收集的信息提交给戴尔技术支持部门以进行进一步分析。

    Produits concernés

    Data Domain

    Produits

    Data Domain
    Propriétés de l’article
    Numéro d’article: 000020437
    Type d’article: How To
    Dernière modification: 21 août 2026
    Version:  9
    Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
    Services de support
    Vérifiez si votre appareil est couvert par les services de support.