|
Packit |
6ef888 |
.TH gfs2_convert 8
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
.SH NAME
|
|
Packit |
6ef888 |
gfs2_convert - Convert a GFS1 filesystem to GFS2
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
.SH SYNOPSIS
|
|
Packit |
6ef888 |
.B gfs2_convert
|
|
Packit |
6ef888 |
[\fIOPTION\fR]... \fIDEVICE\fR
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
.SH DESCRIPTION
|
|
Packit |
6ef888 |
gfs2_convert is used to convert a filesystem from GFS1 to GFS2. It is
|
|
Packit |
6ef888 |
required that the GFS1 filesystem be checked and fixed for errors using
|
|
Packit |
6ef888 |
\fBfsck.gfs2\fP and that the filesystem be backed up before
|
|
Packit |
6ef888 |
attempting to convert it. The convert process is irreversible and any
|
|
Packit |
6ef888 |
error encountered during the conversion can result in the abrupt
|
|
Packit |
6ef888 |
termination of the program and consequently an unusable filesystem.
|
|
Packit |
6ef888 |
See \fBNOTES\fP section below for more information.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
.SH OPTIONS
|
|
Packit |
6ef888 |
.TP
|
|
Packit |
6ef888 |
\fB-h\fP
|
|
Packit |
6ef888 |
Help.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
This prints out the proper command line usage syntax.
|
|
Packit |
6ef888 |
.TP
|
|
Packit |
6ef888 |
\fB-q\fP
|
|
Packit |
6ef888 |
Quiet. Print less information while running.
|
|
Packit |
6ef888 |
.TP
|
|
Packit |
6ef888 |
\fB-n\fP
|
|
Packit |
6ef888 |
No to all questions.
|
|
Packit |
6ef888 |
.TP
|
|
Packit |
6ef888 |
\fB-V\fP
|
|
Packit |
6ef888 |
Print program Version information only.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
Print out the current version name.
|
|
Packit |
6ef888 |
.TP
|
|
Packit |
6ef888 |
\fB-v\fP
|
|
Packit |
6ef888 |
Verbose operation.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
Print more information while running.
|
|
Packit |
6ef888 |
.TP
|
|
Packit |
6ef888 |
\fB-y\fP
|
|
Packit |
6ef888 |
Yes to all questions.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
By specifying this option, gfs2_convert will not prompt before making
|
|
Packit |
6ef888 |
changes.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
.SH EXAMPLE
|
|
Packit |
6ef888 |
.TP
|
|
Packit |
6ef888 |
gfs2_convert /dev/vg0/lvol0
|
|
Packit |
6ef888 |
This will convert the Global File System on the block device
|
|
Packit |
6ef888 |
"/dev/vg0/lvol0" to gfs2 format.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
.SH NOTES
|
|
Packit |
6ef888 |
If gfs2_convert is interrupted for some reason other than a conversion
|
|
Packit |
6ef888 |
failure, DO NOT run \fBfsck.gfs2\fP on this partially converted filesystem.
|
|
Packit |
6ef888 |
When this occurs, reissue the gfs2_convert command on the partially converted
|
|
Packit |
6ef888 |
filesystem to complete the conversion process.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
The GFS2 filesystem does not support Context-Dependent Path Names (CDPNs).
|
|
Packit |
6ef888 |
gfs2_convert identifies such CDPNs and replaces them with empty directories
|
|
Packit |
6ef888 |
with the same name. The administrator can use bind mounts on these
|
|
Packit |
6ef888 |
directories to get the same effect as CDPNs.
|
|
Packit |
6ef888 |
|
|
Packit |
6ef888 |
When converting full or nearly full filesystems, it is possible that there
|
|
Packit |
6ef888 |
won't be enough space available to fit all the GFS2 filesystem data
|
|
Packit |
6ef888 |
structures. In such cases, the size of all the journals is reduced uniformly
|
|
Packit |
6ef888 |
such that everything fits in the available space.
|