bpstulist — NetBackup 8.3.0.1 | Cohesity Documentation

Name

bpstulist — display NetBackup storage units or storage unit groups

SYNOPSIS

bpstulist -group storage_unit_group [-verbose] [-M master_server [,...]

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 bpstulist command displays the attributes for a NetBackup storage unit or storage unit group. If no storage label or storage unit group name is specified, bpstulist displays the attributes for all NetBackup storage units or storage unit groups. In addition, this command accepts a comma-separated list of storage unit labels and displays the information for each of the storage units. The -show_available and -lsa flags enable you to list all of the configured media servers for a particular storage unit.

Errors are sent to stderr. A log of the command's activity is sent to the NetBackup admin log file for the current day.

For more about storage units, see the NetBackup Administrator's Guide, Volume I.

Any authorized user can run this command.

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

OPTIONS

List-type options:

-L

The list type is long. This option produces a listing with one storage unit attribute per line, in the format storage-unit attribute: value. Some attribute values are expressed in both interpreted form and raw form.

For a disk storage unit, a long listing has these attributes for each storage unit:

Label
Storage Unit Type (For example, Disk (0))
Media Subtype (For example, BasicDisk (1))
Host Connection
Concurrent Jobs
On Demand Only
Max MPX
Max Fragment Size
Block Sharing
OK On Root

A long listing has these attributes for each DiskPool disk storage unit:

Label
Storage Unit Type
Media Subtype (DiskPool (6))
Host Connection (one host per line)
Concurrent Jobs
On Demand Only
Max Fragment Size
Max MPX
Block sharing
Use WORM
File System Export
Disk Pool
Snapshots
Replication Primary
Replication Source
Replication Target
Mirror

A long listing has these attributes for each Media Manager storage unit:

Label
Storage Unit Type (For example, Tape (0))
Host Connection
Concurrent Jobs
On Demand Only
Robot Type
Max Fragment Size
Max MPX/drive

-l

The list type is short, which produces a terse listing. This option is useful for the scripts or the programs that rework the listing contents into a customized report format. This option is the default list type.

A single line contains the information for a storage unit, with all attribute values expressed in raw form. The fields on this line are:

label
storage unit type
host
density
concurrent_jobs
initial_mpx
path
on_demand_only
max_mpx
maxfrag_size
ndmp_attach_host
throttle (SnapVault only)
subtype
disk_flags
high_water_mark
low_water_mark
ok_on_root
disk_pool
host_list (one or more comma delimited)

-U

The list type is user. This option produces a listing with one storage-unit attribute per line, in the format storage-unit attribute: value. Attribute values are expressed in interpreted form.

For a disk storage unit, a user-type list has these attributes for each storage unit:

Label
Storage Unit Type (the storage-unit type)
Storage Unit Subtype
Host Connection
Concurrent Jobs
On Demand Only
Max MPX
Path
Max Fragment Size
Stage data
High Water Mark
Ok On Root

For a DiskPool disk storage unit, a user-type list has these attributes for each storage unit:

Label
Storage Unit Type
Host Connection (one host per line)
Concurrent Jobs
On Demand Only
Max Fragment Size
Max MPX
Use WORM
DiskPool
WORM Capable

For a Media Manager storage unit, a user-type list has these attributes for each storage unit:

Label
Storage Unit Type
Storage Unit Subtype
Host Connection
Concurrent Jobs
On Demand Only
Max MPX/drive
Robot Type
Max Fragment Size

-g

This list type causes the storage unit list to include the storage unit groups. The format of this option produces a listing with one storage unit group per line, in the format group_name: group_members. This option also includes the Selection Method value at the beginning of the Storage Unit Group List.

-go: This list type causes the storage unit list to include only information on the storage unit groups.

-label storage_unit_label1 [,storage_unit_label2...]: Specifies the name of the storage unit. This list is a comma-separated list of storage unit labels. If this option is not present, the listing is for all storage units. The maximum length for a storage-unit label is 128 characters.

-group storage_unit_group

Specifies a list of defined storage units and storage unit groups. For the list of storage units, the list type is short, which produces a terse listing. The list of storage unit groups is in the format group_name: group_members.

-lsa

Lists all storage units in the database including any available media servers on the media server list.

-M master_server1 [,master_server2...]

Specifies a comma-separated list of master servers. If this option is present, the command is run on each of the master servers in this list. The master servers must allow access by the system that issued the command. If an error occurs for any master server, the process stops at that point in the list. The default is the master server for the system where the command is entered.

-reason "string"

Indicates the reason why you choose this command action. The reason text string that you enter is captured and appears in the audit report. Enclose this string with double quotes ("..."). The string must not exceed 512 characters. It cannot begin with a dash character (-) nor contain a single quotation mark (').

-show_available

Lists all storage units in the database including any available media servers on the media server list.

-verbose

Select verbose mode for logging. This mode is meaningful when only you run with the debug log function on (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 - List the storage units that are defined on the master server apricot by using the -U display option:

# bpstulist -U -M apricot

Label:               redtest
Storage Unit Type:   Disk
Host Connection:     apricot
Concurrent Jobs:     1
On Demand Only:      yes
Max MPX:             4
Max Fragment Size:   512000 MB 
Block Sharing:       yes
OK On Root:          no
Use WORM:            no
Disk Pool:           simSnapVaultA
Snapshots:           yes
Replication Primary: no
Replication Source:  yes
Replication Target:  yes
Mirror:              no
WORM Capable:        no

Example 2 - The following output is realized by using the following bpstuadd command to create a regular disk staging storage unit:

# bpstuadd -label pear -path /tmp/pear -flags STAGE_DATA

Short output:

pear 0 felix.example.com 0 -1 -1 1 0 "/tmp/pear" 1 1 2000 
*NULL* 0 1 0 98 80 1 pear felix.example.com

Long output:

Label:               pear
Media Type:          Disk (0)
Host Connection:     felix.example.com
Concurrent Jobs:     1
On Demand Only:      yes
Path:                "/tmp/pear"
Robot Type:          (not robotic)
Max Fragment Size:   512000  
Max MPX:             1
Stage data:          no
Block Sharing:       no
File System Export:  no
High Water Mark:     98
Low Water Mark:      80
OK On Root:          no

FILES