IDPA：收集日志文件以对 Avamar Client 备份和恢复问题进行故障处理
Summary: Avamar 备份或恢复作业遇到问题。为了诊断原因，必须找到 Avamar Client 日志文件。本文详细介绍了实现此目的的各种方法。
This article applies to
This article does not apply to
This article is not tied to any specific product.
Not all product versions are identified in this article.
Instructions
从 Avamar HTML UI/AUI 收集客户端日志
通过 Avamar Web 用户界面中的 Activity Monitor，您可以查看客户端会话的详细日志，以执行分析或故障处理。
步骤
从 Avamar Administrator 收集客户端日志
在 Avamar Administrator 界面上，打开活动屏幕，然后右键单击要收集其日志的客户端。选择“Download Support Bundle”，然后将 .zip 文件保存到您的桌面。
要使此功能正常工作，Avamar MCS 服务必须能够访问客户端页面（访问端口 28002 上的客户端 avagent 服务）。
直接从客户端收集日志
此方法适用于运行 avscc 进程的客户端，如 Windows 和 Mac 客户端。
应收集哪些日志文件？
这取决于要调查的问题类型。
最佳实践是提供整个目录，但不提供 Avamar 缓存 (.dat) 文件 和 Windows 系统状态 (.bkf) 文件。 这些文件通常很大，并且对故障处理几乎没有用处。 仅当支持人员要求时再提供这些文件。
不同日志有什么作用？
其他供参考的知识库文章：
LKB23300 ：Avamar：如何收集日志以对 Avamar VMware 映像备份问题
进行故障排除LKB38388：如何收集日志和信息以调查 Avamar Administrator 控制台 （MCGUI） 问题
LKB22859 ：Avamar：如何运行“getlogs”以收集 Avamar Server 日志Avamar：如何配置客户端日志保留以及如何限制 Avtar 日志在客户端上占用的空间量
通过 Avamar Web 用户界面中的 Activity Monitor，您可以查看客户端会话的详细日志，以执行分析或故障处理。
步骤
- 在左侧的 AUI 导航窗格中，单击 >>，然后单击 Activity。此时将显示活动监视器，并显示所有活动的列表。
- 从列表中选择一个活动，然后单击 VIEW LOGS
此时将显示 Log details 窗口。默认情况下，活动监视器显示过去 72 小时内所有客户端备份活动的详细日志
- 要根据搜索字符串过滤内容，请在搜索字段中键入字符串。
- 要下载日志文件，请单击 Download。
从 Avamar Administrator 收集客户端日志
在 Avamar Administrator 界面上，打开活动屏幕，然后右键单击要收集其日志的客户端。选择“Download Support Bundle”，然后将 .zip 文件保存到您的桌面。
要使此功能正常工作，Avamar MCS 服务必须能够访问客户端页面（访问端口 28002 上的客户端 avagent 服务）。
直接从客户端收集日志
- 通过 Avamar Client 界面创建日志的 .zip 文件，如下所示：
此方法适用于运行 avscc 进程的客户端，如 Windows 和 Mac 客户端。
- 从 Avamar 日志目录手动收集日志。
客户端日志的位置因客户端操作系统而异。
- Windows： C:\Program Files\avs\var\
- Linux： /usr/local/avamar/var
- 其他 UNIX 平台： /opt/AVMRclnt/var
- NetWare： sys:\avamar\var
- MacOS： /private/var/avamar
应收集哪些日志文件？
这取决于要调查的问题类型。
最佳实践是提供整个目录，但不提供 Avamar 缓存 (.dat) 文件 和 Windows 系统状态 (.bkf) 文件。 这些文件通常很大，并且对故障处理几乎没有用处。 仅当支持人员要求时再提供这些文件。
不同日志有什么作用？
- *.log 文件 — 也称为 avtar 日志，包含有关备份的信息
- *.alg 文件 — 包含工单摘要信息
- avagent.log — 记录 Avamar 备份服务的工单、连接和注册消息
- avtar.cmd — 传递给 avtar 的特殊参数
- avagent.cmd — 传递给 avagent 的特殊参数
- avagent.cfg — 包含服务器主机名和服务器端 MCS 连接端口
- cid.bin — 包含客户端标识号和服务器详细信息
- avscc.log — Avamar Client GUI 的日志记录
- p_cache.dat — 哈希缓存
- f_cache.dat — 文件缓存
- f_cache2.dat — 分页文件缓存（从 Avamar v7 开始使用）
- SystemState.bkf — Windows 系统状态文件
提醒：从版本 5 开始，Windows 操作系统的 avscc 日志的位置有变化。
- Windows XP： %USER%\Application Data\Avamar\avscc.log
- Windows Vista：%USER%\AppData\Roaming\Avamar\avscc.log
- MacOS：（无变化）/Users/USER/.avamardata/avscc.log
其中，USER 是已登录帐户的用户名（短名称）。
日志可用后，识别任何明确的错误或警告消息，并使用支持搜索工具搜索可能相关的知识库文章。
日志可用后，识别任何明确的错误或警告消息，并使用支持搜索工具搜索可能相关的知识库文章。
LKB23300 ：Avamar：如何收集日志以对 Avamar VMware 映像备份问题
进行故障排除LKB38388：如何收集日志和信息以调查 Avamar Administrator 控制台 （MCGUI） 问题
LKB22859 ：Avamar：如何运行“getlogs”以收集 Avamar Server 日志Avamar：如何配置客户端日志保留以及如何限制 Avtar 日志在客户端上占用的空间量
Additional Information
Avamar HTML UI/AUI 活动监视器概览
启用更详细的（调试）日志记录
有时，支持或引擎需要的详细信息超过默认输出中可用的详细信息。要在单个客户端上启用调试和详细日志记录：
--verbose
也可以通过 GUI 为单个备份启用调试和/或详细日志记录，或为整个数据集启用它。
有关当前详细信息，请参阅最新的 Avamar 系统管理员指南，但一般而言，您需要在执行单个备份时选择“More Options”按钮，选择“Advanced Options”，然后勾选“Enable Debugging Messages”复选框，或将 --debug=true 和 --verbose=true 选项添加到数据集。
提醒：
从服务器检索 Avamar 备份日志
如果备份的日志不再存在于客户端上但在服务器上尚未到期，要对该备份进行故障处理，请从 Avamar Server 检索备份日志。
控制 Avamar Client 日志保留
请参阅以下文章。
只有注册的戴尔客户才能通过以下链接访问内容，Dell.com/support
LKB60840 - Avamar — 如何配置客户端日志保留并限制 avtar 日志在客户
端上可能占用的空间收集 Avamar Client Log on Windows Servers for Guest Level Windows Backup Troubleshooting
启用更详细的（调试）日志记录
有时，支持或引擎需要的详细信息超过默认输出中可用的详细信息。要在单个客户端上启用调试和详细日志记录：
- 在客户端计算机上编辑或创建名为 avtar.cmd 的文本文件。该文件必须放在 Avamar 安装目录中（本文前面提及）
- 使用文本编辑器创建文件并添加以下行，然后保存文件
--verbose
也可以通过 GUI 为单个备份启用调试和/或详细日志记录，或为整个数据集启用它。
有关当前详细信息，请参阅最新的 Avamar 系统管理员指南，但一般而言，您需要在执行单个备份时选择“More Options”按钮，选择“Advanced Options”，然后勾选“Enable Debugging Messages”复选框，或将 --debug=true 和 --verbose=true 选项添加到数据集。
提醒：
-
向支持人员提供日志时，请使用标准 ZIP 文件，而不是其他压缩实用程序（如 Winrar 或 Winace）。EMC 支持人员可能无法访问相关程序来 解压缩其他归档类型。
-
最佳实践是将日志文件直接附加到 SR。除了电子邮件附件大小限制外，如果您的支持案例将所有权转交给另一名支持工程师，新的工程师可能无法访问日志文件。
-
避免永久使用 --debug 和 --verbose avtar 标记。
如果可能并且问题可重现，请提供启用和不启用调试情况下的日志。
从服务器检索 Avamar 备份日志
如果备份的日志不再存在于客户端上但在服务器上尚未到期，要对该备份进行故障处理，请从 Avamar Server 检索备份日志。
- 列出客户端的可用备份：
mccli backup show --name=/domain/full-client-name
Created LabelNum Size Retention
----------------------- -------- ----------- ---------
2012-06-05 09:01:52 IST 99 34117216256 D
2012-06-05 08:49:15 IST 98 34108467200 D
2012-06-04 08:12:59 IST 97 34078259200 DW
2012-06-04 08:09:32 IST 96 34083352576 DW
----------------------- -------- ----------- ---------
2012-06-05 09:01:52 IST 99 34117216256 D
2012-06-05 08:49:15 IST 98 34108467200 D
2012-06-04 08:12:59 IST 97 34078259200 DW
2012-06-04 08:09:32 IST 96 34083352576 DW
- 记下您对其日志感兴趣的备份的标签号。
- 运行以下 avtar 命令，输入相应的信息。
avtar -x --server= --id=root --ap= --path=/domain/full-client-name --labelnum= --showlog > output-file
必须在此处提供的“Avamar 根密码”是 Avamar Server 密码，而不是 Linux 操作系统密码。
- 日志内容在“output-file”中。
控制 Avamar Client 日志保留
请参阅以下文章。
只有注册的戴尔客户才能通过以下链接访问内容，Dell.com/support
LKB60840 - Avamar — 如何配置客户端日志保留并限制 avtar 日志在客户
端上可能占用的空间收集 Avamar Client Log on Windows Servers for Guest Level Windows Backup Troubleshooting
Affected Products
Avamar, Integrated Data Protection Appliance FamilyProducts
Avamar Client, PowerProtect Data Protection Software, Integrated Data Protection Appliance Family, Integrated Data Protection Appliance SoftwareArticle Properties
Article Number: 000157727
Article Type: How To
Last Modified: 06 May 2024
Version: 5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.