Creating FSx for OpenZFS file systems - FSx for OpenZFS

Creating FSx for OpenZFS file systems

You can create an FSx for OpenZFS file system using the Amazon FSx console, AWS CLI, or the Amazon FSx API.

This procedure uses the Standard create creation option to create an FSx for OpenZFS file system with a configuration that you customize for your needs. For information about using the Quick create creation option to create a file system with a default set of configuration parameters, see Step 1: Create an Amazon FSx for OpenZFS file system.

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

  2. On the dashboard, choose Create file system to start the file system creation wizard.

  3. On the Select file system type page, choose FSx for OpenZFS , and then choose Next. The Create file system page appears.

  4. For Creation method, choose Standard create.

    Begin your configuration with the File system details section.

    
                                    Standard create File system basics
                                        section, showing options for file system parameters, such as
                                        the file system name, SSD storage capacity, and throughput
                                        capacity.
  5. For File system name - optional, enter a name for your file system. It's easier to find and manage your file systems when you name them. You can use a maximum of 256 Unicode letters, white space, and numbers, plus these special characters: + - = . _ : /

  6. For Deployment type, choose Multi-AZ, Single-AZ 2, or Single-AZ 1.

    • Multi-AZ file systems replicate your data and support failover across multiple Availability Zones in the same AWS Region.

    • Single-AZ 2 and Single-AZ 1 file systems provide automatic self-healing within a single Availability Zone.

    For more information, see Deployment type availability and File system performance.

  7. For Storage capacity, enter the storage capacity of your file system, in GiB. Enter any whole number from 64–524288.

  8. For Provisioned SSD IOPS, you have two options to provision the number of IOPS for your file system:

    • Choose Automatic (the default) if you want Amazon FSx to automatically provision 3 IOPS per GB of SSD storage.

    • Choose User-provisioned if you want to specify the number of IOPS, up to the maximum for your file system. You pay for SSD IOPS that you provision above 3 IOPS per GB of SSD storage.

  9. Throughput capacity is the sustained speed at which the file server that hosts your file system can serve data. For Throughput capacity, choose from two options to provide your desired throughput capacity in MB per second (MB/s).

    • Choose the default Recommended throughput capacity if you want Amazon FSx to automatically choose the throughput capacity. The recommended value is based on the storage capacity that you choose.

    • Choose Specify throughput capacity if you want to specify the throughput capacity value.

      • For Multi-AZ and SINGLE_AZ_2 file systems, valid values are 160, 320, 640, 1280, 2560, 3840, 5120, 7680, or 10240 MBps.

      • For SINGLE_AZ_1 file systems, valid values are 64, 128, 256, 512, 1024, 2048, 3072, or 4096 MB/s.

      You pay for throughput capacity that you provision that exceeds the recommended amount.

    You can increase the amount of throughput capacity as needed at any time after you create the file system. For more information, see Managing throughput capacity.

  10. In the Network & security section, provide networking and security group information:

    • For Virtual Private Cloud (VPC), choose the Amazon VPC that you want to associate with your file system.

    • For VPC Security Groups, the ID for the default security group for your VPC should already be populated.

    • For Subnet, choose any value from the list of available subnets. If you are creating a Multi-AZ file system, also choose a Standby subnet for the standby file server.

    • (Multi-AZ only) For Select route tables, specify the VPC route tables in which rules for routing traffic to the correct file server will be created. Select all VPC route tables associated with the subnets in which your clients are located. By default, Amazon FSx selects your VPC's default route table.

    • (Multi-AZ only) Endpoint IP address range specifies the IP address range in which the endpoints to access your file system are created. You have three options for the endpoint IP address range:

      • Unallocated IP address range from your VPC – Amazon FSx chooses a block of 16 available IP addresses from the VPC’s CIDR range to use as the endpoint IP address range for the file system.

      • Floating IP address range outside your VPC – Amazon FSx chooses a 198.19.x.0/24 address range.

      • Enter an IP address range – You can provide a CIDR range of your own choosing. The IP address range that you choose can either be inside or outside the VPC’s IP address range, as long as it doesn't overlap with any subnet.

  11. In the Encryption section, for Encryption key, choose the AWS Key Management Service (AWS KMS) encryption key that protects your file system's data at rest.

  12. For Root volume configuration, you can set the following options for the file system's root volume:

    • For Data compression type, choose the type of compression to use for your volume—either Zstandard, LZ4, or No compression. Zstandard compression provides more data compression and higher read throughput than LZ4 compression. LZ4 compression provides less compression and higher write throughput performance than Zstandard compression. For more information about the storage and performance benefits of the volume data compression options, see Data compression.

    • For Copy tags to snapshots, choose whether to copy tags to the volume's snapshot.

    • For NFS exports, you can modify or remove the default client configuration setting. Client configurations determine client access and permissions for the volume.

      To provide additional client configurations:

      1. In the Client addresses field, specify which clients can access the volume. Enter an asterisk (*) for any client, a specific IP address, or a CIDR range of IP addresses.

      2. In the NFS options field, enter a comma-delimited set of export options. For example, enter rw to allow read and write permissions to the volume for the specified Client addresses.

      3. Choose Add client configuration.

      4. Repeat the procedure to add another client configuration.

      For more information, see NFS exports.

    • For Record size, choose whether to use the default suggested record size of 128 KiB, or to set a custom suggested record size for the volume. Workloads that write in fixed small or large record sizes might benefit from setting a custom record size, such as database workloads (small record size) or media streaming workloads (large record size). We recommend using the default setting in most cases. For more information about setting record size, see Volume properties.

    • For User and group quotas, you can set a storage quota for a user or group:

      1. For Quota type, choose USER or GROUP.

      2. For User or group ID, choose the ID number for the user or group.

      3. For Usage quota, choose the storage quota number for the user or group.

      4. Choose Add quota.

      5. Repeat the procedure to add a quota for another user or group.

  13. In Backup and maintenance - optional, you can set the following options:

    • For Daily automatic backup, choose Enabled for automatic daily backups. This option is enabled by default.

    • For Daily automatic backup window, set the time of the day in Coordinated Universal Time (UTC) that you want the daily automatic backup window to start. The window is 30 minutes starting from this specified time. This window can't overlap with the weekly maintenance backup window.

    • For Automatic backup retention period, set a period from 1–90 days to retain automatic backups.

    • For Weekly maintenance window, you can set the time of the week that you want the maintenance window to start. Day 1 is Monday, 2 is Tuesday, and so on. The window is 30 minutes starting from this specified time. This window can't overlap with the daily automatic backup window.

  14. For Tags - optional, you can enter a key and value to add tags to your file system. A tag is a case-sensitive key-value pair that helps you manage, filter, and search for your file system.

    Choose Next.

  15. Review the file system configuration on the Create file system page. Note which file system settings you can modify after the file system is created.

  16. Choose Create file system.

To create an FSx for OpenZFS file system, use the create-file-system CLI command (or the equivalent CreateFileSystem API operation). The following example creates an FSx for OpenZFS file system with a SINGLE_AZ_1 deployment type.

  • aws fsx create-file-system\ --region us-east-1 \ --file-system-type OPENZFS \ --storage-capacity 10000 \ --storage-type SSD \ --security-group-ids sg-0123456789abcdef3,sg-0123abcd4567ef89a \ --subnet-ids subnet-1234567890abcdef4 \ --tags Key=creator,Value=allison \ --open-zfs-configuration '{ "AutomaticBackupRetentionDays": 30, "CopyTagsToBackups": true, "DailyAutomaticBackupStartTime": "02:00", "DeploymentType": "SINGLE_AZ_1", "DiskIopsConfiguration": { "Iops": 250, "Mode": "USER_PROVISIONED" }, "RootVolumeConfiguration": { "CopyTagsToSnapshots": true, "DataCompressionType": "LZ4", "NfsExports": [ { "ClientConfigurations": [ { "Clients": "*", "Options": [ "rw","root_squash","crossmnt" ] } ] } ], "ReadOnly": false, "RecordSizeKiB": 128, "UserAndGroupQuotas": [ { "Id": 1001, "StorageCapacityQuotaGiB": 2000, "Type": "GROUP" } ] }, "ThroughputCapacity": 128 }'

After successfully creating the file system, Amazon FSx returns the file system's description in JSON format.