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-vm-no-boot-incorrect-hugepages-configuration.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,7 +1,7 @@
1
1
---
2
2
title: Linux VM doesn't boot due to incorrect HugePages configuration
3
3
description: Provides a solution to Azure Linux VM boot issues due to incorrect HugePages configuration.
4
-
ms.date: 12/23/2024
4
+
ms.date: 1/7/2024
5
5
ms.reviewer: msaenzbo, v-weizhu
6
6
ms.service: azure-virtual-machines
7
7
ms.custom: sap:My VM is not booting, linux-related-content
@@ -19,7 +19,7 @@ Incorrect HugePages configuration can cause boot issues in Linux Virtual Machine
19
19
20
20
## Symptoms
21
21
22
-
The following issues can occurs due to incorrect HugePages configuration:
22
+
The following issues can occur due to incorrect HugePages configuration:
23
23
24
24
- After you migrate a Linux VM from on-premises to Azure, the VM doesn't boot properly.
25
25
@@ -34,7 +34,7 @@ When you review the serial console logs for various Linux VMs (Red Hat, Oracle,
34
34
- Dependency failures for local file systems and emergency mode.
35
35
- Out of memory errors caused by the systemd-udevd service or other processes.
36
36
- Failed to start various network and system services.
37
-
- System hangs at login or boot.
37
+
- System hung at login or boot.
38
38
39
39
Here are some log examples:
40
40
@@ -235,22 +235,22 @@ Here are some log examples:
235
235
236
236
This issue occurs because all available memory is reserved for HugePages, leaving insufficient free memory for the server to boot and execute processes.
237
237
238
-
For example, if the HugePages configuration parameter `vm.nr_hugepages` is set to 65536 in the **/etc/sysctl.conf** file while the VM has only 16 GB of total memory, this configuration would consume 134,217,728 KB of memory, which exceeds VM memory, leading to an Out of Memory (OOM) condition.
238
+
For example, if the HugePages configuration parameter `vm.nr_hugepages` is set to 65536 in the **/etc/sysctl.conf** file while the VM has only 16 GB of total memory, this configuration consumes 134,217,728 KB of memory, which exceeds VM memory, leading to an Out of Memory (OOM) condition.
239
239
240
240
## Resolution
241
241
242
242
> [!IMPORTANT]
243
-
> Review how much memory the VM has and How much HugePages are setup. Under some scenarios, for example, if the system needs 16 GB for HugePages and the VM only has 16 GB of RAM, it runs out of memory causing the VM not to boot. In this case, we recommend upgrading the VM size to at least 32 GB of RAM. For more information about how much HugePages a VM and database needs, see [Oracle Community](https://community.oracle.com/mosc/discussion/4516170/huge-pages).
243
+
> Review how much memory the VM has and how much HugePages are set up. Under some scenarios, for example, if the system needs 16 GB for HugePages and the VM only has 16 GB of RAM, it runs out of memory causing the VM not to boot. In this case, we recommend upgrading the VM size to at least 32 GB of RAM. For more information about how much HugePages a VM and database needs, see [Oracle Community](https://community.oracle.com/mosc/discussion/4516170/huge-pages).
244
244
245
245
To fix the issue, follow these steps:
246
246
247
247
1. Access the VM using one of the following methods:
248
248
249
249
- [Boot the VM in single-user mode using the Azure Serial Console](serial-console-grub-single-user-mode.md) if the serial console is working.
250
250
251
-
- [Repair the Linux VM using the Azure VM repair commands](repair-linux-vm-using-azure-virtual-machine-repair-commands.md)
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-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).
0 commit comments