Skip to content

Commit 9663ac3

Browse files
authored
Merge pull request #8262 from MicrosoftDocs/main
Sync to live
2 parents 5be264c + 78f401f commit 9663ac3

File tree

39 files changed

+106
-143
lines changed

39 files changed

+106
-143
lines changed
Lines changed: 52 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
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.
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.
44
services: virtual-machines
55
documentationcenter: ''
66
author: saimsh-msft
@@ -13,29 +13,32 @@ ms.topic: troubleshooting
1313
ms.workload: infrastructure-services
1414
ms.tgt_pltfrm: vm-linux
1515
ms.devlang: azurecli
16-
ms.date: 04/15/2024
16+
ms.date: 02/19/2025
1717
ms.author: saimsh
1818
---
19+
1920
# Troubleshoot Linux VM boot issues due to fstab errors
2021

2122
**Applies to:** :heavy_check_mark: Linux VMs
2223

2324
[!INCLUDE [CentOS End Of Life](../../../includes/centos-end-of-life-note.md)]
2425

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:
2731

28-
Few common reasons that can lead to Virtual Machine Boot issues due to fstab misconfiguration are listed below:
2932
* Traditional filesystem name is used instead of the Universally Unique Identifier (UUID) of the filesystem.
3033
* 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.
3336

3437
## Identify fstab issues
3538

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:
3740

38-
```
41+
```output
3942
[K[[1;31m TIME [0m] Timed out waiting for device dev-incorrect.device.
4043
[[1;33mDEPEND[0m] Dependency failed for /data.
4144
[[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
4447
Give root password for maintenance
4548
(or type Control-D to continue)
4649
```
50+
4751
>[!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.
4953
5054
## Resolution
51-
There are 2 ways to resolve the issue:
55+
56+
There are two ways to resolve the issue:
57+
5258
* 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
5561
* [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
5765

58-
### Repair the VM Online
5966
#### 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.
6270

6371
##### Fstab troubleshooting steps
64-
1. Once the vm has booted into single user mode. Use your favorite text editor to open the fstab file.
6572

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
6776
vi /etc/fstab
6877
```
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:
7078

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:
7383

7484
```bash
7585
UUID=<UUID number here> /data xfs defaults,nofail 0 0
7686
```
87+
7788
* 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.
7889
7990
5. Save the changes to the fstab file.
8091
8192
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.
8293
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:
8495
85-
```
96+
```bash
8697
reboot -f
8798
```
8899
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.
91103
92104
### Repair the VM offline
93105
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:
95107

96108
#### Use Azure Linux Auto Repair (ALAR)
97109

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.
101111

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:
105113

106114
```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+
```
116117

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.
118122

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
124124

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:
126126
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:
128127
* [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)
132129
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.
133131
134132
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/virtual-machines/linux/linux-vm-no-boot-incorrect-hugepages-configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -250,7 +250,7 @@ To fix the issue, follow these steps:
250250
251251
- [Repair the Linux VM using the Azure VM repair commands](repair-linux-vm-using-azure-virtual-machine-repair-commands.md).
252252
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).
254254
255255
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).
256256

support/entra/entra-id/app-integration/troubleshoot-wif10201-no-validkey-securitytoken-mvc.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
---
22
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.
44
author: genlin
55
ms.author: bachoang
66
ms.service: entra-id
7-
ms.topic: troubleshooting-general
7+
ms.topic: troubleshooting-problem-resolution
88
ms.date: 02/05/2025
99
ms.custom: sap:Issues Signing In to Applications
1010
---
1111

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
1313

1414
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.
1515

1616
## Symptoms
1717

1818
The ASP.NET MVC application that was previously working generates the following error message although no changes were made to the application:
1919

20-
```
20+
```output
2121
Error Details:
2222
Server Error in '/' Application.
2323
WIF10201: No valid key mapping found for securityToken: 'System.IdentityModel.Tokens.X509SecurityToken' and issuer: 'https://sts.windows.net/<Directory ID>/'.
@@ -29,7 +29,7 @@ Exception Details: System.IdentityModel.Tokens.SecurityTokenValidationException:
2929

3030
## Cause
3131

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:
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:
3333

3434
```web.config
3535
<issuerNameRegistry type="System.IdentityModel.Tokens.ValidatingIssuerNameRegistry,
@@ -49,8 +49,8 @@ System.IdentityModel.Tokens.ValidatingIssuerNameRegistry">
4949

5050
The "WIF10201" error occurs if none of these certificate thumbprints match the one that's used by Entra ID to sign the token.
5151

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.
5353

5454
## Solution
5555

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).

support/power-platform/dataverse/auditing/setup-auditlog-troubleshooting.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,15 @@ title: Troubleshooting sync problems in audit logs
33
description: Provides common causes for sync issues to help troubleshooting.
44
author: pete-msft
55
ms.component: pa-admin
6-
ms.topic: conceptual
7-
ms.date: 10/03/2024
8-
ms.subservice: guidance-toolkit
6+
ms.date: 02/20/2025
97
ms.author: petrip
10-
ms.reviewer: sericks
8+
ms.reviewer: paulliew
9+
ms.custom: sap:Microsoft Dataverse\Auditing
1110
search.audienceType:
1211
- admin
1312
contributors:
1413
- Grant-Archibald-MS
15-
1614
---
17-
1815
# Troubleshooting sync problems in audit logs
1916

2017
## API permissions

support/power-platform/dataverse/data-integration/data-integrator-error-management.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
11
---
22
title: "Error management and troubleshooting for data integration projects"
33
description: "Troubleshoot issues and manage errors when executing data integration projects using the Data Integrator service."
4-
ms.topic: conceptual
54
ms.component: pa-admin
6-
ms.date: 11/19/2021
5+
ms.date: 02/20/2025
76
author: NHelgren
8-
ms.subservice: admin
97
ms.author: nhelgren
10-
ms.reviewer: sericks
8+
ms.reviewer: nhelgren
9+
ms.custom: sap:Microsoft Dataverse\Microsoft Dataverse miscellaneous
1110
search.audienceType:
1211
- admin
1312
---

support/power-platform/dataverse/email-exchange-synchronization/troubleshooting-monitoring-server-side-synchronization.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,11 @@
22
title: Troubleshooting and monitoring server-side synchronization
33
description: Troubleshooting and monitoring server-side synchronization
44
ms.component: pa-admin
5-
ms.topic: conceptual
6-
ms.date: 01/16/2025
5+
ms.date: 02/20/2025
76
author: rahulmital
8-
ms.subservice: admin
97
ms.author: rahulmital
10-
ms.reviewer: sericks
8+
ms.reviewer: rahulmital
9+
ms.custom: sap:Microsoft Dataverse\Email and Exchange Synchronization
1110
search.audienceType:
1211
- admin
1312
---

support/power-platform/dataverse/environment-app-access/troubleshoot-missing-environments.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,11 @@
22
title: Troubleshoot missing environments
33
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."
44
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
87
author: davidme-ms
98
ms.author: davidme
10-
ms.reviewer: sericks
9+
ms.reviewer: iyanni
1110
search.audienceType:
1211
- admin
1312
contributors:

0 commit comments

Comments
 (0)