Modifying throughput capacity - FSx for OpenZFS

Modifying throughput capacity

Every FSx for OpenZFS file system has a throughput capacity that is configured when you create the file system. You can modify your file system's throughput capacity at any time, as needed. Throughput capacity is one factor that determines the speed at which the file server hosting the file system can serve file data. Higher levels of throughput capacity also come with higher levels of I/O operations per second (IOPS) and more memory for caching of data on the file server. For more information, see Performance for Amazon FSx for OpenZFS.

When you modify your file system's throughput capacity, behind the scenes, Amazon FSx switches out the file system's file server. For Single-AZ (HA) and Multi-AZ (HA) file systems, it results in an automatic failover and failback while Amazon FSx switches out the preferred and secondary file servers. Single-AZ (non-HA) file systems will be unavailable for a few minutes during throughput capacity scaling. You are billed for the new amount of throughput capacity once it is available to your file system.

File systems offer varying levels of throughput capacity, depending on your deployment type. The values of throughput capacity (in MB/s) for all Single-AZ deployment types and Multi-AZ (HA) are as follows:

  • Single-AZ 2 (non-HA and HA) and Multi-AZ (HA) – 160, 320, 640, 1280, 2560, 3840, 5120, 7680, 10240

    Note

    For Multi-AZ file systems using the Intelligent-Tiering storage class, throughput capacity values start from 1280 MB/s.

  • Single-AZ 1(HA) – 128, 256, 512, 1024, 2048, 3072, 4096

  • Single-AZ 1(non-HA) – 64, 128, 256, 512, 1024, 2048, 3072, 4096

When to modify throughput capacity

Amazon FSx integrates with Amazon CloudWatch, enabling you to monitor your file system's ongoing throughput usage levels. The performance (throughput and IOPS) that you can drive through your file system depends on your specific workload’s characteristics, in addition to your file system’s throughput capacity, storage capacity, and storage type. You can use CloudWatch metrics to determine which of these dimensions to change to improve performance. For more information, see Monitoring with Amazon CloudWatch.

Modifying throughput capacity

You can modify a file system's throughput capacity using the Amazon FSx console, the AWS Command Line Interface (AWS CLI), or the Amazon FSx API.

  1. Open the Amazon FSx console at https://console.aws.amazon.com/fsx/.

  2. Navigate to File systems, and choose the FSx for OpenZFS file system that you want to increase the throughput capacity for.

  3. For Actions, choose Update throughput capacity. Or, in the Summary panel, choose Update next to the file system's Throughput capacity.

    The Update throughput capacity window appears.

  4. Choose the new value for Desired throughput capacity from the list.

  5. Choose Update to initiate the throughput capacity update.

    Note

    Your file system may experience a very brief period of unavailability during the update.

  • To modify a file system's throughput capacity, use the update-file-system CLI command (or the equivalent UpdateFileSystem API operation), as shown in the following example.

    aws fsx update-file-system \ --file-system-id fs-0123456789abcdef0 \ --open-zfs-configuration '{"ThroughputCapacity":512}'