NetBackup™ Commands Reference Guide

Specifies the backup ID of a single backup to import.

file_name specifies a file that contains a list of backup IDs to import. List one backup ID per line in the file. If this option is included, other selection criteria are ignored.

In addition, NetBackup removes the file that is specified with the -Bidfile parameter during the activation of that command line interface (CLI). It is removed because the NetBackup GUIs commonly use this parameter. The GUIs expect the command-line interface to remove the temporary file that was used for the -Bidfile option upon completion. Direct command-line interface users can also use the option, however it removes the file.

The host name of the client for which the backups were performed. The default is all clients.

Specifies the source copy number of the backups to import. Valid values are 1 through 10. The default is all copies.

This option recreates catalog entries for the backups that are on the specified media. It skips the backups that are already in the catalog. This option only creates information about the backups that are candidates for import, and does not perform the import operation. The bpimport command must be run with this option before you import any backups.

When you use -create_db_info, Cohesity recommends that you use -id for images on tape and basic disk. Cohesity recommends that you use -stype, -dp, and -dv for images on all other disk types.

Imports images on the specified disk pool only. Optionally, the import can be restricted to the images that reside on the specified disk volume only. The disk_volume argument is the path for BasicDisk.

Option -stype is required with this option.

Specifies the start date and end date range for all backups to import.

-s specifies a start date and time for the listing. The output list shows only images in backups or the archives that occurred at or after the specified date and time.

-e specifies an end date and time for the listing. The output list shows only files from backups or the archives that occurred at or before the specified date and time. Use the same format as for the start date. The default is the current date and time.

The valid range of dates is from 01/01/1970 00:00:00 to 01/19/2038 03:14:07. The default is the previous midnight.

The required date and time values format in NetBackup commands varies according to your locale. The /usr/openv/msg/.conf file (UNIX) and the install_path\msg\LC.CONF file (Windows) contain information such as the date-time formats for each supported locale. The files contain specific instructions on how to add or modify the list of supported locales and formats.

For more about the locale of your system, see "About specifying the locale of the NetBackup installation" in the NetBackup Administrator's Guide, Volume II.

The following is part of the -help USAGE statement for -bpimport that shows the -s and -e options:

-s mm/dd/yy [hh[:mm[:ss]]] -e mm/dd/yy [hh[:mm[:ss]]]

Scans for images only that are capable of automatic import and places them in the Storage Lifecycle Policy automatic import worklist. This option is part of Phase 1 of the import.

Specifies the number of hours to search before the current time for backups. Do not use with the -s option. The default is the previous midnight.

Disk media: Specifies the path to the storage directory that contains the backup to be imported.

Tape media: For step 1 (-create_db_info), this option specifies the media ID that has the backups you plan to import. This option is required with -create_db_info.

For step 2, this option designates a specific media ID from which to import backups. The default is all media IDs that were processed in step 1 of the import operation.

A backup ID that begins on a media ID that step 1 does not process, does not import (the backup is incomplete).

Cohesity recommends that you use -id only on basic disk and tape image fragments. For backup imports from other storage server types, Cohesity recommends that you use the -stype, -dp, and -dv options to describe the storage server, disk pool, and disk volume to interrogate.

Specifies the name of a file in which to write progress information. The default is not to use a progress file.

Example for UNIX systems, /usr/openv/netbackup/logs/user_ops

Example for Windows systems, install_path\NetBackup\logs\user_ops

Include the -en option to generate a log that is in English. The name of the log contains the string _en. This option is useful to support the personnel that assist in a distributed environment where different locales may create logs of various languages.

Only default paths are allowed for this option and It is recommended to use the default paths. If you cannot use the NetBackup default path in your setup, you should add custom paths to the NetBackup configuration.

For more information on how to add a custom path, see the "BPCD_ALLOWED_PATH option for NetBackup servers and clients" topic in the NetBackup Administrator's Guide, Volume I.

Produces the output in the progress log that lists each imported file.

When a host other than master server initiates bpimport and -local is not used (default), the following occurs: bpimport starts a remote copy of the command on the master server. The remote copy allows the command to be terminated from the Activity Monitor.

Use -local to prevent the creation of a remote copy on the master server. You also can use it to run the bpimport only from the host where it was initiated. If the -local option is used, bpimport cannot be canceled from the Activity Monitor.

Specifies the master server that manages the media catalog that has the media ID. If this option is not specified, the default is one of the following:

If the command is run on a master server, then that server is the default.

If the command is run on a media server that is not the master, then the master for that media server is the default.

Previews backups to import according to the option settings, but does not perform the import. Displays the media IDs, server name, and information about the backups to import.

Previews the backups to import but does not perform the import. Similar to the -p option, but does not display the backups.

Same as the -PM option, except the backups sort by date and time (newest to oldest).

Displays the information on the backups to be imported according to the option settings, but does not perform the import. It displays the date and time of the backup, and the policy, schedule, backup ID, host, and media ID.

Searches for backups to import in the specified policy. The default is all policies.

Specifies a new priority for the import job that overrides the default job priority.

Searches for the backups that the specified policy type created. The default is any policy type.

The policy_type is one of the following character strings:

Auspex-FastBackup
DataStore
DataTools-SQL-BackTrack
DB2
Enterprise-Vault
FlashBackup
FlashBackup-Windows
Informix-On-BAR
LotusNotes
MS-Exchange-Server
MS-Hyper-V
MS-SharePoint
MS-SQL-Server
MS-Windows
NDMP
Oracle
SAP
Split-Mirror
Standard
Sybase
Universal-share
Vault
VMware

Specifies the name of the media server. The volume database for this server must have a record of the media ID that contains the backups to import. The default is the media server where the command is run.

Search for backups to import that the specified schedule created. The default is all schedules.

Search for backups to import that the specified schedule type created. The default is any schedule type.

Valid values are as follows:

FULL (full backup)

INCR (differential-incremental backup)

CINC (cumulative-incremental backup)

UBAK (user backup)

UARC (user archive)

NOT_ARCHIVE (all backups except user archive)

Specifies a string that identifies the storage server type. The server_type value can originate from one of the following sources:

The storage server type is case sensitive.

Displays more information in the debug logs and progress logs.