mkfs.lustre8
Format a disk for a lustre service
Usage
mkfs.lustre {--ost | --mdt | --mgs}
[options]
device
Overview
mkfs.lustre is used to format a disk device for use as part of a Lustre filesystem. After formatting, a disk can be mounted to start the Lustre service defined by this command.
Options
-
--backfstype=fstype -
Force a particular format for the backing fs (ext3, ldiskfs)
-
--comment=comment -
Set user comment about this disk, ignored by Lustre.
-
--device-size=KB -
Set device size for loop devices
-
--dryrun -
Only print what would be done; does not affect the disk
-
--failnode=nid,... -
Set the NID(s) of a failover partner. This option can be repeated as desired.
-
--fsname=filesystem_name -
The Lustre filesystem this service will be part of. The maximum filesystem_name length is 8 characters. Default is 'lustre'
-
--index=index -
Force a particular OST or MDT index
-
--mkfsoptions=opts -
Format options for the backing fs. For example, ext3 options could be set here.
-
--mountfsoptions=opts -
Set the mount options that will be used when mounting the backing fs. WARNING: unlike earlier versions of
mkfs.lustre, this version completely replaces the default 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: errors=remount-ro,mballoc,extents; MGS/MDT: errors=remount-ro,iopen_nopriv,user_xattr. DO NOT alter the default mount options unless you know what you are doing.
-
--mgsnode=nid,... -
Set the NID(s) of the MGS node, required for all targets other than the MGS.
--paramkey=value-
Set permanent parameter key to value value. This option can be repeated as desired. Typical options might include:
-
--param sys.timeout=40 -
System obd timeout
-
--param lov.stripesize=2M -
Default stripe size
-
--param lov.stripecount=2 -
Default stripe count
-
--param failover.mode=failout -
Return errors instead of waiting for recovery
-
-
--quiet -
Print less information.
-
--reformat -
Reformat an existing Lustre disk
-
--stripe-count-hint=stripes -
Used for optizing MDT inode size
-
--verbose -
Print more information.
Examples
mkfs.lustre --fsname=testfs --mdt --mgs /dev/sda1
|
Combined MGS and MDT for filesystem 'testfs' on node e.g. cfs21 |
|---|---|
mkfs.lustre --fsname=testfs --ost --mgsnode=cfs21@tcp0 /dev/sdb
|
OST for filesystem 'testfs' on any node using the above MGS. |
mkfs.lustre --mgs /dev/sda1
|
Standalone MGS on e.g. node cfs22 |
mkfs.lustre --fsname=myfs1 --mdt --mgsnode=cfs22@tcp0 /dev/sda2
|
MDT for filesystem 'myfs1' on any node, using the above MGS |
Releases
2 releases since Debian 5.0 (Lenny); the text changed 1 time.