[raid]
section
Defines configuration settings for a RAID array that's built from a number of identical Amazon EBS volumes. The RAID drive is mounted on the head node and is exported to compute nodes with NFS.
The format is [raid
. raid-name
]raid-name
must
start with a letter, contain no more than 30 characters, and only contain letters, numbers, hyphens (-), and
underscores (_).
[raid rs]
shared_dir = raid
raid_type = 1
num_of_raid_volumes = 2
encrypted = true
Topics
shared_dir
(Required) Defines the mount point for the RAID array on the head and compute nodes.
The RAID drive is created only if this parameter is specified.
Don't use NONE
or /NONE
as the shared directory.
The following example mounts the array at /raid
.
shared_dir = raid
Update policy: If this setting is changed, the update is not allowed.
ebs_kms_key_id
(Optional) Specifies a custom AWS KMS key to use for encryption.
This parameter must be used together with encrypted = true
, and it must have a custom ec2_iam_role.
For more information, see Disk encryption with a custom KMS Key.
ebs_kms_key_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Update policy: If this setting is changed, the update is not allowed.
encrypted
(Optional) Specifies whether the file system is encrypted.
The default value is false
.
encrypted = false
Update policy: If this setting is changed, the update is not allowed.
num_of_raid_volumes
(Optional) Defines the number of Amazon EBS volumes to assemble the RAID array from.
Minimum number of volumes is 2
.
Maximum number of volumes is 5
.
The default value is 2
.
num_of_raid_volumes = 2
Update policy: If this setting is changed, the update is not allowed.
raid_type
(Required) Defines the RAID type for the RAID array.
The RAID drive is created only if this parameter is specified.
Valid options are the following values:
-
0
-
1
For more information on RAID types, see RAID info in the Amazon EC2 User Guide.
The following example creates a RAID 0
array:
raid_type = 0
Update policy: If this setting is changed, the update is not allowed.
volume_iops
(Optional) Defines the number of IOPS for io1
, io2
,
and gp3
type volumes.
The default value, supported values, and volume_iops
to volume_size
ratio varies by
volume_type and volume_size.
volume_type
=io1
-
Default
volume_iops
= 100Supported values
volume_iops
= 100–64000 †Maximum
volume_iops
tovolume_size
ratio = 50 IOPS per GiB. 5000 IOPS requires avolume_size
of at least 100 GiB. volume_type
=io2
-
Default
volume_iops
= 100Supported values
volume_iops
= 100–64000 (256000 forio2
Block Express volumes) †Maximum
volume_iops
tovolume_size
ratio = 500 IOPS per GiB. 5000 IOPS requires avolume_size
of at least 10 GiB. volume_type
=gp3
-
Default
volume_iops
= 3000Supported values
volume_iops
= 3000–16000Maximum
volume_iops
tovolume_size
ratio = 500 IOPS per GiB. 5000 IOPS requires avolume_size
of at least 10 GiB.
volume_iops = 3000
Update policy: This setting can be changed during an update.
† Maximum IOPS is guaranteed only on Instances built on the Nitro System
provisioned with more than 32,000 IOPS. Other instances guarantee up to 32,000 IOPS. Older io1
volumes
might not reach full performance unless you modify the volume. io2
Block Express
volumes support volume_iops
values up to 256000. For more information, see io2
Block Express volumes (In
preview) in the Amazon EC2 User Guide.
volume_size
(Optional) Defines the size of the volume to be created, in GiB.
The default value and supported values varies by volume_type.
volume_type
=standard
-
Default
volume_size
= 20 GiBSupported values
volume_size
= 1–1024 GiB volume_type
=gp2
,io1
,io2
, andgp3
-
Default
volume_size
= 20 GiBSupported values
volume_size
= 1–16384 GiB volume_type
=sc1
andst1
-
Default
volume_size
= 500 GiBSupported values
volume_size
= 500–16384 GiB
volume_size = 20
Note
Before AWS ParallelCluster version 2.10.1, the default value for all volume types was 20 GiB.
Update policy: If this setting is changed, the update is not allowed.
volume_throughput
(Optional) Defines the throughput for gp3
volume types, in
MiB/s.
The default value is 125
.
Supported values volume_throughput
= 125–1000 MiB/s
The ratio of volume_throughput
to volume_iops
can be no more than 0.25. The maximum
throughput of 1000 MiB/s requires that the volume_iops
setting is at least 4000.
volume_throughput = 1000
Note
Support for volume_throughput
was added in AWS ParallelCluster version 2.10.1.
Update policy: If this setting is changed, the update is not allowed.
volume_type
(Optional) Defines the type of volume to build.
Valid options are the following values:
gp2
,gp3
-
General purpose SSD
io1
,io2
-
Provisioned IOPS SSD
st1
-
Throughput optimized HDD
sc1
-
Cold HDD
standard
-
Previous generation magnetic
For more information, see Amazon EBS volume types in the Amazon EC2 User Guide.
The default value is gp2
.
volume_type = io2
Note
Support for gp3
and io2
was added in AWS ParallelCluster version 2.10.1.
Update policy: If this setting is changed, the update is not allowed.