Dell PowerVault MD3260i CLI Guide - Page 36

Using The Create Virtual Disk Command

Page 36 highlights

Using The Create Virtual Disk Command The create virtualDisk command enables you to create new virtual disks in the storage array in three ways: • Create a new virtual disk while simultaneously creating a new disk group to which you assign the physical disks. • Create a new virtual disk while simultaneously creating a new disk group to which the MD Storage Manager software assigns the physical disks. • Create a new virtual disk in an existing disk group. You must have unassigned physical disks in the disk group. You do not need to assign the entire capacity of the disk group to a virtual disk. Creating Virtual Disks With User-Assigned Physical Disks When you create a new virtual disk and assign the physical disks to use, the MD Storage Manager software creates a new disk group. The RAID controller module firmware assigns a disk group number to the new disk group. The following syntax is the general form of the command: create virtualDisk physicalDisks= (enclosureID0,slotID0...enclosureIDn,slotIDn) raidLevel=(0 | 1 | 5 | 6)userLabel= "virtualDiskName" [capacity=virtualDiskCapacity owner=(0 | 1) segmentSize=segmentSizeValue] [enclosureLossProtect=(TRUE | FALSE)] NOTE: The capacity, owner, segmentSize, and enclosureLossProtect parameters are optional. You can use one or all of the optional parameters as needed to help define your configuration. You do not, however, need to use any optional parameters. The userLabel parameter is the name to give to the virtual disk. The virtual disk name can be any combination of alphanumeric characters, hyphens, and underscores. The maximum length of the virtual disk name is 30 characters. Spaces are not allowed. You must put quotation marks (" ") around the virtual disk name. The physicalDisks parameter is a list of the physical disks that you want to use for the disk group. Enter the enclosure ID and slot ID of each physical disk that you want to use. Put parentheses around the list. Separate the enclosure ID and slot ID of a physical disk by a comma. Separate each enclosure ID and slot ID pair by a space. For example: (0,0 0,1 0,2 0,3 0,4) The capacity parameter defines the size of the virtual disk. You do not have to assign the entire capacity of the physical disks to the virtual disk. You can later assign any unused space to another virtual disk. The owner parameter defines the RAID controller module to which you want to assign the virtual disk. If you do not specify a RAID controller module, the RAID controller module firmware determines the owner of the virtual disk. The segmentSize parameter is the same as described for the autoConfigure storageArray command. See Using The Auto Configure Command. The enclosureLossProtect parameter turns on or turns off enclosure loss protection for the disk group. (For a description of how enclosure loss protection works, see Enclosure Loss Protection. Example of Creating Virtual Disks with User-Assigned Physical Disks client>smcli 123.45.67.89 -c "create virtualDisk physicalDisks=(0,0 0,1 0,2) raidLevel=5 userLabel= \"Engineering_1\" capacity=20 GB owner=0;" NOTE: The capacity parameter returns an error if you specify a value greater than or equal to 10 without a space separating the numeric value and its unit of measure. (For example, 10 GB returns an error, but 10 GB does not return an error). 36

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226

Using The Create Virtual Disk Command
The
create virtualDisk
command enables you to create new virtual disks in the storage array in three ways:
Create a new virtual disk while simultaneously creating a new disk group to which you assign the physical disks.
Create a new virtual disk while simultaneously creating a new disk group to which the MD Storage Manager
software assigns the physical disks.
Create a new virtual disk in an existing disk group.
You must have unassigned physical disks in the disk group. You do not need to assign the entire capacity of the disk
group to a virtual disk.
Creating Virtual Disks With User-Assigned Physical Disks
When you create a new virtual disk and assign the physical disks to use, the MD Storage Manager software creates a
new disk group. The RAID controller module firmware assigns a disk group number to the new disk group. The following
syntax is the general form of the command:
create virtualDisk physicalDisks=
(
enclosureID0,slotID0...enclosureIDn,slotIDn
)
raidLevel=(0 | 1 | 5 | 6)userLabel=
"
virtualDiskName
" [capacity=
virtualDiskCapacity
owner=(0 | 1) segmentSize=
segmentSizeValue
]
[enclosureLossProtect=(TRUE | FALSE)]
NOTE:
The
capacity
,
owner
,
segmentSize
, and
enclosureLossProtect
parameters are optional. You
can use one or all of the optional parameters as needed to help define your configuration. You do not, however,
need to use any optional parameters.
The
userLabel
parameter is the name to give to the virtual disk. The virtual disk name can be any combination of
alphanumeric characters, hyphens, and underscores. The maximum length of the virtual disk name is 30 characters.
Spaces are not allowed. You must put quotation marks (" ") around the virtual disk name.
The
physicalDisks
parameter is a list of the physical disks that you want to use for the disk group. Enter the
enclosure ID and slot ID of each physical disk that you want to use. Put parentheses around the list. Separate the
enclosure ID and slot ID of a physical disk by a comma. Separate each enclosure ID and slot ID pair by a space. For
example:
(0,0 0,1 0,2 0,3 0,4)
The
capacity
parameter defines the size of the virtual disk. You do not have to assign the entire capacity of the
physical disks to the virtual disk. You can later assign any unused space to another virtual disk.
The
owner
parameter defines the RAID controller module to which you want to assign the virtual disk. If you do not
specify a RAID controller module, the RAID controller module firmware determines the owner of the virtual disk.
The
segmentSize
parameter is the same as described for the
autoConfigure storageArray
command. See
Using The Auto Configure Command.
The
enclosureLossProtect
parameter turns on or turns off enclosure loss protection for the disk group. (For a
description of how enclosure loss protection works, see Enclosure Loss Protection.
Example of Creating Virtual Disks with User-Assigned Physical Disks
client>smcli 123.45.67.89 -c "create virtualDisk
physicalDisks=(0,0 0,1 0,2) raidLevel=5 userLabel=
\"Engineering_1\" capacity=20 GB owner=0;"
NOTE:
The
capacity
parameter returns an error if you specify a value greater than or equal to 10 without a
space separating the numeric value and its unit of measure. (For example,
10 GB
returns an error, but
10 GB
does not return an error).
36