gfs_jadd (8) - Linux Manuals

gfs_jadd: Add journals to a GFS filesystem

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.