in→docs

docs/public/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

docs/public/mdadm/index.rst

@@ -0,0 +1,10 @@
+mdadm
+=====
+
+Multi Disk ADMin
+
+.. toctree::
+
+ creation
+ persistence
+ manual

docs/public/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

docs/public/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