bpstulist

bpstulist — display NetBackup storage units or storage unit groups

SYNOPSIS

<admin_dir_path>bpstulist -group storage_unit_group [-verbose] [-M master_server [,...]

On Windows systems, <admin_dir_path> 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.

See your NetBackup Administrator's Guide for more information on storage units.

Any authorized user can run this command.

For more information about NetBackup authorization, refer to 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 instance, a robot-type entry might be TL4 (7) (7 is NetBackup's internal value for a TL4 robot).

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

- Path

- Robot Type (not robotic)

- Max Fragment Size

- Max MPX

- Stage data

- Block sharing

- File System Export

- High Water Mark

- Low Water Mark

- 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

- File System Export

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

- robot_type

- robot_number

- 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 instance, a robot-type value might be TL4, instead of 7.

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

- DiskPool

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.

-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):

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
Path:			/usr/redtest
Max Fragment Size: 512000 MB 

Label:			 bluetest
Storage Unit Type: Media Manager
Host Connection:   apricot
Number of Drives:  6
On Demand Only:	yes
Max MPX/drive:	 1
Density:		 4mm - 4mm Cartridge
Robot Type/Number: TL4 / 0
Max Fragment Size: 1048576 MB

EXAMPLE 2

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

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

Short output:

apple 0 felix.min.veritas.com 0 -1 -1 1 0 "/tmp/apple" 1 1 2000 
*NULL* 0 1 0 98 80 1 apple felix.min.veritas.com

Long output:

Label:			 apple
Media Type:		Disk (0)
Host Connection:	 felix.min.veritas.com
Concurrent Jobs:	 1
On Demand Only:	yes
Path:				"/tmp/apple"
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

Windows systems: install_path\NetBackup\logs\admin\*

EMM database

bpstulist

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

FILES

SEE ALSO