Implementing UFS Journaling on a Desktop PC
|  | Next

## Implementing UFS Journaling on a Desktop PC

### Manolis Kiagias

`<manolis@FreeBSD.org>`

Revision: 41645

Copyright © 2008 Manolis Kiagias

Legal Notice
Last modified on 2013-05-17 by gabor.
Abstract

A journaling file system uses a log to record all transactions that take place in the file system, and preserves its integrity in the event of a system crash or power failure. Although it is still possible to lose unsaved changes to files, journaling almost completely eliminates the possibility of file system corruption caused by an unclean shutdown. It also shortens to a minimum the time required for after-failure file system checking. Although the UFS file system employed by FreeBSD does not implement journaling itself, the new journal class of the GEOM framework in FreeBSD 7.`X` can be used to provide file system independent journaling. This article explains how to implement UFS journaling on a typical desktop PC scenario.

## 1. Introduction

While professional servers are usually well protected from unforeseen shutdowns, the typical desktop is at the mercy of power failures, accidental resets, and other user related incidents that can lead to unclean shutdowns. Soft Updates usually protect the file system efficiently in such cases, although most of the times a lengthy background check is required. On rare occasions, file system corruption reaches a point where user intervention is required and data may be lost.

The new journaling capability provided by GEOM can greatly assist in such scenarios, by virtually eliminating the time required for file system checking, and ensuring that the file system is quickly restored to a consistent state.

This article describes a procedure for implementing UFS journaling on a typical desktop PC scenario (one hard disk used for both operating system and data). It should be followed during a fresh installation of FreeBSD. The steps are simple enough and do not require overly complex interaction with the command line.

After reading this article, you will know:

- How to reserve space for journaling during a new installation of FreeBSD.

- How to load and enable the `geom_journal` module (or build support for it in your custom kernel).

- How to convert your existing file systems to utilize journaling, and what options to use in `/etc/fstab` to mount them.

- How to implement journaling in new (empty) partitions.

- How to troubleshoot common problems associated with journaling.

Before reading this article, you should be able to:

- Understand basic UNIX® and FreeBSD concepts.

- Be familiar with the installation procedure of FreeBSD and the sysinstall utility.

### Warning:

The procedure described here is intended for preparing a new installation where no actual user data is stored on the disk yet. While it is possible to modify and extend this procedure for systems already in production, you should backup all important data before doing so. Messing around with disks and partitions at a low level can lead to fatal mistakes and data loss.

|  | Next
|  | 2. Understanding Journaling in FreeBSD

This, and other documents, can be downloaded from http://ftp.FreeBSD.org/pub/FreeBSD/doc/

For questions about FreeBSD, read the documentation before contacting <questions@FreeBSD.org>.
For questions about this documentation, e-mail <doc@FreeBSD.org>.