Skip to content

Commit

Permalink
Document minimum XFS volume size
Browse files Browse the repository at this point in the history
Longhorn 8488

Signed-off-by: Eric Weber <eric.weber@suse.com>
  • Loading branch information
ejweber authored and derekbit committed May 13, 2024
1 parent b6a1a51 commit c2378b8
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions content/docs/1.7.0/deploy/important-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current
- [Engine Upgrade Enforcement](#engine-upgrade-enforcement)
- [Danger Zone Setting Configuration](#danger-zone-setting-configuration)
- [Longhorn PVC with Block Volume Mode](#longhorn-pvc-with-block-volume-mode)
- [Minimum XFS Filesystem Size](#minimum-xfs-filesystem-size)
- [V2 Data Engine](#v2-data-engine)
- [Longhorn System Upgrade](#longhorn-system-upgrade)
- [Changing Default Huge Page Size to 2 GiB](#changing-default-huge-page-size-to-2-gib)
Expand Down Expand Up @@ -208,6 +209,20 @@ spec:
```
From this version, you need to add group id 6 to the security context or run container as root. For more information, see [Longhorn PVC ownership and permission](../../nodes-and-volumes/volumes/pvc-ownership-and-permission)

### Minimum XFS Filesystem Size

Recent versions of `xfsprogs` (including the version Longhorn currently uses) *do not allow* the creation of XFS
filesystems [smaller than 300
MiB](https://git.kernel.org/pub/scm/fs/xfs/xfsprogs-dev.git/commit/?id=6e0ed3d19c54603f0f7d628ea04b550151d8a262).
Longhorn v{{< current-version >}} does not allow the following:

- CSI flow: Volume provisioning if `resources.requests.storage < 300 Mi` and the corresponding StorageClass has `fsType:
xfs`
- Longhorn UI: `Create PV/PVC` with `File System: XFS` action to be completed on a volume that has `spec.size < 300 Mi`

However, Longhorn still allows the listed actions when cloning or restoring volumes created with earlier Longhorn
versions.

## V2 Data Engine

### Longhorn System Upgrade
Expand Down

0 comments on commit c2378b8

Please sign in to comment.