You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/azure/virtual-machines/linux/linux-virtual-machine-cannot-start-fstab-errors.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Troubleshoot Linux VM boot issues due to fstab errors | Microsoft Learn
3
-
description: Explains why Linux VM cannot start and how to solve the problem.
3
+
description: Explains why Linux VM cant start and how to solve the problem.
4
4
services: virtual-machines
5
5
documentationcenter: ''
6
6
author: saimsh-msft
@@ -58,18 +58,18 @@ There are 2 ways to resolve the issue:
58
58
### Repair the VM Online
59
59
#### Use the serial console
60
60
1. Connect to [the serial console](./serial-console-linux.md) of the VM from Azure portal.
61
-
2. Manual access to single user mode is required to reconfigure fstab. The steps can vary based on the type of Linux OS in use and access to the root account. Follow [single user mode](serial-console-grub-single-user-mode.md) documentation to access single user mode for each supported Linux partner images.
61
+
2. Manual access to single user mode is required to reconfigure fstab. The steps can vary based on the type of Linux OS in use and access to the root account. Follow [single user mode](serial-console-grub-single-user-mode.md) documentation to access single user mode for each supported Linux partner image.
62
62
63
63
##### Fstab troubleshooting steps
64
64
1. Once the vm has booted into single user mode. Use your favorite text editor to open the fstab file.
65
65
66
66
```
67
67
vi /etc/fstab
68
68
```
69
-
2. Review the listed filesystems in `/etc/fstab`. Each line in the fstab file indicates a filesystem that is mounted when the VM starts. For more information about the syntax of the fstab file, run the `man fstab` command. To troubleshoot a boot failure, review the entry for the filesystem that failed to mount. It is a good practice to review each line to ensure that it is correct in both structure and content. Few points to consider to correctly administer an fstab file are as follows:
69
+
2. Review the listed filesystems in `/etc/fstab`. Each line in the fstab file indicates a filesystem that is mounted when the VM starts. For more information about the syntax of the fstab file, run the `man fstab` command. To troubleshoot a boot failure, review the entry for the filesystem that failed to mount. It's a good practice to review each line to ensure that it's correct in both structure and content. Few points to consider to correctly administer a fstab file are as follows:
70
70
71
-
* Fields on each line are separated by tabs or spaces. Blank lines are ignored. Lines that have a number sign (#) as the first character are comments. Commented lines can remain in the fstab file, but they won't be processed. We recommend that you comment fstab lines that you are unsure about instead of removing the lines.
72
-
* Mount the data disks on Azure VMs by using the UUID of the file system partition.To determine the UUID of the file system, run the `blkid` command. For more information about the syntax, run the `man blkid` command. Example of UUID entry in fstab file:
71
+
* Fields on each line are separated by tabs or spaces. Blank lines are ignored. Lines that have a number sign (#) as the first character are comments. Commented lines can remain in the fstab file, but they won't be processed. We recommend that you comment fstab lines that you're unsure about instead of removing the lines.
72
+
* Mount the data disks on Azure VMs by using the UUID of the file system partition.To determine the UUID of the file system, run the `blkid` command. For more information about the syntax, run the `man blkid` command. Example of UUID entry in fstab file:
73
73
74
74
```bash
75
75
UUID=<UUID number here> /data xfs defaults,nofail 0 0
@@ -91,11 +91,11 @@ There are 2 ways to resolve the issue:
91
91
92
92
### Repair the VM offline
93
93
94
-
If the VM serial console access is not available, an alternative solution is to repair the vm offline. There are two ways to take an offline approach:
94
+
If the VM serial console access isn't available, an alternative solution is to repair the vm offline. There are two ways to take an offline approach:
95
95
96
96
#### Use Azure Linux Auto Repair (ALAR)
97
97
98
-
Azure Linux Auto Repair (ALAR) scripts is a part of VM repair extension described in [Use Azure Linux Auto Repair (ALAR) to fix a Linux VM](./repair-linux-vm-using-alar.md). ALAR covers automation of multiple repair scenarios including `/etc/fstab` issues.
98
+
Azure Linux Auto Repair (ALAR) scripts are a part of VM repair extension described in [Use Azure Linux Auto Repair (ALAR) to fix a Linux VM](./repair-linux-vm-using-alar.md). ALAR covers automation of multiple repair scenarios including `/etc/fstab` issues.
99
99
100
100
The ALAR scripts use the repair extension `repair-button` to fix fstab issues by specifying `--button-command fstab`. This parameter triggers the automated recovery. Implement the following steps to automate fstab errors via the offline ALAR approach:
101
101
@@ -105,13 +105,13 @@ az vm repair repair-button --button-command fstab --verbose rgtest --name vmtest
105
105
106
106
>[!NOTE]
107
107
>The resource group name `rgtest` and VM name `vmtest` shown in these examples are placeholders and must be updated accordingly.
108
-
>The Repair VM script, in conjunction with the ALAR script, will temporarily create a Resource Group, a repair VM, and a copy of the OS disk from the affected VM. It backs up the original `/etc/fstab` file and modifies it—either by stripping out or commenting out data file system entries that are not required for booting the system.
108
+
>The Repair VM script, in conjunction with the ALAR script, will temporarily create a Resource Group, a repair VM, and a copy of the OS disk from the affected VM. It backs up the original `/etc/fstab` file and modifies it—either by stripping out or commenting out data file system entries that aren't required for booting the system.
109
109
>After the OS starts successfully, review and edit the `/etc/fstab` file to correct any errors that may have prevented a proper reboot. Finally, the Resource Group containing the repair VM will be automatically deleted by the `repair-button` script.
110
110
111
111
112
112
#### Use Manual Method
113
113
114
-
If both serial console and ALAR approach is not possible or fails , the repair has to be performed manually. Follow the steps here to manually attach the OS disk to a recovery VM and swap the OS disk back to the original VM:
114
+
If both serial console and ALAR approach isn't possible or fails , the repair has to be performed manually. Follow the steps here to manually attach the OS disk to a recovery VM and swap the OS disk back to the original VM:
115
115
* [Attach the OS disk to a recovery VM using the Azure portal](./troubleshoot-recovery-disks-portal-linux.md)
116
116
* [Attach the OS disk to a recovery VM using Azure CLI](./troubleshoot-recovery-disks-linux.md)
0 commit comments