^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ==================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Global File System
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) ==================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) https://fedorahosted.org/cluster/wiki/HomePage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) GFS is a cluster file system. It allows a cluster of computers to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) simultaneously use a block device that is shared between them (with FC,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) iSCSI, NBD, etc). GFS reads and writes to the block device like a local
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) file system, but also uses a lock module to allow the computers coordinate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) their I/O so file system consistency is maintained. One of the nifty
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) features of GFS is perfect consistency -- changes made to the file system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) on one machine show up immediately on all other machines in the cluster.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) GFS uses interchangeable inter-node locking mechanisms, the currently
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) supported mechanisms are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) lock_nolock
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) - allows gfs to be used as a local file system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) lock_dlm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) - uses a distributed lock manager (dlm) for inter-node locking.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) The dlm is found at linux/fs/dlm/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Lock_dlm depends on user space cluster management systems found
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) at the URL above.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) To use gfs as a local file system, no external clustering systems are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) needed, simply::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) $ mkfs -t gfs2 -p lock_nolock -j 1 /dev/block_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) $ mount -t gfs2 /dev/block_device /dir
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) If you are using Fedora, you need to install the gfs2-utils package
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) and, for lock_dlm, you will also need to install the cman package
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) and write a cluster.conf as per the documentation. For F17 and above
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) cman has been replaced by the dlm package.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) GFS2 is not on-disk compatible with previous versions of GFS, but it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) is pretty close.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) The following man pages can be found at the URL above:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) ============ =============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) fsck.gfs2 to repair a filesystem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) gfs2_grow to expand a filesystem online
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) gfs2_jadd to add journals to a filesystem online
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) tunegfs2 to manipulate, examine and tune a filesystem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) gfs2_convert to convert a gfs filesystem to gfs2 in-place
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) mkfs.gfs2 to make a filesystem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) ============ =============================================