Provided by: lustre-utils_1.8.5+dfsg-3ubuntu1_i386 bug

NAME

       tunefs.lustre - modify the Lustre configuration information on a disk

SYNOPSIS

       tunefs.lustre [options] device

DESCRIPTION

       tunefs.lustre  is  used  to  modify  the configuration information on a
       Lustre target disk. This includes upgrading old (pre-Lustre 1.6) disks.
       This  does  not  reformat the disk or erase the target information, but
       modifying the configuration  information  can  result  in  an  unusable
       filesystem.  You have been warned.
       Changes made here will affect a filesystem only when the target is next
       mounted.

OPTIONS

       --comment=comment
              Set user comment about this disk, ignored by Lustre.

       --dryrun
              Only print what would be done; does not affect the disk

       --erase-params
              Remove all previous parameter info

       --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.  Default is
              'lustre'

       --index=index
              Force a particular OST or MDT index

       --mountfsoptions=opts
              Set  the mount options that  will  be  used  when  mounting  the
              backing  fs.  WARNING: unlike earlier versions of tunefs.lustre,
              this version completely replaces the existing 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.

       --mgs  Add a configuration management service to this target

       --mgsnode=nid,...
              Set the NID(s) of the MGS node, required for all  targets  other
              than the MGS.

       --nomgs
              Remove a configuration management service to this target

       --quiet
              Print less information.

       --verbose
              Print more information.

       --writeconf
              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.  All targets (OSTs/MDTs) must then be  restarted  to
              regenerate  the  logs.   No  clients should be started until all
              targets have restarted.
              Correct order of operations is:
              * Unmount all clients of this filesystem
              * Unmount MDT and all OSTs of this filesystem
              * Run tunefs.lustre --writeconf <device> on every server
              * Mount MDT and OSTs
              * Mount clients

EXAMPLES

       tunefs.lustre --erase-param --mgsnode=<new_nid> --writeconf /dev/sda
              Change the MGS NID address. (This should be done on every target
              disk, since they should all be contacting the same MGS.)

       tunefs.lustre --param="failover.node=192.168.0.13@tcp0" /dev/sda
              Add a failover NID location for this target

       tunefs.lustre --mgs --mdt --fsname=testfs /dev/sda
              Upgrade  an old 1.4.X Lustre MDT to 1.6. The new filesystem name
              is "testfs".

       tunefs.lustre --writeconf --mgs --mdt --fsname=testfs /dev/sda1
              Upgrade an old 1.4.X Lustre MDT to 1.6, and start with brand-new
              1.6  configuration  logs.  All  old  servers and clients must be
              stopped.

BUGS

       Please    report    all    bugs    to    Sun     Microsystems     using
       http://bugzilla.lustre.org/

AVAILABILITY

       tunefs.lustre  is  part  of  the  Lustre(7)  filesystem  package and is
       available from Sun Microsystems, Inc via
       http://downloads.lustre.org

SEE ALSO

       lustre(7), mkfs.lustre(8), mount.lustre(8), lctl(8), lfs(1)