2 .\" Copyright 2006 by Cluster File Systems, Inc. All Rights Reserved.
3 .\" Copyright 2008 by Sun Microsystems. All Rights Reserved.
4 .\" This file may be copied under the terms of the GNU Public License.
6 .TH mkfs.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
8 mkfs.lustre \- format a disk for a Lustre service
11 .BR mkfs.lustre { --ost | --mdt | --mgs }
22 metadata storage target
25 configuration management service - one per site. This service can be
28 service by specifying both types
31 is used to format a disk device for use as part of a Lustre
32 filesystem. After formatting, a disk can be mounted to start the Lustre
33 service defined by this command.
37 .BI \--backfstype= fstype
38 Force a particular format for the backing fs (ext3, ldiskfs)
40 .BI \--comment= comment
41 Set user comment about this disk, ignored by Lustre.
43 .BI \--device-size= KB
44 Set device size for loop devices
47 Only print what would be done; does not affect the disk
49 .BI \--failnode= nid,...
50 Set the NID(s) of a failover partner. This option can be repeated as desired.
52 .BI \--fsname= filesystem_name
53 The Lustre filesystem this service will be part of. The maximum
54 filesystem_name length is 8 characters. Default is 'lustre'
57 Force a particular OST or MDT index
59 .BI \--mkfsoptions= opts
60 Format options for the backing fs. For example, ext3 options could be set here.
62 .BI \--mountfsoptions= opts
63 Set permanent mount options, equivalent to setting in /etc/fstab
65 .BI \--mgsnode= nid,...
66 Set the NID(s) of the MGS node, required for all targets other than the MGS.
68 .BI \--param " key=value"
69 Set permanent parameter
73 This option can be repeated as desired. Typical options might include:
75 .I \--param sys.timeout=40
79 .I \--param lov.stripesize=2M
83 .I \--param lov.stripecount=2
87 .I \--param failover.mode=failout
89 Return errors instead of waiting for recovery
94 Print less information.
97 Reformat an existing Lustre disk
99 .BI \--stripe-count-hint= stripes
100 Used for optizing MDT inode size
103 Print more information.
107 .B mkfs.lustre --fsname=testfs --mdt --mgs /dev/sda1
108 Combined MGS and MDT for filesystem 'testfs' on node e.g. cfs21
110 .B mkfs.lustre --fsname=testfs --ost --mgsnode=cfs21@tcp0 /dev/sdb
111 OST for filesystem 'testfs' on any node using the above MGS.
113 .B mkfs.lustre --mgs /dev/sda1
114 Standalone MGS on e.g. node cfs22
116 .B mkfs.lustre --fsname=myfs1 --mdt --mgsnode=cfs22@tcp0 /dev/sda2
117 MDT for filesystem 'myfs1' on any node, using the above MGS
120 Please report all bugs to Sun Microsystems via http://bugzilla.lustre.org/
125 filesystem package and is available from Sun Microsystems via
127 http://downloads.lustre.org/
130 .BR mount.lustre (8),
131 .BR tunefs.lustre (8),