<?xml version="1.0" encoding="utf-8"?>
<chapter xmlns="http://docbook.org/ns/docbook"
-xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US"
-xml:id="userutilities"
-xmlns:xi="http://www.w3.org/2001/XInclude">
+ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US"
+ xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="userutilities">
<title xml:id="userutilities.title">User Utilities</title>
<para>This chapter describes user utilities.</para>
- <section xml:id="dbdoclet.50438206_94597">
+ <section xml:id="userutilities.lfs">
<title>
<indexterm>
<primary>lfs</primary>
lfs quota [-q] [-v] [-h] [-o <replaceable>obd_uuid</replaceable>|-I <replaceable>ost_idx</replaceable>|-i <replaceable>mdt_idx</replaceable>]
[-u <replaceable>username|uid|-g</replaceable> <replaceable>group|gid</replaceable>|-p <replaceable>projid</replaceable>] <replaceable>/mount_point</replaceable>
lfs quota -t -u|-g|-p <replaceable>/mount_point</replaceable>
-lfs quotacheck [-ug] <replaceable>/mount_point</replaceable>
-lfs quotachown [-i] <replaceable>/mount_point</replaceable>
-lfs quotainv [-ug] [-f] <replaceable>/mount_point</replaceable>
-lfs quotaon [-ugf] <replaceable>/mount_point</replaceable>
-lfs quotaoff [-ug] <replaceable>/mount_point</replaceable>
lfs setquota {-u|--user|-g|--group|-p|--project} <replaceable>uname|uid|gname|gid|projid</replaceable>
[--block-softlimit <replaceable>block_softlimit</replaceable>]
[--block-hardlimit <replaceable>block_hardlimit</replaceable>]
<literal>-v</literal> option with
<literal>lfs quota</literal>.</para>
</note>
+ <para condition="l28">
+ The <literal>quotacheck</literal>, <literal>quotaon</literal> and
+ <literal>quotaoff</literal> sub-commands were deprecated in the
+ Lustre 2.4 release, and removed completely in the Lustre 2.8 release.
+ See <xref linkend="enabling_disk_quotas"/> for details on
+ configuring and checking quotas.
+ </para>
</section>
<section remap="h5">
<title>Description</title>
guarantee that
<literal>atime</literal> is kept coherent across the
cluster.)</para>
- <para>OSTs store a transient
+ <para>OSTs by default only hold a transient
<literal>atime</literal> that is updated when clients do read
requests. Permanent
- <literal>atime</literal> is written to the MDS when the file is
+ <literal>atime</literal> is written to the MDT when the file is
closed. However, on-disk atime is only updated if it is more
than 60 seconds old (
- <literal>/proc/fs/lustre/mds/*/max_atime_diff</literal>). The
- Lustre software considers the latest
- <literal>atime</literal> from all OSTs. If a
+ <literal>mdd.*.atime_diff</literal>).
+ </para>
+ <para condition='l2D'>In Lustre 2.14, it is possible to set
+ the OSTs to persistently store atime with each object, in
+ order to get more accurate persistent atime updates for files
+ that are open for a long time via the similarly-named
+ <literal>obdfilter.*.atime_diff</literal> parameter.
+ </para>
+ <para>
+ The client considers the latest <literal>atime</literal> from
+ all OSTs and MDTs. If a
<literal>setattr</literal> is set by user, then it is updated on
- both the MDS and OST, allowing the
+ both the MDT and OST, allowing the
<literal>atime</literal> to go backward.</para>
</entry>
</row>
<row>
<entry nameend="c2" namest="c1">
<para>
- <literal>quotachown</literal>
- </para>
- </entry>
- <entry>
- <para>Changes the file's owner and group on OSTs of the
- specified file system.</para>
- </entry>
- </row>
- <row>
- <entry nameend="c2" namest="c1">
- <para>
- <literal>quotacheck [-ugf]
- <replaceable>/mount_point</replaceable></literal>
- </para>
- </entry>
- <entry>
- <para>Scans the specified file system for disk usage, and
- creates or updates quota files. Options specify quota for users
- (
- <literal>-u</literal>), groups (
- <literal>-g</literal>), and force (
- <literal>-f</literal>).</para>
- </entry>
- </row>
- <row>
- <entry nameend="c2" namest="c1">
- <para>
- <literal>quotaon [-ugf]
- <replaceable>/mount_point</replaceable></literal>
- </para>
- </entry>
- <entry>
- <para>Turns on file system quotas. Options specify quota for
- users (
- <literal>-u</literal>), groups (
- <literal>-g</literal>), and force (
- <literal>-f</literal>).</para>
- </entry>
- </row>
- <row>
- <entry nameend="c2" namest="c1">
- <para>
- <literal>quotaoff [-ugf]
- <replaceable>/mount_point</replaceable></literal>
- </para>
- </entry>
- <entry>
- <para>Turns off file system quotas. Options specify quota for
- users (
- <literal>-u</literal>), groups (
- <literal>-g</literal>), and force (
- <literal>-f</literal>).</para>
- </entry>
- </row>
- <row>
- <entry nameend="c2" namest="c1">
- <para>
- <literal>quotainv [-ug] [-f]
- <replaceable>/mount_point</replaceable></literal>
- </para>
- </entry>
- <entry>
- <para>Clears quota files (administrative quota files if used
- without
- <literal>-f</literal>, operational quota files otherwise), all
- of their quota entries for users (
- <literal>-u</literal>) or groups (
- <literal>-g</literal>). After running
- <literal>quotainv</literal>, you must run
- <literal>quotacheck</literal> before using quotas.</para>
- <caution>
- <para>Use extreme caution when using this command; its
- results cannot be undone.</para>
- </caution>
- </entry>
- </row>
- <row>
- <entry nameend="c2" namest="c1">
- <para>
<literal>setquota {-u|-g|-p
<replaceable>uname|uid|gname|gid|projid}</replaceable>
[--block-softlimit
<screen>
$ lfs quota -t -u /mnt/lustre
</screen>
- <para>Changes file owner and group.</para>
- <screen>
-$ lfs quotachown -i /mnt/lustre
-</screen>
- <para>Checks quotas for user and group. Turns on quotas after making the
- check.</para>
- <screen>
-$ lfs quotacheck -ug /mnt/lustre
-</screen>
- <para>Turns on quotas of user and group.</para>
- <screen>
-$ lfs quotaon -ug /mnt/lustre
-</screen>
- <para>Turns off quotas of user and group.</para>
- <screen>
-$ lfs quotaoff -ug /mnt/lustre
-</screen>
<para>Sets quotas of user 'bob', with a 1 GB block quota hardlimit and a
2 GB block quota softlimit.</para>
<screen>
<section remap="h5">
<title>See Also</title>
<para>
- <xref linkend="dbdoclet.50438206_94597" />
+ <xref linkend="userutilities.lfs" />
</para>
</section>
</section>
</screen>
</section>
</chapter>
+<!--
+ vim:expandtab:shiftwidth=2:tabstop=8:
+ -->