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
- 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
- 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 SCSI addresses on Windows hosts
- 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. 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 VII. 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 VIII. 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
Examples of redirected restores
This topic provides some example configurations that allow clients to restore the files that were backed up by other clients. These methods may be required when a client connects through a gateway or has multiple Ethernet connections.
In all cases, the requesting client must have access to an image database directory on the master server or the requesting client must be a member of an existing NetBackup policy.
On Windows: install_path\NetBackup\db\images\client_name
On UNIX: /usr/openv/netbackup/db/images/client_name
Note:
Not all file system types on all computers support the same features. Problems can be encountered when a file is restored from one file system type to another. For example, the S51K file system on an SCO computer does not support symbolic links nor does it support names greater than 14 characters long. You may want to restore a file to a computer that doesn't support all the features of the computer from which the restore was performed. In this case, all files may not be recovered.
In the following examples, assume the following conditions:
client1 is the client that requests the restore.
client2 is the client that created the backups that the requesting client wants to restore.
On Windows: install_path is the path where you installed the NetBackup software. By default, this path is C:\Program Files\Veritas.
Note:
The information in this topic applies to the restores that are made by using the command line, not the Backup, Archive, and Restore client interface.
Note:
On Windows: You must have the necessary permissions to perform the following steps.
On UNIX: You must be a root user for any of the steps that must be performed on the NetBackup server. You may also need to be a root user to make the changes on the client.
Assume you must restore files to client1 that were backed up from client2. The client1 and client2 names are those specified by the NetBackup client name setting on the clients.
In the nominal case, do the following:
On Windows: Log on to the NetBackup server.
Add client2 to the following file and perform one of the following:
Edit install_path\NetBackup\db\altnames\client1 to include the name of client2.
Create the following empty file:
install_path\NetBackup\db\altnames\No.Restrictions
On UNIX: Log on as root on the NetBackup server.
Perform one of the following actions:
Edit /usr/openv/netbackup/db/altnames/client1 so it includes the name of client2. Or,
Run the touch command on the following file:
/usr/openv/netbackup/db/altnames/No.Restrictions
Note:
The No.Restrictions file allows any client to restore files from client2.
Log on to client1 and change the NetBackup client name to client2.
Restore the file.
Undo the changes that were made on the server and client.
This example explains how altnames provides restore capabilities to clients that do not use their own host name when they connect to the NetBackup server.
By default, the NetBackup client name of the requesting client must match the peer name that is used in the connection to the NetBackup server. When the NetBackup client name is the host name for the client and matches the peer name (normal case), this requirement is met.
However, problems arise when clients connect to multiple ethernet or connect to the NetBackup server through a gateway.
In this example, restore requests from client1, client2, and client3 are routed through the TCP gateway. Because the gateway uses its own peer name rather than the client host names for connection to the NetBackup server, NetBackup refuses the requests. Clients cannot restore even their own files.
To correct the situation, do the following.
Determine the peer name of the gateway:
Try a restore from the client in question. In this example, the request fails with an error message similar to the following:
client is not validated to use the server
Examine the NetBackup problems report and identify the peer name that is used on the request. Entries in the report may be similar to the following:
01/29/12 08:25:03 bpserver - request from invalid server or client client1.dvlp.null.com
In this example, the peer name is client1.dvlp.null.com.
On Windows: Determine the peer name, then create the following file on the NetBackup master server:
install_path\NetBackup\db\altnames\peername
On UNIX: Run the touch command on the following file:
/usr/openv/netbackup/db/altnames/peername
In this example, the file is:
On Windows:
install_path\NetBackup\db\altnames\client1.dvlp.null.com
On UNIX:
/usr/openv/netbackup/db/altnames/client1.dvlp.null.com
Edit the peername file so that it includes the client names.
For example, if you leave file client1.dvlp.null.com empty, client1, client2, and client3 can all access the backups that correspond to their NetBackup client name setting.
If you add the names client2 and client3 to the file, you give these two clients access to NetBackup file restores, but exclude client1.
Note that this example requires no changes on the clients.
Restore the files.
If you cannot restore files with a redirected client restore by using the altnames file, troubleshoot the situation, as follows.
On Windows:
Create the debug log directory for the NetBackup Request Daemon:
install_path\NetBackup\logs\bprd
On the master server, stop and restart the NetBackup Request Daemon. Restart the service to ensure that this service is running in verbose mode and logs information regarding client requests.
On client1 (the requesting client), try the file restore.
On the master server, identify the peer name connection that client1 uses.
Examine the failure as logged on the All Log Entries report. Or, examine the debug log for the NetBackup Request Daemon to identify the failing name combination:
install_path\NetBackup\logs\bprd\mmddyy.log
On the master server, do one of the following:
Create an install_path\NetBackup\db\altnames\No.Restrictions file. The file allows any client to access client2 backups if the client changes its NetBackup client name setting to client2.
Create an install_path\NetBackup\db\altnames\peername file. The file allows client1 to access client2 backups if client1 changes its NetBackup client name setting to client2.
Add client2 name to the following file: install_path\NetBackup\db\altnames\peername.
client1 is allowed to access backups on client2 only.
On client1, change the NetBackup client name setting to match what is specified on client2.
Restore the files from client1.
Perform the following actions:
Delete install_path\NetBackup\logs\bprd and the contents.
On the master server, select NetBackup Management > Host Properties > Master Servers > Double-click on master server. In the Master Server Properties dialog box, in the left pane, click on Logging. Clear the Keep logs for days property check box.
If you do not want the change to be permanent, do the following:
Delete install_path\NetBackup\db\altnames\No.Restrictions (if existent).
Delete install_path\NetBackup\db\altnames\peername (if existent).
On client1, change the NetBackup client name to its original value.
On UNIX:
On the NetBackup master server, add the VERBOSE entry and a logging level to the bp.conf file. For example:
VERBOSE = 3
Create the debug log directory for bprd by running the following command:
mkdir /usr/openv/netbackup/logs/bprd
On the NetBackup server, stop the NetBackup Request Daemon, bprd, and restart it in verbose mode by running:
/usr/openv/netbackup/bin/admincmd/bprdreq -terminate /usr/openv/netbackup/bin/bprd -verbose
Restart bprd to ensure that bprd logs information regarding client requests.
On client1, try the file restore.
On the NetBackup server, identify the peer name connection that client1 used.
Examine the failure as logged on the All Log Entries report or examine the bard debug log to identify the failing name combination:
/usr/openv/netbackup/logs/bprd/log.date
Take one of the following on the NetBackup server:
Enter the following commands:
mkdir -p /usr/openv/netbackup/db/altnames touch /usr/openv/netbackup/db/altnames/No.Restrictions
These commands allow any client access to client2 backups by changing its NetBackup client name setting to specify the client2.
Run the touch command on the following file:
/usr/openv/netbackup/db/altnames/peername
The command allows client1 access to any client2 backups by changing its NetBackup client name setting to specify client2.
Add client2 to the /usr/openv/netbackup/db/altnames/peername file. The addition to the peername file allows client1 access to the backups that were created on client2 only.
On client1, change the NetBackup client name setting in the user interface to match what is specified on client2.
Restore the files to client1.
Do the following:
Delete the VERBOSE entry from the /usr/openv/netbackup/bp.conf file on the master server.
Delete /usr/openv/netbackup/logs/bprd and the contents.
To return the configuration to what it was before the restore, do the following:
Delete /usr/openv/netbackup/db/altnames/peer.or.hostname (if it exists)
Delete /usr/openv/netbackup/db/altnames/No.Restrictions (if it exists)
On client1, restore the NetBackup client name setting to its original value.