How to generate NetBackup Unified Logs

Description

This article provides quick reference instructions for gathering and viewing NetBackup Unified Logs.

Note: The directory paths to the related commands (vxlogcfg, vxlogmgr, and vxlogview) are...

UNIX/Linux: /usr/openv/netbackup/bin/
Windows: <install_path>\NetBackup\bin\

1. Checking Log Levels:

vxlogcfg -l -p nb -o nbpem

2. Changing Log Levels:

vxlogcfg -a -p nb -o nbjm -s DiagnosticLevel=6 -s DebugLevel=6

Note: Check the change was successful as vxlogcfg can fail silently

vxlogcfg -l -p nb -o nbjm

3. Reset to Default Log Levels:

vxlogcfg -a -p nb -o nbjm -s DiagnosticLevel=6 -s DebugLevel=1

Note: The default Diagnostic Level is 6, and the default Debug Level is 1

4. Gather raw logs using the vxlogmgr command to a temp directory. (Preferred Method)

mkdir TempLogFolder
vxlogmgr -c -p nb -t 12:00:00 -f TempLogFolder

Note: Use "vxlogmgr -help" for full command syntax.

5. Manually copy the raw log files from /usr/openv/logs. (Quick Method)

Logs are found at:

• (Windows) install_path\NetBackup\Logs
• (Unix/Linux) /usr/openv/logs

The filename format for log files is: <date> == YYMMDD:

<productid>-<originatorid>-<hostid>-<date>-<sequence>.log

To manually copy all of the nbemm log files from 15th June 2009 to TempLogFolder:

mkdir TempLogFolder
cd install_path\NetBackup\Logs (Windows) or /usr/openv/logs (Unix/Linux)
cp *-111-*-090615-* TempLogFolder

6. Gather specific log entries using the vxlogview command (Least Preferred Method):

vxlogview -p nb -t 24:00:00 -d all > vxlog.txt

Note: Remember to ALWAYS use the "-d all" option when running vxlogview.

Check time zone of raw log files with vxlogmgr received from another NetBackup environment:

cd FolderContainingReceivedRawLogFiles
vxlogmgr -s -G . -z

View received raw logs locally:

cd FolderContainingReceivedRawLogFiles
vxlogview -G . -p nb -o nbpem -d all > nbpem.txt

Note: Remember to include the time zone adjustment if the server is in a different time zone.

vxlogview -z GMT-08:00 -p nb -o nbpem -d all > nbpem.txt

7. The difference between the "-i" and "-o" vxlogview options

vxlogview -p nb -o 111 -d all

• Looks in ALL of the log files in the log path for log messages from the OID.
• Useful for filtering just one OID from a log file that has several OIDs. For example, nbemm log includes da and mds.

vxlogview -p nb -i 118 -d all

• This ONLY looks at log files in the log path with an originator id of 118 in the log file name.
• It prints ALL the log lines in those log files, regardless of the originator id. Useful for seeing library messages too (from OIDs 137, 156, etc).

For in-depth examples, command syntax usage, issues, and exceptions of vxlogcfg, vxlogmgr, and vxlogview, see the NetBackup Command Reference Guides, as well as the Related Documents section of this article.