Lustre Quota Troubleshooting - Revision history

Thcrowe: /* Multiple File Systems */

2025-01-31T14:58:28Z

Multiple File Systems

← Older revision		Revision as of 07:58, 31 January 2025
Line 66:		Line 66:
	- { index: 5, event: set_param, device: testfs, parameter: osd-.testfs.quota_slave_dt.enabled, value: ugp }		- { index: 5, event: set_param, device: testfs, parameter: osd-.testfs.quota_slave_dt.enabled, value: ugp }

	A file system named "testlab" will match index 2 ~~(wildcard) unless a specific entry for testlab has a greater~~ index value ~~in the params LLOG~~		A file system named "testlab" will match index 2. The enabled value will be '''none'''

			A file system named "testfs" will match index 2, and subsequently match index 5. The enabled value will be '''ugp'''

	== References and Links ==		== References and Links ==

Thcrowe: /* Status Verification */

2025-01-31T13:16:39Z

Status Verification

← Older revision		Revision as of 06:16, 31 January 2025
Line 45:		Line 45:

	The values for '''enabled=''' can be '''none''' or any combination of the letters '''u''' (for user), '''g''' (for group) and '''p''' (for project). The default value is '''none''' indicating '''NO QUOTA ENFORCEMENT IS ENABLED'''		The values for '''enabled=''' can be '''none''' or any combination of the letters '''u''' (for user), '''g''' (for group) and '''p''' (for project). The default value is '''none''' indicating '''NO QUOTA ENFORCEMENT IS ENABLED'''

			Multiple examples in the [https://doc.lustre.org/lustre_manual.xhtml#configuringquotas Lustre Operations Manual] outline how to configure quota.

	== Enable missing LDISKFS Features ==		== Enable missing LDISKFS Features ==

Thcrowe: /* Accounting and Quota Modification */

2025-01-30T22:43:08Z

Accounting and Quota Modification

← Older revision		Revision as of 15:43, 30 January 2025
Line 46:		Line 46:
	The values for '''enabled=''' can be '''none''' or any combination of the letters '''u''' (for user), '''g''' (for group) and '''p''' (for project). The default value is '''none''' indicating '''NO QUOTA ENFORCEMENT IS ENABLED'''		The values for '''enabled=''' can be '''none''' or any combination of the letters '''u''' (for user), '''g''' (for group) and '''p''' (for project). The default value is '''none''' indicating '''NO QUOTA ENFORCEMENT IS ENABLED'''

	== ~~Accounting and Quota Modification~~ ==		== Enable missing LDISKFS Features ==
	To enable the quota and project LDISKFS file system features, stop Lustre, unmount all targets and run the following:		To enable the quota and project LDISKFS file system features, stop Lustre, unmount all targets and run the following:

Thcrowe: /* Multiple File Systems */

2025-01-30T22:40:56Z

Multiple File Systems

← Older revision		Revision as of 15:40, 30 January 2025
Line 55:		Line 55:
	== Multiple File Systems ==		== Multiple File Systems ==

	The MGS can store configuration data about multiple file system. '''If''' a "wild card" lctl command is used, it will apply to any/all file systems.		The MGS can store configuration data about multiple file system. '''IF''' a "wild card" lctl command is used to set quota parameters (no file system name specified), it will apply to any/all file systems that are not specifically configured by a higher index '''set_param''' entry. See the example below:

	lctl set_param -P osd-..quota_slave_dt.enabled=none		lctl set_param -P osd-..quota_slave_dt.enabled=none
			lctl set_param -P osd-.testfs.quota_slave_dt.enabled=ugp

	~~It is also worth noting, the last/highest quota entry in the~~ MGS params ~~LLOG is applied~~		lctl --device MGS llog_print params
			- { index: 2, event: set_param, device: general, parameter: osd-..quota_slave_dt.enabled, value: none }
			- { index: 5, event: set_param, device: testfs, parameter: osd-.testfs.quota_slave_dt.enabled, value: ugp }

	~~lctl --device MGS llog_print~~ params		A file system named "testlab" will match index 2 (wildcard) unless a specific entry for testlab has a greater index value in the params LLOG

	== References and Links ==		== References and Links ==

Thcrowe: /* Multiple File Systems */

2025-01-30T22:14:06Z

Multiple File Systems

← Older revision		Revision as of 15:14, 30 January 2025
Line 54:		Line 54:

	== Multiple File Systems ==		== Multiple File Systems ==

			The MGS can store configuration data about multiple file system. '''If''' a "wild card" lctl command is used, it will apply to any/all file systems.

			lctl set_param -P osd-..quota_slave_dt.enabled=none

			It is also worth noting, the last/highest quota entry in the MGS params LLOG is applied

			lctl --device MGS llog_print params

	== References and Links ==		== References and Links ==

Thcrowe: /* Accounting and Quota Modification */

2025-01-30T22:02:16Z

Accounting and Quota Modification

← Older revision		Revision as of 15:02, 30 January 2025
Line 52:		Line 52:

	Your path to the appropriate block device (/dev/sdb) may be different. Exercise caution when using '''tune2fs'''		Your path to the appropriate block device (/dev/sdb) may be different. Exercise caution when using '''tune2fs'''

			== Multiple File Systems ==

	== References and Links ==		== References and Links ==

Thcrowe: /* Accounting and Quota Modification */

2025-01-30T21:11:25Z

Accounting and Quota Modification

← Older revision		Revision as of 14:11, 30 January 2025
Line 47:		Line 47:

	== Accounting and Quota Modification ==		== Accounting and Quota Modification ==
			To enable the quota and project LDISKFS file system features, stop Lustre, unmount all targets and run the following:

	~~If the '''~~quota~~''' or '''~~project~~''' file system feature is not enabled, , stop Lustre, unmount all targets and enable~~ the ~~file system feature~~(s) ~~with~~ '''tune2fs ~~-O quota, project~~'''		tune2fs -O quota, project /dev/sdb

			Your path to the appropriate block device (/dev/sdb) may be different. Exercise caution when using '''tune2fs'''

	== References and Links ==		== References and Links ==

Thcrowe: /* Accounting and Quota Modification */

2025-01-30T20:39:05Z

Accounting and Quota Modification

← Older revision		Revision as of 13:39, 30 January 2025
Line 48:		Line 48:
	== Accounting and Quota Modification ==		== Accounting and Quota Modification ==

	If the '''quota''' or '''project''' file system feature is not enabled, stop Lustre, unmount all targets and enable the file system feature(s) with '''tune2fs -O quota, project'''		If the '''quota''' or '''project''' file system feature is not enabled, , stop Lustre, unmount all targets and enable the file system feature(s) with '''tune2fs -O quota, project'''

	== References and Links ==		== References and Links ==

Thcrowe: /* Quota Modification */

2025-01-30T20:37:59Z

Quota Modification

← Older revision		Revision as of 13:37, 30 January 2025
Line 46:		Line 46:
	The values for '''enabled=''' can be '''none''' or any combination of the letters '''u''' (for user), '''g''' (for group) and '''p''' (for project). The default value is '''none''' indicating '''NO QUOTA ENFORCEMENT IS ENABLED'''		The values for '''enabled=''' can be '''none''' or any combination of the letters '''u''' (for user), '''g''' (for group) and '''p''' (for project). The default value is '''none''' indicating '''NO QUOTA ENFORCEMENT IS ENABLED'''

	== Quota Modification ==		== Accounting and Quota Modification ==

	~~User~~, ~~group~~ and ~~project~~ quota ~~can be modified on a per target basis. Typically~~, ~~it is desirable to have all target~~'~~s quota configuration set the same.~~		If the '''quota''' or '''project''' file system feature is not enabled, stop Lustre, unmount all targets and enable the file system feature(s) with '''tune2fs -O quota, project'''

	== References and Links ==		== References and Links ==

Thcrowe: /* Introduction */

2025-01-30T20:25:04Z

Introduction

← Older revision		Revision as of 13:25, 30 January 2025
Line 8:		Line 8:
	This document is based on and tested with Lustre 2.15 and LDISKFS. If your Lustre version is older or you are using ZFS, the content may not be applicable.		This document is based on and tested with Lustre 2.15 and LDISKFS. If your Lustre version is older or you are using ZFS, the content may not be applicable.

	Space accounting and project ID tracking are enabled by default on a LDISKFS file system. However, quota restrictions are NOT enabled by default. User, Group and Project quota restrictions must be manually enabled on all targets, as well as configuring data/block and/or metadata/inode limits.		Space accounting and project ID tracking are enabled by default on a LDISKFS file system. However, quota restrictions for user, group and project are NOT enabled by default. User, Group and Project quota restrictions must be manually enabled on all targets, as well as configuring data/block and/or metadata/inode limits.

	== Status Verification ==		== Status Verification ==