Veritas NetBackup™ Logging Reference Guide
- Using logs
- About logs
- About UNIX system logs
- About log retention in NetBackup
- About limiting the size of unified and legacy logs
- About unified logging
- Gathering unified logs for NetBackup
- Types of unified logging messages
- File name format for unified logging
- Originator IDs for the entities that use unified logging
- About changing the location of unified log files
- About rolling over unified log files
- About recycling unified log files
- About using the vxlogview command to view unified logs
- About query strings used with the vxlogview command
- Examples of using vxlogview to view unified logs
- Examples of using vxlogmgr to manage unified logs
- Examples of using vxlogcfg to configure unified logs
- About legacy logging
- UNIX client processes that use legacy logging
- PC client processes that use legacy logging
- File name format for legacy logging
- Directory names for legacy debug logs for servers
- Directory names for legacy debug logs for media and device management
- How to control the amount of information written to legacy logging files
- About limiting the size and the retention of legacy logs
- Configuring the legacy log rotation
- About global logging levels
- Setting retention limits for logs on clients
- Logging options with the Windows Event Viewer
- Troubleshooting error messages in the NetBackup Administration Console
- Backup process and logging
- Media and device processes and logging
- Restore process and logging
- Advanced Backup and Restore Features
- Storage logging
- NetBackup Deduplication logging
- OpenStorage Technology (OST) logging
- Snapshot technologies
- Locating logs
- acsssi logging
- bpbackup logging
- bpbkar logging
- bpbrm logging
- bpcd logging
- bpcompatd logging
- bpdbm logging
- bpjobd logging
- bprd logging
- bprestore logging
- bptm logging
- daemon logging
- ltid logging
- nbemm logging
- nbjm logging
- nbpem logging
- nbproxy logging
- nbrb logging
- NetBackup web services logging
- NetBackup web server certificate logging
- PBX logging
- reqlib logging
- robots logging
- tar logging
- txxd and txxcd logging
- vnetd logging
- Java-based administration console logging
- About the Java-based administration console logging
- Java-based administration console logging process flow
- Setting up a secure channel between the Java-based administration console and bpjava-*
- Setting up a secure channel between the Java-based administration console and either nbsl or nbvault
- Java-based administration console logging configuration on NetBackup servers and clients
- Java-based remote administration console logging on a Windows computer where NetBackup is not installed
- Configuring and gathering logs when troubleshooting Java GUI issues
- Undo logging
About rolling over unified log files
To prevent log files from becoming too large, or to control when or how often logs are created, you can set a log rollover option. When a file size or time setting is reached, the current log file is closed. New log messages for the logging process are written or "rolled over" to a new log file.
See About log retention in NetBackup.
You can set log file rollover to occur based on file size, time of day, or elapsed time. Set the conditions by using the vxlogcfg command with the options described in Table: vxlogcfg options that control the rollover of the unified log files.
Table: vxlogcfg options that control the rollover of the unified log files
Option | Description |
|---|---|
MaxLogFileSizeKB | Specifies the maximum size that is allowed for the log file (in kilobytes) before rollover occurs, if the RolloverMode is set to FileSize. |
RolloverAtLocalTime | Specifies the time of day at which the log file is rolled over, if the RolloverMode is set to LocalTime. |
RolloverPeriodInSeconds | Specifies a period of time in seconds after which the log file is rolled over, if the RolloverMode is set to Periodic. |
MaxLogFileSizeKB or RolloverAtLocalTime | Specifies that the log file rollover occurs whenever the file size limit or the local time limit is reached, whichever is first. An example of the command: vxlogcfg -a -p 51216 -g Default MaxLogFileSizeKB=256 RolloverAtLocalTime=22:00 |
MaxLogFileSizeKB or RolloverPeriodInSeconds | Specifies that the log file rollover occurs whenever the file size limit or the periodic time limit is reached, whichever is first. |
A complete description of vxlogcfg is in the NetBackup Commands Reference Guide.
By default, log file rollover is based on a file size of 51200 KB. When a log file reaches 51200 KB in size, the file closes and a new log file opens.
The following example sets the NetBackup (prodid 51216) rollover mode to Periodic.
# vxlogcfg -a --prodid 51216 --orgid 116 -s RolloverMode=Periodic
RolloverPeriodInSeconds=86400The previous example uses the vxlogcfg command with the RolloverMode option. It sets rollover mode for nbpem (originator ID 116) to Periodic. It also sets the interval until the next nbpem log file rollover to 24 hours (86400 seconds).
In the following example, the file names show the log file rollover with the rotation ID incremented:
/usr/openv/logs/nbpem/51216-116-2201360136-041029-0000000000.log
/usr/openv/logs/nbpem/51216-116-2201360136-041029-0000000001.log
/usr/openv/logs/nbpem/51216-116-2201360136-041029-0000000002.logIn addition, you can use log file rotation with the following:
Logs for the server processes that use unified logging
See Originator IDs for the entities that use unified logging.
Certain legacy logs
The unified logging files that the Bare Metal Restore process bmrsavecfg creates