BeeGFS File System Check (beegfs-fsck)

This section describes the beegfs-fsck command and its options. It is used for two independent actions. (a) It checks the file system for consistency and provides a repair tool, and (b) it is used to enable quota support. The default options for the file system check vary between different versions of BeeGFS. It also provides the parameter --automatic, which would directly try to bring everything back in a consistent state. In a system with data loss on the metadata targets, this would result in a deletion of storage data. Therefore, we recommend not to enable --automatic, unless you are sure about it. A suggested procedure to check a BeeGFS file system efficiently will be explained within this page.

Table of Contents (Page)


General Information

The primary use of beegfs-fsck is to check a file system for consistency and run to execute repair tools. Furthermore it offers the possiblity to enable quota support.
For its main purpose, it creates a database of the current file system contents, which will be stored on the local machine.

A BeeGFS file system check gathers information from all available servers in parallel and stores the information in a database to check for errors and to validate consistency across the servers. A checkup of a file system of moderate size (with tens of millions of entries) usually takes less than one hour to complete. However, a checkup of a large file system (with hundreds of millions of entries) can take significantly longer to complete. Therefore, it is important to plan this procedure carefully.

Often, the user faces a trade-off between speed and safety when performing a large file system checkup. The fastest way would be taking the system down and performing a single execution of the command beegfs-fsck with the option --automatic, to repair all errors automatically. However, unexpected errors caused by unsuccessful maintenance procedures executed in the past and hardware failures could lead the command to try to fix inconsistencies in the wrong way.

Enable Quota

The command beegfs-fsck --enablequota sets quota information. Further options can be be displayed with beegfs-fsck --enablequota --help. For information about quota please look here.

BeeGFS file system check

The command beegfs-fsck --checkfs runs a consistency check of the file system and repairs it using default actions. For this purpose, it creates a database of the current file system contents on the local machine. This command should only be run with all targets in the "Good" state, and never if there are targets in a "Bad" or "Needs-resync" state or while a resync is running. This must be verified before executing the file system check by running the following commands:
$ beegfs-ctl --listtargets --nodetype=meta --state
$ beegfs-ctl --listtargets --nodetype=storage --state

Suggested procedure for a large file system

The following steps help you to find a balanced approach for checking the file system that is more suitable for your case.

Valid XHTML :: Valid CSS: :: Powered by WikkaWiki