Important Update: Cohesity Products Documentation
All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.
NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
- acsd
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- msdpcldutil
- msdpimgutil
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcmdrun
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbepicfile
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhsmcmd
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nblogparser
- nbmariadb
- nbmysql
- nbmlb
- nborair
- nboracmd
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbpgsql
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqlcmd
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tiermover
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
Name
nbdelete — remove deleted fragments from disk volumes
SYNOPSIS
-allvolumes [-ost_worm_lock | -snapshots | tar] [-priority number]
-list [-snapshots | tar] [{-dt disk_type -media_id name} | -backup_id bid [-copy_number number]]
{-dt disk_type -media_id name | -backup_id bid [-copy_number number]} [-ost_worm_lock | -snapshots | -tar] [-media_server name -storage_server name -priority number -bpdm_media_server name]
-deletion_stats [-U] [-snapshots] -stype server_type [-dp disk_pool_name [-dv disk_volume_name ]]
-deletion_stats [-U] [-tar] -media_id name
-purge_snap_deletion_list -stype server_type -media_id name -dp disk_pool_name -dv disk_volume_name [-force]
-purge_deletion_list {-media_id name | -backup_id bid [-copy_number number]} [-force]
-list
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
The nbdelete command removes all deleted fragments from the disk volumes that are specified on the command line. The -allvolumes option removes the fragments from all volumes that contain deleted fragments. The -dt, -media_id, -media_server, and -storage_server options specify an individual volume where deleted fragments should be removed.
The nbdelete command can also be used to refresh the write-once read-many (WORM) properties of copies by using the -ost_worm_lock option.
The nbdelete command can perform three operation types. These operations can be combined in a single execution of the command. The -tar option removes fragments from storage. The -snapshots options deletes snapshots. The -ost_worm_lock option finds the copies that require a retry or refresh of setting storage WORM attributes.
OPTIONS
- -allvolumes
Queries the image list in the EMM database to obtain the list of volumes with deleted fragments. It removes the fragments from those volumes and deletes eligible imported snaps, unimported snaps, and NetBackup (tar) images in that order. -allvolumes calls bpdm on master server to delete imported snaps. It also queries the storage servers with unimported snapshots but does not direct bpdm to delete them.
If no operation mode parameters (-tar, -snapshots, or -ost_worm_lock) are specified, the default modes are -tar and -snapshots. You must explicitly specify the -ost_worm_lock parameter in order for WORM processing to take place.
- -bpdm_media_server name
Starts up bpdm on the specified media server. Use if a media server has a much faster network connection to the disk volume's storage server for the delete operations.
- -copy_number cnum
Limits the images to be processed to the specified copy number.
- -deletion_stats
Displays information about disk fragments in the
DeletedImageFragmenttable or snapshots in the DBM_DeletedSnapReplica table that are ready to be deleted.Fragment or snapshot records are placed in these tables when their corresponding copies are expired from the NetBackup image catalog. This option queries
nbemmto retrieve the number of deletable fragments and the total number KBytes that are waiting to be deleted.- -dp disk_pool_name
Specifies the disk pool name. When -dp is used with -stype but not -dv, then -bprecover returns stats for all images for the disk pool. Only applicable to operations that are related to snapshots.
- -dt disk_type
Specifies the disk type where the deleted fragments should be removed. The following are the valid values for disk_type:
0 - All
1 - BasicDisk
6 - DiskPool
- -dv disk_volume_name
Specifies the disk volume name. Only applicable to operations that are related to snapshots.
- -force
Proceeds without asking for user verification.
Note:
Before you run nbdelete with the -force option, ensure that all media servers and valid disks can communicate with the master server. If they are unable, the -force option removes the expired images from EMM but it orphans the image fragments on the disk. Once an expired image is removed from EMM, there is no further attempt to remove the image disk fragments.
- -list
Lists imported and unimported snapshots or NetBackup (tar) images eligible for deletion. The list may be limited to the image with the specified backup ID and the specified copy number. You can also limit the list to images on a given media ID.
- -media_server name
Specifies the name that represents the media server for the volume whose deleted fragments are to be removed.
- -media_id
Specifies a 6-character media ID (that is, @aaaa0).
- -ost_worm_lock
Finds copies which have a Pending WORM state. Copies in such a state indicate that some failure may have occurred while NetBackup tried to set the WORM attributes for that copy. If any copies that require attention are found in the catalog, requests are made to storage attempting to set the correct WORM attributes.
Note that this operation does not result in deletion of any fragments.
- -priority number
Specifies a new priority for the job that overrides the default job priority.
- -purge_deletion_list
Removes all entries from deletion lists for a disk volume without trying to contact storage or delete anything from storage. This function is useful if a storage server has been decommissioned but deletable image records are still in the NetBackup catalog.
- -purge_snap_deletion_list
Removes all entries from snapshot deletion lists for a disk volume without trying to contact storage or delete anything from storage. This function is useful if a storage server has been decommissioned but deletable image records are still in the NetBackup catalog.
- -snapshots
Deletes all eligible imported and unimported image snapshots. When -snapshots is used with -deletion_stats on the command line, nbdelete displays stats for deletable unimported snapshots.
- -storage_server name
Specifies the name that represents the storage server of the volume whose deleted fragments are to be removed.
- -stype server_type
Specifies a disk storage server type. If you do not use the -dp option with -stype, the command returns stats for all images of the storage server type. Only applicable to operations that are related to snapshots.
- -tar
Deletes NetBackup (tar) images.
- -U
User mode query, with text header for each result. Default is comma-separated values.
EXAMPLES
Example 1
# nbdelete -deletion_stats -U -stype AdvancedDisk -dp ad_dp -dv /dv1 Frags : 6 KB : 2134
Example 2
# nbdelete -deletion_stats -U -media_id "@aaaa0" Frags : 2 KB : 64
Example 3: Only process WORM attributes for a specific copy.
#nbdelete -backup_id client_123456789 -copy_number 3 -ost_worm_lock
Example 4: Remove fragments from storage as needed; process WORM attributes as needed; and skips snapshots processing.
#nbdelete -allvolumes -tar -ost_worm_lock