Data Domain：启用 DD Boost API 日志记录 |Precert 日志

启用 API 级别（预认证）日志记录的原因：

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

一般注意事项：

• 仅当工程部门或支持部门明确要求时，才启用认证前日志记录。
• 密切监控磁盘空间;日志可能会迅速增长。
• 确保权限和文件放置正确。
• 删除 .ini 文件以禁用日志记录。
• 必须先卸载再重新装载 BoostFS，更改才能生效。

按作系统列出的文件位置

对于 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_files 和 log_file_size 根据需要。
• 如果磁盘空间有限，日志可以重定向到其他位置。

Linux BOOSTFS 客户端设置

1. 创建 /DDLog 目录：
   • mkdir /DDLog
chmod 777 /DDLog

2. 创建 /ddboost_precert.ini 使用上述配置。

3. 确保卸载并重新装载 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

2. 创建 C:\DDLog 并分配完全读/写权限。

3. 卸载并重新装载启用调试日志记录的 BoostFS。

清理和禁用日志记录

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

对于 7.0 之前的 BOOST/BoostFS 版本，通过在下表所示的位置创建名为“ddboost_precert.ini”的空文件来启用预验证日志。这样做将导致 DD Boost SDK API 启用默认位置和文件名的日志记录，如下表所示：

此工具应仅在工程或支持团队请求时启用，并且由于生成的日志量，应谨慎，以便尽快禁用此日志记录。

 

对于 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



使用上述设置，它将创建 4 个文件，每个文件为 512MB，因此总共仅占用 2GB 磁盘空间。

如果 4 个文件（每个 512 MB）未涵盖故障排除所需的时间范围，请使用参数“num_log_files”和“log_file_size”调整文件数量及其大小。

显示配置后，日志将在表中相同的位置创建，但如果作系统根分区不够大，则可以选择在其他位置创建日志。

注意：此文件夹需要与ddboost_precert.ini文件位于同一路径中（等待更了解的人确认，如果这是真的，则无法将日志写入通常较小的根目录以外的某个分区）