The splitvdiskcopy command creates a separate VDisk from a synchronized copy of a mirrored VDisk.
Syntax
>>-svctask-- --splitvdiskcopy-- -- -copy -- id -- --------------> >--+-----------------------------------------+------------------> '- -iogrp -- io_group_id | io_group_name -' >--+--------------------------------+---------------------------> '- -node-- --node_id | node_name-' >--+---------------------+--+------------------------------+----> '- -name-- --new_name-' '- -cache-- --readwrite | none-' >-- --+-----------------+-- --+---------+--+-vdisk_name-+------>< '- -udid-- --udid-' '- -force-' '-vdisk_id---'
Parameters
- -copy id
- (Required) Specifies the ID of the copy to split.
- -iogrp io_group_id | io_group_name
- (Optional) Specifies the I/O group to add the new virtual disk to. The default is the I/O group of the specified VDisk.
- -node node_id | node_name
- (Optional) Specifies the preferred node ID or the name for I/O operations to this virtual disk. You can use the -node parameter to specify the preferred access node.
- -name new_name
- (Optional) Assigns a name to the new virtual disk.
- -cache readwrite | none
- (Optional) Specifies the caching options for the new virtual disk. Enter readwrite or none; the default is readwrite.
- -udid udid
- (Optional) Specifies the udid for the new VDisk. The udid is a required identifier for OpenVMS hosts; no other hosts use this parameter. Supported values are a decimal number 0 - 32 767, or a hexadecimal number 0 - 0x7FFF. A hexadecimal number must be preceded by 0x; for example, 0x1234. The default udid value is 0.
- -force
- (Optional) Allows the split to proceed even when the specified copy is not synchronized, or even when the cache flush is likely to fail. The newly created VDisk might not be consistent.
Description
The splitvdiskcopy command creates a new VDisk in the specified I/O Group from a copy of the specified VDisk. If the copy that you are splitting is not synchronized, you must use the -force parameter. The command fails if you are attempting to remove the only synchronized copy. To avoid this, wait for the copy to synchronize or split the unsynchronized copy from the VDisk by using the -force parameter. You can run the command when either VDisk copy is offline.
An invocation example
svctask splitvdiskcopy -copy 1 vdisk8
The resulting output
Virtual Disk, id [1], successfully created.