Skip to content

Commit 5593cf3

Browse files
denreadenrea
authored
Merge pull request #16275 from pauljewellmsft/amlfs-quota
[AMLFS] Add quota article
2 parents 2d1f0a7 + 568b426 commit 5593cf3

File tree

3 files changed

+167
-0
lines changed

3 files changed

+167
-0
lines changed

‎azure-managed-lustre/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,8 @@
3838
items:
3939
- name: Configure root squash settings
4040
href: root-squash-configure-settings.md
41+
- name: Set and configure Lustre quotas
42+
href: lustre-quotas.md
4143
- name: Security
4244
items:
4345
- name: Configure a network security group

‎azure-managed-lustre/index.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,8 @@ landingContent:
6262
links:
6363
- text: Configure root squash settings
6464
url: root-squash-configure-settings.md
65+
- text: Set and configure Lustre quotas
66+
url: lustre-quotas.md
6567
- title: Security
6668
linkLists:
6769
- linkListType: how-to-guide

‎azure-managed-lustre/lustre-quotas.md

Lines changed: 163 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,163 @@
1+
---
2+
title: Use quotas in Azure Managed Lustre file systems
3+
description: Learn how to set and configure quotas for Azure Managed Lustre file systems.
4+
ms.topic: how-to
5+
ms.date: 11/11/2024
6+
author: pauljewellmsft
7+
ms.author: pauljewell
8+
ms.reviewer: blepore
9+
10+
---
11+
12+
# Use quotas in Azure Managed Lustre file systems
13+
14+
In this article, you learn how to set and configure quotas for Azure Managed Lustre file systems. Quotas allow a system administrator to limit the amount of storage that users can consume in a file system. You can set quotas for individual users, groups, or projects.
15+
16+
## Prerequisites
17+
18+
- Existing Azure Managed Lustre file system - create one using the [Azure portal](create-file-system-portal.md), [Azure Resource Manager](create-file-system-resource-manager.md), or [Terraform](create-aml-file-system-terraform.md). To learn more about blob integration, see [Blob integration prerequisites](amlfs-prerequisites.md#blob-integration-prerequisites-optional).
19+
20+
## Quota types
21+
22+
Azure Managed Lustre supports the following types of quotas:
23+
24+
- **User quotas**: Limits the amount of storage that an individual user can consume in a file system. A user quota for a specific user can be different from the quotas of other users.
25+
- **Group quotas**: Limits the amount of storage that a group of users can consume in a file system. A group quota applies to all users who are members of a specific group.
26+
- **Project quotas**: Limits the amount of storage that a project can consume in a file system. A project quota applies to all files or directories associated with a project. A project can include multiple directories or individual files located in different directories within a file system.
27+
28+
The following limit quotas can be applied to user, group, or project quotas:
29+
30+
- **Block quotas**: Limits the amount of storage that a user, group, or project can consume in a file system. You configure the storage size in kilobytes.
31+
- **Inode quotas**: Limits the number of files that a user, group, or project can create in a file system. You configure the maximum number of inodes as an integer.
32+
33+
> [!NOTE]
34+
> Quotas *don't* apply to the root user. Quotas set for the root user are not enforced. Similarly, writing data as the root user using the sudo command bypasses enforcement of the quota.
35+
36+
## Set and view quotas for a file system
37+
38+
To set quotas for a file system, you use the `lfs setquota` command. The `lfs setquota` command allows you to set quotas for individual users, groups, or projects. To view quotas for a file system, you use the `lfs quota` command.
39+
40+
### Set quotas for a file system
41+
42+
To set a quota for a user, group, or project, use the following syntax:
43+
44+
```bash
45+
lfs setquota {-u|--user|-g|--group|-p|--project} username|groupname|projectid
46+
[-b block_softlimit] [-B block_hardlimit]
47+
[-i inode_softlimit] [-I inode_hardlimit]
48+
/mount_point
49+
```
50+
51+
The command uses the following parameters:
52+
53+
- `-u` or `--user` specifies a user to set a quota for.
54+
- `-g` or `--group` specifies a group to set a quota for.
55+
- `-p` or `--project` specifies a project to set a quota for.
56+
- `-b` specifies the soft limit for block quotas. `-B` specifies the hard limit for block quotas. To learn more about limits, see [Limits and grace periods for quotas](#limits-and-grace-periods-for-quotas).
57+
- `-i` specifies the soft limit for inode quotas. `-I` specifies the hard limit for inode quotas.
58+
- `/mount_point` specifies the mount point of the file system.
59+
60+
### [User quotas](#tab/user-quotas)
61+
62+
The following example sets a block quota with a soft limit of 1 TB and a hard limit of 2 TB for the user `user1` on the file system mounted to `/mnt/fs1`:
63+
64+
```bash
65+
sudo lfs setquota -u user1 -b 1T -B 2T /mnt/fs1
66+
```
67+
68+
### [Group quotas](#tab/group-quotas)
69+
70+
The following example sets an inode quota with a soft limit of 2500 and a hard limit of 5000 for the group `group1` on the file system mounted to `/mnt/fs1`:
71+
72+
```bash
73+
sudo lfs setquota -g group1 -i 2500 -I 5000 /mnt/fs1
74+
```
75+
76+
### [Project quotas](#tab/project-quotas)
77+
78+
The following example sets a block quota with a hard limit of 1 TB and an inode quota with a hard limit of 5000 for the project `project1` on the file system mounted to `/mnt/fs1`:
79+
80+
```bash
81+
sudo lfs setquota -p project1 -B 1T -I 5000 /mnt/fs1
82+
```
83+
84+
---
85+
86+
### View quotas for a file system
87+
88+
To view quotas for a file system, use the `lfs quota` command. You can view information about user quotas, group quotas, project quotas, and grace periods.
89+
90+
The following examples show different ways to display quotas on the file system mounted to `/mnt/fs1`:
91+
92+
| Command | Description |
93+
| --- | --- |
94+
| `lfs quota /mnt/fs1` | Displays general quota information (disk usage and limits) for the user running the command and the user's primary group. |
95+
| `lfs quota -u user1 /mnt/fs1` | Displays general quota information for the user `user1` in the file system. |
96+
| `lfs quota -g group1 /mnt/fs1` | Displays general quota information for the group `group1` in the file system. |
97+
| `lfs quota -p project1 /mnt/fs1` | Displays general quota information for the project `project1` in the file system. |
98+
| `lfs quota -t -u /mnt/fs1` | Displays block and inode grace periods for user quotas. |
99+
| `lfs quota -t -g /mnt/fs1` | Displays block and inode grace periods for group quotas. |
100+
| `lfs quota -t -p /mnt/fs1` | Displays block and inode grace periods for project quotas. |
101+
102+
## Limits and grace periods for quotas
103+
104+
Azure Managed Lustre enforces user, group, and project quotas as either a hard limit or a soft limit with a configurable grace period.
105+
106+
The hard limit is the absolute limit. If a user exceeds the hard limit, a block or inode allocation fails with a `Disk quota exceeded` message. Users who reach their quota hard limit must delete enough files or directories to get under the quota limit before they can write to the file system again.
107+
108+
The soft limit must be smaller than the hard limit. If a user exceeds the soft limit, the user can continue to exceed the quota until the grace period elapses or until the hard limit is reached. After the grace period ends, the soft limit converts to a hard limit and users are blocked from any further write operations until their usage returns below the defined block quota or inode quota limits. A user doesn't receive a notification or warning when the grace period begins.
109+
110+
The grace period defaults to one week, and applies to all users (for user quotas), groups (for group quotas), or projects (for project quotas). In other words, you can't apply different grace periods to different user quotas. The same restriction applies to group quotas and project quota. However, you *can* set different grace periods for inode and block quotas.
111+
112+
The grace period setting can vary for user, group, and project quotas, but the change applies to all entities within each of the three categories.
113+
114+
### Set grace periods for quotas
115+
116+
To set a grace period for a quota, use the following syntax:
117+
118+
```bash
119+
sudo lfs setquota -t {-u|-g|-p}
120+
[-b block_grace]
121+
[-i inode_grace]
122+
/mount_point
123+
```
124+
125+
The command uses the following parameters:
126+
127+
- `-t` specifies that you're setting a grace period.
128+
- `-u`sets a grace period for all users.
129+
- `-g` sets a grace period for all groups.
130+
- `-p` sets a grace period for all projects.
131+
- `-b` specifies the grace period for block quotas. `-i` specifies the grace period for inode quotas. Both `block_grace` and `inode_grace` values are in seconds by default. You can also use `XXwXXdXXhXXmXXs` format to specify the grace period in weeks, days, hours, minutes, or seconds.
132+
133+
No values are allowed after `-u`, `-g`, or `-p`. By default, the grace period is one week.
134+
135+
### [User quotas](#tab/user-quotas)
136+
137+
The following example sets the block quota grace period to five days (`5d`) for all users in the file system `fs1`:
138+
139+
```bash
140+
sudo lfs setquota -t -u -b 5d /mnt/fs1
141+
```
142+
143+
### [Group quotas](#tab/group-quotas)
144+
145+
The following example sets the inode quota grace period to one week, three days (`1w3d`) for all groups in the file system `fs1`:
146+
147+
```bash
148+
sudo lfs setquota -t -g -i 1w3d /mnt/fs1
149+
```
150+
151+
### [Project quotas](#tab/project-quotas)
152+
153+
The following example sets the block quota grace period to two weeks (`2w`) for all projects in the file system `fs1`:
154+
155+
```bash
156+
sudo lfs setquota -t -p -b 2w /mnt/fs1
157+
```
158+
159+
---
160+
161+
## Next steps
162+
163+
In this article, you learned how to set and configure quotas for Azure Managed Lustre file systems. To learn more about Azure Managed Lustre, see the [Azure Managed Lustre documentation](/azure/azure-managed-lustre/).

0 commit comments

Comments
 (0)