Veritas NetBackup™ Logging Reference Guide

Last Published:
Product(s): NetBackup (8.0)
  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. Snapshot technologies
    1.  
      Snapshot Client backup
    2.  
      VMware backup
    3.  
      Snapshot backup and Windows open file backups
  10. 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.  
      bptm logging
    12.  
      daemon logging
    13.  
      ltid logging
    14.  
      nbemm logging
    15.  
      nbjm logging
    16.  
      nbpem logging
    17.  
      nbproxy logging
    18.  
      nbrb logging
    19.  
      NetBackup web services logging
    20.  
      NetBackup web server certificate logging
    21.  
      PBX logging
    22.  
      reqlib logging
    23.  
      robots logging
    24.  
      tar logging
    25.  
      txxd and txxcd logging
    26.  
      vnetd logging
  11. 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

About query strings used with the vxlogview command

Use the vxlogview command to display the logs that unified logging generates. The vxlogview command includes the following option: -w (- -where) QueryString.

QueryString represents a text expression similar to a database WHERE clause. The query string expression is used to retrieve log entries from the unified logging system. The expression is a combination of relational operators, constant integers, constant strings, and names of log fields that evaluate to a single value. Expressions are grouped by logical operators such as AND and OR.

The supported relational operators are as follows:

<

less than

>

greater than

<=

less than and equal to

>=

greater than and equal to

=

equal to

!=

not equal to

The supported logical operators are as follows:

&&

logical AND

||

logical OR

Table: Data types for fields shows data types for specific fields as well as description and an example. When more than one example is listed, both examples produce the same results.

Table: Data types for fields

Field name

Type

Description

Example

PRODID

Integer or string

Provide the product ID or the abbreviated name of product.

PRODID = 51216

PRODID = 'NBU'

ORGID

Integer or string

Provide the originator ID or the abbreviated name of the component.

ORGID = 116

ORGID = 'nbpem'

PID

Long Integer

Provide the process ID

PID = 1234567

TID

Long Integer

Provide the thread ID

TID = 2874950

STDATE

Long Integer or string

Provide the start date in seconds or in the locale-specific short date and time format. For example, a locale may have format 'mm/dd/yy hh:mm:ss AM/PM'

STDATE = 98736352

STDATE = '4/26/11 11:01:00 AM'

ENDATE

Long Integer or string

Provide the end date in seconds or in the locale-specific short date and time format. For example, a locale may have format 'mm/dd/yy hh:mm:ss AM/PM'

ENDATE = 99736352

ENDATE = '04/27/11 10:01:00 AM'

PREVTIME

String

Provide the hours in 'hh:mm:ss' format. This field should be used only with operators =, <, >, >=, and <=

PREVTIME = '2:34:00'

SEV

Integer

Provide one of the following possible severity types:

0 = INFO

1 = WARNING

2 = ERR

3 = CRIT

4 = EMERG

SEV = 0

SEV = INFO

MSGTYPE

Integer

Provide one of the following possible message types:

0 = DEBUG (debug messages)

1 = DIAG (diagnostic messages)

2 = APP (application messages)

3 = CTX (context messages)

4 = AUDIT (audit messages)

MSGTYPE = 1

MSGTYPE = DIAG

CTX

Integer or string

Provide the context token as string identifier or 'ALL' to get all the context instances to be displayed. This field should be used only with the operators = and !=.

CTX = 78

CTX = 'ALL'

Consider the following when writing a query string.

Case sensitivity

Field names, severity types, and message types are not case-sensitive. For example, the following are valid entries:

  • sev = info

  • msgtype = diag

String constants

String constants should be given in single quotes. For example, PRODID = 'NBU'

Dates

Start and end dates can be provided in the following formats:

  • A string constant that corresponds to the regional display short date format

  • A UNIX long value of number of seconds that elapsed since midnight January 1, 1970.

Table: Examples of query strings provides examples of query strings.

Table: Examples of query strings

Example

Description

(PRODID == 51216) && ((PID == 178964)
|| ((STDATE == '2/5/15 09:00:00 AM') 
&& (ENDATE == '2/5/15 12:00:00 PM'))

Retrieves the log file message for the NetBackup product ID 51216 between 9AM and 12PM on 2015-05-02.

((prodid = 'NBU') && ((stdate >= 
'11/18/14 00:00:00 AM') && (endate 
<= '12/13/14 12:00:00 PM'))) || 
((prodid = 'BENT') && ((stdate >= 
'12/12/14 00:00:00 AM') && 
(endate <= '12/25/14 12:00:00 PM')))

Retrieves the log messages for the NetBackup product NBU between 2014-18-11 and 2014-13-12 and the log messages for the NetBackup product BENT between 2014-12-12 and 2014-25-12.

(STDATE <= '04/05/15 0:0:0 AM')

Retrieves the log messages that were logged on or before 2015-05-04 for all of the installed Veritas products.