Modifying SSD storage capacity and provisioned IOPS
When you need additional storage for your dataset, you can increase the solid state drive (SSD) storage capacity of your Amazon FSx for OpenZFS file system without any disruption to your end users or applications by using the Amazon FSx console, Amazon FSx API, or Amazon Command Line Interface (Amazon CLI).
You can also change the provisioned SSD IOPS for your file system when you increase SSD storage capacity, or as an independent action. To specify the amount of provisioned SSD IOPS for your file system, use one of two IOPS modes:
-
Use Automatic mode if you want Amazon FSx to automatically scale your SSD IOPS.
-
Use User-provisioned mode if you want to provision a specific amount of SSD IOPS.
For more information about these modes, see Considerations when updating storage and IOPS.
When you increase the SSD storage capacity of your Amazon FSx file system, the new capacity is
available for use within minutes. You can update the SSD storage capacity or SSD IOPS at
anytime, as long as storage capacity increases are at least 6 hours apart. These updates
do not impact the availability of your file system in any way. You will be billed for the
new SSD storage capacity after it becomes available to you. For more information, see
Amazon FSx for OpenZFS Pricing
You can track the progress of an SSD storage capacity increase or SSD IOPS update at any time by using the Amazon FSx console, CLI, and API. For more information, see Monitoring storage capacity and IOPS updates.
Once the increased SSD capacity is available, if the file system's root volume storage capacity quota is set to the
same size as the file system, FSx will automatically update the volume's storage capacity quota to match the
newly-increased file system capacity. Otherwise, you need to manually increase the storage capacity quota
of the
root volume, and any other volumes in your file system. For more information, see
Updating an Amazon FSx for OpenZFS volume.
Topics
Considerations when updating storage and IOPS
Here are a few important considerations when modifying your SSD storage capacity and provisioned IOPS:
Storage capacity increase only – You can only increase the amount of SSD storage capacity for a file system; you cannot decrease the storage capacity.
Storage capacity minimum increase – Each SSD storage capacity increase must be a minimum of 10 percent of the file system's current SSD storage capacity, up to the maximum allowed value of 512 Tebibytes (TiB)*.
Note
*The maximum storage capacity of your file system depends on the Amazon Web Services Region in which it is located. For more information, see Resource quotas for each file system.
Time between increases – You can't make further SSD storage capacity increases on a file system until 6 hours after the last increase was requested.
Allocating increased storage capacity – If the file system's root volume storage capacity quota is set to the same size as the file system, FSx will automatically update the volume's storage capacity quota to match the newly-increased file system capacity. Otherwise, you will need to manually increase storage on the root volume and any other volumes in your file system.
Provisioned IOPS modes – For a provisioned IOPS change, you must specify a mode. The two IOPS modes are the following:
Automatic mode – Amazon FSx automatically scales your SSD IOPS to maintain 3 SSD IOPS per GiB of storage capacity, up to the maximum number of IOPS for your file system.
User-provisioned mode – You specify the number of SSD IOPS, which must be greater than or equal to 3 IOPS per GiB of storage capacity. If the amount of SSD IOPS is not at least 3 IOPS per GiB, the request will fail. You can optionally provision a higher level of IOPS. If you do so, you pay for the average IOPS provisioned above 3 IOPS per GiB per file system.
Note
For file systems that are already configured with User-provisioned SSD IOPS, you must specify a value for User-provisioned SSD IOPS when you are updating your file system, or the update request will fail.
When to increase storage capacity
If you are running out of SSD storage, we recommend that you increase the storage capacity of your file system. You can monitor SSD storage capacity on the file system using these file system-level Amazon CloudWatch metrics.
StorageCapacity
measure the total amount of file system SSD storage capacity.UsedStorageCapacity
measures the amount of used SSD storage capacity.
You can use these metrics to measure storage capacity and create alarms. The following are some examples:
Per cent storage capacity used =
UsedStorageCapacity
÷StorageCapacity
Per cent storage capacity available =
StorageCapacity
÷UsedStorageCapacity
Amount of free storage capacity =
StorageCapacity
−UsedStorageCapacity
You can create a CloudWatch alarm on a metric and get notified when it drops below a specific threshold. For more information, see Monitoring with Amazon CloudWatch.
Updating SSD storage capacity and provisioned IOPS
You can increase a file system's SSD storage capacity and modify your provisioned SSD IOPS by using the Amazon FSx console, the Amazon CLI, or the Amazon FSx API.
Open the Amazon FSx console at https://console.amazonaws.cn/fsx/
. In the left navigation pane, choose File systems. In the File systems list, choose the FSx for OpenZFS file system that you want to update SSD storage capacity and SSD IOPS for.
On the Summary panel, choose Update next to the file system's SSD storage capacity value.
The Update SSD storage capacity and IOPS dialog box appears.
To increase SSD storage capacity, select Modify storage capacity.
For Input type, choose one of the following:
-
To enter the new SSD storage capacity as a percentage change from the current value, choose Percentage.
For Desired % increase, enter the percentage by which you want to increase storage capacity. This value must be at least 10 percent.
To enter the new value in GiB, choose Absolute.
For Desired storage capacity, enter the new value for SSD storage capacity value in GiB, up to the maximum allowed value of 512 TiB*.
Note
*The maximum storage capacity of your file system depends on the Amazon Web Services Region in which it is located. For more information, see Resource quotas for each file system.
-
-
For Provisioned SSD IOPS, you have two options to modify the number of provisioned SSD IOPS for your file system:
If you want Amazon FSx to automatically scale your SSD IOPS to maintain 3 provisioned SSD IOPS per GiB of primary storage capacity, up to a maximum of 160,000 for Single-AZ 1 and 400,000 for Multi-AZ*, choose Automatic.
If you want to specify the number of SSD IOPS, choose User-provisioned. Enter an absolute number of IOPS that is at least 3 times the amount of GiB of your primary storage tier, and less than or equal to the maximum number of IOPS for your file system.
Choose Update.
To update the SSD storage capacity and provisioned IOPS for an FSx for OpenZFS file system, use the Amazon CLI command update-file-system (UpdateFileSystem is the equivalent API action). Set the following parameters:
Set
--file-system-id
to the ID of the file system that you are updating.To increase your SSD primary storage capacity, set
--storage-capacity
to a value that is at least 10 percent greater than the current value.-
To modify your provisioned SSD IOPS, use the
--open-zfs-configuration DiskIopsConfiguration
property. This property has two parameters,Iops
andMode
:-
If you want to specify the number of provisioned SSD IOPS, use
Iops=
, up to a maximum of 160,000 for Single-AZ 1 and Multi-AZ*, andnumber_of_IOPS
Mode=USER_PROVISIONED
. The SSD IOPS value must be greater than or equal to 3 times the requested SSD storage capacity. If you're not increasing the storage capacity, the IOPs value must be greater than or equal to 3 times the current SSD storage capacity.Note
*The maximum SSD IOPS you can provision for Multi-AZ file systems depends on the Amazon Web Services Region your file system is located in. For more information, see Data access from disk.
-
If you want Amazon FSx to automatically increase your SSD IOPS, use
Mode=AUTOMATIC
and don't use theIops
parameter. Amazon FSx will automatically maintain 3 provisioned SSD IOPS per GiB of your primary storage capacity, up to a maximum of 160,000 for Single-AZ 1 and Multi-AZ.
-
The following example requests an increase of 2000 GiB to the file system's SSD storage capacity. It also requests 7000 provisioned SSD IOPS.
aws fsx update-file-system \ --file-system-id
fs-0123456789abcdef0
\ --storage-capacity2000
\ --open-zfs-configuration 'DiskIopsConfiguration={Iops=7000
,Mode=USER_PROVISIONED
}'
To monitor the progress of the update, use the describe-file-systems Amazon CLI command. Look for the AdministrativeActions
section in the output.
For more information, see AdministrativeAction in the Amazon FSx for OpenZFS API Reference.
Monitoring storage capacity and IOPS updates
You can monitor the progress of an SSD storage capacity and IOPS update by using the Amazon FSx console, the API, or the Amazon CLI.
Monitoring updates in the console
You can monitor file system updates in the Updates tab on the File system details page.
For SSD storage capacity and IOPS updates, you can view the following information:
- Update type
-
Supported types are Storage capacity, IOPS Mode, and SSD IOPS. The IOPS Mode and SSD IOPS values are listed for all storage capacity and IOPS scaling requests.
- Target value
-
The updated value for the file system's SSD storage capacity or IOPs.
- Status
-
The current status of the update. The possible values are as follows:
Pending – Amazon FSx has received the update request, but has not started processing it.
In progress – Amazon FSx is processing the update request.
Completed – The update finished successfully.
Failed – The update request failed. Choose the question mark (?) to see details on why the request failed.
- Request time
-
The time that Amazon FSx received the update action request.
Monitoring increases with the Amazon CLI and API
You can view and monitor file system SSD storage capacity increase requests using the
describe-file-systems Amazon CLI command and the
DescribeFileSystems API operation. The AdministrativeActions
array
lists the 10 most recent update actions for each administrative action type. When you
increase a file system's SSD storage capacity, a FILE_SYSTEM_UPDATE
AdministrativeActions
is generated.
The following example shows an excerpt of the response of a describe-file-systems
CLI command. The file system has a pending administrative action to increase the SSD storage
capacity to 2000 GiB and the provisioned SSD IOPS to 7000.
"AdministrativeActions": [ { "AdministrativeActionType": "FILE_SYSTEM_UPDATE", "RequestTime": 1586797629.095, "Status": "PENDING", "TargetFileSystemValues": { "StorageCapacity": 2000, "OpenZFSConfiguration": { "DiskIopsConfiguration": { "Mode": "USER_PROVISIONED", "Iops": 7000 } } } } ]
Amazon FSx processes the FILE_SYSTEM_UPDATE
action, increasing the file system's
storage capacity. When the new storage is available to the file system, the
FILE_SYSTEM_UPDATE
status changes to COMPLETED
. The storage
capacity shows the new larger value. This behavior is shown in the following excerpt of the
response of a describe-file-systems
CLI command.
"AdministrativeActions": [ { "AdministrativeActionType": "FILE_SYSTEM_UPDATE", "RequestTime": 1586799169.445, "Status": "UPDATED_OPTIMIZING", "TargetFileSystemValues": { "StorageCapacity": 2000, "OpenZFSConfiguration": { "DiskIopsConfiguration": { "Mode": "USER_PROVISIONED", "Iops": 7000 } } } } ]
If the storage capacity or IOPS update request fails, the status of the
FILE_SYSTEM_UPDATE
action changes to FAILED
, as shown
in the following example. The FailureDetails
property provides
information about the failure.
"AdministrativeActions": [ { "AdministrativeActionType": "FILE_SYSTEM_UPDATE", "RequestTime": 1586373915.697, "Status": "FAILED", "TargetFileSystemValues": { "StorageCapacity": 2000, "OpenZFSConfiguration": { "DiskIopsConfiguration": { "Mode": "USER_PROVISIONED", "Iops": 7000 } } }, "FailureDetails": { "Message": "
failure-message
" } } ]