Provided by: lustre-utils_1.6.5-1_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 permanent mount options, equivalent to setting in /etc/fstab

       --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 all config logs for the filesystem that this MDT  is  part
              of,  and  regenerate them.  This is very dangerous.  All clients
              and servers  should  be  stopped.   All  targets  must  then  be
              restarted  to regenerate the logs.  No clients should be started
              until all targets have restarted.  In  general  this  should  be
              executed on the MDT only, not the OSTs.

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)