Provided by: gfs-tools_1.20060222-0ubuntu5_i386 bug

NAME

       gfs_jadd - Add journals to a GFS filesystem

SYNOPSIS

       gfs_jadd [OPTION]... <DEVICE|MOINTPOINT>...

DESCRIPTION

       gfs_jadd  is  used to add journals to a GFS filesystem after the device
       upon which the filesystem resides has been grown.  By running  gfs_jadd
       on  a  GFS filesystem, you are filling in space between the current end
       of the filesystem and the end of the device upon which  the  filesystem
       resides.  When this operation is complete, the journal index is updated
       so that machines mounting the filesystem at a later date will  see  the
       newly  created  journals  in  addition  to  the journals already there.
       Machines which are already running in the cluster are unaffected.

       gfs_jadd will not use space that has been formatted for filesystem data
       even if that space has never been populated with files.

       You may only run gfs_jadd on a mounted filesystem, addition of journals
       to unmounted filesystems is  not  supported.   You  only  need  to  run
       gfs_jadd  on  one node in the cluster. All the other nodes will see the
       expansion has occurred when required.

       You must be superuser to execute gfs_jadd. The gfs_jadd tool  tries  to
       prevent  you from corrupting your filesystem by checking as many of the
       likely problems as it can. When growing a  filesystem,  only  the  last
       step  of  updating  the  journal  index  affects  the currently mounted
       filesystem and so failure part way through the expansion process should
       leave your filesystem in its original state.

       You can run gfs_jadd with the -Tv flags to get a display of the current
       state of a mounted GFS filesystem.  This can be useful to do after  the
       journal addition process to see if the changes have been successful.

OPTIONS

       -j num The number of new journals to add. This defaults to 1.

       -J size
              The size of the new journals in megabytes. The defaults to 128MB
              (the minimum size allowed is 32MB). If you want to add  journals
              of  different  sizes  to  the  filesystem,  you’ll  need  to run
              gfs_jadd once for each different size of journal. The  size  you
              specify  here  will  be rounded down so that it is a multiple of
              the journal segment  size  which  was  specified  at  filesystem
              creation time.

       -h     Help. Prints out a short usage message and exits.

       -q     Quiet. Turns down the verbosity level.

       -T     Test. Do all calculations, but do not write any data to the disk
              and do not add journals. This is used to discover what the  tool
              would have done were it run without this flag. You probably want
              to turn the verbosity level up in order to gain most information
              from this option.

       -V     Version. Print version information, then exit.

       -v     Verbose. Turn up verbosity of messages.

              gfs_mkfs(8) gfs_grow(8)

                                                                   gfs_jadd(8)