NetBackup Commands for Windows | Implementing Backup and Recovery: The Readiness Guide for the Enterprise

< Day Day Up >

Just about any backup and recovery application you use will offer a graphical user interface (GUI). These are very helpful in the normal day-to-day operations, but there are times when they just aren't what you are looking for. If you want to access, control, or configure your backup application using a slow-speed dial-up line, for example, a GUI can be painful to try to use-if it will work at all. There are also situations where you might want to schedule your backups with a third-party scheduler. In these cases, what you need is access to a good command-line interface (CLI). A good understanding of the CLI for your backup and recovery application gives you the ability to access, configure, control, and monitor both backups and restores from a nongraphic terminal or over a slow line. It also offers a method to interface the backup application with a third-party scheduler.

In this appendix, we list the most commonly used commands for VERITAS NetBackup. We also define the command. A complete listing of the supported commands, along with their options and switches, can be found in the man pages for NetBackup and in the System Administrator's Guide. There is a UNIX and Windows NetBackup System Administrator's Guide and a UNIX and Windows Media Manager System Administrator's Guide. Maybe at some point, if demand is high enough, we will write a companion book on the CLI and greatly expand on their uses. For sample UNIX and Windows NT and 2000 scripts, check out www.NetBackupCentral.com.

NetBackup Commands for UNIX

bp Starts the NetBackup menu interface that lets users archive, back up, and restore files, directories, or raw partitions from their client workstations.
bpadm Starts the NetBackup menu interface for administrators, which an administrator can use to configure NetBackup and monitor its operations. bpadm requires root privileges.
bparchive Archives files to the NetBackup server by processing files that you list on the command line or in the file you specify with the -f listfile option. Any file path entered can be a file or directory name. If the list of files includes a directory, bparchive archives all files and subdirectories of that directory starting at the directory itself.
bpauthorize Manages the authorize.txt file on remote servers. This command is available only on NetBackup master servers and sets up authentication files on NetBackup servers and clients according to the options that are specified with the command.
bpauthsync Synchronizes authentication files on NetBackup servers and clients. This command is available only on NetBackup master servers and sets up authentication files on NetBackup servers and clients according to the options that are specified with the command.
bpbackup Backs up files to the NetBackup server. If issued on a client, bpbackup starts a user backup that is the equivalent to what is performed by using the interface on the client. This type of backup can be started from any NetBackup client in order to back up files from that client. The bpbackup command processes the files that you list on the command line or in the file that you specify with the -f listfile option. A file path can be a file or directory name. If the named files include a directory, bpbackup backs up all files and subdirectories of that directory starting at the directory itself.

If issued on the master server, bpbackup starts an immediate-manual backup of a client. This variation requires the -i option on the bpbackup command and is available only to the administrator on the master server. It is the equivalent of starting a manual backup from the NetBackup administrator's interface. Use the -h option to specify the host.
bpbackupdb Initiates a backup of one or more NetBackup image catalogs specified on the command line. It also backs up the default set of NetBackup catalogs, unless the command line contains -nodbpaths. If the command line specifies a destination, the backup is stored there. Otherwise, the backup is stored at the default location for backups of the NetBackup internal databases, which are called catalogs.
bpchangeprimary Promotes a copy of a backup to be the primary copy.
bpclient Manages client entries on a master server.
bpconfig Modifies or displays the global configuration attributes for NetBackup. These attributes affect operations for all policies and clients.
bpdbjobs Interacts with the NetBackup jobs database and is useful in scripts or as a command-line administration tool. Use bpdbjobs to print the entire jobs database, print a summary, delete done jobs, cancel uncompleted jobs, and clean old jobs.
bpdbm NetBackup database manager daemon that responds to queries related to the NetBackup internal databases, which are called catalogs. bpdbm must be running in order for NetBackup commands and utilities to work properly. This daemon runs only on the master server and can be started only by the administrator.
bpduplicate Creates a copy of backups created by NetBackup; can also change the primary copy in order to enable restoring from a duplicated backup. The primary copy is used to satisfy restore requests and is initially the original copy.
bperror Displays NetBackup status and troubleshooting information or entries from the NetBackup error catalog. It displays information from either the same source as the online troubleshooter (in the Activity Monitor or Reports applications) or from the NetBackup error catalog.
bpexpdate Changes the expiration date of backups in the image catalog and media in the media catalog. It is also used to change the expiration of removable media in the NetBackup media catalog.
bpimagelist Queries the NetBackup catalog and produces a report on the status of the NetBackup images. It will produce one of two types of reports:
- Report images satisfying a set of criteria (if -media is absent)
- Report on removable media satisfying a set of criteria (if -media is present)

bpimmedia Queries the NetBackup image catalog and reports on the NetBackup images. It can produce two reports:
- An Images-on-Media report
- A Spangroups report

bpimport Imports NetBackup and Backup Exec backups that are expired or are from another NetBackup or Backup Exec server.
bplabel Writes a NetBackup label on tape media. Labeling is required only for media that was last used for NetBackup catalog backups or by a non-NetBackup application. You can also use it to assign specific media IDs.
bplist Lists backed-up and archived files on the NetBackup server according to the options that you specify.
bppldelete Deletes policies from the NetBackup database.
bppllist Lists policies and policy information within the NetBackup database.
bpmedia Freezes, unfreezes, suspends, or unsuspends an individual NetBackup media ID, allowing or disallowing future backups or archives to be directed to the media. Note that this command applies only to media managed by Media Manager.
bpmedialist Displays NetBackup media status by making queries of one or more NetBackup media catalogs and produces a report on the status of the NetBackup media.
bpminlicense Manages NetBackup license file.
bpplclients, bpclclients Administers the clients within NetBackup policies.
bpplinfo, bpclinfo Initializes, modifies, or displays policy attributes for a NetBackup policy.
bpplinclude, bpclinclude Maintains the policy file list for a NetBackup policy. This is the list of files backed up when NetBackup runs an automatic backup for the policy.
bpplsched, bpclsched Adds, deletes, or lists NetBackup schedules to/from a policy.
bpplschedrep, bpclschedrep Modifies the attributes of a NetBackup schedule. The schedule and policy named by the command should already exist when it is run.
bppolicynew, bpclassnew Creates, copies, or renames a NetBackup policy.
bprd Initiates the NetBackup request daemon, which is responsible for starting automatic client backups and responding to client requests for file restores and user backups and archives.
bprecover Initiates the NetBackup utility for restoring the NetBackup internal databases called catalogs and recovers catalogs that were backed up by using the procedures described in the NetBackup system administrator's guide. The command has two main modes: list and recover.
bprestore Restores files or directories from the NetBackup server.
bpstuadd Creates a NetBackup storage unit group or a storage unit.
bpstudel Deletes a NetBackup storage unit or storage unit group.
bpstulist Displays the attributes for one or all of the NetBackup storage units or storage unit groups.
bpsturep Modifies an existing NetBackup storage unit by replacing selected storage-unit or storage-unit-group attributes in the NetBackup catalog.
bpverify Verifies the backups created by NetBackup.
cat_convert Converts NetBackup catalog .f files between Versions 3.4 and 4.0, or between 4.5 ASCII format and 4.5 binary format.
jbpSA Starts the Backup, Archive, and Restore client interface on Java-capable UNIX machines.
jnbSA Starts the NetBackup Administration Console on Java-capable UNIX machines.
nbdbsetport Sets TCP/IP port used by the nbdbd database service.
nbdbsetpw Modifies passwords used by the nbdbd database service.
vopied Daemon to provide VERITAS one-time password user authentication.
vopie_util Manages local vopie authentication files.
xbp Starts the X Windows-based interface for NetBackup users.

< Day Day Up >