Veritas NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup (8.2)
  1. Introduction
    1.  
      About NetBackup commands
    2.  
      Navigating multiple menu levels
    3.  
      NetBackup command conventions
    4.  
      NetBackup Media Manager command notes
    5.  
      IPV6 updates
  2. Appendix A. NetBackup Commands
    1.  
      acsd
    2.  
      add_media_server_on_clients
    3.  
      backupdbtrace
    4.  
      backuptrace
    5.  
      bmrc
    6.  
      bmrconfig
    7.  
      bmrepadm
    8.  
      bmrprep
    9.  
      bmrs
    10.  
      bmrsrtadm
    11.  
      bp
    12.  
      bparchive
    13.  
      bpbackup
    14.  
      bpbackupdb
    15.  
      bpcatarc
    16.  
      bpcatlist
    17.  
      bpcatres
    18.  
      bpcatrm
    19.  
      bpcd
    20.  
      bpchangeprimary
    21.  
      bpclient
    22.  
      bpclimagelist
    23.  
      bpclntcmd
    24.  
      bpclusterutil
    25.  
      bpcompatd
    26.  
      bpconfig
    27.  
      bpdbjobs
    28.  
      bpdbm
    29.  
      bpdgclone
    30.  
      bpdown
    31.  
      bpduplicate
    32.  
      bperror
    33.  
      bpexpdate
    34.  
      bpfis
    35.  
      bpflist
    36.  
      bpgetconfig
    37.  
      bpgetdebuglog
    38.  
      bpimage
    39.  
      bpimagelist
    40.  
      bpimmedia
    41.  
      bpimport
    42.  
      bpinst
    43.  
      bpkeyfile
    44.  
      bpkeyutil
    45.  
      bplabel
    46.  
      bplist
    47.  
      bpmedia
    48.  
      bpmedialist
    49.  
      bpminlicense
    50.  
      bpnbat
    51.  
      bpnbaz
    52.  
      bppficorr
    53.  
      bpplcatdrinfo
    54.  
      bpplclients
    55.  
      bppldelete
    56.  
      bpplinclude
    57.  
      bpplinfo
    58.  
      bppllist
    59.  
      bpplsched
    60.  
      bpplschedrep
    61.  
      bpplschedwin
    62.  
      bppolicynew
    63.  
      bpps
    64.  
      bprd
    65.  
      bprecover
    66.  
      bprestore
    67.  
      bpretlevel
    68.  
      bpschedule
    69.  
      bpschedulerep
    70.  
      bpsetconfig
    71.  
      bpstsinfo
    72.  
      bpstuadd
    73.  
      bpstudel
    74.  
      bpstulist
    75.  
      bpsturep
    76.  
      bptestbpcd
    77.  
      bptestnetconn
    78.  
      bptpcinfo
    79.  
      bpup
    80.  
      bpverify
    81.  
      cat_convert
    82.  
      cat_export
    83.  
      cat_import
    84.  
      configureCertsForPlugins
    85.  
      configureMQ
    86.  
      configurePorts
    87.  
      configureWebServerCerts
    88.  
      create_nbdb
    89.  
      csconfig cldinstance
    90.  
      csconfig cldprovider
    91.  
      csconfig meter
    92.  
      csconfig throttle
    93.  
      csconfig reinitialize
    94.  
      duplicatetrace
    95.  
      importtrace
    96.  
      jbpSA
    97.  
      jnbSA
    98.  
      ltid
    99.  
      manageClientCerts
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcatsync
    103.  
      NBCC
    104.  
      NBCCR
    105.  
      nbcertcmd
    106.  
      nbcertupdater
    107.  
      nbcldutil
    108.  
      nbcloudrestore
    109.  
      nbcomponentupdate
    110.  
      nbcplogs
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_restore
    116.  
      nbdb_unload
    117.  
      nbdbms_start_server
    118.  
      nbdbms_start_stop
    119.  
      nbdc
    120.  
      nbdecommission
    121.  
      nbdelete
    122.  
      nbdeployutil
    123.  
      nbdevconfig
    124.  
      nbdevquery
    125.  
      nbdiscover
    126.  
      nbdna
    127.  
      nbemm
    128.  
      nbemmcmd
    129.  
      nbfindfile
    130.  
      nbfirescan
    131.  
      nbftadm
    132.  
      nbftconfig
    133.  
      nbgetconfig
    134.  
      nbhba
    135.  
      nbholdutil
    136.  
      nbhostidentity
    137.  
      nbhostmgmt
    138.  
      nbhypervtool
    139.  
      nbimageshare
    140.  
      nbinstallcmd
    141.  
      nbjm
    142.  
      nbkmsutil
    143.  
      nboraadm
    144.  
      nborair
    145.  
      nbpem
    146.  
      nbpemreq
    147.  
      nbperfchk
    148.  
      nbplupgrade
    149.  
      nbrb
    150.  
      nbrbutil
    151.  
      nbregopsc
    152.  
      nbreplicate
    153.  
      nbrepo
    154.  
      nbrestorevm
    155.  
      nbseccmd
    156.  
      nbsetconfig
    157.  
      nbsnapimport
    158.  
      nbsnapreplicate
    159.  
      nbsqladm
    160.  
      nbstl
    161.  
      nbstlutil
    162.  
      nbstop
    163.  
      nbsu
    164.  
      nbsvrgrp
    165.  
      resilient_clients
    166.  
      restoretrace
    167.  
      stopltid
    168.  
      tl4d
    169.  
      tl8d
    170.  
      tl8cd
    171.  
      tldd
    172.  
      tldcd
    173.  
      tlhd
    174.  
      tlhcd
    175.  
      tlmd
    176.  
      tpautoconf
    177.  
      tpclean
    178.  
      tpconfig
    179.  
      tpext
    180.  
      tpreq
    181.  
      tpunmount
    182.  
      verifytrace
    183.  
      vltadm
    184.  
      vltcontainers
    185.  
      vlteject
    186.  
      vltinject
    187.  
      vltoffsitemedia
    188.  
      vltopmenu
    189.  
      vltrun
    190.  
      vmadd
    191.  
      vmchange
    192.  
      vmcheckxxx
    193.  
      vmd
    194.  
      vmdelete
    195.  
      vmoprcmd
    196.  
      vmphyinv
    197.  
      vmpool
    198.  
      vmquery
    199.  
      vmrule
    200.  
      vmupdate
    201.  
      vnetd
    202.  
      vssat
    203.  
      vwcp_manage
    204.  
      vxlogcfg
    205.  
      vxlogmgr
    206.  
      vxlogview
    207.  
      W2KOption

Name

bpimagelist — produce status report on NetBackup images or removable media

SYNOPSIS

bpimagelist [-media] [-l | -L | -U | -idonly] [-tape] [-d date] [-e date] [-hoursago hours] [-keyword "keyword phrase"] [-client client_name] [-server server_name] [-backupid backup_id] [-option INCLUDE_PRE_IMPORT | INCLUDE_TIR | LIST_COMPLETE_COPIES | LIST_OLD_TO_NEW | ONLY_PRE_IMPORT | ONLY_TIR] [-policy policy_name] [-pt policy_type] [-rl retention_level] [-sl sched_label] [-st sched_type] [-class_id class_guid] [-stl_complete] [-stl_incomplete] [-stl_name storage_lifecycle_name] [-M master_server,...] [-inter-domain] [-v]
[-oracle_copilot_ir]

bpimagelist -changelog [-L | -json | -json_compact] [-min_changelog_keykey] [-d mm/dd/yyyy hh:mm:ss] [-e mm/dd/yyyy hh:mm:ss] [-new_images] [-updated_images] [-deleted_images]

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd

On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd

DESCRIPTION

bpimagelist uses a specified format to report on catalog images or the removable media that matches the attributes that are sent from the command options. bpimagelist reports on the removable media if the -media option is on the command line. If not, it reports on the catalog images.

The bpimagelist -changelog option reports on records in the image change log. You can filter the report to only new images, updated images, or deleted images.

It writes its debug log information to the following directory:

On UNIX systems: /usr/openv/netbackup/logs/admin
On Windows systems: install_path\NetBackup\logs\admin

You can use the information in this directory for troubleshooting.

The output of bpimagelist goes to standard output.

Authorized users can run this command.

For more about NetBackup authorization, see the NetBackup Security and Encryption Guide.

Note:

For the NetBackup Accelerator feature, bpimagelist reports the amount of data that was transferred over the network for each backup. You can also configure the command to show the transferred data in the field that normally shows the Accelerator backup image size. For details, see the Accelerator topics in the NetBackup Administrator's Guide Volume I, the NetBackup for VMware Administrator's Guide, and the NetBackup for NDMP Administrator's Guide.

OPTIONS

The following are the bpimagelist options:

-backupid backup_id

Specifies a backup ID to use for finding applicable images (applies only to the image list).

-changelog

Reports on the records from the image change log.

-class_id class_guid

Specifies a class identifier to use to select images. The identifier represents a GUID (globally unique identifier ). The bpimagelist command reports only those images with the specified class identifier.

-client client_name

Specifies a client name to use for finding backups or archives to list. The client name that bpimagelist searches for is case insensitive. For example, bpimagelist displays images from client, cLiEnT, and CLIENT. By default, bpimagelist searches for all clients.

-d mm/dd/yy hh:mm:ss, -e mm/dd/yy hh:mm:ss

Specifies the start date and end date range for the listing. If these values are not included on the command line, the default values are as follows:

  • The -d default is the previous midnight.

  • The -e default is the current date and time.

The complete format of the start date and end date is as follows:

-d specifies a start date and time for the listing. The output list shows only images in backups or the archives (or data in the change log for the -changelog option) 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 (or data in the change log for the -changelog option) that occurred at or before the specified date and time. Use the same format as for the start date.

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

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\VERITAS\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.

-hoursago hours

Includes the images that were written up to this many hours ago. This option is equivalent to a specification of a start time (-d) of the current time minus hours. hours must be 1 or greater.

-idonly

Produces an abbreviated list. For an image list, the list contains the creation time, backup ID, and schedule type of each image. For instance, if the list criterion is a window of time, the image list contains the following: For each image that is created in this window, only the creation time, backup ID, and schedule type of the image.

For a media list, the list contains only the applicable media IDs. For instance, if the list criterion is a window of time, the list contains only the media IDs that are written in this window.

The following options represent the criteria that determine which images or media are selected for the report. Where images are discussed in these options, media can be substituted if the report is a media report.

-inter-domain

Displays placeholder copies of images that have been replicated from the source and replicated images that are pending import on the target.

-json

Prints the data in json format and spans multiple lines.

-json_compact

Prints the data in json format on a single line.

-keyword "keyword_phrase"

Specifies a keyword phrase for NetBackup to use when it searches. The phrase must match the one that was previously associated with the image. For instance, the -k option of the bpbackup or the bparchive command associates a keyword with the image when the image is created.

-L

Generates the report in Long mode. For instance, for the Media List report, the report lists the information for each media ID as a series of attribute = value pairs. The density value is provided as both a descriptive term and a number. Long mode is the default condition.

-l

Reports in Short mode, which produces a terse listing. This option is useful for the scripts or programs that rework the listing contents into a customized report format.

-M master_server,...

Specifies a list of one or more alternative master servers. This list is a comma-delimited list of hostnames. If this option is present, each master server in the list runs the bpimagelist command. If an error occurs for any master server, the process stops at that point.

The report is the composite of the information that all the master servers in this list return. bpimagelist queries each of these master servers. The master server returns image or media information from the image catalogs. Each master server must allow access by the system that issues the bpimagelist command.

The default is the master server for the system running bpimagelist.

-media

Specifies that the listing reports on the removable media that are based on a set of criteria. If -media is not in the command line, the report is on images, not media.

-min_changelog_key key

Prints records with the specified log key and newer. Newer change log entries have greater change log key values.

[-new_images] [-updated_images] [-deleted_images]

Limits the change log report to new, updated, or deleted images. The default condition is to report all change log images.

-option option_name,...

Specifies one or more criteria for finding images to list. option_name is one of the following character strings in uppercase or lowercase:

  • INCLUDE_PRE_IMPORT - Report the images that completed phase 1 of an import.

  • INCLUDE_TIR - Report the images that true-image-recovery backups created.

  • LIST_COMPLETE_COPIES - Do not report fragments of a duplicate copy that is still in process.

  • LIST_OLD_TO_NEW - Report images by oldest to newest date.

  • ONLY_PRE_IMPORT - Report only the images that completed phase 1 of an import.

  • ONLY_TIR - Report only the images that true-image-recovery backups created.

The default is no restrictions on the selected images.

-oracle_copilot_ir

Searches for and displays the images that may be used for Oracle Copilot Instant Recovery.

-policy name

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

-pt policy_type

Specifies a policy type. By default, bpimagelist searches for all policy types.

The policy_type is one of the following character strings:

BigData
DataStore
DataTools-SQL-BackTrack
DB2
Enterprise-Vault
FlashBackup
FlashBackup-Windows
Hyper-V
Informix-On-BAR
LotusNotes
MS-Exchange-Server
MS-SharePoint
MS-SQL-Server
MS-Windows
NDMP
Oracle
PureDisk-Export
SAP
Split-Mirror
Standard
Sybase
Vault
VMware
-rl retention_level

Specifies the retention_level. The retention_level is an integer between 0 and 100. By default, bpimagelist searches for all retention levels.

Note:

If you run this command on a pre-NetBackup 8.0 media server, you can only specify a retention level between 0 and 24.

-server server_name

Specifies the name of a NetBackup server or ALL. If -server specifies a server name, then the images or media in the report are only those that reside on that server. The images also satisfy the other criteria that bpimagelist specifies. For instance, if -hoursago 2 is specified, the media must contain an image that was created in the past two hours.

The query goes to the image catalog that resides on the local master server. The master server must allow access by the system running bpimagelist.

The default is to report all media in the image catalog on the local master server, which is equivalent to the specification of -server ALL.

-sl sched_label

Specifies a schedule label for the image selection. The default is all schedules.

-st sched_type

Specifies a schedule type for the image selection. 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)

-stl_complete

Reports only the images that the storage lifecycle completely processed. This option cannot be used with the stl_incomplete option.

-stl_incomplete

Reports only the images that the storage lifecycle has not completely processed. This option cannot be used with the stl_complete option.

-stl_name storage_lifecycle_name

Specifies a storage lifecycle name to be used when you select images. Only images with the specified storage lifecycle name are selected.

-tape

Displays in the list only the images that have at least one fragment that resides on removable or tape-based media. Any disk-based fragments in these images are ignored. If an image has fragments on both tape and disk, this option displays only the tape-based fragments.

-U

Generates the report in User mode. The report is formatted. It includes a banner that lists the column titles. The status is a descriptive term instead of a number.

-v

Selects the verbose mode. This option causes bpimagelist to log additional information for debugging purposes. The information goes into the NetBackup administration daily debug log. This option is meaningful only when the debug log function is enabled; that is, when the following directory is defined:

UNIX systems: /usr/openv/netbackup/logs/admin

Windows systems: install_path\NetBackup\logs\admin

EXAMPLES

Example 1 - Show the last time the media IDs available to the server had a backup image that was written during the specified time:

# bpimagelist -media -d 01/05/2012 18:00:46 -e 01/06/2012 23:59:59 
-U
    Media ID   Last Written       Server
    --------   ----------------   ----------
    IBM000     01/06/2012 01:06   hatt
    AEK800     01/06/2012 03:01   hatt
    C0015      01/06/2012 02:01   hatt
    143191     01/05/2012 23:00   hatt

Example 2 - List all images that were written today:

# bpimagelist -U
Backed Up        Expires     Files     KB C Sched Type   Policy
---------------  -------- -------- ------ - ------------ ----------
01/27/2012 01:08 02/03/2012  1122  202624 N Full Backup  3590Grau
01/27/2012 01:01 02/03/2012  1122  202624 N Full Backup  IBM35pol
01/27/2012 03:01 02/03/2012   531 1055104 N Full Backup  DELLpol
01/27/2012 02:01 02/03/2012   961   31776 N Full Backup  QUALpol
01/27/2012 01:08 02/03/2012  2063  603328 N Full Backup  IBM35pol
01/27/2012 01:01 02/03/2012  2063  603328 N Full Backup  3590Grau

Example 3 - List all the images that the storage lifecycle has not completely processed that were written today:

# bpimagelist -U -stl_incomplete -idonly
Time:     12/6/2011 1:03:46 PM   ID: escape_1323198226         FULL (0)
Time:    12/6/2011 12:48:22 PM   ID: gordito19_1323197302      INCR (1)
Time:     12/6/2011 1:02:42 PM   ID: louisebl8vm1_1323198162   FULL (0)
Time:     12/6/2011 1:03:28 PM   ID: monterrey_1323198208      FULL (0)
Time:     12/6/2011 1:03:10 PM   ID: oprahbl14vm3_1323198190   FULL (0)
Time:     12/6/2011 1:03:11 PM   ID: oprahbl14vm4_1323198191   FULL (0)
Time:     12/6/2011 1:03:12 PM   ID: oprahbl15vm3_1323198192   FULL (0)
Time:     12/6/2011 1:03:17 PM   ID: oprahbl15vm4_1323198197   FULL (0)
Time:     12/6/2011 1:02:22 PM   ID: oprahbl8vm5_1323198142    FULL (0)
Time:     12/6/2011 1:02:41 PM   ID: thelmabl1vm1_1323198161   FULL (0)
Time:     12/6/2011 1:02:54 PM   ID: thelmabl1vm2_1323198174   FULL (0)
Time:     12/6/2011 1:03:01 PM   ID: thelmabl2vm1_1323198181   FULL (0)

Example 4 - List all the incomplete images that were written today for the pem_tort policy:

# bpimagelist -U -stl_incomplete -policy pem_tort

Backed Up         Expires    Files      KB  C  Sched Type  ...  Policy
----------------  ---------- ----- -------  -  ------------   ---------
12/06/2011 13:03  12/12/2011    86    1632  N  Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011    12   12512  N  Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     5      32  N  Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011  3742   95936  N  Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011  3762   95936  N  Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     8      64  N  Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     9      32  N  Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011  5041  223104  N  Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011     6      32  N  Full Backup ... pem_tort
12/06/2011 13:02  12/12/2011  3559   95808  N  Full Backup ... pem_tort
12/06/2011 13:03  12/12/2011     5      32  N  Full Backup ... pem_tort

Example 5 - List the new and updated change log entries entered since May 2, 2012:

# bpimagelist -changelog -new_images -updated_images -d 05/02/2012 10:18:00 
-json
Image Change Log Key:      2
Backup ID:                 jumpmanvm2_1335967123
Client Type:               Standard (0)
Image Change Log Oper. Id: Updated (2)
Image Change Log Time:     Wed 02 May 2012 10:39:09 AM CDT (1335973149)

FILES

UNIX systems:

/usr/openv/netbackup/logs/admin/log.mmddyy
/usr/openv/netbackup/db/images

Windows systems:

install_path\NetBackup\logs\admin\log.mmddyy
install_path\NetBackup\db\images

SEE ALSO

See bp.

See bparchive.

See bpbackup.

See bprestore.