-
NOTE: This command is used
to activate both Remote Replication and Remote Replication (Legacy).
Description
This command creates the replication repository virtual disks and
activates the Remote Replication and Remote Replication (legacy) premium
features. When using this command, the replication repository virtual
disk can be defined in one of three ways:
- User-defined physical disks
- User-defined disk group
- User-defined number of physical disks
If you define a number of physical disks, the RAID controller
module firmware selects which physical disks to use for the replication
repository virtual disk.
Syntax
User-Defined Physical Disks
activate storageArray feature=remoteReplication
repositoryRAIDLevel=(0 |1 | 5 | 6)
repositoryPhysicalDisks=(
enclosureID1,
drawerID1,
slotID1 ...
enclosureIDn,
drawerIDn,
slotIDn) [repositoryDiskGroupUserLabel="
diskGroupName"]
[enclosureLossProtect=(TRUE | FALSE)]
[drawerLossProtect=(TRUE | FALSE)]
[dataAssurance=(none | enabled)]
User-Defined Disk Group
activate storageArray feature=remoteReplication
repositoryDiskGroup=
diskGroupName
[freeCapacityArea=
freeCapacityIndexNumber]
User-Defined Number Of Physical Disks
activate storageArray feature=remoteReplication
repositoryRAIDLevel=(1 | 5 | 6)
repositoryPhysicalDiskCount=
numberOfPhysicalDisks
[repositoryDiskGroupUserLabel="
diskGroupName"]
[enclosureLossProtect=(TRUE | FALSE)]
[drawerLossProtect=(TRUE | FALSE)]
[dataAssurance=(none | enabled)]
Parameters
Parameter
|
Description
|
repositoryRAIDLevel
|
The RAID level for the replication repository virtual
disk. Valid values are
0
,
1
,
5
, or
6
.
|
repositoryPhysicalDisks
|
The physical disks for the replication repository
virtual disk. For dense expansion enclosures, specify the enclosure
ID value, the drawer ID value, and the slot ID value for each physical
disk that you assign to the replication repository virtual disk. For
non-dense expansion enclosures, specify the enclosure ID value and
the slot ID value for each physical disk that you assign to the replication
repository virtual disk. Enclosure ID values are
0
to
99
. Drawer ID values are
0
to
4
. Slot ID values are
0
to
31
. Enclose the enclosure
ID values, the drawer ID values, and the slot ID values in parentheses.
|
repositoryDiskGroupUserLabel
|
The name that you want to give the new disk group
in which the replication repository virtual disk is located. Enclose
the disk group name in double quotation marks (" ").
|
repositoryDiskGroup
|
The name of the replication repository disk group
where the replication repository virtual disk is located.
To determine the names of the disk groups in your storage
array, run the
show storageArray profile command.
|
freeCapacityArea
|
The index number of the free space in an existing
disk group that you want to use to create the replication repository
virtual disk. Free capacity is defined as the free capacity between
existing virtual disks in a disk group. For example, a disk group
might have the following areas: virtual disk 1, free capacity, virtual
disk 2, free capacity, virtual disk 3, free capacity. To use the free
capacity following virtual disk 2, you would specify:
freeCapacityArea=2
Run the
show diskGroup command to determine if a free capacity area
exists.
|
repositoryPhysicalDiskCount
|
The number of unassigned physical disks that you
want to use for the replication repository virtual disk.
|
enclosureLossProtect
|
The setting to enforce enclosure loss protection
when you create the replication repository virtual disk. To enforce
enclosure loss protection, set this parameter to
TRUE
. The default value is
FALSE
.
|
drawerLossProtect
|
The setting to enforce drawer loss protection when
you create the replication repository virtual disk. To enforce drawer
loss protection, set this parameter to
TRUE
.
The default value is
FALSE
.
|
dataAssurance
|
The setting to specify that a disk
group, and the virtual disks within the disk group, has data assurance
protection to make sure that the data maintains its integrity. When
you use this parameter, only protected physical disks can be used
for the disk group. These settings are valid:
-
none - The disk group does not have data assurance
protection.
-
enabled - The disk group has data assurance
protection. The disk group supports protected information and is formatted
with protection information enabled.
-
NOTE: This option is only valid
for enablement, if the drives support DA.
|
Notes
The
repositoryPhysicalDisks parameter
supports both dense expansion enclosures and non-dense expansion enclosures.
A dense expansion enclosure has drawers that hold the physical disks.
The drawers slide out of the expansion enclosure to provide access
to the physical disks. A non-dense expansion enclosure does not have
drawers. For a dense expansion enclosure, you must specify the identifier
(ID) of the expansion enclosure, the ID of the drawer, and the ID
of the slot in which a physical disk resides. For a non-dense expansion
enclosure, you need only specify the ID of the expansion enclosure
and the ID of the slot in which a physical disk resides. For a non-dense
expansion enclosure, an alternative method for identifying a location
for a physical disk is to specify the ID of the expansion enclosure,
set the ID of the drawer to
0
, and specify the
ID of the slot in which a physical disk resides.
If the physical disks that you select for the
repositoryPhysicalDisks parameter are not compatible with other parameters (such as the
repositoryRAIDLevel parameter), the script command returns
an error, and Remote Replication (Legacy) is not activated. The error
returns the amount of space that is needed for the replication repository
virtual disk. You can then re-enter the command, and specify the appropriate
amount of space.
If you enter a value for the repository
storage space that is too small for the replication repository virtual
disks, the RAID controller module firmware returns an error message
that provides the amount of space that is needed for the replication
repository virtual disks. The command does not try to activate Remote
Replication (Legacy). You can re-enter the command by using the value
from the error message for the repository storage space value.
When you assign the physical disks, if you set the
enclosureLossProtect parameter to
TRUE
and have selected more than one physical disk from any one enclosure,
the storage array returns an error. If you set the
enclosureLossProtect parameter to
FALSE
, the storage array performs
operations, but the disk group that you create might not have enclosure
loss protection.
When the RAID controller module
firmware assigns the physical disks, if you set the
enclosureLossProtect parameter to
TRUE
, the storage array returns
an error if the RAID controller module firmware cannot provide physical
disks that result in the new disk group having enclosure loss protection.
If you set the
enclosureLossProtect parameter to
FALSE
, the storage array performs the operation
even if it means that the disk group might not have enclosure loss
protection.
The
drawerLossProtect parameter defines if data on a virtual disk is accessible if a drawer
fails. When you assign the physical disks, if you set the
drawerLossProtect parameter to
TRUE and select more than one physical disk
from any one drawer, the storage array returns an error. If you set
the
drawerLossProtect parameter to
FALSE
, the storage array performs operations, but the disk group that
you create might not have drawer loss protection.
You must set the
enclosureLossProtect parameter and
the
drawerLossProtect parameter to the same value.
Both of the parameters must be either
TRUE
or
FALSE
. If the
enclosureLossProtect parameter and the
drawerLossProtect parameter is
set to different values, the storage array returns an error.