Data Domain:启用 DD Boost API 日志记录 — 预认证日志
Summary: 本文介绍如何在对与 Boost 和 BoostFS 相关的问题进行故障处理时启用 Data Domain Boost (DD Boost) 插件日志记录。这称为预认证日志。
Instructions
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_files和log_file_size(根据需要): - 如果磁盘空间有限,则可以将日志重定向到其他位置。
Linux BOOSTFS 客户端设置
- 创建
/DDLog日志文件:
mkdir /DDLog
chmod 777 /DDLog
- 创建
/ddboost_precert.ini使用上面的配置。
- 确保 卸载并重新装载 BoostFS:
mount -o log-level=debug <mount_point>
Windows BOOSTFS 客户端设置
- 创建
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
- 创建
C:\DDLog并分配完整的读/写权限。 - 卸载和重新装载 启用调试日志记录的 BoostFS。
清理和禁用日志记录
- 删除。
ddboost_precert.ini文件中包含空格。 - 删除。
DDLog目录及其内容。 - 重新装载 BoostFS 以应用更改。
- 从以下位置收集 BoostFS 日志
/opt/emc/boostfs/log。
Additional Information
常见问题 (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 装载命令和权限信息。
答: 将收集的信息提交给戴尔技术支持部门以进行进一步分析。