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

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

Denne artikkelen gjelder for Denne artikkelen gjelder ikke for Denne artikkelen er ikke knyttet til noe bestemt produkt. Det er ikke produktversjonene som identifiseres i denne artikkelen.

Instruksjoner

注意: 默认情况下,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

Tilleggsinformasjon

常见问题 (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 装载命令和权限信息。
    答: 将收集的信息提交给戴尔技术支持部门以进行进一步分析。

    Berørte produkter

    Data Domain

    Produkter

    Data Domain
    Artikkelegenskaper
    Artikkelnummer: 000020437
    Artikkeltype: How To
    Sist endret: 21 aug. 2026
    Versjon:  9
    Få svar på spørsmålene dine fra andre Dell-brukere
    Støttetjenester
    Sjekk om enheten din er dekket av støttetjenestene.