Veritas NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup (9.0.0.1, 9.0)
  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.  
      configureCerts
    85.  
      configureCertsForPlugins
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig reinitialize
    94.  
      csconfig throttle
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      manageClientCerts
    101.  
      mklogdir
    102.  
      nbauditreport
    103.  
      nbcatsync
    104.  
      NBCC
    105.  
      NBCCR
    106.  
      nbcertcmd
    107.  
      nbcertupdater
    108.  
      nbcldutil
    109.  
      nbcloudrestore
    110.  
      nbcomponentupdate
    111.  
      nbcplogs
    112.  
      nbcredkeyutil
    113.  
      nbdb_admin
    114.  
      nbdb_backup
    115.  
      nbdb_move
    116.  
      nbdb_ping
    117.  
      nbdb_restore
    118.  
      nbdb_unload
    119.  
      nbdb2adutl
    120.  
      nbdbms_start_server
    121.  
      nbdbms_start_stop
    122.  
      nbdc
    123.  
      nbdecommission
    124.  
      nbdelete
    125.  
      nbdeployutil
    126.  
      nbdevconfig
    127.  
      nbdevquery
    128.  
      nbdiscover
    129.  
      nbdna
    130.  
      nbemm
    131.  
      nbemmcmd
    132.  
      nbfindfile
    133.  
      nbfirescan
    134.  
      nbftadm
    135.  
      nbftconfig
    136.  
      nbgetconfig
    137.  
      nbhba
    138.  
      nbholdutil
    139.  
      nbhostidentity
    140.  
      nbhostmgmt
    141.  
      nbhypervtool
    142.  
      nbidpcmd
    143.  
      nbimageshare
    144.  
      nbinstallcmd
    145.  
      nbjm
    146.  
      nbkmiputil
    147.  
      nbkmscmd
    148.  
      nbkmsutil
    149.  
      nboraadm
    150.  
      nborair
    151.  
      nbpem
    152.  
      nbpemreq
    153.  
      nbmlb
    154.  
      nbperfchk
    155.  
      nbplupgrade
    156.  
      nbrb
    157.  
      nbrbutil
    158.  
      nbregopsc
    159.  
      nbreplicate
    160.  
      nbrepo
    161.  
      nbrestorevm
    162.  
      nbseccmd
    163.  
      nbsetconfig
    164.  
      nbsnapimport
    165.  
      nbsnapreplicate
    166.  
      nbsqladm
    167.  
      nbstl
    168.  
      nbstlutil
    169.  
      nbstop
    170.  
      nbsu
    171.  
      nbsvrgrp
    172.  
      resilient_clients
    173.  
      restoretrace
    174.  
      stopltid
    175.  
      tldd
    176.  
      tldcd
    177.  
      tpautoconf
    178.  
      tpclean
    179.  
      tpconfig
    180.  
      tpext
    181.  
      tpreq
    182.  
      tpunmount
    183.  
      verifytrace
    184.  
      vltadm
    185.  
      vltcontainers
    186.  
      vlteject
    187.  
      vltinject
    188.  
      vltoffsitemedia
    189.  
      vltopmenu
    190.  
      vltrun
    191.  
      vmadd
    192.  
      vmchange
    193.  
      vmcheckxxx
    194.  
      vmd
    195.  
      vmdelete
    196.  
      vmoprcmd
    197.  
      vmphyinv
    198.  
      vmpool
    199.  
      vmquery
    200.  
      vmrule
    201.  
      vmupdate
    202.  
      vnetd
    203.  
      vssat
    204.  
      vwcp_manage
    205.  
      vxlogcfg
    206.  
      vxlogmgr
    207.  
      vxlogview
    208.  
      W2KOption
  3.  
    Index

Name

nbstl — add, delete, modify, or list NetBackup storage lifecycle policies

SYNOPSIS

nbstl storage_lifecycle_name [-add | -modify | -modify_current | -modify_version] [-dc class] [-dp duplication_priority] [-version version_number]

[-uf used_for1 [,used_for2,..used_forn]]

[-source source1[,source2,..sourcen]]

[-residence storage_unit1 | __NA__[,storage_unit2 | __NA__,..storage_unitn | __NA__]]

[-pool volume_pool1 | __NA__[,volume_pool2 | __NA__,..volume_pooln | __NA__]]

[-server_group host1 | *ANY* | *NONE* | __NA__[,host2 | *ANY* | *NONE* | __NA__,..hostn | *ANY* | *NONE* | __NA__]]

[-managed m1[,m2,..mn]]
[-rl retention_level1 | __NA__ [,retention_level2 | __NA__,..retention_leveln | __NA__]]
[-as alt_read_server1 | __NA__ [,alt_read_server2 | __NA__,..alt_read_servern | __NA__]]

[-mpx T | F [,T | F,..,T | F]] [-target_master target_master_server1 | __NA__ [,target_master_server2 | __NA__,..target_master_servern | __NA__]][-target_importslp target_importslp1 | __NA__ [,target_importslp2 | __NA__,..target_importslpn | __NA__]] [-defop T | F [,T | F,..,T | F]] [-v] [-M master_server] [-destpri priority1 [,priority2,..priorityn]] [-window window_1 [,window_2,..window_n]] [-wcopt option_set1 [,option_set2,..option_setn]

nbstl storage_lifecycle_name -delete [-v] [-M master_server]

nbstl [storage_lifecycle_name] -L | -l | -b | U | -json | -json_compact | -conflicts [-v] [-M master_server] [-all_versions] [-version version_number]

 

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 nbstl command can do the following:

  • -add adds a new storage lifecycle.

  • -delete deletes an existing storage lifecycle.

  • -modify modifies an existing storage lifecycle.

  • -L or -l lists long or short information about one or all storage lifecycles. -b lists only the storage lifecycle policy names themselves.

    The nbstl command creates, modifies, or deletes all of the destinations at the same time and does not support adding or modifying single destinations. To change properties of one destination, all of the existing destinations must be accounted for as well as the destination to be updated.

    Many of the options that need to be entered for a destination may not be applicable (NA). In that case, enter the value as __NA__ (double underscores before and after NA). The following options accept __NA__ as a value:

    • -residence

    • -pool

    • -server_group

    • -as (alternate read server)

    • -target_master

    • -target_importslp

Note:

Successful attempts to create, modify, or delete a storage lifecycle policy are audited and logged when they are initiated through the nbstl command, a NetBackup graphical user interface, or an API.

OPTIONS

-all_versions

Displays all versions of the specified storage lifecycle policy or all storage lifecycle policies if storage_lifecycle_name is not specified.

-b

Displays the name of the specified storage lifecycle policy or all storage lifecycle policies if storage_lifecycle_name is not specified. Use this option with the -all_versions option to display the name and version of all the storage lifecycle policies.

-conflicts

Shows how changes to this SLP as described by the other nbstl options can affect the policies that are associated with this SLP. nbstl submits the SLP changes for validation. It compares the proposed content of the SLP with all the policies that use the SLP and displays any errors on stdout. No changes are committed at this time. If no errors are found, the user can then resubmit the changes without the -conflicts option to commit the changes.

-dc class

Specifies the numeric data classification that is associated with this service.

-delete

Deletes the specified storage lifecycle policy.

-defop T | F [,T | F,..,T | F]

Sets the deferred operation flag for duplication copies.

  • F or f - Do not defer the creation of additional image copies.

  • T or t - Defer the creation of additional image copies until the source copy is about to expire. The duplication job begins about four hours before the source is to expire. This default time can be changed by changing the Deferred duplication offset parameter in the SLP Parameters host properties.

-dp duplication_priority

Specifies the duplication job priority that is associated with this Storage service.

storage_lifecycle_name

Identifies the name of the storage lifecycle policy to be created, modified, deleted, or displayed.

-json

Generates data in json format and spans multiple lines.

-json_compact

Generates data in json format on a single line.

-l

Displays the condensed output of the specified storage lifecycle policy, or all storage lifecycle policies if storage_lifecycle_name is not specified. The output contains only data for the storage lifecycle. It does not identify the name.

-L

Displays the long output of the specified storage lifecycle, or all storage lifecycles if storage_lifecycle_name is not specified. It identifies the output by name.

-M master_server

Specifies the NetBackup master server. The default is the local server.

-modify

Modifies the specified storage lifecycle policy. This option creates a new version of the storage lifecycle policy. You can modify information such as pool volume or retention level.

-modify_current

Modifies the current version of the storage lifecycle policy instead of creating a new policy. This option cannot be used with the - dc, -uf, -source, or - managed options.

-modify_version

Modifies the selected version (nn) of the storage lifecycle policy instead of creating a new policy. This option cannot be used with the - dc, -uf, -source, or - managed options.

-v

Selects the verbose mode for logging.

-version nn

Displays only the specified version number (nn) of the storage lifecycle policy or all storage lifecycle policies if storage_lifecycle_name is not specified.

The following destination options must all specify the same number of parameters, one for each destination of the Storage service. The resulting number of destinations equals the number of parameters. The parameters are separated by commas with no blank spaces between them.

-destpri priority1 [,priority2,...priorityn]]

Specifies the job priority for each storage lifecycle policy destination index. This option can be used only for import destinations. All other destinations must be set to 0.

-managed m,...

Specifies the managed retention type for each destination. The possible values are the following:

  • 0 - fixed

  • 1 - capacity managed

  • 2 - Expire after copy. After all operations complete that use this copy as a source, the copy expires. These include operations such as duplication, replication, backup from snapshot, and index from snapshot.

  • 3 - remote (imported) expiration date.

  • 4 - maximum snapshot rotation.

  • 5 - mirror copy

For example, -managed 4 means that the retention type is maximum snapshot rotation.

-mpx T | F [,T | F,..,T | F]

Sets the preserve multiplexing flag for duplication copies. This option is not allowed for backup or snapshot copies. Settings in the policy host and storage unit properties determine the multiplexed state of the backup copies. The flag is only relevant for tape copies. The option is -mpx followed by a set of commas that are separated by the following values:

  • F or f - Do not preserve multiplexing for the copy.

  • T or t - Preserve multiplexing for the copy, if possible.

  • __NA__ - Not applicable

-pool volume_pool1 | __NA__[,volume_pool2 | __NA__,..volume_pooln | __NA__]

Specifies the volume pool for each destination. Volume pools do not apply to disk copies.

-residence storage_unit1 | __NA__[,storage_unit2 | __NA__,..storage_unitn | __NA__]

The storage unit that is to be used for each destination. Storage units do not apply to snapshot destinations (-uf option set to 2) or duplication to remote master (-uf option set to 3).

-rl retention_level1 [,retention_level,...retention_level]

The retention level (0-100) applied to each destination. If you run this command on a pre-NetBackup 8.0 media server, the output only displays the retention levels between 0 and 24.

Note:

Retention level 25 has a value of expire immediately. You cannot edit this value.

-server_group host1 | *ANY* | *NONE* | __NA__[,host2 | *ANY* | *NONE* | __NA__,..hostn | *ANY* | *NONE* | __NA__]

Specifies the server group. Use *ANY* when you can use any media sharing server group. Use *NONE* when no sharing group is allowed.

-as alt_read_server1 | __NA__ [,alt_read_server2 | __NA__,..alt_read_servern | __NA__]

The alternate read server for each destination. Alternate read servers apply only to duplication destinations.

-source source1[,source2,...sourcen]

Configures a hierarchy of duplications for the -add and -modify operations of storage lifecycle.

Accepted values for -source are the following:

  • Backup and snapshot destinations - value must be 0. Backup and snapshot copies do not require a source.

  • Duplication destinations - the serial number of the destination from the list of destinations to be used as the source copy. (A snapshot copy cannot be used as the source for a duplication.) Duplication destinations that do not use any specific source (that is, they use the primary copy as the source), must be set to 0.

-U

Outputs data about the specified storage lifecycle(s) in user display format.

-uf used_for1 [used_for2,...used_forn]

Specifies when each destination is used. Use one of the following values:

  • 0 - backup

  • 1 - duplication

  • 2 - snapshot

  • 3 - replication to remote master (requires a -residence value of __NA__)

  • 4 - import

  • 5 - backup from snapshot

  • 6 - index from snapshot

  • 7 - replication

For example, -uf 2 is for snapshot operation.

-wcopt option1 [,option2,...optionn]

Specifies how to treat images that cannot be suspended. If a window closes and the jobs for an SLP have not completed, NetBackup attempts to suspend the images that are in progress. When the window reopens, NetBackup resumes those jobs at the point they were when suspended.

If the images cannot be suspended, the option determines how the images are processed:

  • SFN - Finish processing the active images. The window closes, but NetBackup continues to process the active images until they are finished. NetBackup does not begin to process any other images until the window reopens.

  • SHN - Cancel the processing of the active images. The window closes and NetBackup immediately stops processing the active images. When the window reopens, NetBackup begins to process the images where it left off.

-window window_1 [,window_2,..window_n]

Specifies a time window for a specific destination. If the user runs the bpschedule command to create a new duplication window, then a subsequent nbstl command can create a lifecycle with a backup and duplication destination. And duplication from this policy would run only from 6 AM and last for 4 hours (which means all job should be done by 10AM).

EXAMPLES

Example 1 - List the long output of information on lifecycle1:

# nbstl lifecycle1 -L 
                             Name: lifecycle1
              Data Classification: Gold
         Duplication job priority: 0
                            State: active
Destination 1             Use for: backup
                     Storage Unit: adv_dsu1
                      Volume Pool: (none specified)
                     Server Group: (none specified)
                   Retention Type: Fixed
                  Retention Level: 1 (2 hours)
            Alternate Read Server: (none specified)
            Preserve Multiplexing: false
                            State: inactive
                           Source: (client)

The storage unit named adv_dsu1 is inactive. Values for "State" in the -L display are either active or inactive.

Example 2 - Create a lifecycle named HDLifecyle1. This lifecycle has a data classification of Gold. It contains the following four destinations:

  • A backup destination (-uf value is 0) with storage unit AdvDisk1 which does not require any source (-source value is 0).

  • A backup destination using storage unit DataDomain1.

  • A duplication destination (-uf value is 1) with storage unit DataDomain2 that uses destination at serial number 1 (i.e. the backup destination with storage unit DataDomain1) as a source (-source value is 1).

  • A duplication destination with storage unit cooperstown-tape1 that uses the destination at serial number 2 (i.e. the duplication destination with storage unit DataDomain2) as the source (-source value is 2).

# nbstl HDLifecycle1 -add -dc Gold -uf 0,0,1,1,1 -residence AdvDisk1,
DadaDomain1,DataDomain2,cooperstown-tape1 -source 0,0,1,2

Example 3 - Create a lifecycle that does snapshot with backup to disk and then duplication to tape. The disk storage unit is DskSTU and the tape storage unit is TpSTU.

# nbstl LCPolicy -add -dc Gold -uf 0,1,2 -residence DskStU,TpSTU,__NA__ 
-pool NetBackup,DLP_Pool1,__NA__ -managed 0,0,0 -rl 6,12,1

Data retention is defined as follows:

  • Snapshot images are retained for one week.

  • Backup images on disk are retained for six (6) months.

  • Tape images are retained for five (5) years.

  • The user has defined retention level 12 to be five (5) years.

Example 4 - Change the retention level for existing version 4 of the lifecycle:

# nbstl LCPolicy -modify_version -version 4 -rl 4,6,7,7

The storage lifecycle policy must have four destinations previously defined.

Example 5 - List the condensed contents of version 2 of LCPolicy:

# nbstl LCPolicy -l -version 2

Example 6 - Change the fields in the current version of the storage lifecycle policy SLP8:

# nbstl SLP8 -modify_current -pool Pool1,Pool2,Pool3 -as __NA__,
AltReadServer2,__NA__ -mpx F,F,T

Example 7 - Create a new duplication window. Then a subsequent nbstl command can create a lifecycle with a backup and duplication destination (0,1). A previous bpplsched command set the duplication window for this policy to run from 6:00 a.m. to 10:00 a.m. (4 hours).

# nbstl morning_dup_slp -add -dc Gold -dp 999 -uf 0,1 -source 0,1 
-residence DISK1,TAPE1

SEE ALSO

See nbdc.

See nbstlutil.