Veritas NetBackup™ Logging Reference Guide

Last Published:
Product(s): NetBackup (8.2, 8.1.2)
  1. Using logs
    1.  
      About logs
    2.  
      About UNIX system logs
    3.  
      About log retention in NetBackup
    4.  
      About limiting the size of unified and legacy logs
    5. About unified logging
      1.  
        Gathering unified logs for NetBackup
      2.  
        Types of unified logging messages
      3.  
        File name format for unified logging
      4.  
        Originator IDs for the entities that use unified logging
      5.  
        About changing the location of unified log files
      6.  
        About rolling over unified log files
      7.  
        About recycling unified log files
      8.  
        About using the vxlogview command to view unified logs
      9.  
        About query strings used with the vxlogview command
      10.  
        Examples of using vxlogview to view unified logs
      11.  
        Examples of using vxlogmgr to manage unified logs
      12.  
        Examples of using vxlogcfg to configure unified logs
    6. About legacy logging
      1.  
        UNIX client processes that use legacy logging
      2.  
        PC client processes that use legacy logging
      3.  
        File name format for legacy logging
      4.  
        Directory names for legacy debug logs for servers
      5.  
        Directory names for legacy debug logs for media and device management
      6.  
        How to control the amount of information written to legacy logging files
      7.  
        About limiting the size and the retention of legacy logs
      8.  
        Configuring the legacy log rotation
    7. About global logging levels
      1.  
        Changing the logging level
      2.  
        Changing the logging level on Windows clients
      3.  
        Setting Media Manager debug logging to a higher level
    8.  
      Setting retention limits for logs on clients
    9.  
      Logging options with the Windows Event Viewer
    10. Troubleshooting error messages in the NetBackup Administration Console
      1.  
        About extra disk space required for logs and temporary files
      2.  
        Enabling detailed debug logging
  2. Backup process and logging
    1.  
      Backup process
    2. NetBackup process descriptions
      1.  
        Backup and restore startup process
      2.  
        Backup and archive processes
      3.  
        Backups and archives - UNIX clients
      4.  
        Multiplexed backup process
    3.  
      About backup logging
    4.  
      Sending backup logs to Veritas Technical Support
  3. Media and device processes and logging
    1.  
      Media and device management startup process
    2.  
      Media and device management process
    3.  
      Shared Storage Option management process
    4.  
      Barcode operations
    5.  
      Media and device management components
  4. Restore process and logging
    1.  
      Restore process
    2.  
      UNIX client restore
    3.  
      Windows client restore
    4.  
      About restore logging
    5.  
      Sending restore logs to Veritas Technical Support
  5. Advanced Backup and Restore Features
    1.  
      SAN Client Fiber Transport backup
    2.  
      SAN Client Fiber Transport restore
    3.  
      Hot catalog backup
    4.  
      Hot catalog restore
    5. Synthetic backups
      1.  
        Creating legacy log directories to accompany problem reports for synthetic backup
      2.  
        Logs to accompany problem reports for synthetic backups
  6. Storage logging
    1.  
      NDMP backup logging
    2.  
      NDMP restore logging
  7. NetBackup Deduplication logging
    1.  
      Deduplication backup process to the Media Server Deduplication Pool (MSDP)
    2.  
      Client deduplication logging
    3.  
      Deduplication configuration logs
    4.  
      Media server deduplication/pdplugin logging
    5.  
      Disk monitoring logging
    6.  
      Logging keywords
  8. OpenStorage Technology (OST) logging
    1.  
      OpenStorage Technology (OST) backup logging
    2.  
      OpenStorage Technology (OST) configuration and management
  9. Storage lifecycle policy (SLP) and Auto Image Replication (A.I.R.) logging
    1.  
      About storage lifecycle policies (SLPs) and Auto Image Replication (A.I.R.)
    2.  
      Storage lifecycle policy (SLP) duplication process flow
    3.  
      Automatic Image Replication (A.I.R.) process flow logging
    4.  
      Import process flow
    5.  
      SLP and A.I.R. logging
    6.  
      SLP configuration and management
  10. NetBackup secure communication logging
    1.  
      About NetBackup secure communication logging
    2.  
      Tomcat logging
    3.  
      NetBackup web services logging
    4.  
      Command-line logging
    5.  
      NetBackup cURL logging
    6.  
      Java logging
    7.  
      Embeddable Authentication Client (EAT) logging
    8.  
      Authentication Services (AT) logging
    9.  
      vssat logging
    10. NetBackup proxy helper logging
      1.  
        Originator ID 486
    11. NetBackup proxy tunnel logging
      1.  
        Originator ID 490
    12.  
      PBX logging
    13.  
      Sending secure communication logs to Veritas Technical Support
  11. Snapshot technologies
    1.  
      Snapshot Client backup
    2.  
      VMware backup
    3.  
      Snapshot backup and Windows open file backups
  12. Locating logs
    1.  
      acsssi logging
    2.  
      bpbackup logging
    3.  
      bpbkar logging
    4.  
      bpbrm logging
    5.  
      bpcd logging
    6.  
      bpcompatd logging
    7.  
      bpdbm logging
    8.  
      bpjobd logging
    9.  
      bprd logging
    10.  
      bprestore logging
    11.  
      bptestnetconn logging
    12.  
      bptm logging
    13.  
      daemon logging
    14.  
      ltid logging
    15.  
      nbemm logging
    16.  
      nbjm logging
    17.  
      nbpem logging
    18.  
      nbproxy logging
    19.  
      nbrb logging
    20.  
      NetBackup web services logging
    21.  
      NetBackup web server certificate logging
    22.  
      PBX logging
    23.  
      reqlib logging
    24.  
      robots logging
    25.  
      tar logging
    26.  
      txxd and txxcd logging
    27.  
      vnetd logging
  13. Java-based administration console logging
    1.  
      About the Java-based administration console logging
    2.  
      Java-based administration console logging process flow
    3.  
      Setting up a secure channel between the Java-based administration console and bpjava-*
    4.  
      Setting up a secure channel between the Java-based administration console and either nbsl or nbvault
    5.  
      Java-based administration console logging configuration on NetBackup servers and clients
    6.  
      Java-based remote administration console logging on a Windows computer where NetBackup is not installed
    7.  
      Configuring and gathering logs when troubleshooting Java GUI issues
    8.  
      Undo logging

Examples of using vxlogmgr to manage unified logs

The following examples show how to use the vxlogmgr command to manage unified logging files. Log file management includes actions such as deleting or moving the log files.

Table: Example uses of the vxlogmgr command

Item

Example

List the log files

List all unified log files for the nbrb service:

# vxlogmgr -s -o nbrb
/usr/openv/logs/nbrb/51216-118-1342895976-050503-00.log
/usr/openv/logs/nbrb/51216-118-1342895976-050504-00.log
/usr/openv/logs/nbrb/51216-118-1342895976-050505-00.log
Total 3 file(s)

Delete the oldest log files

If the vxlogcfg NumberOfLogFiles option is set to 1, the following example deletes the two oldest log files for the nbrb service:

# vxlogcfg -a -p 51216 -o nbrb -s NumberOfLogFiles=1
# vxlogmgr -d -o nbrb -a 
Following are the files that were found:
/usr/openv/logs/nbrb/51216-118-1342895976-050504-00.log
/usr/openv/logs/nbrb/51216-118-1342895976-050503-00.log
Total 2 file(s)
Are you sure you want to delete the file(s)? (Y/N):
Y
Deleting 
/usr/openv/logs/nbrb/51216-118-1342895976-050504-00.log ...
Deleting 
/usr/openv/logs/nbrb/51216-118-1342895976-050503-00.log ...

Delete the newest log files

Delete all the unified log files that NetBackup created in the last 15 days:

# vxlogmgr -d --prodid 51216 -n 15

Make sure that you roll over (rotate) the log files before you recycle them.

Delete the log files for a specific originator

Delete all unified log files for originator nbrb:

# vxlogmgr -d -o nbrb

Make sure that you roll over (rotate) the log files before you recycle them.

Delete all the log files

Delete all unified log files for NetBackup:

# vxlogmgr -d -p NB

Make sure that you roll over (rotate) the log files before you recycle them.

Control the number of log files

You can use the vxlogmgr command with the vxlogcfg command's NumberOfLogFiles option to manually delete log files.

For example, the NumberOfLogFiles option is set to 2, you have 10 unified logging files, and cleanup has not occurred. Enter the following to keep the two most recent log files and delete the rest for all originators:

# vxlogmgr -a -d

The following command keeps the two most recent log files of all PBX originators:

# vxlogmgr -a -d -p ics

The following deletes the older log files for the nbrb service only:

# vxlogmgr -a -d -o nbrb

Control disk space usage

Periodically run the vxlogmgr -a -d command (such as through a cron job) to delete logs and monitor the disk space that unified logging uses.

The disk space that a given originator uses can be calculated as follows:

NumberOfFiles for originator * MaxLogFileSizeKB for originator

The total disk space that unified logs consume is the sum of the disk space that each originator consumes. If none of the originators override the NumberOfFiles and MaxLogFileSizeKB settings, then the total disk space that unified logging consumes is as follows:

Number of originators * default MaxLogFileSizeKB * default NumberOfFiles

Use the vxlogcfg command to list the current unified logging settings.

For example, assume the following:

  • vxlogmgr -a -d -p NB is configured as a cron job with a frequency of one hour.

  • No originators override default settings for MaxLogFileSizeKB or NumberOfFiles.

  • The number of active NetBackup originators on the host is 10. (Typical of a NetBackup master server that is not running BMR or NDMP.)

  • The default MaxLogFileSizeKB is equal to 51200.

  • The default NumberOfFiles is equal to 3.

To calculate the total disk space that unified logging consumes, insert the values from the example into the previous formula. The results are as follows:

10 * 51200 * 3 KB = 1,536,000 KB of additional disk space used each hour.

A complete description of vxlogmgr is in the NetBackup Commands Reference Guide.