nbdevconfig

nbdevconfig — preview, import, create, or inventory disk pools

SYNOPSIS

<admin_dir_path>nbdevconfig -changedp [-noverbose] -stype server_lifecycle_type -dp disk_pool_name [-add_storage_servers storage_server...] | [-del_storage_servers storage_server...] [-hwm high_watermark_percent] [-lwm low_watermark_percent] [-max_io_streams n][-comment comment] [-setattribute attribute] [-clearattribute attribute] [-M master_server]

<admin_dir_path>nbdevconfig -changestate [-noverbose] -stype server_type -dp disk_pool_name [-dv disk_volume_name] -state [UP | DOWN | RESET] [-M master_server]

<admin_dir_path>nbdevconfig -createdp [-noverbose] -dp disk_pool_name -stype server_type -storage_servers storage_server... [-hwm high_watermark_percent] [-lwm low_watermark_percent] [-comment comment] [-dvlist filename] [-M master_server]

<admin_dir_path>nbdevconfig -deletedp [-noverbose] stype service_type -dp disk_pool_name [-M master_server]

<admin_dir_path>nbdevconfig -importenclr [-noverbose] -enclosure enclosure_name -storage_servers storage_server... [-hwm high_watermark_percent] [-lwm low_watermark_percent] [-comment comment] [-M master_server]

<admin_dir_path>nbdevconfig -inventorydp [-preview | -noverbose] -stype server_type -dp disk_pool_name [-media_server media_server] [-M master_server]

<admin_dir_path>nbdevconfig -mergedps [-noverbose] -stype service_type -primarydp disk_pool_name_1 -secondarydp disk_pool_name_2 [-M master_server]

<admin_dir_path>nbdevconfig -previewenclr [-l|-U] -enclosure enclosure_name | -storage_server storage_server... [-M master_server]

<admin_dir_path>nbdevconfig -previewdv -storage_server storage_server -stype storage_server_type [-media_server media_server] [-dp disk_pool_name] [-dvlist file_name] [-M master_server]

<admin_dir_path>nbdevconfig -help operation

<admin_dir_path>nbdevconfig -creatests [-noverbose] -storage_server storage_server -stype server_type -media_server media_server [-st storage_type] [-setattribute attribute]

<admin_dir_path>nbdevconfig -updatests [-noverbose] -storage_server storage_server -stype server_type -media_server media_server [-st storage_type]

<admin_dir_path>nbdevconfig -changests [-noverbose] -storage_server storage_server -stype server_type [-setattribute attribute] [-clearattribute attribute]

<admin_dir_path>nbdevconfig -deletests [-noverbose] -storage_server storage_server -stype server_type

<admin_dir_path>nbdevconfig -deletedv [-noverbose] -dp disk_pool_name -stype server_type-dv disk_volume_name [-M master_server]

<admin_dir_path>nbdevconfig -setSharedDiskSPR 0 | 1

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

DESCRIPTION

Use the nbdevconfig command as a command line interface or a menu interface to configure and support disk pool operations.

nbdevconfig performs the following disk pool operations:

  • Previews enclosures (disk arrays) available for disk pool creation

  • Imports enclosures

  • Previews and deletes disk volumes

  • Creates and deletes disk pools from an enclosure or from an explicit list of disk volumes

  • Merges the disk pools

  • Inventories disk pools to discover new storage (new volumes, resized volumes, or new LUNs)

  • Deletes a disk pool from NetBackup and the storage server

  • Modifies the disk pool properties

  • Changes the state of a disk pool or a disk volume

  • Creates and delete storage servers

  • Allows SCSI Persistent Reserve (SPR) or LUN operation

  • Sets and clears storage server attributes

  • Sets the maximum number of I/O streams (jobs) allowed in each volume of a disk pool

The vmupdate command detects whether new tapes have been added to or removed from a robotic library. In the same way, the inventory and the preview options of nbdevconfig detect if the storage administrator has changed the composition of the disk pool. An inventory detects if new volumes were added, existing volumes were resized (added more space), or volumes were removed. The inventory operation can also accept new space. (For example, it updates the NBU database with the existence of new disk volumes or configures new volumes from the new space.)

OPTIONS

The following are the nbdevconfig command operations.

-changedp

Changes the indicated properties of the disk pool. Specify the disk pool name option (-dp) and the storage server type (-stype) to identify the disk pool uniquely.

-changestate

Changes the state of the disk pool or disk volume. If -dv is specified, then -changestate changes the specified disk volume of the disk pool. Otherwise, it changes the state of the disk pool itself. The value for the state can be UP, DOWN, or RESET.

-createdp

Creates a disk pool from the specified list of disk volumes. Additional properties like High Water Mark and comments can be specified.

-creatests

Creates a storage server.

-deletedp

Deletes the specified disk pool from the NetBackup device database. Expire and delete all images before you run this option.

-deletedv

Deletes the specified disk volume from the specified disk pool. No backup image fragments can exist on the volume. No backup jobs can be active on the volume. The disk volume and disk pool must be DOWN.

-deletests

Deletes the specified storage server.

-help operation

Specifies an operation (-changestate, -deletedp, -inventorydp, ...) for which you want usage information.

-importenclr

Creates a disk pool from the specified enclosure. You can also specify additional properties like High Water Mark and comments.

-inventorydp

Discovers new or changed storage in a disk pool and accept these changes. Storage changes include new volumes, change of volume size, or new LUNs. Use the -preview option if you only want to view the details of the changes to the disk pool without accepting them.

-max_io_streams n

Limits the number of jobs that are allowed for each volume in the disk pool to the specified number n. This number is the sum of the jobs that read backup images and the jobs that write backup images. When the limit is reached, NetBackup chooses another available volume for write operations. If none is available, NetBackup queues jobs until a volume becomes available. Factors that affect the optimal number of streams include disk speed, CPU speed, and the amount of memory.

This parameter is not supported for BasicDisk. NetBackup does not limit the number of streams for BasicDisk storage units.

-mergedps

Merge the specified primary and secondary disk pools. Disk_pool_name_2 merges into "disk_pool_name_1" leaving only "disk_pool_name_1." Merge the specified primary and secondary disk pools.

-previewdv

Previews inventory changes to be made, but does not perform the inventory update.

-previewenclr

Lists the details of all enclosures (disk arrays) that any disk pool uses or may use.

-setSharedDiskSPR 0 | 1

Configures SPR (SCSI Persistent Reserve) or LUN masking. Zero (0) enables LUN masking; 1 enables SPR. (SharedDisk applies to NetBackup 6.5 media servers only.)

The following is a description of each of the nbdevconfig suboptions. Multiple options may use some of these suboptions (see the Synopsis).

-clearattribute attribute

Removes an attribute from the storage server for restore or duplication operations. It is used only with the -changests and -changedp options. You can specify more than one -clearattribute attribute on the command line. The following are the attributes:

  • PrefRestore. The storage server is preferred for the read side of restore operations.

  • ReqRestore. The storage server is required for the read side of restore operations.

  • ReqDuplicate. The storage server is required for the read side of duplication operations.

-comment comment

Adds a comment for the disk pool. Quotation marks (" ") are required if the comment contains any spaces.

-dp disk_pool_name

The name of the disk pool that nbdevconfig previews, inventories, or creates.

-dv disk_volume_name

The name of the disk volume.

-dvlist filename

The file name that contains a list of the disk volumes.

-enclosure enclosure_name

The unique name of the enclosure. When it is used with the previewenclr option, it displays details about the enclosure. This option runs successfully only if the vendor CLI is installed on the master server and its name in the disk array's host map.

When it is used with the importenclr option, it creates the disk pool from the specified enclosure.

-hwm high_watermark_percent

The percentage of used capacity at which the storage (disk volume) is considered full. No new jobs can be assigned to the volume, and staging expiration operations can be triggered.

-l

Sets the list type to short. This option produces parsable output with all fields on one line with no headers. The first field indicates the version of the output as an aid to the script operation.

-lwm low_watermark_percent

The percentage of used capacity to which staging and expiration operations drain each volume in the disk pool upon reaching the high water mark.

-M master_server

The name of the master server.

-media_server media_server

The media server that executes the operation.

-noverbose

Suppresses all stdout messages, including successful confirmation output such as "Disk pool disk_pool_name was successfully inventoried."

-setattribute attribute

Applies an attribute to the storage server or data pool for the read side of restore or duplication operations. It is used only with the -changests and changedp options. The attributes help you manage the restore traffic and duplication traffic. You can specify more than one -setattribute attribute on the command line. The following are the attributes:

  • PrefRestore. The storage server or data pool is preferred for the read side of restore operations. More than one storage server can have the PrefRestore attribute.

    The storage servers and data pools that are marked as PrefRestore are considered for use first. If none are available, any unmarked storage server is considered for use.

    Normal NetBackup load balancing occurs among all storage servers marked PrefRestore.

  • ReqRestore. The storage server or data pool is required for the read side of restore operations. More than one storage server or data pool can have the ReqRestore attribute.

    If a ReqRestore server is not available, NetBackup considers PrefRestore servers for use. If none are available, jobs queue until a ReqRestore or PrefRestore is available.

    If you configure ReqRestore servers but not PrefRestore servers, unmarked storage servers are never considered for restore jobs. Jobs are queued until a ReqRestore storage server is available to execute the job.

    Normal NetBackup rules for job retry apply.

    Normal NetBackup load balancing occurs for all storage servers marked ReqRestore. Load balancing does not occur between the ReqRestore and PrefRestore storage servers.

  • ReqRestore. The storage server is required for the read side of duplication operations. More than one storage server can have the ReqDuplicate attribute.

    If any storage server is marked as ReqDuplicate, only storage servers that are marked as ReqDuplicate are considered for use. If a ReqDuplicate server is unavailable, jobs queue until a ReqDuplicate server is available to execute the job. Normal NetBackup rules for job retry apply.

    ReqRestore also applies to storage server allocation for synthetic backup operations.

-st storage_type

The type of storage being used:

1 -- Formatted disk (default) OR 2 -- Raw disk

4 -- Direct attached OR 8 -- Network attached (default)

The two values are added together. For example a storage_type of 10 indicates a raw disk (2) that is network attached (8).

-state UP | DOWN | RESET

Selects the state of the disk pool or disk volume. Specify UP to up the disk pool or disk volume and DOWN to down the disk pool or disk volume.

The RESET option does the following:

  • Sets the internal state to UP (both disk volume and disk pool)

  • Sets committed_space to ZERO (disk volume only)

  • Sets the precommitted space to ZERO (disk volume only)

-storage_server storage_server

A single storage server. Interpretation differs depending upon one of the following options that are used with it:

  • previewdv: -storage_server restricts the output to arrays that are connected to the specified servers. All of the hosts must be connected to all storage (LUNs) within the disk volume.

  • creatests: -storage_server identifies the host name of the storage server.

-storage_servers storage_servers...

The list of storage server names for creating a disk pool. Spaces, and not commas, must separate the items in this list.

-stype server_type

The string that identifies the storage server type.

-U

Sets the list type to user readable. This option produces a listing with more fields and one attribute per line.

EXAMPLES

EXAMPLE 1

Preview all SharedDisk enclosures that the storage servers see and display in short mode. Note that SharedDisk operates on NetBackup 6.5 media servers only.

# nbdevconfig -previewenclr -l -hosts daloa -M daloa
	V6.5 imported_dg 0 1.20 1.20 3 daloa.min.veritas.com

EXAMPLE 2

Preview all SharedDisk enclosures that the storage servers see and display in user readable mode. Note that SharedDisk operates on NetBackup 6.5 media servers only.

# nbdevconfig -previewenclr -U -storage_servers daloa -M daloa  
	Preview of Enclosure imported_dp as Disk pool
	Disk Pool Name   : imported_dp
	Disk Pool Id	 : imported_dp
	Disk Type		: SharedDisk
	Availability	 : Free
	Raw Size (GB)	: 1.20
	Usable Size (GB) : 1.20
	Num Volumes	: 3
	Storage Server   : daloa.min.veritas.com

EXAMPLE 3

Delete a disk pool.

# nbdevconfig -deletedp -dp Disk-Pool-2
failed to delete disk pool

...[user expires all images on the disk group]...

$ nbdevconfig -deletedp -dp Disk-Pool-2
Disk pool Disk-Pool-2 has been deleted successfully

EXAMPLE 4

Mark a disk pool as DOWN.

# nbdevconfig -changestate -stype AdvancedDisk -dp diskpool_alpha 
-state DOWN

EXAMPLE 5

Mark a disk volume as UP.

# nbdevconfig -changestate -stype AdvancedDisk -dp diskpool_alpha -dv 
alpha_vol1 -state UP

EXAMPLE 6

Inventory a disk group.

# nbdevconfig -inventorydp -preview -stype AdvancedDisk -dp 
Disk-Pool-2 
Old Raw Size (GB): 97.85
New Raw Size (GB): 103.45

Old Formatted Size (GB): 97.80
New Formatted Size (GB): 103.40

Old Host List: willow,Apple,dunamo
New Host List: Dellco,carrot,Apple,dynamo

Affected Storage Units
------------------------------
SSO-STU-7 - willow [...] would be removed from media server list
SSO-STU-9 - willow [...] would be removed from media server list,  \ 
switched to "any available" media server list.

Affected Storage Units
------------------------------
SSO-STU-7 -willow [...] was removed from media server list
SSO-STU-9 -willow [...] was removed from media server list, 	\
switched to "any available" media server list.

SEE ALSO

nbemmcmd