2 .\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
4 .\" Copyright (c) 2011, Whamcloud, Inc.
6 .\" This file may be copied under the terms of the GNU Public License.
8 .TH mkfs.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
10 mkfs.lustre \- format a disk for a Lustre service
13 .BR mkfs.lustre { --ost | --mdt | --mgs }
24 metadata storage target
27 configuration management service - one per site. This service can be
30 service by specifying both types
33 is used to format a disk device for use as part of a Lustre
34 filesystem. After formatting, a disk can be mounted to start the Lustre
35 service defined by this command.
39 .BI \--backfstype= fstype
40 Force a particular format for the backing fs (ext3, ldiskfs)
42 .BI \--comment= comment
43 Set user comment about this disk, ignored by Lustre.
45 .BI \--device-size= KB
46 Set device size for loop devices
49 Only print what would be done; does not affect the disk
51 .BI \--failnode= nid,...
52 Set the NID(s) of a failover partner. This option can be repeated as desired.
53 Cannot be used with --servicenode.
55 .BI \--servicenode= nid,....
56 Set the NID(s) of all service partner. This option treats all nodes as equal
57 service nodes. Cannot be used with --failnode.
59 .BI \--fsname= filesystem_name
60 The Lustre filesystem this service will be part of. The maximum
61 filesystem_name length is 8 characters. Default is 'lustre'
64 Force a particular OST or MDT index
66 .BI \--mkfsoptions= opts
67 Format options for the backing fs. For example, ext3 options could be set here.
69 .BI \--mountfsoptions= opts
70 Set the mount options that will be used when mounting the backing fs.
71 WARNING: unlike earlier versions of \fBmkfs.lustre\fR, this version completely
72 replaces the default mount options with those specified on the command line,
73 issuing a warning on stderr if any of the default mount options are omitted.
74 The defaults for \fIldiskfs\fR are
75 OST: \fIerrors=remount-ro,mballoc,extents\fR;
76 MGS/MDT: \fIerrors=remount-ro,user_xattr\fR.
77 \fBDO NOT\fR alter the default mount options unless you know what you are doing.
79 .BI \--network= net,...
80 Network(s) to restrict this ost/mdt to. This option can be repeated as desired.
82 .BI \--mgsnode= nid,...
83 Set the NID(s) of the MGS node, required for all targets other than the MGS.
85 .BI \--param " key=value"
86 Set permanent parameter
90 This option can be repeated as desired. Typical options might include:
92 .I \--param sys.timeout=40
96 .I \--param lov.stripesize=2M
100 .I \--param lov.stripecount=2
104 .I \--param failover.mode=failout
106 Return errors instead of waiting for recovery
111 Print less information.
114 Reformat an existing Lustre disk
116 .BI \--stripe-count-hint= stripes
117 Used for optizing MDT inode size
120 Print more information.
124 .B mkfs.lustre --fsname=testfs --mdt --mgs /dev/sda1
125 Combined MGS and MDT for filesystem 'testfs' on node e.g. cfs21
127 .B mkfs.lustre --fsname=testfs --ost --mgsnode=cfs21@tcp0 /dev/sdb
128 OST for filesystem 'testfs' on any node using the above MGS.
130 .B mkfs.lustre --mgs /dev/sda1
131 Standalone MGS on e.g. node cfs22
133 .B mkfs.lustre --fsname=myfs1 --mdt --mgsnode=cfs22@tcp0 /dev/sda2
134 MDT for filesystem 'myfs1' on any node, using the above MGS
137 Please report all bugs to Sun Microsystems via http://bugzilla.lustre.org/
142 filesystem package and is available from Sun Microsystems via
144 http://downloads.lustre.org/
147 .BR mount.lustre (8),
148 .BR tunefs.lustre (8),