Welcome to the Reiser4 Wiki, the Wiki for users and developers of the ReiserFS and Reiser4 filesystems.
For now, most of the documentation is just a snapshot of the old Namesys site (archive.org, 2007-09-29).
There was also a Reiser4 Wiki (archive.org, 2007-07-06) once on pub.namesys.com.
Logical Volumes Howto
WARNING! FSCK doesn't work correctly on volumes with scaling-out abilities. Any attempts to repair such volumes will result in data loss
Disk format 5.1.3 allows to create volumes with scaling-out abilities. That is, you are able to easily add a brick (i.e. formatted block device) to your volume, thus, increasing its capacity. Bricks don't need to be of equal size: data will be distributed fairly among different sized bricks. Also, at any time you are able to remove such brick. Moreover, at any time you can change an abstract capacity of any brick, thus, controlling a portion of IO requests being issued against each brick in your logical volume. More information can be found in Logical Volumes Background.
Finally, you can add a proxy-brick created over a high-performance block device (e.g. SSD or NVRAM) to your logical volume. It allows to increase performance of file operations in the case when your volume is composed of slow media.
To get started with logical volumes you will need Reiser4 kernel module of SFRN (Software Framework Release Number) 5.1.3, or higher. The patches against stock kernels can be found here. When building the kernel, make sure that "Plan-A key allocation scheme" is disabled in the configuration menu (or CONFIG_REISER4_OLD is not set, which is the same). The important note is that volumes based on the old disk format ("format40") are not scalable (you are not able to add a brick to such volume). Moreover, it is impossible to mount volumes managed by new and old disk format in the same system: you need to choose (by enabling, or disabling the mentioned configuration option). This is for performance reasons.
To work with scalable volumes you will need reiser4progs-2.0.3, or higher. It requires libaal-1.0.7.
To create a scalable volume, just build the first brick of your volume by formatting some block-device with mkfs.reiser4 utility and mount it. Then you will be able to grow it by adding new bricks by volume.reiser4 utility. See logical volumes administration guide for details. For managing proxy-bricks see proxy-device administration guide.