lustre/doc/tunefs.lustre.8

   1 .\" -*- nroff -*-
   2 .\" Copyright 2006 by ClusterFileSystems.  All Rights Reserved.
   3 .\" This file may be copied under the terms of the GNU Public License.
   4 .\"
   5 .TH tunefs.lustre 8 "2006 Jun 15" Lustre "configuration utilities"
   6 .SH NAME
   7 tunefs.lustre \- modify the Lustre configuration information on a disk
   8 .SH SYNOPSIS
   9 .br
  10 .B tunefs.lustre
  11 [options]
  12 .I device
  13 .br
  14 .SH DESCRIPTION
  15 .B tunefs.lustre
  16 is used to modify the configuration information on a Lustre target
  17 disk. This includes upgrading old (pre-Lustre 1.6) disks.  This does not
  18 reformat the disk or erase the target information, but modifying the
  19 configuration information can result in an unusable filesystem.  You have
  20 been warned.
  21 .br
  22 Changes made here will affect a filesystem only when the target is next
  23 mounted.
  24
  25 .SH OPTIONS
  26 .TP
  27 .BI \--comment= comment
  28 Set user comment about this disk, ignored by Lustre.
  29 .TP
  30 .BI \--erase-params
  31 Remove all previous parameter info
  32 .TP
  33 .BI \--failnode= nid,...
  34 Set the NID(s) of a failover partner. This option can be repeated as desired.
  35 .TP
  36 .BI \--fsname= filesystem_name
  37 The Lustre filesystem this service will be part of.  Default is 'lustre'
  38 .TP
  39 .BI \--index= index
  40 Force a particular OST or MDT index
  41 .TP
  42 .BI \--mountfsoptions= opts
  43 Set permanent mount options, equivalent to setting in /etc/fstab
  44 .TP
  45 .BI \--mgs
  46 add a configuration management service to this target
  47 .TP
  48 .BI \--mgsnode= nid,...
  49 Set the NID(s) of the MGS node, required for all targets other than the MGS.
  50 .TP
  51 .BI \--noformat
  52 Only print what would be done; does not affect the disk
  53 .TP
  54 .BI \--nomgs
  55 remove a configuration management service to this target
  56 .TP
  57 .BI \--quiet
  58 Print less information.
  59 .TP
  60 .BI \--verbose
  61 Print more information.
  62 .TP
  63 .BI \--writeconf
  64 Erase all config logs for the filesystem that this target is part of.  This
  65 is very dangerous.
  66
  67 .SH EXAMPLES
  68 .TP
  69 .B tunefs.lustre --fsname=testfs --mdt --mgs /dev/sda1
  70 Combined MGS and MDT for filesystem 'testfs' on node e.g. cfs21
  71 .TP
  72 .B tunefs.lustre --fsname=testfs --ost --mgsnode=cfs21@tcp0 /dev/sdb
  73 OST for filesystem 'testfs' on any node using the above MGS.
  74 .TP
  75 .B tunefs.lustre --mgs /dev/sda1
  76 Standalone MGS on e.g. node cfs22
  77 .TP
  78 .B tunefs.lustre --fsname=myfs1 --mdt --mgsnode=cfs22@tcp0 /dev/sda2
  79 MDT for filesystem 'myfs1' on any node, using the above MGS
  80
  81 .SH BUGS
  82 Please report all bugs to ClusterFileSystems, support@clusterfs.com
  83 .SH AVAILABILITY
  84 .B tunefs.lustre
  85 is part of the
  86 .BR Lustre (7)
  87 filesystem package and is available from CFS
  88 .br
  89 http://clusterfs.com
  90 .SH SEE ALSO
  91 .BR Lustre (7),
  92 .BR mkfs.lustre (8),
  93 .BR mount.lustre (8),
  94 .BR lctl (8),
  95 .BR lfs (1)