Section: Maintenance Commands (8)
Return to Main Contents
gfs_jadd - Add journals to a GFS filesystem
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
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.
- -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.
Help. Prints out a short usage message and exits.
Quiet. Turns down the verbosity level.
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.
Version. Print version information, then exit.
Verbose. Turn up verbosity of messages.
linux.jgfs.net manual pages