Page MenuHomeClusterLabs Projects
Files F3151901

gfs_jadd.8
No OneTemporary
Actions

gfs_jadd.8
View Options

.TH gfs_jadd 8
.SH NAME
gfs_jadd \- Add journals to a GFS filesystem
.SH SYNOPSIS
.B gfs_jadd
[\fIOPTION\fR]... <\fIDEVICE\fR|\fIMOINTPOINT\fR>...
.SH DESCRIPTION
\fIgfs_jadd\fR is used to add journals to a GFS filesystem after
the device upon which the filesystem resides has been grown.
By running \fIgfs_jadd\fR
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.
\fIgfs_jadd\fR 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 \fIgfs_jadd\fR on a mounted filesystem, addition of journals to
unmounted filesystems is not supported.
You only need to run \fIgfs_jadd\fR
on one node in the cluster. All the other nodes will see the expansion
has occurred when required.
You must be superuser to execute \fIgfs_jadd\fR. The
\fIgfs_jadd\fR
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 \fIgfs_jadd\fR with the \fI-Tv\fR
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.
.SH OPTIONS
.TP
\fB-j num\fP
The number of new journals to add. This defaults to 1.
.TP
\fB-J size\fP
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.
.TP
\fB-h\fP
Help. Prints out a short usage message and exits.
.TP
\fB-q\fP
Quiet. Turns down the verbosity level.
.TP
\fB-T\fP
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.
.TP
\fB-V\fP
Version. Print version information, then exit.
.TP
\fB-v\fP
Verbose. Turn up verbosity of messages.
.SH SEE ALSO
gfs_mkfs(8) gfs_grow(8)

File Metadata

Mime Type
text/troff
Expires
Mon, Feb 24, 12:40 PM (15 h, 3 m ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1463097
Default Alt Text
gfs_jadd.8 (2 KB)

Event Timeline