HP P2000 HP P2000 G3 MSA System CLI Reference Guide - Page 45

create master-volume - mib

Page 45 highlights

create master-volume Description Creates a volume that is enabled for snapshots. The master volume is created in a specified vdisk and is associated with a specified snap pool. You can either associate the master volume with an existing snap pool owned by the same controller, or optionally specify the size of a new snap pool to automatically create. The vdisk and snap pool must be owned by the same controller. For use with remote replication, you can create a replication-prepared volume that is intended to be added to a replication set as its secondary volume. A secondary volume cannot be assigned a LUN or mapped to hosts. Syntax create master-volume vdisk vdisk size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] [snap-pool snap-pool] [reserve size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]] [lun LUN] [prepare-replication-volume] [ovms-uid ID] name Parameters vdisk vdisk Name or serial number of the vdisk to create the volume in. For vdisk syntax, see Command syntax on page 21. size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Sets the volume size using the current base, as shown by the show cli-parameters command. The unit can be specified as follows: • If base 2 is in use: B (bytes), KiB (kibibytes), MiB (mebibytes), or GiB (gibibytes) • If base 10 is in use: B (bytes), KB (kilobytes), MB (megabytes), or GB (gigabytes) If no unit is specified, the unit is 512-byte blocks. snap-pool snap-pool Optional. Name or serial number of the snap pool to associate with the new master volume. For volume syntax, see Command syntax on page 21. If this parameter is omitted, the system automatically creates a snap pool that is either 20% of the master volume's size or the minimum snap-pool size, whichever is larger. Use either this parameter or the reserve parameter. reserve size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Optional. Size of the snap pool to create in the vdisk. The default size is either 20% of the volume size or the minimum snap-pool size, whichever is larger. Use either this parameter or the snap-pool parameter. lun LUN Optional. A default LUN to assign to the new master volume. If this parameter is omitted, no LUN is assigned. Use either this parameter or the prepare-replication-volume parameter. prepare-replication-volume Optional. Specifies to create a replication volume instead of a regular master volume. Use either this parameter or the lun parameter. ovms-uid ID For a volume to be accessed by an OpenVMS host, assign a volume ID in the range 1-32767 to identify the volume to the host. name A name for the new volume. The name is case sensitive; cannot include a comma, double quote, or backslash; and can have a maximum of 20 bytes. A name that includes a space must be enclosed in double quotes. HP P2000 G3 MSA System CLI Reference Guide 45

  • 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
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448

HP P2000 G3 MSA System CLI Reference Guide
45
create master-volume
Description
Creates a volume that is enabled for snapshots. The master volume is created in a specified vdisk
and is associated with a specified snap pool. You can either associate the master volume with an
existing snap pool owned by the same controller, or optionally specify the size of a new snap pool to
automatically create. The vdisk and snap pool must be owned by the same controller.
For use with remote replication, you can create a replication-prepared volume that is intended to be
added to a replication set as its secondary volume. A secondary volume cannot be assigned a LUN
or mapped to hosts.
Syntax
create master-volume
vdisk
vdisk
size
size
[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]
[snap-pool
snap-pool
]
[reserve size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]]
[lun
LUN
]
[prepare-replication-volume]
[ovms-uid
ID
]
name
Parameters
vdisk
vdisk
Name or serial number of the vdisk to create the volume in. For vdisk syntax, see
Command syntax
on page 21.
size
size
[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]
Sets the volume size using the current base, as shown by the
show cli-parameters
command. The unit
can be specified as follows:
If base 2 is in use:
B
(bytes),
KiB
(kibibytes),
MiB
(mebibytes), or
GiB
(gibibytes)
If base 10 is in use:
B
(bytes),
KB
(kilobytes),
MB
(megabytes), or
GB
(gigabytes)
If no unit is specified, the unit is 512-byte blocks.
snap-pool
snap-pool
Optional. Name or serial number of the snap pool to associate with the new master volume. For
volume syntax, see
Command syntax
on page 21. If this parameter is omitted, the system
automatically creates a snap pool that is either 20% of the master volume's size or the minimum
snap-pool size, whichever is larger. Use either this parameter or the
reserve
parameter.
reserve
size
[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]
Optional. Size of the snap pool to create in the vdisk. The default size is either 20% of the volume
size or the minimum snap-pool size, whichever is larger. Use either this parameter or the
snap-pool
parameter.
lun
LUN
Optional. A default LUN to assign to the new master volume. If this parameter is omitted, no LUN is
assigned. Use either this parameter or the
prepare-replication-volume
parameter.
prepare-replication-volume
Optional. Specifies to create a replication volume instead of a regular master volume. Use either this
parameter or the
lun
parameter.
ovms-uid
ID
For a volume to be accessed by an OpenVMS host, assign a volume ID in the range 1–32767 to
identify the volume to the host.
name
A name for the new volume. The name is case sensitive; cannot include a comma, double quote, or
backslash; and can have a maximum of 20 bytes. A name that includes a space must be enclosed in
double quotes.