.\" -*- nroff -*-
-.\" Copyright 2006 by ClusterFileSystems. All Rights Reserved.
-.\" This file may be copied under the terms of the GNU Public License.
+.\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
.\"
-.TH tunefs.lustre 8 "2006 Jun 15" Lustre "configuration utilities"
+.\" Copyright (c) 2011, Whamcloud, Inc.
+.\"
+.\" This file may be copied under the terms of the GNU Public License, v2.
+.\"
+.TH tunefs.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
.SH NAME
tunefs.lustre \- modify the Lustre configuration information on a disk
.SH SYNOPSIS
.BI \--comment= comment
Set user comment about this disk, ignored by Lustre.
.TP
+.BI \--dryrun
+Only print what would be done; does not affect the disk
+.TP
.BI \--erase-params
Remove all previous 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'
Force a particular OST or MDT index
.TP
.BI \--mountfsoptions= opts
-Set permanent mount options, equivalent to setting in /etc/fstab
+Set the mount options that will be used when mounting the backing 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,user_xattr\fR.
+\fBDO NOT\fR alter the default mount options unless you know what you are doing.
+.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 \--noformat
-Only print what would be done; does not affect the disk
-.TP
.BI \--nomgs
-remove a configuration management service to this target
+Remove a configuration management service to this target
.TP
.BI \--quiet
Print less information.
Print more information.
.TP
.BI \--writeconf
-Erase all config logs for the filesystem that this target is part of. This
-is very dangerous.
+Erase the configuration logs for the filesystem that this server is part of, and regenerate them. This is very dangerous. All clients must be unmounted and servers for this filesystem should be stopped.
+All targets (OSTs/MDTs) must then be restarted to regenerate the logs.
+No clients should be started until all targets have restarted.
+.br
+Correct order of operations is:
+.br
+* Unmount all clients of this filesystem
+.br
+* Unmount MDT and all OSTs of this filesystem
+.br
+* Run \fBtunefs.lustre --writeconf <device>\fR on every server
+.br
+* Mount MDT and OSTs
+.br
+* Mount clients
+.TP
+.BI \--quota
+Enable space accounting on old 2.x devices.
.SH EXAMPLES
.TP
-.B tunefs.lustre --fsname=testfs --mdt --mgs /dev/sda1
-Combined MGS and MDT for filesystem 'testfs' on node e.g. cfs21
+.B tunefs.lustre --erase-param --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 --fsname=testfs --ost --mgsnode=cfs21@tcp0 /dev/sdb
-OST for filesystem 'testfs' on any node using the above MGS.
+.B tunefs.lustre --param="failover.node=192.168.0.13@tcp0" /dev/sda
+Add a failover NID location for this target
.TP
-.B tunefs.lustre --mgs /dev/sda1
-Standalone MGS on e.g. node cfs22
+.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".
.TP
-.B tunefs.lustre --fsname=myfs1 --mdt --mgsnode=cfs22@tcp0 /dev/sda2
-MDT for filesystem 'myfs1' on any node, using the above MGS
+.B tunefs.lustre --writeconf --mgs --mdt --fsname=testfs /dev/sda1
+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 ClusterFileSystems, support@clusterfs.com
+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 CFS
+filesystem package and is available from Sun Microsystems, Inc via
.br
-http://clusterfs.com
+http://downloads.lustre.org
.SH SEE ALSO
-.BR Lustre (7),
+.BR lustre (7),
.BR mkfs.lustre (8),
.BR mount.lustre (8),
.BR lctl (8),
git://git.whamcloud.com / fs / lustre-release.git / blobdiff