Section: configuration utilities (8)Updated: 2008 Mar 15Local indexUp
NAME
mkfs.lustre - format a disk for a Lustre service
SYNOPSIS
mkfs.lustre{--ost|--mdt|--mgs}
[options] device <target_type>
is one of
--ost
object storage target
--mdt
metadata storage target
--mgs
configuration management service - one per site. This service can be
combined with one
--mdt
service by specifying both types
DESCRIPTION
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.
--param key=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