Skip to content

Commit 148ebcc

Browse files
alek-pgmelikov
authored andcommitted
fix page heading vs sub-heading on VDEVs page
1 parent 9497303 commit 148ebcc

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

docs/Basic Concepts/VDEVs.rst

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,28 @@
1+
VDEVs
2+
=====
3+
14
What is a VDEV?
2-
===============
5+
~~~~~~~~~~~~~~~
36

47
A vdev (virtual device) is a fundamental building block of ZFS storage pools. It represents a logical grouping of physical storage devices, such as hard drives, SSDs, or partitions.
58

69
What is a leaf vdev?
7-
====================
10+
~~~~~~~~~~~~~~~~~~~~
811

912
A leaf vdev is the most basic type of vdev, which directly corresponds to a physical storage device. It is the endpoint of the storage hierarchy in ZFS.
1013

1114
What is a top-level vdev?
12-
=========================
15+
~~~~~~~~~~~~~~~~~~~~~~~~~
1316

1417
Top-level vdevs are the direct children of the root vdev. They can be single devices or logical groups that aggregate multiple leaf vdevs (like mirrors or RAIDZ groups). ZFS dynamically stripes data across all top-level vdevs in a pool.
1518

1619
What is a root vdev?
17-
====================
20+
~~~~~~~~~~~~~~~~~~~~
1821

1922
The root vdev is the top of the pool hierarchy. It aggregates all top-level vdevs into a single logical storage unit (the pool).
2023

2124
What are the different types of vdevs?
22-
======================================
25+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2326

2427
OpenZFS supports several types of vdevs. Top-level vdevs carry data and provide redundancy:
2528

@@ -42,7 +45,7 @@ Auxiliary vdevs provide specific functionality:
4245
* **Dedup**: A vdev dedicated strictly to storing the Deduplication Table (DDT).
4346

4447
How do vdevs relate to storage pools?
45-
=====================================
48+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4649

4750
Vdevs are the building blocks of ZFS storage pools. A storage pool (zpool) is created by combining one or more top-level vdevs. The overall performance, capacity, and redundancy of the storage pool depend on the configuration and types of vdevs used.
4851

@@ -66,7 +69,7 @@ for a pool with two RAIDZ1 top-level vdevs and 10 leaf vdevs:
6669
/dev/dsk/disk9 (leaf vdev)
6770

6871
How does ZFS handle vdev failures?
69-
==================================
72+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7073

7174
ZFS is designed to handle vdev failures gracefully. If a vdev fails, ZFS can continue to operate using the remaining vdevs in the pool,
7275
provided that the redundancy level of the pool allows for it (e.g., in a mirror, RAIDZ, or dRAID configuration).
@@ -75,7 +78,7 @@ Administrators can `zpool-replace(8) <https://openzfs.github.io/openzfs-docs/man
7578
the data onto the new vdev to return the pool to a healthy state.
7679

7780
How do I manage vdevs in ZFS?
78-
=============================
81+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7982

8083
Vdevs are managed using the `zpool(8) <https://openzfs.github.io/openzfs-docs/man/master/8/zpool.8.html>`_ command-line utility. Common operations include:
8184

0 commit comments

Comments
 (0)