mdadm

in/index.rst

@@ -16,6 +16,7 @@ RTFD
    public/network/index
    public/packages/index
    public/security/index
+   public/storage/index
    public/systems/index
    public/versions/index
    public/web/index

in/public/storage/index.rst

@@ -0,0 +1,7 @@
+Storage
+=======
+
+.. toctree::
+   :maxdepth: 2
+
+   mdadm/index

in/public/storage/mdadm/creation.rst

@@ -0,0 +1,31 @@
+Creation
+========
+
+.. warning::
+
+ Only use partitions, never whole devices,
+ otherwise assembly will fail after reboot!
+
+RAID 0
+------
+
+.. code:: shell
+
+ mdadm --create /dev/md0 --level=0 \
+ --raid-devices=2 /dev/sd[bc]1
+
+RAID 1
+------
+
+.. code:: shell
+
+ mdadm --create /dev/md0 --level=1 \
+ --raid-devices=2 /dev/sd[bc]1
+
+RAID 5
+------
+
+.. code:: shell
+
+ mdadm --create /dev/md0 --level=5 \
+ --raid-devices=3 /dev/sd[b-d]1

in/public/storage/mdadm/index.rst

@@ -0,0 +1,8 @@
+MDadm (MultiDisk admin)
+=======================
+
+.. toctree::
+
+ creation
+ persistence
+ manual

in/public/storage/mdadm/manual.rst

@@ -0,0 +1,27 @@
+Manual operations
+=================
+
+.. note::
+
+ Use --scan to refer to all known devices
+
+Details
+-------
+
+.. code:: shell
+
+ mdadm --detail /dev/md0
+
+Stop
+----
+
+.. code:: shell
+
+ mdadm --stop /dev/md0
+
+Assemble
+--------
+
+.. code:: shell
+
+ mdadm --assemble /dev/md0

in/public/storage/mdadm/persistence.rst

@@ -0,0 +1,14 @@
+Persistence
+===========
+
+* reference the device in configuration
+
+.. code:: shell
+
+ mdadm --detail --scan /dev/md0 >> /etc/mdadm/mdadm.conf
+
+* update the initial file system
+
+.. code:: shell
+
+ update-initramfs -u