diff --git a/help/custom.css b/help/custom.css index 865f475..7770540 100644 --- a/help/custom.css +++ b/help/custom.css @@ -1,5 +1,9 @@ body { font-family: sans-serif; + line-height: 1.5; + margin: 2rem auto; + padding: 0 1.25rem 2rem; + color: #202124; } h1, @@ -17,14 +21,20 @@ code { padding: 0.1rem 0.3rem; } -div { - pading: 5em; +img { + display: block; + margin: auto; + padding: 15px 0; /* Adds space between each */ } p { margin: .2em; } +. center { + text-align:center; +} + .footer { border-top: 1px solid #d0d7de; color: #5f6368; diff --git a/help/mx-boot-repair.html b/help/mx-boot-repair.html index 7a6fe6a..2ed23b7 100644 --- a/help/mx-boot-repair.html +++ b/help/mx-boot-repair.html @@ -2,33 +2,32 @@ + HELP: MX Boot Repair - + -

HELP: MX Boot Repair

+

HELP: MX Boot Repair

-

MX Boot Repair is a GUI app that can be used to recover from boot failure.

+

MX Boot Repair is a GUI app that can be used to recover from boot failure.

-

Some definitions:

+

Some definitions:

-

This app’s selection for “Install on” (see below) in the “Reinstall GRUB bootloader on ESP, MBR or PBR (root)” is not to be assumed as automatically correct at all times.

- -

At times, with a very complex PC configuration there may need to be change(s) made to better match the PC under repair.

+

This application’s selection for “Install on” (see below) in the “Reinstall GRUB bootloader on ESP, MBR or PBR (root)” is not to be assumed as automatically correct at all times. With a very complex PC configuration there may need to be change(s) made to better match the PC under repair.

-
Select-boot-method-ESP.png
+Select boot method ESP

The best starting point is to live-boot from a recent USB, and select “Repair GRUB configuration file”.

-

NOTES

+

NOTES

Repair Grub configuration file is the most common use of this app. It should always be attempted first. Running just the “Repair GRUB configuration file” assumes that Grub is fully and properly installed in the expected location. Sometimes running a “Reinstall Grub bootloader” is needed to be done first, before Repair Grub configuration file.

@@ -37,9 +36,9 @@

NOTES

Booting the PC

-

Example at below of a One Time Boot Menu. Choose the option ▸UEFI Boot Sources or Legacy Boot Sources depending on how Linux was installed. If you know that the PC’s Linux installation was in Legacy mode then pick “Legacy Boot Sources”. Other PCs screens may vary.

+

Example at below of a One Time Boot Menu. Choose the option ▸UEFI Boot Sources or Legacy Boot Sources depending on how Linux was installed. If you know that the PC’s Linux installation was in Legacy mode then pick “Legacy Boot Sources”. Other PCs screens may vary.

-
BootRepair02.jpg
+BootRepair02

Dual Boot with Windows 10 and Windows 11

@@ -51,6 +50,8 @@

Partition labels

It is always good to have your partitions labeled. This allows better recognition for where the ESP (EFI System Partition) is located. Some Linux distro’s install do not label the ESP nor the /root.

+
+

TIP: you can open GParted and right click on partitions in order to give them labels e,g like “EFI-SYSTEM” or just “ESP” (without ” “). Labeling partitions is best done from a Live USB, as these partitions needs to be unmounted for GParted to set a label on the partition(s).

@@ -63,9 +64,10 @@

Windows partitions

Below is a view of a Windows hard disk layout prior to any partitions being labeled.

-
Before-Choose-Partitions.jpg
Typical GParted view of a Windows 11 hard disk layout.
+Before Choose Partitions +
Typical GParted view of a Windows 11 hard disk layout.
-

Partitions above explained:

+

Partitions above explained:

sda1 – EFI aka ESP. Can be FAT32 or Vfat. Size ranges from 25-300 MiB. MX default is 256 MiB.

sda2 – “Windows Resources” Normally hidden in Windows File Manager. No format is normal.

@@ -78,9 +80,9 @@

After running boot repair

It is preferred to power OFF the PC, and then power on the PC back ON. This is because with a normal reboot will not clear all EFI stuff from RAM. Sometimes the MX Installer misses generating entries for other previously installed OS’s, so run in terminal:

-
sudo update-grub
+
sudo update-grub
-

This is a good check, to see anything was missed.

+

This is a good check, to see if anything was missed.



@@ -97,36 +99,44 @@

Repair GRUB configuration file

2. Select: ◉ Repair GRUB configuration file. Click ‘→ Next’.

3. On the ‘Select GRUB location‘ screen in ‘Select root location:’ choose the MX Linux / root partition.

-
Select-Grub-Location01.png
+Select-Grub-Location01

4. Click ‘✔Apply’.

5. In the ‘Authenticate‘ pop-up enter ‘demo’ for the ‘Password:’ prompt and click ‘Authenticate’.

6. A pop-up appears: ‘The GRUB configuration file (grub.cfg) is being rebuilt’.

7. When ‘Success‘ popup asks: ‘Do you want to exit MX Boot Repair?’ click ‘✔Yes’.

-
+


+

UEFI PC boot repair

+

You MUST be booted in UEFI mode to repair a UEFI installation with this app.

-

To reinstall GRUB bootloader:

+ +

To reinstall GRUB bootloader:

Note: in the image below “EFI-SYSTEM” and “MX25Xfce” are partition labels are displayed as hints for your choices.

-
Select-boot-method-ESP.png
+
+
Select-boot-method-ESP.png
+

1. Boot MX Linux USB in UEFI mode. Run MX Boot Repair.

-

2. Select: ‘◉ Reinstall GRUB bootloader on ESP, MBR or PBR (root)’. Click ‘→ Next’.

+ +

2. Select: ‘◉ Reinstall GRUB bootloader on ESP, MBR or PBR (root)’. Click ‘→ Next’.

+

3. On the Select Boot Method:

+ -

4. Click ‘✔Apply’.

+

4. Click ‘✔Apply’.

5. In the Authenticate pop-up enter ‘demo’ for the ‘Password:’ prompt and click ‘Authenticate’.

6. A pop-up ‘Select /boot location:’ asks you to choose: If no encryption is in use, choose the ESP / EFI and then click ‘✔OK’.

7. Select the ESP aka EFI partition (if encryption is not in use) with the arrow and then click ‘✔OK’.

@@ -138,15 +148,15 @@

To reinstall GRUB bootloader:

Legacy/MBR PC repairs

You MUST be booted in Legacy/MBR mode to repair a Legacy installation with this app.

- -

Repairing the bootloader by regenerating the GRUB configuration file is the most common use of this application and should be attempted first.

+
+

Repairing the bootloader by regenerating the GRUB configuration file is the most common use of this application and should be attempted first.

Reinstall GRUB bootloader:

Note: in the image below “Lexar 126GB SSD” is the physical “sda” device and “MX25Xfce” is a partition label. The app displays these as hints for your choices.

-
Select-boot-method-MBR.png
+
Select-boot-method-MBR.png

1. Boot MX Linux USB in Legacy mode. Run MX Boot Repair.

2. Leave selected: ‘◉ Reinstall GRUB bootloader’ on MBR. Click ‘→ Next’.

@@ -175,15 +185,15 @@

Regenerate initramfs images

The files will take some time to be regenerated, especially on a slower PC .

From the man update-initramfs:

- +
The update-initramfs script manages your initramfs images on your lo‐cal box. It keeps track of the existing initramfs archives in /boot. There are three modes of operation create, update or delete. You must at least specify one of those modes. The initramfs is a gzipped cpio archive. At boot time, the kernel unpacks that archive into RAM disk, mounts and uses it as initial root file system. All finding of the root device happens in this early userspace. +



-

Development history: Adrian

-

License: here.

+

License: license.