nbdevquery

nbdevquery — display NetBackup disk media status

SYNOPSIS

<admin_dir_path>nbdevquery -listdp -stype server_type [-dp disk_pool_name] [-M master_server] [-l | -U | -D]

<admin_dir_path>nbdevquery -liststs [-stype server_type] [-storage_server storage_server] [-l | -U | -D]

<admin_dir_path>nbdevquery -listdv -stype server_type [-dp disk_pool_name [-dv disk_volume_name]] [-M master_server] [-l | -U | -D]

<admin_dir_path>nbdevquery -listmediaid id... [-l | -U]

<admin_dir_path>nbdevquery -listglobals

On Windows systems, <admin_dir_path> is <install_path>\NetBackup\bin\admincmd\

DESCRIPTION

The nbdevquery command line utility is the disk equivalent of bpmedialist for tape. The following are the three operations that nbdevquery performs:

  • -listdp lists all disk pools.

  • -liststs lists all storage servers in the system.

  • -listdv displays status for disk volumes of imported disk pools. It includes such things as whether the volume is online or offline and the number of current readers (or writers) to the volume.

    When used with the -D option, the -listdv command returns a large set of data including the following values that NetBackup uses to determine the available free space within the disk pool:

    total_capacity : xxxxxxx -- The total size of the disk as derived from the file system.

    free_space : xxxxxxx -- The amount of free space on the disk as derived from the file system.

    potential_free_space : xxxxxxx -- The total size of all fragments on the disk that have been duplicated as part of a storage lifecycle policy and are eligible for expiration. The potential_free_space value is computed after duplication and expiration sessions. This information is applicable only when capacity managed retention is used for a storage destination.

    committed_space : xxxxxxx -- The amount of data that NetBackup estimates as being written to the disk, based on all in-progress backups.

    precommitted_space : xxxxxxx -- A helper value for committed_space. This value is decreased as a backup job proceeds and the total_capacity and free_space information is updated.

    NetBackup uses free_space, potential_free_space, and committed_space to determine how much space is available on a disk. It uses the following formula:

    available space = free_space + potential_free_space - committed_space

  • -listmediaid lists all disk volumes that have been given a disk media ID.

  • -listglobals lists the global disk attributes.

OPTIONS

-D

Sets the list type to dump debug data. This option dumps information without further processing. The output format and displayed fields are subject to change without notification.

-dp disk_pool_name

Specifies the name of the disk pool to be queried. This pool is the data storage area for this storage unit.

-dv disk_volume

Displays the status for only the specified disk volume. For NearStore, the input value is the volume path. For BasicDisk, the input value is the path. In all other cases, the input value is the volume name.

-l

Sets the list type to short. This option produces parsable output with all fields on one line, no headers. The first field indicates the version of the output as an aid to the script operation. Date and time values appear in UNIX long format; status values appear in integer form.

-listdp

Lists all imported disk pools in the NetBackup database. For an OpenStorage disk, -listdp lists all the disk pools that have been configured.

-listdv

Lists the status for all disk volumes of imported disk pools and returns a list of all disk volumes in the NetBackup database. See Example 3.

-listglobals

Lists NetBackup Disk Service Manager global disk attributes. If SPR is enabled, the SCSI Persistent Reservation setting is set to one (1). If LUN masking is enabled, the output shows zero (0) rather than 1.

-listmediaid id...

Lists all disk volumes that have been given the specified disk media IDs.

-liststs

Lists all servers that host storage. These include appliances such as OpenStorage, SAN-attached storage such as SharedDisk (NetBackup 6.5 media servers only), BasicDisk, and Network-attached storage (NAS devices) such as NetApp.

-storage_server storage_server

The host name of the storage server. For NearStore, this name is the hostname of the NearStore system. For BasicDisk, the name of the media server. In all other cases, this option is the name given to the storage server when it was created.

-stype server_type

Specifies the string that identifies the storage server type.

-U

Lists the configuration information about the specified disk pool, storage server, or disk storage (see Example 1). Some of the items cannot be changed.

EXAMPLES

EXAMPLE 1

# nbdevquery -liststs -stype AdvancedDisk -U 
Storage Server	: <machine_name> 
Storage Server Type : AdvancedDisk 
Storage Type		: Formatted Disk, Direct Attached 
State			 : UP 
Flag				: OpenStorage 
Flag				: AdminUp 
Flag				: InternalUp 
Flag				: SpanImages 
Flag				: LifeCycle 
Flag				: CapacityMgmt 
Flag				: FragmentImages 
Flag				: Cpr 
Flag				: RandomWrites 
Flag				: FT-Transfer

EXAMPLE 2

List all disk pools in the system. Note that SharedDisk operates on NetBackup 6.5 media servers only.

# nbdevquery -stype SharedDisk -dp disk-pool-1 
V6.5 Disk-Pool-1 0 97456 97480 10 80 90 server1,server2,server3

EXAMPLE 3

List all disk pool information in user format.

nbdevquery -listdv -stype AdvancedDisk -U
Disk Pool Name	: djs_bd
Disk Type		 : AdvancedDisk
Disk Volume Name	: Internal_16
Disk Media ID	 : @aaaab
Total Capacity (GB) : 68.21
Free Space (GB)	 : 55.93
Use%				: 17
Status			: UP
Flag				: OkOnRoot
Flag				: ReadOnWrite
Flag				: AdminUp
Flag				: InternalUp
Num Read Mounts	 : 0
Num Write Mounts	: 1
Cur Read Streams	: 8
Cur Write Streams   : 6

EXAMPLE 4

Do a disk drive dump of the disk pool sim_dp1 that SharedDiski uses. Note that SharedDisk operates on NetBackup 6.5 media servers only.

# nbdevquery -listdp -dp sim_dp1 -stype SharedDisk -D
Disk Drive Dump
  name				: <sim_dg1>
  id				: <sim_dg1>
  server_type		 : <SharedDisk>
  master_server	 : <daloa.min.veritas.com>
  access_media_server : <>
  disk_storage_type   : 6
  total_capacity	: 1286602752
  used_space		: 0
  sts_state		 : 0
  availability		: 2
  connectivity		: 0
  high_watermark	: 98
  low_watermark	 : 80
  num_diskvolumes	 : 3
  num_disks		 : 0

  num_stservers	 : 2
  system_tag		: <Imported from STS>
  user_tag			: <>
Storage Server [0]
  name : <daloa.min.veritas.com>
  id				: <>
  server_type		 : <SharedDisk>
  storage_type		: 6
  access_media_serv.: <>
Storage Server [1]
  name			: <blackjack.min.veritas.com>
  id				: <>
  server_type	 : <SharedDisk>
  storage_type	: 6
  access_media_serv.: <>

SEE ALSO

nbemmcmd