Skip to content

Commit

Permalink
docs: fix double spacing errors
Browse files Browse the repository at this point in the history
Signed-off-by: Bobby Eshleman <bobby.eshleman@gmail.com>
  • Loading branch information
beshleman committed Jul 30, 2021
1 parent 1501bb3 commit 837b849
Show file tree
Hide file tree
Showing 5 changed files with 1,448 additions and 7 deletions.
6 changes: 3 additions & 3 deletions docs/guides.md
Original file line number Diff line number Diff line change
Expand Up @@ -648,7 +648,7 @@ Sometimes what happens is that the system either does not find all of the parts

This can also happen to the `md127` boot array where it will show with only one of the two drives in place and running. If it does not start and run at all, we will fail to get a normal boot of the system and likely be tossed into an emergency shell instead of the normal boot process. This is usually not consistent and another reboot will start the system. This can even happen when the boot RAID is the only RAID array in the system but fortunately that rarely happens.

So what can we do about this? Fortunately, we can give the system more information about what RAID arrays are in the system and specify that they should be started up at boot.
So what can we do about this? Fortunately, we can give the system more information about what RAID arrays are in the system and specify that they should be started up at boot.

### Stabilizing the RAID Boot Configuration: The mdadm.conf File

Expand Down Expand Up @@ -685,7 +685,7 @@ mdadm --examine --scan >> /etc/mdadm.conf
```
And then edit the file to change the format of the array names from `/dev/md/0` to `/dev/md0` and remove the `name=` parameters from each line. This isn't strictly necessary but keeps the array names in the file consistent with what is reported in `/proc/mdstat` and `/proc/partitions` and avoids giving each array another name (in our case those names would be `localhost:127` and `XCP-ng:0`).

So what do these lines do? The first line instructs the system to allow or attempt automatic assembly for all arrays defined in the file. The second specifies to report errors in the system by email to the root user. The third is a list of all drives in the system participating in RAID arrays. Not all drives need to be specified on a single DEVICE line. Drives can be split among multiple lines and we could even have one DEVICE line for each drive. The last two are descriptions of each array in the system.
So what do these lines do? The first line instructs the system to allow or attempt automatic assembly for all arrays defined in the file. The second specifies to report errors in the system by email to the root user. The third is a list of all drives in the system participating in RAID arrays. Not all drives need to be specified on a single DEVICE line. Drives can be split among multiple lines and we could even have one DEVICE line for each drive. The last two are descriptions of each array in the system.

This file gives the system a description of what arrays are configured in the system and what drives are used to create them but doesn't specify what to do with them. The system should be able to use this information at boot for automatic assembly of the arrays. Booting with the `mdadm.conf` file in place is more reliable but still runs into same problems as before.

Expand Down Expand Up @@ -797,7 +797,7 @@ This type of problem is very difficult to diagnose and correct. It may be possib

### More and Different

So what if we don't have or don't want a system that's identical to the example we just built in these instructions? Here are some of the possible and normal variations of software RAID under XCP-ng.
So what if we don't have or don't want a system that's identical to the example we just built in these instructions? Here are some of the possible and normal variations of software RAID under XCP-ng.

#### No preexisting XCP-ng RAID 1

Expand Down
Loading

0 comments on commit 837b849

Please sign in to comment.