HP MSA2324sa HP StorageWorks 2300 Family Modular Smart Array CLI reference gui - Page 186

volumecopy

Page 186 highlights

volumecopy Description Copies a snapshot or a master volume to a new standard volume. The command creates the destination volume you specify, which must be in a vdisk owned by the same controller as the source volume. While the copy operation is in progress, the destination volume's type is shown as standard*; when complete, it changes to standard. Before copying a master volume, verify that the snap-pool has space for the temporary snapshot, which is used to track changes to the master volume while the copy is in progress. Also, you must unmount the master volume from hosts. After the volume copy has started, you can remount the master volume. Before copying a snapshot volume with its modified data, you must unmount it from hosts. When the volume copy starts, the snapshot and the destination volume will be offline (unavailable to hosts) until the operation is complete. CAUTION: Copying a mounted master volume or a mounted snapshot volume (when modified data is included) will result in data corruption. Syntax volumecopy source-volume volume1 dest-vdisk vdisk [modified-snapshot yes|no] volume2 Parameters source-volume volume1 Name or serial number of the snapshot or master volume to copy. For syntax, see Command syntax. dest-vdisk vdisk Name or serial number of the destination vdisk. For syntax, see Command syntax. modified-snapshot yes|no Optional. Specifies whether to include or exclude modified write data from the snapshot in the copy. This parameter applies only when the source volume is a snapshot; it is ignored if the source volume is a master volume. • yes: Include modified snapshot data. • no: Exclude modified snapshot data. If this parameter is omitted for a snapshot, modified snapshot data is excluded. volume2 A name for the volume to create in the destination vdisk. For syntax, see Command syntax. Example Copy master volume MV1 to new volume MV1copy on vdisk VD2: # volumecopy source-volume MV1 dest-vdisk VD2 Copy Leaving the source volume mounted when starting a volume copy operation will result in data corruption. The source volume must be unmounted prior to beginning the volume copy operation. The source volume can be remounted once the volume copy has started. In addition, once volume copy starts, the destination volume will be created, and will be offline until the volume copy operation is complete. Is the source volume unmounted from all Operating Systems? yes Success: Command completed successfully. - The volume copy started. # show volumes Vdisk Name ... Type VD2 MV1 ... mastervol VD2 MV1copy ... standard* 186

  • 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

186
volumecopy
Description
Copies a snapshot or a master volume to a new standard volume. The command creates the
destination volume you specify, which must be in a vdisk owned by the same controller as the source
volume. While the copy operation is in progress, the destination volume's type is shown as
standard*
; when complete, it changes to
standard
.
Before copying a master volume, verify that the snap-pool has space for the temporary snapshot,
which is used to track changes to the master volume while the copy is in progress. Also, you must
unmount the master volume from hosts. After the volume copy has started, you can remount the
master volume.
Before copying a snapshot volume with its modified data, you must unmount it from hosts. When the
volume copy starts, the snapshot and the destination volume will be offline (unavailable to hosts) until
the operation is complete.
CAUTION:
Copying a mounted master volume or a mounted snapshot volume (when modified data
is included) will result in data corruption.
Syntax
volumecopy
source-volume
volume1
dest-vdisk
vdisk
[modified-snapshot yes|no]
volume2
Parameters
source-volume
volume1
Name or serial number of the snapshot or master volume to copy. For syntax, see
Command syntax
.
dest-vdisk
vdisk
Name or serial number of the destination vdisk. For syntax, see
Command syntax
.
modified-snapshot yes|no
Optional. Specifies whether to include or exclude modified write data from the snapshot in the copy.
This parameter applies only when the source volume is a snapshot; it is ignored if the source volume
is a master volume.
yes
: Include modified snapshot data.
no
: Exclude modified snapshot data.
If this parameter is omitted for a snapshot, modified snapshot data is excluded.
volume2
A name for the volume to create in the destination vdisk. For syntax, see
Command syntax
.
Example
Copy master volume
MV1
to new volume
MV1copy
on vdisk
VD2
:
# volumecopy source-volume MV1 dest-vdisk VD2 Copy
Leaving the source volume mounted when starting a volume copy operation will
result in data corruption. The source volume must be unmounted prior to
beginning the volume copy operation. The source volume can be remounted once the
volume copy has started.
In addition, once volume copy starts, the destination volume will be created,
and will be offline until the volume copy operation is complete.
Is the source volume unmounted from all Operating Systems?
yes
Success: Command completed successfully. - The volume copy started.
# show volumes
Vdisk
Name
...
Type
----------------------------------------------------------------
VD2
MV1
...
mastervol
VD2
MV1copy
...
standard*
----------------------------------------------------------------