.\" -*- nroff -*-
.\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
+.\"
+.\" Copyright (c) 2011, 2017, Intel Corporation.
+.\"
.\" This file may be copied under the terms of the GNU Public License, v2.
.\"
.TH tunefs.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
Set user comment about this disk, ignored by Lustre.
.TP
.BI \--dryrun
-Only print what would be done; does not affect the disk
+Only print what would be done; does not affect the disk.
+.TP
+.BI \--erase-param " param"
+Remove all previously stored instances of the parameter \fIparam\fR. Attempts
+to remove a non-existing parameter appear as successful ones.
.TP
.BI \--erase-params
-Remove all previous parameter info
+Remove all previously stored parameter info.
.TP
.BI \--failnode= nid,...
Set the NID(s) of a failover partner. This option can be repeated as desired.
+Cannot be used with --servicenode.
+.TP
+.BI \--servicenode= nid,....
+Set the NID(s) of all service partner. This option treats all nodes as equal
+service nodes. Cannot be used with --failnode.
.TP
.BI \--fsname= filesystem_name
-The Lustre filesystem this service will be part of. Default is 'lustre'
+The Lustre filesystem this service will be part of. Default is 'lustre'.
.TP
.BI \--index= index
-Force a particular OST or MDT index
+Force a particular OST or MDT index.
.TP
.BI \--mountfsoptions= opts
-Set the mount options that will be used when mounting the backing fs.
+Set the persistent mount options that will be used when Lustre fs.
WARNING: unlike earlier versions of \fBtunefs.lustre\fR, this version
completely replaces the existing mount options with those specified on
the command line, issuing a warning on stderr if any of the default
mount options are omitted. The defaults for ldiskfs are
OST: \fIerrors=remount-ro,mballoc,extents\fR;
-MGS/MDT: \fIerrors=remount-ro,iopen_nopriv,user_xattr\fR.
+MGS/MDT: \fIerrors=remount-ro,user_xattr\fR.
\fBDO NOT\fR alter the default mount options unless you know what you are doing.
.TP
+.BI \--backfs-mount-opts=opts
+Use these options for mounting backing fs while tune.lustre is working.
+.TP
.BI \--network= net,...
Network(s) to restrict this ost/mdt to. This option can be repeated as desired.
.TP
.BI \--mgs
-Add a configuration management service to this target
+Add a configuration management service to this target.
.TP
.BI \--mgsnode= nid,...
Set the NID(s) of the MGS node, required for all targets other than the MGS.
.TP
.BI \--nomgs
-Remove a configuration management service to this target
+Remove a configuration management service to this target.
+.TP
+.BI \--param " key=value"
+Set permanent parameter
+.I key
+to value
+.IR value .
+This option can be repeated as desired. All previously stored instances of
+.IR key
+are removed, and new instances specified in the command line are added.
+Typical options might include:
+.RS
+.I \--param sys.timeout=40
+.RS
+System obd timeout
+.RE
+.I \--param lov.stripesize=2M
+.RS
+Default stripe size
+.RE
+.I \--param lov.stripecount=2
+.RS
+Default stripe count
+.RE
+.I \--param failover.mode=failout
+.RS
+Return errors instead of waiting for recovery
+.RE
+.RE
+.TP
+.BI \--force-nohostid
+Ignore unset hostid for ZFS import protection. To set hostid either set
+spl_hostid option for spl.ko or set /etc/hostid, see zgenhostid(8).
.TP
.BI \--quiet
Print less information.
.br
Correct order of operations is:
.br
-* Unmount all clients of this filesystem
+* Unmount all clients of this filesystem.
.br
-* Unmount MDT and all OSTs of this filesystem
+* Unmount MDT and all OSTs of this filesystem.
.br
-* Run \fBtunefs.lustre --writeconf <device>\fR on every server
+* Run \fBtunefs.lustre --writeconf <device>\fR on every server.
.br
-* Mount MDT and OSTs
+* Mount MDT and OSTs.
.br
* Mount clients
+.TP
+.BI \--nolocallogs
+Use configuration logs from the MGS, not local ones.
+.br
+There is feature that starts a target with a local copy of
+the config log in order to avoid a delay in communicating with
+the MGS and to load MGS log updates later on.
+However, that feature is not always useful.
+.br
+replace_nids changes config logs on the server side and local copies
+become invalid. --nolocallogs sets the nolocallogs mount flag,
+which causes the local copy of the config log to be ignored.
+The flag is reset once new logs are downloaded from MGS.
+.TP
+.BI \--quota
+Enable space accounting on old 2.x devices.
+
.SH EXAMPLES
.TP
-.B tunefs.lustre --erase-param --mgsnode=<new_nid> --writeconf /dev/sda
+.B tunefs.lustre --erase-params --mgsnode=<new_nid> --writeconf /dev/sda
Change the MGS NID address. (This should be done on every target disk,
since they should all be contacting the same MGS.)
.TP
-.B tunefs.lustre --param="failover.node=192.168.0.13@tcp0" /dev/sda
-Add a failover NID location for this target
+.B tunefs.lustre --param "failover.node=192.168.0.13@tcp0" /dev/sda
++Remove all previous failover NID locations for this target, and add a new
++failover NID location for this target.
++.TP
++.B tunefs.lustre --erase-param failover.node /dev/sda
++Remove all failover NID locations for this target.
.TP
.B tunefs.lustre --mgs --mdt --fsname=testfs /dev/sda
Upgrade an old 1.4.X Lustre MDT to 1.6. The new filesystem name is "testfs".
Upgrade an old 1.4.X Lustre MDT to 1.6, and start with brand-new 1.6
configuration logs. All old servers and clients must be stopped.
-.SH BUGS
-Please report all bugs to Sun Microsystems using http://bugzilla.lustre.org/
.SH AVAILABILITY
.B tunefs.lustre
is part of the
.BR Lustre (7)
-filesystem package and is available from Sun Microsystems, Inc via
-.br
-http://downloads.lustre.org
+filesystem package.
.SH SEE ALSO
.BR lustre (7),
.BR mkfs.lustre (8),
git://git.whamcloud.com / fs / lustre-release.git / blobdiff