Whamcloud - gitweb
LU-57 Allow OSTs to be created with no primary node
[fs/lustre-release.git] / lustre / doc / tunefs.lustre.8
1 .\" -*- nroff -*-
2 .\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
3 .\" This file may be copied under the terms of the GNU Public License, v2.
4 .\"
5 .TH tunefs.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
6 .SH NAME
7 tunefs.lustre \- modify the Lustre configuration information on a disk
8 .SH SYNOPSIS
9 .br
10 .B tunefs.lustre
11 [options] 
12 .I device
13 .br
14 .SH DESCRIPTION
15 .B tunefs.lustre
16 is used to modify the configuration information on a Lustre target
17 disk. This includes upgrading old (pre-Lustre 1.6) disks.  This does not
18 reformat the disk or erase the target information, but modifying the
19 configuration information can result in an unusable filesystem.  You have
20 been warned.
21 .br
22 Changes made here will affect a filesystem only when the target is next
23 mounted.
24
25 .SH OPTIONS
26 .TP
27 .BI \--comment= comment
28 Set user comment about this disk, ignored by Lustre.
29 .TP
30 .BI \--dryrun
31 Only print what would be done; does not affect the disk
32 .TP
33 .BI \--erase-params
34 Remove all previous parameter info
35 .TP
36 .BI \--failnode= nid,...  
37 Set the NID(s) of a failover partner. This option can be repeated as desired.
38 Cannot be used with --servicenode.
39 .TP
40 .BI \--servicenode= nid,....
41 Set the NID(s) of all service partner. This option treats all nodes as equal
42 service nodes. Cannot be used with --failnode.
43 .TP
44 .BI \--fsname= filesystem_name  
45 The Lustre filesystem this service will be part of.  Default is 'lustre'
46 .TP
47 .BI \--index= index
48 Force a particular OST or MDT index 
49 .TP
50 .BI \--mountfsoptions= opts
51 Set  the mount options that will be used when mounting the backing fs.
52 WARNING: unlike earlier versions of \fBtunefs.lustre\fR,  this version
53 completely replaces the existing mount options with those specified on
54 the command line, issuing a warning  on  stderr  if any  of the default
55 mount options are omitted.  The defaults for ldiskfs  are
56 OST: \fIerrors=remount-ro,mballoc,extents\fR;
57 MGS/MDT: \fIerrors=remount-ro,user_xattr\fR.
58 \fBDO NOT\fR alter the default mount options unless you know what you are doing.
59 .TP
60 .BI \--network= net,...
61 Network(s) to restrict this ost/mdt to. This option can be repeated as desired.
62 .TP
63 .BI \--mgs
64 Add a configuration management service to this target
65 .TP
66 .BI \--mgsnode= nid,...  
67 Set the NID(s) of the MGS node, required for all targets other than the MGS.
68 .TP
69 .BI \--nomgs
70 Remove a configuration management service to this target
71 .TP
72 .BI \--quiet
73 Print less information.
74 .TP
75 .BI \--verbose
76 Print more information.
77 .TP
78 .BI \--writeconf
79 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.  
80 All targets (OSTs/MDTs) must then be restarted to regenerate the logs. 
81 No clients should be started until all targets have restarted.
82 .br
83 Correct order of operations is:
84 .br
85 * Unmount all clients of this filesystem
86 .br
87 * Unmount MDT and all OSTs of this filesystem
88 .br
89 * Run \fBtunefs.lustre --writeconf <device>\fR on every server
90 .br
91 * Mount MDT and OSTs
92 .br
93 * Mount clients
94 .SH EXAMPLES
95 .TP
96 .B tunefs.lustre --erase-param --mgsnode=<new_nid> --writeconf /dev/sda
97 Change the MGS NID address. (This should be done on every target disk,
98 since they should all be contacting the same MGS.)
99 .TP
100 .B tunefs.lustre --param="failover.node=192.168.0.13@tcp0" /dev/sda
101 Add a failover NID location for this target
102 .TP
103 .B tunefs.lustre --mgs --mdt --fsname=testfs /dev/sda
104 Upgrade an old 1.4.X Lustre MDT to 1.6. The new filesystem name is "testfs". 
105 .TP
106 .B tunefs.lustre --writeconf --mgs --mdt --fsname=testfs /dev/sda1
107 Upgrade an old 1.4.X Lustre MDT to 1.6, and start with brand-new 1.6
108 configuration logs. All old servers and clients must be stopped.
109
110 .SH BUGS
111 Please report all bugs to Sun Microsystems using http://bugzilla.lustre.org/
112 .SH AVAILABILITY
113 .B tunefs.lustre
114 is part of the 
115 .BR Lustre (7) 
116 filesystem package and is available from Sun Microsystems, Inc via
117 .br
118 http://downloads.lustre.org
119 .SH SEE ALSO
120 .BR lustre (7),
121 .BR mkfs.lustre (8),
122 .BR mount.lustre (8),
123 .BR lctl (8),
124 .BR lfs (1)