Chapter 25. Setting up Stratis file systems

Procedure

1. Install packages that provide the Stratis service and command-line utilities:

   # dnf install stratisd stratis-cli

2. Verify that the stratisd service is enabled:

   # systemctl enable --now stratisd

Procedure

1. Erase any file system, partition table, or RAID signatures that exist on each block device that you want to use in the Stratis pool:

   # wipefs --all block-device

   where block-device is the path to the block device; for example, /dev/sdb.

2. Create the new unencrypted Stratis pool on the selected block device:

   # stratis pool create my-pool block-device

   where block-device is the path to an empty or wiped block device.

   Note

   Specify multiple block devices on a single line:

   # stratis pool create my-pool block-device-1 block-device-2

3. Verify that the new Stratis pool was created:

   # stratis pool list

Procedure

1. Log in to the RHEL 9 web console.

   For details, see Logging in to the web console.

2. Click Storage.
3. In the Storage table, click the menu button.

4. From the drop-down menu, select Create Stratis pool.

   

5. In the Create Stratis pool dialog box, enter a name for the Stratis pool.

   

6. Select the Block devices from which you want to create the Stratis pool.
7. Optional: If you want to specify the maximum size for each file system that is created in pool, select Manage filesystem sizes.
8. Click Create.

Procedure

1. Erase any file system, partition table, or RAID signatures that exist on each block device that you want to use in the Stratis pool:

   # wipefs --all block-device

   where block-device is the path to the block device; for example, /dev/sdb.

2. If you have not created a key set already, run the following command and follow the prompts to create a key set to use for the encryption.

   # stratis key set --capture-key key-description

   where key-description is a reference to the key that gets created in the kernel keyring.

3. Create the encrypted Stratis pool and specify the key description to use for the encryption. You can also specify the key path using the --keyfile-path option instead of using the key-description option.

   # stratis pool create --key-desc key-description my-pool block-device

   where

   key-description

   References the key that exists in the kernel keyring, which you created in the previous step.

   my-pool

   Specifies the name of the new Stratis pool.

   block-device

   Specifies the path to an empty or wiped block device.

   Note

   Specify multiple block devices on a single line:

   # stratis pool create --key-desc key-description my-pool block-device-1 block-device-2

4. Verify that the new Stratis pool was created:

   # stratis pool list

Procedure

1. Log in to the RHEL 9 web console.

   For details, see Logging in to the web console.

2. Click Storage.
3. In the Storage table, click the menu button.
4. From the drop-down menu, select Create Stratis pool.

5. In the Create Stratis pool dialog box, enter a name for the Stratis pool.

   

6. Select the Block devices from which you want to create the Stratis pool.

7. Select the type of encryption, you can use a passphrase, a Tang keyserver, or both:

   • Passphrase:

     1. Enter a passphrase.
     2. Confirm the passphrase

   • Tang keyserver:

     1. Enter the keyserver address. For more information, see Deploying a Tang server with SELinux in enforcing mode.
8. Optional: If you want to specify the maximum size for each file system that is created in pool, select Manage filesystem sizes.
9. Click Create.

Procedure

1. Log in to the RHEL 9 web console.
2. Click Storage.
3. In the Storage table, click the Stratis pool you want to rename.

4. On the Stratis pool page, click edit next to the Name field.

   

5. In the Rename Stratis pool dialog box, enter a new name.
6. Click Rename.

1. Create a pool from one or more block devices:

   # stratis pool create --no-overprovision pool-name /dev/sdb

   • By using the --no-overprovision option, the pool cannot allocate more logical space than actual available physical space.

2. Set overprovisioning mode in the existing pool:

   # stratis pool overprovision pool-name <yes|no>

   • If set to "yes", you enable overprovisioning to the pool. This means that the sum of the logical sizes of the Stratis filesystems, supported by the pool, can exceed the amount of available data space.

Verification

1. Run the following to view the full list of Stratis pools:

   # stratis pool list
   
   Name          Total Physical                    Properties     UUID                                   Alerts
   pool-name     1.42 TiB / 23.96 MiB / 1.42 TiB   ~Ca,~Cr,~Op    cb7cb4d8-9322-4ac4-a6fd-eb7ae9e1e540

2. Check if there is an indication of the pool overprovisioning mode flag in the stratis pool list output. The " ~ " is a math symbol for "NOT", so ~Op means no-overprovisioning.

3. Optional: Run the following to check overprovisioning on a specific pool:

   # stratis pool overprovision pool-name yes
   
   # stratis pool list
   
   Name          Total Physical                    Properties     UUID                                   Alerts
   pool-name     1.42 TiB / 23.96 MiB / 1.42 TiB   ~Ca,~Cr,~Op    cb7cb4d8-9322-4ac4-a6fd-eb7ae9e1e540

Procedure

1. Re-create the key set using the same key description that was used previously:

   # stratis key set --capture-key key-description

   where key-description references the key that exists in the kernel keyring, which was generated when you created the encrypted Stratis pool.

2. Verify that the Stratis pool is visible:

   # stratis pool list

Procedure

1. To create a Stratis file system on a pool, use:

   # stratis filesystem create --size number-and-unit my-pool my-fs

   where

   number-and-unit

   Specifies the size of a file system. The specification format must follow the standard size specification format for input, that is B, KiB, MiB, GiB, TiB or PiB.

   my-pool

   Specifies the name of the Stratis pool.

   my-fs

   Specifies an arbitrary name for the file system.

   For example:

   Example 25.1. Creating a Stratis file system

   # stratis filesystem create --size 10GiB pool1 filesystem1

Procedure

1. Log in to the RHEL 9 web console.

   For details, see Logging in to the web console.

2. Click Storage.
3. Click the Stratis pool on which you want to create a file system.

4. On the Stratis pool page, scroll to the Stratis filesystems section and click Create new filesystem.

   

5. In the Create filesystem dialog box, enter a Name for the file system.

   

6. Enter the Mount point for the file system.
7. Select the Mount option.
8. In the At boot drop-down menu, select when you want to mount your file system.

9. Create the file system:

   • If you want to create and mount the file system, click Create and mount.
   • If you want to only create the file system, click Create only.

Procedure

1. Determine the UUID attribute of the file system:

   $ lsblk --output=UUID /dev/stratis/my-pool/my-fs

   For example:

   Example 25.2. Viewing the UUID of Stratis file system

   $ lsblk --output=UUID /dev/stratis/my-pool/fs1
   
   UUID
   a1f0b64a-4ebb-4d4e-9543-b1d79f600283

2. If the mount point directory does not exist, create it:

   # mkdir --parents mount-point

3. As root, edit the /etc/fstab file and add a line for the file system, identified by the UUID. Use xfs as the file system type and add the x-systemd.requires=stratisd.service option.

   For example:

   Example 25.3. The /fs1 mount point in /etc/fstab

   UUID=a1f0b64a-4ebb-4d4e-9543-b1d79f600283 /fs1 xfs defaults,x-systemd.requires=stratisd.service 0 0

4. Regenerate mount units so that your system registers the new configuration:

   # systemctl daemon-reload

5. Try mounting the file system to verify that the configuration works:

   # mount mount-point