As we all enter month three of the COVID-19 pandemic and look for new projects to keep us engaged (read: sane), can we interest you in learning the fundamentals of computer storage? Quietly this spring, we've already gone over some necessary basics like how to test the speed of your disks and what the heck RAID is. In the second of those stories, we even promised a follow-up exploring the performance of various multiple-disk topologies in ZFS, the next-gen filesystem you have heard about because of its appearances everywhere from Apple to Ubuntu.
Well, today is the day to explore, ZFS-curious readers. Just know up front that in the understated words of OpenZFS developer Matt Ahrens, "it's really complicated."
But before we get to the numbers—and they are coming, I promise!—for all the ways you can shape eight disks' worth of ZFS, we need to talk about how ZFS stores your data on-disk in the first place.
Zpools, vdevs, and devices
To really understand ZFS, you need to pay real attention to its actual structure. ZFS merges the traditional volume management and filesystem layers, and it uses a copy-on-write transactional mechanism—both of these mean the system is very structurally different than conventional filesystems and RAID arrays. The first set of major building blocks to understand are
zpool is the uppermost ZFS structure. A zpool contains one or more
vdevs, each of which in turn contains one or more
devices. Zpools are self-contained units—one physical computer may have two or more separate zpools on it, but each is entirely independent of any others. Zpools cannot share
vdevs with one another.
ZFS redundancy is at the
vdev level, not the
zpool level. There is absolutely no redundancy at the zpool level—if any storage
SPECIAL vdev is lost, the entire
zpool is lost with it.
Modern zpools can survive the loss of a
LOG vdev—though they may lose a small amount of dirty data, if they lose a
LOG vdev during a power outage or system crash.
It is a common misconception that ZFS "stripes" writes across the pool—but this is inaccurate. A zpool is not a funny-looking RAID0—it's a funny-looking JBOD, with a complex distribution mechanism subject to change.
For the most part, writes are distributed across available vdevs in accordance to their available free space, so that all vdevs will theoretically become full at the same time. In more recent versions of ZFS, vdev utilization may also be taken into account—if one vdev is significantly busier than another (ex: due to read load), it may be skipped temporarily for write despite having the highest ratio of free space available.
The utilization awareness mechanism built into modern ZFS write distribution methods can decrease latency and increase throughput during periods of unusually high load—but it should not be mistaken for carte blanche to mix slow rust disks and fast SSDs willy-nilly in the same pool. Such a mismatched pool will still generally perform as though it were entirely composed of the slowest device present.
zpool consists of one or more
vdevs(short for virtual device). Each vdev, in turn, consists of one or more real
devices. Most vdevs are used for plain storage, but several special support classes of vdev exist as well—including
SPECIAL. Each of these vdev types can offer one of five topologies—single-device, RAIDz1, RAIDz2, RAIDz3, or mirror.
RAIDz1, RAIDz2, and RAIDz3 are special varieties of what storage greybeards call "diagonal parity RAID." The 1, 2, and 3 refer to how many parity blocks are allocated to each data stripe. Rather than having entire disks dedicated to parity, RAIDz vdevs distribute that parity semi-evenly across the disks. A RAIDz array can lose as many disks as it has parity blocks; if it loses another, it fails, and takes the
zpool down with it.
Mirror vdevs are precisely what they sound like—in a mirror vdev, each block is stored on every device in the vdev. Although two-wide mirrors are the most common, a mirror vdev can contain any arbitrary number of devices—three-way are common in larger setups for the higher read performance and fault resistance. A mirror vdev can survive any failure, so long as at least one device in the vdev remains healthy.
Single-device vdevs are also just what they sound like—and they're inherently dangerous. A single-device vdev cannot survive any failure—and if it's being used as a storage or
SPECIAL vdev, its failure will take the entire
zpool down with it. Be very, very careful here.
SPECIAL vdevs can be created using any of the above topologies—but remember, loss of a
SPECIAL vdev means loss of the pool, so redundant topology is strongly encouraged.
This is probably the easiest ZFS related term to understand—it's literally just a random-access block device. Remember,
vdevs are made of individual devices, and the
zpool is made of
Disks—either rust or solid-state—are the most common block devices used as
vdev building blocks. Anything with a descriptor in
/dev that allows random access will work, though—so entire hardware RAID arrays can be (and sometimes are) used as individual devices.
The simple raw file is one of the most important alternative block devices a
vdev can be built from. Test pools made of sparse files are an incredibly convenient way to practice zpool commands, and see how much space is available on a pool or vdev of a given topology.
Let's say you're thinking of building an eight-bay server, and pretty sure you'll want to use 10TB (~9300 GiB) disks—but you aren't sure what topology best suits your needs. In the above example, we build a test pool out of sparse files in seconds—and now we know that a RAIDz2 vdev made of eight 10TB disks offers 50TiB of usable capacity.
There's one special class of
SPARE. Hotspare devices, unlike normal devices, belong to the entire pool, not a single
vdev. If any
vdev in the pool suffers a device failure, and a
SPARE is attached to the pool and available, the
SPARE will automatically attach itself to the degraded
Once attached to the degraded
SPARE begins receiving copies or reconstructions of the data that should be on the missing device. In traditional RAID, this would be called "rebuilding"—in ZFS, it's called "resilvering."
It's important to note that
SPARE devices don't permanently replace failed devices. They're just placeholders, intended to minimize the window during which a
vdev runs degraded. Once the admin has replaced the vdev's failed device and the new, permanent replacement device resilvers, the
SPARE detaches itself from the vdev, and returns to pool-wide duty.
Datasets, blocks, and sectors
The next set of building blocks you'll need to understand on your ZFS journey relate not so much to the hardware, but how the data itself is organized and stored. We're skipping a few levels here—such as the metaslab—in the interests of keeping things as simple as possible, while still understanding the overall structure.
dataset is roughly analogous to a standard, mounted filesystem—like a conventional filesystem, it appears to casual inspection as though it's "just another folder." But also like conventional mounted filesystems, each ZFS
dataset has its own set of underlying properties.
First and foremost, a
dataset may have a quota assigned to it. If you
zfs set quota=100G poolname/datasetname, you won't be able to put more than 100GiB of data into the system mounted folder
Notice the presence—and absence—of leading slashes in the above example? Each dataset has its place in both the ZFS hierarchy, and the system mount hierarchy. In the ZFS hierarchy, there is no leading slash—you begin with the name of the pool, and then the path from one dataset to the next—eg
pool/parent/child for a dataset named
child under the parent dataset
parent, in a pool creatively named
By default, the mountpoint of a
dataset will be equivalent to its ZFS hierarchical name, with a leading slash—the pool named
pool is mounted at
parent is mounted at
/pool/parent, and child dataset
child is mounted at
/pool/parent/child. The system mountpoint of a dataset may be altered, however.
If we were to
zfs set mountpoint=/lol pool/parent/child, the dataset
pool/parent/child would actually be mounted on the system as
In addition to datasets, we should mention
zvol is roughly analogous to a
dataset, except it doesn't actually have a filesystem in it—it's just a block device. You could, for example, create a
mypool/myzvol, then format it with the ext4 filesystem, then mount that filesystem—you now have an ext4 filesystem, but backed with all of the safety features of ZFS! This might sound silly on a single computer—but it makes a lot more sense as the back end for an iSCSI export.
In a ZFS pool, all data—including metadata—is stored in
blocks. The maximum size of a
block is defined for each
dataset in the
recordsize property. Recordsize is mutable, but changing
recordsize won't change the size or layout of any
blocks which have already been written to the dataset—only for new blocks as they are written.
If not otherwise defined, the current default
recordsize is 128KiB. This represents a sort of uneasy compromise in which performance won't be ideal for much of anything, but won't be awful for much of anything either.
Recordsize may be set to any value from 4K through 1M. (
Recordsize may be set even larger with additional tuning and sufficient determination, but that's rarely a good idea.)
block references data from only one file—you can't cram two separate files into the same
block. Each file will be composed of one or more
blocks, depending on size. If a file is smaller than
recordsize, it will be stored in an undersized block—for example, a
block holding a 2KiB file will only occupy a single 4KiB
sector on disk.
If a file is large enough to require multiple
blocks, all records containing that file will be
recordsize in length—including the last record, which may be mostly slack space.
Zvols do not have the
recordsize property—instead, they have
volblocksize, which is roughly equivalent.
The final building block to discuss is the lowly
sector is the smallest physical unit that can be written to or read from its underlying
device. For several decades, most disks used 512 byte
sectors. More recently, most disks use 4KiB
sectors, and some—particularly SSDs—use 8KiB
sectors, or even larger.
ZFS has a property which allows you to manually set the
sector size, called
ashift. Somewhat confusingly,
ashift is actually the binary exponent which represents sector size—for example, setting
ashift=9 means your
sector size will be 2^9, or 512 bytes.
ZFS queries the operating system for details about each block
device as it's added to a new
vdev, and in theory will automatically set
ashift properly based on that information. Unfortunately, there are many disks that lie through their teeth about what their
sector size is, in order to remain compatible with Windows XP (which was incapable of understanding disks with any other
This means that a ZFS admin is strongly advised to be aware of the actual
sector size of his or her
devices, and manually set
ashift accordingly. If
ashift is set too low, an astronomical read/write amplification penalty is incurred—writing a 512 byte "sectors" to a 4KiB real
sector means having to write the first "sector", then read the 4KiB
sector, modify it with the second 512 byte "sector", write it back out to a *new* 4KiB
sector, and so forth, for every single write.
In real world terms, this amplification penalty hits a Samsung EVO SSD—which should have
ashift=13, but lies about its sector size and therefore defaults to
ashift=9 if not overridden by a savvy admin—hard enough to make it appear slower than a conventional rust disk.
By contrast, there is virtually no penalty to setting
ashift too high. There is no real performance penalty, and slack space increases are infinitesimal (or zero, with compression enabled). We strongly recommend even disks that really do use 512 byte sectors should be set
ashift=12 or even
ashift=13 for future-proofing.
ashift property is per-
vdev—not per pool, as is commonly and mistakenly thought!—and is immutable, once set. If you accidentally flub
ashift when adding a new vdev to a pool, you've irrevocably contaminated that pool with a drastically under-performing
vdev, and generally have no recourse but to destroy the pool and start over. Even
vdev removal can't save you from a flubbed
CoW—Copy on Write—is a fundamental underpinning beneath most of what makes ZFS awesome. The basic concept is simple—if you ask a traditional filesystem to modify a file in-place, it does precisely what you asked it to. If you ask a copy-on-write filesystem to do the same thing, it says "okay"—but it's lying to you.
Instead, the copy-on-write filesystem writes out a new version of the
block you modified, then updates the file's metadata to unlink the old
block, and link the new
block you just wrote.
Unlinking the old
block and linking in the new is accomplished in a single operation, so it can't be interrupted—if you dump the power after it happens, you have the new version of the file, and if you dump power before, then you have the old version. You're always filesystem-consistent, either way.
Copy-on-write in ZFS isn't only at the filesystem level, it's also at the disk management level. This means that the RAID hole—a condition in which a stripe is only partially written before the system crashes, making the array inconsistent and corrupt after a restart—doesn't affect ZFS. Stripe writes are atomic, the vdev is always consistent, and Bob's your uncle.
ZIL—the ZFS Intent Log
There are two major categories of write operations—synchronous (sync) and asynchronous (async). For most workloads, the vast majority of write operations are asynchronous—the filesystem is allowed to aggregate them and commit them in batches, reducing fragmentation and tremendously increasing throughput.
Sync writes are an entirely different animal—when an application requests a sync write, it's telling the filesystem "you need to commit this to non volatile storage now, and until you do so, I can't do anything else." Sync writes must therefore be committed to disk immediately—and if that increases fragmentation or decreases throughput, so be it.
ZFS handles sync writes differently from normal filesystems—instead of flushing out sync writes to normal storage immediately, ZFS commits them to a special storage area called the ZFS Intent Log, or ZIL. The trick here is, those writes also remain in memory, being aggregated along with normal asynchronous write requests, to later be flushed out to storage as perfectly normal TXGs (Transaction Groups).
In normal operation, the ZIL is written to and never read from again. When writes saved to the ZIL are committed to main storage from RAM in normal TXGs a few moments later, they're unlinked from the ZIL. The only time the ZIL is ever read from is upon pool import.
If ZFS crashes—or the operating system crashes, or there's an unhandled power outage—while there's data in the ZIL, that data will be read from during the next pool import (eg when a crashed system is restarted). Whatever is in the ZIL will be read in, aggregated into TXGs, committed to main storage, and then unlinked from the ZIL during the import process.
One of the classes of support
vdev available is
LOG—also known as SLOG, or Secondary LOG device. All the SLOG does is provide the pool with a separate—and hopefully far faster, with very high write endurance—
vdev to store the
ZIL in, instead of keeping the Read More – Source