Veritas NetBackup™ Administrator's Guide, Volume I
- Section I. About NetBackup
- Section II. Configuring hosts
- Configuring Host Properties
- About the NetBackup Host Properties
- Access Control properties
- Bandwidth properties
- Busy File Settings properties
- Client Attributes properties
- Client Settings properties for UNIX clients
- Client Settings properties for Windows clients
- Data Classification properties
- Default Job Priorities properties
- Encryption properties
- Exchange properties
- Exclude Lists properties
- Fibre Transport properties
- Firewall properties
- General Server properties
- Global Attributes properties
- Logging properties
- Login Banner Configuration properties
- Media properties
- Network Settings properties
- Port Ranges properties
- Preferred Network properties
- Resilient Network properties
- Restore Failover properties
- Retention Periods properties
- Scalable Storage properties
- Servers properties
- SharePoint properties
- SLP Parameters properties
- Throttle Bandwidth properties
- Universal Settings properties
- User Account Settings properties
- Configuration options for NetBackup servers
- ECA_CERT_PATH for NetBackup servers and clients
- PREFERRED_NETWORK option for NetBackup servers
- THROTTLE_BANDWIDTH option for NetBackup servers
- Configuration options for NetBackup clients
- IGNORE_XATTR option for NetBackup clients
- VXSS_NETWORK option for NetBackup clients
- Configuring server groups
- Enabling support for NAT clients in NetBackup
- Configuring host credentials
- Managing media servers
- Configuring Host Properties
- Section III. Configuring storage
- Configuring disk storage
- Configuring robots and tape drives
- About configuring robots and tape drives in NetBackup
- Adding a robot to NetBackup manually
- Managing robots
- Adding a tape drive to NetBackup manually
- Adding a tape drive path
- Correlating tape drives and device files on UNIX hosts
- Managing tape drives
- Performing device diagnostics
- Configuring tape media
- About NetBackup volume pools
- About WORM media
- About adding volumes
- Configuring media settings
- Media settings options
- Media type (new media setting)
- Media settings options
- About barcodes
- Configuring barcode rules
- Configuring media ID generation rules
- Adding volumes by using the Actions menu
- Configuring media type mappings
- Managing volumes
- About exchanging a volume
- About frozen media
- About injecting and ejecting volumes
- About rescanning and updating barcodes
- About labeling NetBackup volumes
- About moving volumes
- About recycling a volume
- Managing volume pools
- Managing volume groups
- Inventorying robots
- About showing a robot's contents
- About updating the NetBackup volume configuration
- About the vmphyinv physical inventory utility
- Configuring storage units
- About the Storage utility
- Creating a storage unit
- About storage unit settings
- Absolute pathname to directory or absolute pathname to volume setting for storage units
- Maximum concurrent jobs storage unit setting
- Staging backups
- Creating a basic disk staging storage unit
- Configuring storage unit groups
- Section IV. Configuring storage lifecycle policies (SLPs)
- Configuring storage lifecycle policies
- Storage operations
- Index From Snapshot operation in an SLP
- Snapshot operation in an SLP
- Retention types for SLP operations
- Capacity managed retention type for SLP operations
- Storage lifecycle policy options
- Using a storage lifecycle policy to create multiple copies
- Storage lifecycle policy versions
- Section V. Configuring backups
- Creating backup policies
- Planning for policies
- Policy Attributes tab
- Policy storage (policy attribute)
- Policy volume pool (policy attribute)
- Take checkpoints every __ minutes (policy attribute)
- Backup Network Drives (policy attribute)
- Cross mount points (policy attribute)
- Encryption (policy attribute)
- Collect true image restore information (policy attribute) with and without move detection
- Use Accelerator (policy attribute)
- Enable optimized backup of Windows deduplicated volumes
- Use Replication Director (policy attributes)
- Schedule Attributes tab
- Type of backup (schedule attribute)
- Frequency (schedule attribute)
- Multiple copies (schedule attribute)
- Retention (schedule attribute)
- Media multiplexing (schedule attribute)
- Start Window tab
- Include Dates tab
- How open schedules affect calendar-based and frequency-based schedules
- About the Clients tab
- Backup Selections tab
- Adding backup selections to a policy
- Verifying the Backup Selections list
- Pathname rules for UNIX client backups
- About the directives on the Backup Selections list
- ALL_LOCAL_DRIVES directive
- Files that are excluded from backups by default
- Disaster Recovery tab
- Active Directory granular backups and recovery
- Synthetic backups
- Using the multiple copy synthetic backups method
- Protecting the NetBackup catalog
- Parts of the NetBackup catalog
- Protecting the NetBackup catalog
- Archiving the catalog and restoring from the catalog archive
- Estimating catalog space requirements
- About the NetBackup relational database
- About the NetBackup relational database (NBDB) installation
- Using the NetBackup Database Administration utility on Windows
- Using the NetBackup Database Administration utility on UNIX
- Post-installation tasks
- About backup and recovery procedures
- Managing backup images
- Creating backup policies
- Section VI. Deployment Management
- Deployment Management
- Adding or changing schedules in a deployment policy
- Deployment Management
- Section VII. Configuring replication
- About NetBackup replication
- About NetBackup Auto Image Replication
- Viewing the replication topology for Auto Image Replication
- About the storage lifecycle policies required for Auto Image Replication
- Removing or replacing replication relationships in an Auto Image Replication configuration
- About NetBackup replication
- Section VIII. Monitoring and reporting
- Monitoring NetBackup activity
- About the Jobs tab
- About the Daemons tab
- About the Processes tab
- About the Drives tab
- About the jobs database
- About pending requests and actions
- Reporting in NetBackup
- Using the Logging Assistant
- Monitoring NetBackup activity
- Section IX. Administering NetBackup
- Management topics
- Accessing a remote server
- Using the NetBackup Remote Administration Console
- Run-time configuration options for the NetBackup Administration Console
- About improving NetBackup performance
- About adjusting time zones in the NetBackup Administration console
- Alternate server restores
- About performing alternate server restores
- Managing client backups and restores
- About client-redirected restores
- Powering down and rebooting NetBackup servers
- About Granular Recovery Technology
- About configuring Services for Network File System (NFS) on Windows 2012, 2012 R2, or 2016
- About configuring Services for Network File System (NFS) on Windows 2008 and 2008 R2
Logging properties
The Logging properties apply to the master servers, media servers, and the clients that are currently selected. The available properties differ between master servers, media servers, and clients. The Logging properties contain the processes that continue to use Legacy logging as well as processes that use Unified logging.
For those processes that use legacy logging, administrators must first create a log directory for each process to be logged. A logging level selection on the Logging properties page does not create the log directory.
Note:
If you have used the Logging Assistant tool earlier, you do not need to manually create log directories. The Logging Assistant tool automatically creates log directories.
Create the NetBackup legacy log directories in the following locations:
On Windows: install_path\NetBackup\logs\process_name
On UNIX: /usr/openv/netbackup/logs/process_name
Note:
Do not save logs to a remote file system such as NFS or CIFS. Logs that are stored remotely and then grow large can cause critical performance issues.
To create all of the NetBackup debug log directories at one time, run the following files:
Create the Media Manager legacy log directories in the following locations:
On Windows: install_path\Volmgr\debug
On UNIX: /usr/openv/volmgr/debug
In the case of legacy logging, NetBackup uses the configuration file (the Windows registry or the bp.conf file on UNIX) to set the maximum size of a log file. Use the bpsetconfig command-line interface to configure the following parameters:
The MAX_LOGFILE_SIZE parameter indicates the maximum size of a log file. When the log file size in NetBackup matches the MAX_LOGFILE_SIZE setting, the next logs are stored in a new log file.
See MAX_LOGFILE_SIZE option for NetBackup servers and clients for legacy logging.
The MAX_NUM_LOGFILES parameter indicates the maximum number of log files that can be created in NetBackup. When the number of log files matches the MAX_NUM_LOGFILES setting, the older log files are purged.
See MAX_NUM_LOGFILES option for NetBackup servers and clients for legacy logging.
Note:
Do not edit the configuration file manually because incorrect syntax or characters in the file may adversely affect NetBackup operations.
See the NetBackup Commands Reference Guide for information about the bpsetconfig command.
Unified logging creates log file names and messages in a format that is standardized across Veritas products. Some NetBackup processes on the server use unified logging.
Unified logging writes the logs into subdirectories in the following locations:
On Windows: install_path\NetBackup\logs
On UNIX: /usr/openv/logs
Unlike legacy logging, subdirectories for the processes that use unified logging are created automatically.
Note:
Do not save logs to a remote file system such as NFS or CIFS. Logs that are stored remotely and then grow large can cause critical performance issues.
In the case of unified logging, NetBackup uses the nblog.conf configuration file to set the maximum size of a log file. Use the vxlogcfg command to configure the following log settings in the nblog.conf file:
Configure the MaxLogFileSizeKB parameter to set the maximum size of a log file. When the log file size in NetBackup matches the MaxLogFileSizeKB setting, the next logs are stored in a new log file.
Configure the NumberOfLogFiles parameter to set the maximum number of log files that you want to create in NetBackup. When the number of log files in NetBackup matches the NumberOfLogFiles setting, the older log files are purged.
See the NetBackup Logging Reference Guide for more information about controlling the log file size.
Note:
Do not edit the nblog.conf file manually. Incorrect syntax or characters in the file may adversely affect NetBackup operations.
See the NetBackup Commands Reference Guide for information about the vxlogcfg command and the nblog.conf file.
The Logging dialog box contains the following properties:
Table: Logging dialog box properties
Property | Description |
---|---|
This property controls the logging level for all processes in the Logging dialog box that are set to . The logging levels control the amount of information that the NetBackup server writes to the logs.
Some NetBackup processes allow individual control over the amount of information the process writes to logs. For those processes you can specify a different logging level other than . | |
The processes that are listed under Process specific overrides use Legacy logging. These services require that you first create a log directory in the following location:
The following settings are available for each process:
Table: Process-specific overrides lists and describes the processes that use legacy logging. | |
These services use unified logging. Each service creates a log automatically in the following directories:
The following settings are available for each process:
You can also use the vxlogcfg command to change debug levels. Table: Debug logging levels for NetBackup services lists and describes the services that use unified logging. | |
Click Enable to create logs for critical NetBackup processes. In previous NetBackup versions, logging starts once you have created the log directories for the required processes. After you click Enable, the log directories are automatically created for the critical NetBackup processes and logging begins. You can enable Logging for critical processes for master servers, media servers, and clients. Note: Enabling Logging for critical processes is a one-time activity that you can do using the NetBackup Administration Console. After the logging is enabled, you cannot disable it using the Logging dialog box. To manually disable the logging for a process, disable the logging level of the process. See Disabling the logging of NetBackup processes. If you have enabled Logging for critical processes, clicking does not modify Logging for critical processes and Keep logs up to GB options. While changing the logging properties for multiple hosts, if the Logging for critical processes option on one of the hosts is enabled, clicking does not modify the Logging for critical processes and Keep logs up to GB options of any host. After the Logging for critical processes is enabled, NetBackup sets the log retention to the default log size in GB. You can modify it by reconfiguring the option. Note: Clearing the Logging for critical processes is enabled. option may adversely affect NetBackup operations. Veritas recommends that you specify the log retention in GB whenThe following critical NetBackup processes are logged when you select the Enable option:
| |
Specifies how many days to keep the logs in case you need the logs to evaluate failures. For example, if you check the backups every day, you can delete the logs sooner than if you check the backups once a month. However, the logs can consume a large amount of disk space, so do not keep the logs any longer than necessary. The default is 28 days. Specifies the length of time, in days, that the master server keeps its error catalog, job catalog, and debug log information. NetBackup derives the Backup Status, Problems, All Log Entries, and Media Log reports from the error catalog. Also limits the time period that these reports can cover. When this time expires, NetBackup also deletes these logs (that exist) on media servers and clients. | |
| Specifies the size of the NetBackup logs that you want to retain. When the NetBackup log size grows to this value, the older logs are deleted. To set the log size in GB, select the check box and specify the value in GB. This option is available for the master servers, media servers, and clients.
When configuring this option, consider the NetBackup log pruning behavior. All logs are retained until the log size reaches the high water mark, that is, 95% of the Keep logs up to GB value. NetBackup checks for the log size every 10 minutes. Once the log size reaches the high water mark, the deletion of older logs is started. The deletion continues until the log size reaches the low water mark, that is, 85% of the Keep logs up to GB value. Consider the following example:
If you do not select the Keep logs up to GB option, the default value is unlimited. The log retention or log pruning does not happen based on the log size. If both Keep logs up to GB and Keep logs for days are selected, the logs are pruned depending on the condition that occurs first. If no log retention options are selected, the increasing log size may eventually lead to a situation of low disk space, as all logs are retained. Note: You can verify the log pruning behavior in NetBackup using the logs at the following location: On Windows: install_path\NetBackup\logs\nbutil On UNIX: /usr/openv/netbackup/logs/nbutil |
If NetBackup Vault is installed, the Keep Vault logs for property is enabled. Select the number of days to keep the Vault session directories, or select . Session directories are found in the following location: install_path\NetBackup\vault\sessions\vaultname\ session_x Where session_x is the session number. This directory contains vault log files, temporary working files, and report files. |
Note:
While collecting NetBackup logs using Logging Assistant, the total NetBackup log size may increase. If you have enabled the new
option and the total NetBackup log size reaches its high water mark, logs are deleted. Logs that you want to retain may also be deleted. To avoid the deletion of logs that you want to retain, disable the option while you collect logs using Logging Assistant. Alternatively, you can set the option to a value higher than the current value, so that the important logs are not deleted before the log collection is complete.Table: Process-specific overrides
Service | Description |
---|---|
The NetBackup backup and restore manager. | |
The NetBackup tape manager. | |
The NetBackup disk manager. | |
The NetBackup Jobs Database Management daemon. | |
The NetBackup database manager. | |
The NetBackup request daemon or manager. |
Table: Debug logging levels for NetBackup services
Service | Description |
---|---|
This property appears for master servers. NBPEM creates Policy/Client tasks and determines when jobs are due to run. If a policy is modified or if an image expires, NBPEM is notified and the appropriate Policy/Client tasks are updated. | |
This property appears for master servers. NBJM accepts the jobs that the Policy Execution Manager submits and acquires the necessary resources. | |
NBRB makes the allocations for storage units, tape drives, client reservations. |
Legacy logging and unified logging write information about the NetBackup processes that backup, restore, duplicate, and so on. You can also configure NetBackup so that it writes log information about the NetBackup Administration Console. The log information may be helpful to troubleshoot problems.
The NetBackup Logging Reference Guide describes how to troubleshoot the NetBackup Administration Console: