doc: raid-new-documentation

This commit is contained in:
fett0 2021-12-24 13:57:34 -03:00
parent 6ed06afb70
commit 3b556cb154

View File

@ -26,7 +26,7 @@ The VyOS implementation of RAID 1 allows the following:
.. _raid_instalation: .. _raid_instalation:
Installation Implications Installation Implications
========================= =========================
The VyOS systems installation utility provides several options for installing The VyOS systems installation utility provides several options for installing
@ -42,8 +42,8 @@ to a RAID 1 set. You can:
Configuration Configuration
============= =============
NonRAID 1 System Single disk, install as normal
----------------- ------------------------------
When the VyOS system is installed, it automatically detects the presence of two When the VyOS system is installed, it automatically detects the presence of two
disks not currently part of a RAID array. In these cases, the VyOS disks not currently part of a RAID array. In these cases, the VyOS
@ -57,13 +57,12 @@ mirroring for the drives, with the following prompt.
* If you do not want to configure RAID 1 mirroring, enter “No” at the prompt * If you do not want to configure RAID 1 mirroring, enter “No” at the prompt
and continue with installation in the normal way. and continue with installation in the normal way.
NonRAID 1 to RAID 1 Empty 2+ Disk
-------------------- -------------
If you reinstall a non-RAID VyOS system on a system with two identical disks If VyOS system detect two identical disks that are not currently part of a
that are not currently part of a RAID 1 set, the VyOS installation utility RAID-1 set, the VyOS installation utility automatically offers you the option
automatically offers you the option of configuring RAID 1 mirroring for the of configuring RAID 1 mirroring for the drives, with the following prompt.
drives, with the following prompt.
.. code-block:: none .. code-block:: none
@ -90,13 +89,20 @@ prompted to confirm that you want to continue
installation is complete. Enter “No” to delete the current VyOS installation is complete. Enter “No” to delete the current VyOS
configuration. configuration.
5 - Continue with installation in the normal way. .. code-block:: none
Would you like me to save the data on it before I delete it?
5 - Enter “Yes” at the prompt to retain the current VyOS configuration once
installation is complete. Enter “No” to delete the current VyOS configuration.
6 - Continue with installation in the normal way.
RAID 1 to NonRAID 1 Present RAID-1
-------------------- --------------
If you reinstall VyOS software on a system with a RAID 1 set already configured, When the VyOS software on a system with a RAID 1 set already configured,
the installation utility will detect the array and will display the following the installation utility will detect the array and will display the following
prompt: prompt:
@ -135,60 +141,6 @@ installation is complete. Enter “No” to delete the current VyOS configuratio
5 - Continue with installation in the normal way. 5 - Continue with installation in the normal way.
RAID 1 to RAID 1
----------------
If you reinstall the VyOS software on a system with a RAID 1 set already
configured, the installation utility will detect the array and will display
the following prompt:
.. code-block:: none
Would you like to use this one?
1 - To continue to use the existing RAID 1 array, enter “Yes” at the prompt.
The system prompts you to indicate whether you want to save the old
configuration data. This represents the current VyOS configuration.
.. code-block:: none
Would you like me to save the data on it before I delete it?
2 - Enter “Yes” at the prompt to retain the current VyOS configuration once
installation is complete. Enter “No” to delete all current VyOS configuration.
3 - Continue with installation in the normal way.
RAID 1 to new RAID 1
--------------------
You can also recreate the RAID 1 array on disk drives already configured for
RAID-1.The installation utility will detect the array and will display the
following prompt:
.. code-block:: none
Would you like to use this one?
1 - To stop using the existing RAID 1 array, enter “No” at the prompt.
The system detects the two disks and prompts you to indicate whether you
want to configure RAID 1 mirroring in them.
.. code-block:: none
Would you like to configure RAID 1 mirroring on them?
2 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system
detects a file system on the partitions being used for RAID 1 it will prompt
you to indicate whether you want to continue creating the RAID 1 array.
.. code-block:: none
Continue creating array?
3 - To overwrite the old filesystem, enter “Yes”.
4 - Continue with installation in the normal way.
Detecting and Replacing a Failed RAID 1 Disk Detecting and Replacing a Failed RAID 1 Disk
-------------------------------------------- --------------------------------------------
@ -202,12 +154,10 @@ To replace a bad disk within a RAID 1 set, perform the following steps:
1 - Remove the failed disk from the RAID 1 set by issuing the following 1 - Remove the failed disk from the RAID 1 set by issuing the following
command: command:
.. code-block:: none .. opcmd:: delete raid RAID1device member diskpartition
vyos@vyos:~$ remove raid RAID1device member diskpartition where RAID-1-device is the name of the RAID 1 device (for example, md0) and
disk-partition is the name of the failed disk partition (for example, sdb2).
where RAID-1-device is the name of the RAID 1 device (for example, md0) and
disk-partition is the name of the failed disk partition (for example, sdb2).
2- Physically remove the failed disk from the system. If the drives are not 2- Physically remove the failed disk from the system. If the drives are not
hot-swappable, then you must shut down the system before removing the disk. hot-swappable, then you must shut down the system before removing the disk.
@ -216,51 +166,35 @@ hot-swappable, then you must shut down the system before removing the disk.
4 - Format the new disk for RAID 1 by issuing the following command: 4 - Format the new disk for RAID 1 by issuing the following command:
.. code-block:: none .. opcmd:: format <diskdevice1> like <diskdevice2>
vyos@vyos:~$ format <diskdevice1> like <diskdevice2> where disk-device1 is the replacement disk (for example, sdb) and
disk-device2 is the existing healthy disk (for example, sda).
where disk-device1 is the replacement disk (for example, sdb) and disk-device2
is the existing healthy disk (for example, sda).
5-Add the replacement disk to the RAID 1 set by issuing the following command: 5-Add the replacement disk to the RAID 1 set by issuing the following command:
.. code-block:: none .. opcmd:: add raid <RAID1device> member <diskpartition>
vyos@vyos:~$ add raid <RAID1device> member <diskpartition> where RAID-1-device is the name of the RAID 1 device (for example, md0) and
disk-partition is the name of the replacement disk partition
where RAID-1-device is the name of the RAID 1 device (for example, md0) and (for example, sdb2).
disk-partition is the name of the replacement disk partition
(for example, sdb2).
Operation Operation
========= =========
Use this command to add a member disk partition to the RAID 1 set. Adding a This part introduces how to add a disk partition to a RAID-1 set initiates
disk partition to a RAID 1 set initiates mirror synchronization, where all data mirror synchronization, check and display information.
on the existing member partition is copied to the new partition.
Before adding a brand new drive to a RAID 1 set, the drive must be formatted
using
.. code-block:: none .. opcmd:: add raid <RAID1device> member <diskpartition>
Use this command to add a member disk partition to the RAID 1 set. Adding a
disk partition to a RAID 1 set initiates mirror synchronization, where all
data on the existing member partition is copied to the new partition.
vyos@vyos:~$ add raid <RAID1device> member <diskpartition> .. opcmd:: format <diskdevice1> like <diskdevice2>
Use this command to format a disk to be partitioned exactly like a second disk. This command is typically used to prepare a disk to be added to a preexisting
The disk to be formatted must be inactive; that is, it must not have any RAID 1 set (of which disk-device2 is already a member).
partitions mounted and it must not already be part of an active RAID 1 set.
In formatting, no data is copied to the formatted device, but any existing data
on the formatted device is lost.
This command is typically used to prepare a disk to be added to a preexisting
RAID 1 set (of which disk-device2 is already a member).
.. code-block:: none
vyos@vyos:~$ format <diskdevice1> like <diskdevice2>
Displaying information about a RAID 1 set with two members  one being
resynchronized.
.. opcmd:: show raid <RAID1device> .. opcmd:: show raid <RAID1device>
@ -309,4 +243,3 @@ resynchronized.