|
|
<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 -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
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
Creates and deletes disk pools from an enclosure or from an explicit list of disk volumes
Inventories disk pools to discover new storage (new volumes, resized volumes, or new LUNs)
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.)
The following are the nbdevconfig command operations.
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.
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.
Creates a disk pool from the specified list of disk volumes. Additional properties like High Water Mark and comments can be specified.
Deletes the specified disk pool from the NetBackup device database. Expire and delete all images before you run this option.
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.
Specifies an operation (-changestate, -deletedp, -inventorydp, ...) for which you want usage information.
Creates a disk pool from the specified enclosure. You can also specify additional properties like High Water Mark and comments.
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.
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.
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.
Previews inventory changes to be made, but does not perform the inventory update.
Lists the details of all enclosures (disk arrays) that any disk pool uses or may use.
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).
Adds a comment for the disk pool. Quotation marks (" ") are required if the comment contains any spaces.
The name of the disk pool that nbdevconfig previews, inventories, or creates.
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.
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.
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.
The percentage of used capacity to which staging and expiration operations drain each volume in the disk pool upon reaching the high water mark.
Suppresses all stdout messages, including successful confirmation output such as "Disk pool disk_pool_name was successfully inventoried."
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.
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).
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 list of storage server names for creating a disk pool. Spaces, and not commas, must separate the items in this list.
Sets the list type to user readable. This option produces a listing with more fields and one attribute per line.
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
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
# 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
# nbdevconfig -changestate -stype AdvancedDisk -dp diskpool_alpha -state DOWN
# nbdevconfig -changestate -stype AdvancedDisk -dp diskpool_alpha -dv alpha_vol1 -state UP
# 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.