X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Ftunefs.lustre.8;h=bde107178ddff91ad23669399456c884be341171;hb=46ff76137160b66f1d4437b3443859027faae9c4;hp=6ee0c9653b78c1d1096e4ba1a93c44fb758d14fe;hpb=80ac0f4ee600d5a0b8d818843562d9328fef2ef0;p=fs%2Flustre-release.git diff --git a/lustre/doc/tunefs.lustre.8 b/lustre/doc/tunefs.lustre.8 index 6ee0c96..bde1071 100644 --- a/lustre/doc/tunefs.lustre.8 +++ b/lustre/doc/tunefs.lustre.8 @@ -1,5 +1,8 @@ .\" -*- 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" @@ -28,10 +31,14 @@ mounted. 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. @@ -42,13 +49,13 @@ 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 @@ -57,17 +64,52 @@ OST: \fIerrors=remount-ro,mballoc,extents\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. @@ -82,23 +124,44 @@ No clients should be started until all targets have restarted. .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 \fR on every server +* Run \fBtunefs.lustre --writeconf \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= --writeconf /dev/sda +.B tunefs.lustre --erase-params --mgsnode= --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". @@ -107,15 +170,11 @@ 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),