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
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.
2
+
title: Troubleshoot Linux VM boot issues due to fstab errors
3
+
description: Explains why Linux VM can't start and how to solve the problem.
4
4
services: virtual-machines
5
5
documentationcenter: ''
6
6
author: saimsh-msft
@@ -13,29 +13,32 @@ ms.topic: troubleshooting
13
13
ms.workload: infrastructure-services
14
14
ms.tgt_pltfrm: vm-linux
15
15
ms.devlang: azurecli
16
-
ms.date: 04/15/2024
16
+
ms.date: 02/19/2025
17
17
ms.author: saimsh
18
18
---
19
+
19
20
# Troubleshoot Linux VM boot issues due to fstab errors
20
21
21
22
**Applies to:**:heavy_check_mark: Linux VMs
22
23
23
24
[!INCLUDE [CentOS End Of Life](../../../includes/centos-end-of-life-note.md)]
24
25
25
-
The Linux filesystem table, fstab is a configuration table which is designed to configure rules where specific file systems are detected and mounted in an orderly manner during the system boot process.
26
-
This article discusses multiple conditions where a wrong fstab configuration can lead to boot issue and provides troubleshooting guidance.
26
+
The Linux filesystem table, fstab, is a configuration table that is designed to configure rules where specific file systems are detected and mounted in an orderly manner during the system boot process.
27
+
28
+
This article discusses multiple conditions where a wrong fstab configuration can lead to boot issues and provides troubleshooting guidance.
29
+
30
+
Here are some common reasons that can lead to virtual machine (VM) boot issues due to fstab misconfiguration:
27
31
28
-
Few common reasons that can lead to Virtual Machine Boot issues due to fstab misconfiguration are listed below:
29
32
* Traditional filesystem name is used instead of the Universally Unique Identifier (UUID) of the filesystem.
30
33
* An incorrect UUID is used.
31
-
* An entry exists for an unattached device without ```nofail``` option within fstab configuration.
32
-
* Incorrect entry within fstab configuration.
34
+
* An entry exists for an unattached device without the `nofail` option within the fstab configuration.
35
+
* Incorrect entry within the fstab configuration.
33
36
34
37
## Identify fstab issues
35
38
36
-
Check the current boot state of the VM in the serial log within the [Boot diagnostics](/azure/virtual-machines/boot-diagnostics#boot-diagnostics-view) blade in the Azure portal. The VM will be in an Emergency Mode. You see log entries that resemble the following example leading to the Emergency Mode state:
39
+
Check the current boot state of the VM in the serial log within the [Boot diagnostics](/azure/virtual-machines/boot-diagnostics#boot-diagnostics-view) blade in the Azure portal. The VM will be in an Emergency Mode. You see log entries that resemble the following example leading to the Emergency Mode state:
37
40
38
-
```
41
+
```output
39
42
[K[[1;31m TIME [0m] Timed out waiting for device dev-incorrect.device.
40
43
[[1;33mDEPEND[0m] Dependency failed for /data.
41
44
[[1;33mDEPEND[0m] Dependency failed for Local File Systems.
@@ -44,91 +47,86 @@ Welcome to emergency mode! After logging in, type "journalctl -xb" to viewsystem
44
47
Give root password for maintenance
45
48
(or type Control-D to continue)
46
49
```
50
+
47
51
>[!Note]
48
-
> "/data" is an example of mount point used. Dependency failure for filesystem mount point will differ based on the names used.
52
+
> `/data` is an example of mount point used. Dependency failure for filesystem mount point will differ based on the names used.
49
53
50
54
## Resolution
51
-
There are 2 ways to resolve the issue:
55
+
56
+
There are two ways to resolve the issue:
57
+
52
58
* Repair the VM online
53
-
*[Use the Serial Console](#use-the-serial-console)
54
-
* Repair the vm offline
59
+
*[Use the serial console](#use-the-serial-console)
60
+
* Repair the VM offline
55
61
*[Use Azure Linux Auto Repair (ALAR)](#use-azure-linux-auto-repair-alar)
56
-
*[Use Manual Method](#use-manual-method)
62
+
*[Use the manual method](#use-the-manual-method)
63
+
64
+
### Repair the VM online
57
65
58
-
### Repair the VM Online
59
66
#### Use the serial console
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.
67
+
68
+
1. Connect to [the serial console](./serial-console-linux.md) of the VM from the Azure portal.
69
+
2. Manual access to single-user mode is required to reconfigure fstab. The steps can vary based on the type of Linux OS used and access to the root account. Follow the [single-user mode](serial-console-grub-single-user-mode.md) documentation to access single-user mode for each supported Linux partner image.
62
70
63
71
##### Fstab troubleshooting steps
64
-
1. Once the vm has booted into single user mode. Use your favorite text editor to open the fstab file.
65
72
66
-
```
73
+
1. Once the VM has booted into single-user mode. Use your favorite text editor to open the fstab file.
74
+
75
+
```bash
67
76
vi /etc/fstab
68
77
```
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:
70
78
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:
79
+
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. A few points to consider to correctly administer a fstab file are as follows:
80
+
81
+
* 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.
82
+
* 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 the UUID entry in the fstab file:
73
83
74
84
```bash
75
85
UUID=<UUID number here> /data xfs defaults,nofail 0 0
76
86
```
87
+
77
88
* Use the `nofail` option in the filesystem entries (data disks) to enable startup to continue even after errors occur in partitions for the corresponding entries. The `nofail` option helps make sure that the VM starts even if the file system is corrupted or if it doesn't exist at startup.
78
89
79
90
5. Save the changes to the fstab file.
80
91
81
92
6. Use `mount -a` as a best practice after making changes to the fstab entries. This will rerun the fstab configuration and notify the users of any existing syntax or entry errors.
82
93
83
-
6. Once, the syntax and entries are verified, reboot the vm using the below command.
94
+
6. Once the syntax and entries are verified, reboot the VM using the following command:
84
95
85
-
```
96
+
```bash
86
97
reboot -f
87
98
```
88
99
7. If the entries comment or fix was successful, the system should reach a bash prompt in the portal. Check whether you can connect to the VM.
89
-
> [!Note]
90
-
> You can also use "ctrl+x" command which would also reboot the vm.
100
+
101
+
> [!Note]
102
+
> You can also use the `ctrl+x` command that will also reboot the VM.
91
103
92
104
### Repair the VM offline
93
105
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:
106
+
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
107
96
108
#### Use Azure Linux Auto Repair (ALAR)
97
109
98
-
Azure Linux Auto Repair (ALAR) scripts is a part of VM repair extension described in [Repair a Linux VM by using the Azure Virtual Machine repair commands](./repair-linux-vm-using-azure-virtual-machine-repair-commands.md). ALAR covers automation of multiple repair scenarios including `/etc/fstab` issues.
99
-
100
-
The ALAR scripts use the repair extension `run` command and its `--run-id` option. The script-id for the automated recovery is: **linux-alar2**. Implement the following steps to automate fstab errors via offline ALAR approach:
110
+
Azure Linux Auto Repair (ALAR) scripts are part of the VM repair extension described in [Use Azure Linux Auto Repair (ALAR) to fix a Linux VM](./repair-linux-vm-using-alar.md). ALAR covers the automation of multiple repair scenarios, including `/etc/fstab` issues.
101
111
102
-
```azurecli-interactive
103
-
az vm repair create --verbose -g centos7 -n cent7 --repair-username rescue --repair-password 'password!234' --copy-disk-name repairdiskcopy
104
-
```
112
+
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:
105
113
106
114
```azurecli-interactive
107
-
az vm repair run --verbose -g centos7 -n cent7 --run-id linux-alar2 --parameters fstab --run-on-repair
108
-
```
109
-
110
-
```azurecli-interactive
111
-
az vm repair restore --verbose -g centos7 -n cent7
112
-
```
113
-
114
-
> [!Note]
115
-
>The resource group name "centos7, vm name "cent7", and --copy-disk-name "repairdiskcopy" are examples and the values need to change accordingly.
115
+
az vm repair repair-button --button-command fstab --verbose rgtest --name vmtest
116
+
```
116
117
117
-
>The fstab repair script will take a backup of the original file and strip off any lines in the /etc/fstab file which are not needed to boot a system. After successful start of the OS, edit the fstab again and correct any errors which didn’t allow a reboot of the system before.
118
+
> [!NOTE]
119
+
> - Replace the resource group name `rgtest` and VM name `vmtest` accordingly.
120
+
> - The repair VM script, in conjunction with the ALAR script, will temporarily create a resource group, a repair VM, and a copy of the affected VM's OS disk. It backs up the original **/etc/fstab** file and modifies it by removing or commenting out data file system entries that aren't required to boot the system.
121
+
> - After the OS starts successfully, review and edit the **/etc/fstab** file to fix any errors that might have prevented a proper reboot. Finally, the `repair-button` script will automatically delete the resource group containing the repair VM.
118
122
119
-
Alternatively, once a repair vm is created, the changes can also be implemented by manually logging into the repair vm, mounting the attached copy of OS disk and making changes to its fstab file. Follow the steps here:
120
-
* Create a repair VM using the `az vm repair create` command.
121
-
* In order to mount and chroot to the filesystems of the attached OS disk in a rescue VM, follow the detailed [chroot instructions](./chroot-environment-linux.md).
122
-
* Next, follow the same [fstab troubleshooting steps](#fstab-troubleshooting-steps) as above.
123
-
* Once the changes are applied, `az vm repair restore` command can be used to perform automatic OS disk swap with the original VM.
123
+
#### Use the manual method
124
124
125
-
#### Use Manual Method
125
+
If both the serial console and ALAR approaches aren't possible or fail, 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:
126
126
127
-
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:
128
127
* [Attach the OS disk to a recovery VM using the Azure portal](./troubleshoot-recovery-disks-portal-linux.md)
129
-
* [Attach the OS disk to a recovery VM using Azure CLI](./troubleshoot-recovery-disks-linux.md)
130
-
131
-
Once the OS disk is successfully attached to the recovery VM, follow the detailed [chroot instructions](./chroot-environment-linux.md) to mount and chroot to the filesystems of the attached OS disk. Then, implement [fstab troubleshooting steps](#fstab-troubleshooting-steps) to make appropriate changes to the fstab file of the problematic OS disk.
128
+
* [Attach the OS disk to a recovery VM using the Azure CLI](./troubleshoot-recovery-disks-linux.md)
132
129
130
+
Once the OS disk is successfully attached to the recovery VM, follow the detailed [chroot instructions](./chroot-environment-linux.md) to mount and chroot to the filesystems of the attached OS disk. Then, implement the [fstab troubleshooting steps](#fstab-troubleshooting-steps) to make appropriate changes to the fstab file of the problematic OS disk.
133
131
134
132
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
Copy file name to clipboardExpand all lines: support/azure/virtual-machines/linux/linux-vm-no-boot-incorrect-hugepages-configuration.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -250,7 +250,7 @@ To fix the issue, follow these steps:
250
250
251
251
- [Repair the Linux VM using the Azure VM repair commands](repair-linux-vm-using-azure-virtual-machine-repair-commands.md).
252
252
253
-
- (Offline method) [Create a Rescue VM to fix VM boot issues manually](linux-virtual-machine-cannot-start-fstab-errors.md#use-manual-method).
253
+
- (Offline method) [Create a Rescue VM to fix VM boot issues manually](linux-virtual-machine-cannot-start-fstab-errors.md#use-the-manual-method).
254
254
255
255
2. If you use the Azure VM repair commands or the offline method in step 1, follow the chroot process introduced in [Chroot environment in a Linux rescue VM](chroot-environment-linux.md).
Copy file name to clipboardExpand all lines: support/entra/entra-id/app-integration/troubleshoot-wif10201-no-validkey-securitytoken-mvc.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,23 +1,23 @@
1
1
---
2
2
title: ASP.NET MVC Application Error WIF10201 No Valid Key Mapping Found for SecurityToken
3
-
description: This article provides guidance for troubleshooting the error, "WIF10201- No valid key mapping found for securityToken."
3
+
description: This article provides guidance for troubleshooting the error, WIF10201- No valid key mapping found for securityToken.
4
4
author: genlin
5
5
ms.author: bachoang
6
6
ms.service: entra-id
7
-
ms.topic: troubleshooting-general
7
+
ms.topic: troubleshooting-problem-resolution
8
8
ms.date: 02/05/2025
9
9
ms.custom: sap:Issues Signing In to Applications
10
10
---
11
11
12
-
# "WIF10201: No valid key mapping found for securityToken" error in ASP.NET application
12
+
# WIF10201: No valid key mapping found for securityToken error in ASP.NET application
13
13
14
14
This article provides guidance for troubleshooting an authentication issue that occurs in an ASP.NET MVC application that uses both [WS-Federation](https://github.com/Azure-Samples/active-directory-dotnet-webapp-wsfederation) OWIN middleware and [Windows Identity Foundation](../../../windows-server/user-profiles-and-logon/windows-identity-foundation.md) (WIF) to authenticate to Microsoft Entra ID.
15
15
16
16
## Symptoms
17
17
18
18
The ASP.NET MVC application that was previously working generates the following error message although no changes were made to the application:
19
19
20
-
```
20
+
```output
21
21
Error Details:
22
22
Server Error in '/' Application.
23
23
WIF10201: No valid key mapping found for securityToken: 'System.IdentityModel.Tokens.X509SecurityToken' and issuer: 'https://sts.windows.net/<Directory ID>/'.
To validate the signature of the token that's returned by the Entra ID after a successful sign-in, WIF uses the certificate thumbprints that are in the Web.config file, as shown in the following example:
32
+
To validate the signature of the token that's returned by the Entra ID after a successful sign-in, WIF uses the certificate thumbprints that are in the **Web.config** file, as shown in the following example:
The "WIF10201" error occurs if none of these certificate thumbprints match the one that's used by Entra ID to sign the token.
51
51
52
-
The Entra ID uses a [signing key rollover mechanism](/entra/identity-platform/signing-key-rollover) to update the certificate that's used to sign authentication tokens periodically. This key rollover causes the initial certificate thumbprints that are configured in the Web.config file to become invalid.
52
+
The Entra ID uses a [signing key rollover mechanism](/entra/identity-platform/signing-key-rollover) to update the certificate that's used to sign authentication tokens periodically. This key rollover causes the initial certificate thumbprints that are configured in the **Web.config** file to become invalid.
53
53
54
54
## Solution
55
55
56
-
You can either manually update the certificate thumbprints that are in the Web.config file or automate the process through code. For more information, see [Best practices for keys metadata caching and validation](/entra/identity-platform/signing-key-rollover#best-practices-for-keys-metadata-caching-and-validation).
56
+
You can either manually update the certificate thumbprints that are in the **Web.config** file or automate the process through code. For more information, see [Best practices for keys metadata caching and validation](/entra/identity-platform/signing-key-rollover#best-practices-for-keys-metadata-caching-and-validation).
Copy file name to clipboardExpand all lines: support/power-platform/dataverse/email-exchange-synchronization/troubleshooting-monitoring-server-side-synchronization.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,12 +2,11 @@
2
2
title: Troubleshooting and monitoring server-side synchronization
3
3
description: Troubleshooting and monitoring server-side synchronization
4
4
ms.component: pa-admin
5
-
ms.topic: conceptual
6
-
ms.date: 01/16/2025
5
+
ms.date: 02/20/2025
7
6
author: rahulmital
8
-
ms.subservice: admin
9
7
ms.author: rahulmital
10
-
ms.reviewer: sericks
8
+
ms.reviewer: rahulmital
9
+
ms.custom: sap:Microsoft Dataverse\Email and Exchange Synchronization
Copy file name to clipboardExpand all lines: support/power-platform/dataverse/environment-app-access/troubleshoot-missing-environments.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,12 +2,11 @@
2
2
title: Troubleshoot missing environments
3
3
description: "Learn how to update a record's owner, an Owning Business Unit, or both an Owner and Owning Business Unit because the record changes ownership."
4
4
ms.component: pa-admin
5
-
ms.topic: conceptual
6
-
ms.date: 12/03/2024
7
-
ms.subservice: admin
5
+
ms.date: 02/20/2025
6
+
ms.custom: sap:Microsoft Dataverse\Environment and app access issues
0 commit comments