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

Media and device management components

This topic shows the file and the directory structure and the programs and the daemons that are associated with media management and device management.

Figure: Media and device management directories and files shows the file structure and directory structure for media management and device management on a UNIX server. A Windows NetBackup server has the equivalent files and the directories that are located in the directory where NetBackup is installed (by default, the C:\Program Files\VERITAS directory).

Figure: Media and device management directories and files

Media and device management directories and files

Table: Media and device management directories and files describes the directories and files that are of special interest.

Table: Media and device management directories and files

File or directory

Contents

bin

Commands, scripts, programs, daemons, and files that are required for media and device management. The following subdirectories under bin are available:

driver: Contains the SCSI drivers that are used on various platforms to control robotics.

goodies: Contains the vmconf script and scan utility.

debug

Legacy debug logs for the Volume Manager daemon, vmd, and all requesters of vmd, ltid, and device configuration. The administrator must create these directories for debug logging to occur.

help

Help files that the media and device management programs use. These files are in ASCII format.

misc

Lock files and temporary files that are required by the various components of media and device management.

vm.conf

Media and device management configuration options.

Table: Media and device management daemons and programs describes the media management and device management programs and daemons. The explanations include what starts and stops the program or daemon, and the log (if any) where it records its activities. On UNIX, all of the components that are discussed in this table are in /usr/openv/volmgr/bin. On Windows, they are in install_path\volmgr\bin.

Note:

The following table contains references to the system log. On UNIX, syslog manages this log (the facility is daemon). On Windows, the Event Viewer manages the system log (the log type is Application).

Table: Media and device management daemons and programs

Program or daemon

Description

acsd

The Automated Cartridge System daemon interfaces with the Automated Cartridge System. It communicates with the server that controls the ACS robotics through the acsssi process (UNIX) or the STK Libattach Service (Windows).

For UNIX, see the acsssi and the acssel programs.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/ascd command.

Stopped By: Stopping ltid (or on UNIX, independently by finding the PID (process ID) and then using the kill command).

Debug Log: Errors are logged in the system log and robots debug log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by starting the daemon with the -v option: this option can also be used through ltid, or by putting VERBOSE in the vm.conf file.

acssel

Available only on UNIX.

See the NetBackup Device Configuration Guide.

acsssi

Available only on UNIX.

See the NetBackup Device Configuration Guide.

avrd

The automatic-volume-recognition daemon controls the automatic volume assignment and label scanning. This daemon lets NetBackup read labeled tape volumes and automatically assigns the associated removable media to the requesting processes.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/avrd command).

Stopped By: Stopping ltid, (or on UNIX, independently by finding the PID (process ID) and then using the kill command).

Debug Log: All errors are logged in the system log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by aborting avrd and starting the daemon with the -v option.

ltid

The device daemon (UNIX) or NetBackup Device Manager service (Windows) controls the reservation and assignment of tapes.

Started By: /usr/openv/volmgr/bin/ltid command on UNIX or the Stop/Restart Device Manager Service command in the Media and Device Management window on Windows.

Stopped By: /usr/openv/volmgr/bin/stopltid command on UNIX or the Stop/Restart Device Manager Service command in the Media and Device Management window on Windows.

Debug Log: Errors are logged in the system log and the ltid debug log. Debug information is included if the daemon is started with the -v option (available only on UNIX) or adding VERBOSE to the vm.conf file.

tl4d

The Tape Library 4MM daemon is the interface between ltid and the Tape Library 4MM and communicates with the robotics through a SCSI interface.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tl4d command).

Stopped By: Stopping ltid (or on UNIX, independently by finding the PID (process ID) and then using the kill command).

Debug Log: All errors are logged in the system log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by starting the daemon with the -v option (either by itself or through ltid).

tl8d

The Tape Library 8MM daemon provides the robotic control for a TL8 robot (Tape Library 8mm or Tape Stacker 8mm). The Tape Library 8MM daemon drives in the same TL8 robot can be attached to different hosts than the robotic control. tl8d is the interface between the local ltid and the robotic control. If a host has a device path for a drive in a TL8 robot, then mount or unmount requests for that drive go first to the local ltid and then to the local tl8d (all on the same host). tl8d then forwards the request to tl8cd on the host that is controls the robot (it can be on another host).

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tl8d command).

Stopped By: Stopping ltid (or on UNIX, independently by finding the PID (process ID) and then using the kill command.

Debug Log: Errors are logged in the system log and the robots debug log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by starting the daemon with the -v option (either by itself or through ltid).

tl8cd

The Tape Library 8MM control daemon provides the robotic control for a TL8 robot and communicates with the robotics through a SCSI interface. tl8cd receives mount and unmount requests from tl8d on the host to which the drive is attached and then communicates these requests to the robot.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tl8cd command).

Stopped By: Stopping ltid or by using the tl8cd -t command.

Debug Log: Errors are logged in the system log and the robots debug log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by starting the daemon with the -v option (either by itself or through ltid).

tldd

The Tape Library DLT daemon works with tldcd to handle requests to TLD robots (Tape Library DLT and Tape Stacker DLT). tldd provides the interface between the local ltid and the robotic control (tldcd) in the same way as explained previously for tl8d.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tldd command).

Stopped By: Stopping ltid (or on UNIX, independently by finding the PID (process ID) and then using the kill command).

Debug Log: Errors are logged in the system log and robots debug log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by starting the daemon with the -v option (either by itself or through ltid).

tldcd

The tape library DLT control daemon provides robotic control for a TLD robot in the same way as explained previously for tl8cd.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tldcd command).

Stopped By: Stopping ltid or by using the tldcd -t command.

Debug Log: Errors are logged in the system log and robots debug log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by starting the daemon with the -v option (either by itself or through ltid).

tlhd

The Tape Library Half-inch daemon works with tlhcd to handle requests to the TLH robots that are in an IBM Automated Tape Library (ATL). tlhd provides the interface between the local ltid and the robotic control (tlhcd) in the same way as explained previously for tl8d.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tlhd command).

Stopped By: Stopping ltid (or on UNIX, independently by finding the PID (process ID) and then using the kill command).

Debug Log: Errors are logged in the system log and robots debug log. Debug information is included by adding VERBOSE to the vm.conf file. On UNIX, debug information is also included by starting the daemon with the -v option (either by itself or through ltid).

tlhcd

The Tape Library half-inch control daemon provides robotic control for a TLH robot that is in an IBM Automated Tape Library (ATL) in the same way as explained previously for tl8cd.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tlhcd command).

Stopped By: Stopping ltid or by using the tlhcd -t command.

Debug Log: Errors are logged in the system log and robots debug log. Debug information is included if the daemon is started with the -v option (either by itself or through ltid). The -v option is available only on UNIX. Also, add the VERBOSE option to the vm.conf file.

tlmd

The Tape Library Multimedia daemon is the interface between ltid and a TLM robot that is in an ADIC Distributed AML Server (DAS). This daemon communicates with the TLM robotics through a network API interface.

Started By: Starting ltid or starting independently by using the /usr/openv/volmgr/bin/tlmd command.

Stopped By: Stopping ltid or stopping independently by finding the PID (process ID) and then using the kill command.

Debug Log: Errors are logged in the system log and robots debug log. Debug information is included if the daemon is started with the -v option (either by itself or through ltid). The -v option is available only on UNIX. Also, add the VERBOSE option to the vm.conf file.

tshd

The Tape Stacker Half-inch daemon is the interface between ltid and the half-inch-cartridge stacker and communicates with the robotics through a SCSI interface. This robot is not supported on Windows.

Started By: Starting ltid (or on UNIX, independently by using the /usr/openv/volmgr/bin/tshd command).

Started By: tpconfig command.

Stopped By: Quit option from within the utility on UNIX. On Windows, tpconfig is only a command-line interface that runs to completion (no quit option).

Debug Log: tpcommand debug logs.

vmd

The Volume Manager daemon (NetBackup Volume Manager service on Windows) allows the remote administration and control of Media and Device Management.

Started By: Starting ltid.

Stopped By: Terminating the Media Manager Volume Daemon option.

Debug Log: System log and also a debug log if the daemon or reqlib debug directories exist.

vmscd

The Media Manager Status Collector Daemon keeps the EMM server database up-to-date with the actual status of the drives that are attached to the 5.x servers.

Started By: the EMM server.

Stopped By: the EMM server.

Debug Log: /usr/openv/volmgr/debug/vmscd (UNIX), install_path\Volmgr\debug\vmscd (Windows)