Skip to content

Commit e66fb25

Browse files
Merge pull request #10148 from MicrosoftDocs/main
Auto Publish – main to live - 2025-11-07 22:00 UTC
2 parents 894f940 + d729b18 commit e66fb25

25 files changed

+1115
-289
lines changed
Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
title: Troubleshooting Tool for Linux Guest Agent - VM assist
3+
description: Provides script-based tool to help diagnose and resolve Azure Guest Agent issues on Azure virtual machines running Linux.
4+
author: JarrettRenshaw
5+
ms.author: jarrettr
6+
manager: dcscontentpm
7+
ms.date: 10/24/2025
8+
ms.reviewer: v-jsitser, scotro, v-ryanberg
9+
ms.service: azure-virtual-machines
10+
ms.custom: sap:zzzz
11+
---
12+
# Troubleshooting Tool for Linux Guest Agent - VM assist
13+
14+
**Applies to:** :heavy_check_mark: Linux VMs
15+
16+
## Overview
17+
18+
The Microsoft Azure Linux VM Agent is a secure, lightweight process that manages virtual machine (VM) interaction with the Azure fabric controller. The Azure Linux VM Agent has a primary role in enabling and running Azure VM extensions. VM extensions enable post-deployment configuration of VMs, such as installing and configuring software. VM extensions also enable recovery features, such as resetting the administrative password of a VM. Without the Azure Linux VM Agent, you can't run VM extensions.
19+
20+
## Purpose
21+
The Linux version of VM assist is composed of bash and Python scripts that are used to detect potential issues that affect the guest agent in a Linux VM. It also examines other issues that are related to the general health of the VM. Output is intended to be viewed in the serial console. It provides pointers to solve well-known issues and certain deviations from best practice that can affect VM availability. The intention is for engineers to provide this script to customers through GitHub. However, it's possible and acceptable that a customer uses the script on their own and provides data through a service request.
22+
23+
Because the output of this script is designed to be viewed in a worst-case scenario of the Azure serial console, the information that's displayed is minimal and condensed. Details are provided through online resources that are accessed through a link that's provided in the output. See [VM assist for Linux](https://aka.ms/vmassistlinux).
24+
25+
VM assist is delivered in two functional scripts (one in bash and one in python3) plus an optional 'downloader' script.
26+
27+
The bash script performs some basic checks and determines whether running the Python script is possible or necessary.
28+
29+
## Key features
30+
31+
### Bash checks
32+
33+
The following checks are run in bash today:
34+
35+
- OS family detection
36+
- Identify the Guest Agent service
37+
- Identify the path of Python called from the service - this will be used for running the Python script
38+
- Display the package and package repository for the agent and the Python called from the agent
39+
- Basic connectivity checks to the wire server and IMDS
40+
41+
> If the bash script finds a python2 system the script will exit and display the information it has gathered.
42+
43+
### Python analysis
44+
45+
If no issues are discovered during the base checks by using bash, the Python script is called to perform a deeper analysis that includes the following tasks:
46+
47+
- Find the source (package) for the guest agent executable and the Python passed from bash
48+
- Optionally check any service or package statuses (this is currently a proof-of-concept inside the script)
49+
- Only SSH is checked for the PoC
50+
- Provide source information for all checked files and services
51+
- Do configuration checks for the Guest Agent
52+
- Connectivity checks for requirements of the guest agent
53+
- Basic system configuration and status checks (#Guest best practices)
54+
55+
## Prerequisites
56+
57+
- The VM must start to the full OS (not emergency or maintenance mode).
58+
- Root-level access must be available through either sudo or direct login/sudo -i
59+
60+
## How to run the tool
61+
62+
The VM assist scripting is run initially from the documentation. Subsequently, you can run the bash script directly: `vmassist.sh` as root or by using `sudo`.
63+
64+
If you open a support request, please include both of these files to aid the support agent who assists you.
65+
66+
## Known issues
67+
- Don't try to run VM assist on appliances. Appliances don't run on general purpose operating systems, and the guest agent might not run at all.
68+
- Distributions outside PAYG versions of RedHat or SUSE, or any Ubuntu or Mariner or Azure Linux, might display false positive warnings about repository names. This situation requires a more careful reading because even official repositories might not match strict pattern matching. This condition is true because we don't build cases for all distributions.
69+
- Ubuntu 24.04 has a different architecture of the SSH service. It might flag the service even if the service is operating well.
70+
71+
[!INCLUDE [azure-help-support](~/includes/azure-help-support.md)]
72+
73+
[!INCLUDE [Third-party contact disclaimer](~/includes/third-party-contact-disclaimer.md)]

support/azure/virtual-machines/linux/toc.yml

Lines changed: 83 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -18,64 +18,64 @@ items:
1818
- name: Microsoft Azure PaaS VM logs
1919
href: ../windows/sdp352ef8720-e3ee-4a12-a37e-cc3b0870f359-windows-vm.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
2020

21-
- name: Support statements
21+
- name: Azure VM support statements
2222
items:
2323
- name: Support for Linux and open-source technology in Azure
2424
href: support-linux-open-source-technology.md
2525
- name: Upgrade VMs running Canonical Ubuntu 18.04 LTS
2626
href: upgrade-canonical-ubuntu-18dot04-lts.md
27-
- name: Windows Server 2003 Server Support on Azure
28-
items:
29-
- name: Citrix services support policy
30-
href: ../windows/support-policy-citrix-services.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
3127

32-
- name: VM health
28+
- name: Increase Quota Limits
29+
items:
30+
- name: Increase VM series vCPU limit
31+
href: /azure/azure-portal/supportability/per-vm-quota-requests?context=/troubleshoot/azure/virtual-machines/linux/context/context
32+
- name: Increase total regional vCPU limit
33+
href: /azure/azure-portal/supportability/regional-quota-requests?context=/troubleshoot/azure/virtual-machines/linux/context/context
34+
- name: Increase spot quota limit
35+
href: /azure/azure-portal/supportability/low-priority-quota?context=/troubleshoot/azure/virtual-machines/linux/context/context
36+
- name: Increase networking limits
37+
href: /azure/azure-portal/supportability/networking-quota-requests?context=/troubleshoot/azure/virtual-machines/linux/context/context
38+
39+
- name: Determining VM health
3340
items:
3441
- name: HealthResources table in Resource Graph has missing entries
3542
href: ../windows/healthresources-table-resource-graph-missing-entries.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
3643
- name: VM availability might be inaccurate during restart
3744
href: ../windows/inaccurate-vm-availability-during-vm-restart.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
38-
39-
- name: Increase quota limits
40-
items:
41-
- name: Increase compute vCPU limits (Quota)
42-
items:
43-
- name: Increase VM series vCPU limit
44-
href: /azure/azure-portal/supportability/per-vm-quota-requests?context=/troubleshoot/azure/virtual-machines/linux/context/context
45-
- name: Increase total regional vCPU limit
46-
href: /azure/azure-portal/supportability/regional-quota-requests?context=/troubleshoot/azure/virtual-machines/linux/context/context
47-
- name: Increase spot quota limit
48-
href: /azure/azure-portal/supportability/low-priority-quota?context=/troubleshoot/azure/virtual-machines/linux/context/context
49-
- name: Networking quota increases
50-
items:
51-
- name: Increase networking limits
52-
href: /azure/azure-portal/supportability/networking-quota-requests?context=/troubleshoot/azure/virtual-machines/linux/context/context
45+
- name: VM stuck in failed state
46+
href: ../windows/vm-stuck-in-failed-state.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
47+
- name: VM is unavailable for 15 minutes
48+
href: ../windows/azure-vm-unavailable.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
5349

5450
- name: Cannot connect to my VM
5551
items:
56-
- name: Basic SSH troubleshooting
57-
href: troubleshoot-ssh-connection.md
58-
- name: Detailed SSH troubleshooting
59-
href: detailed-troubleshoot-ssh-connection.md
60-
- name: Network issues
61-
href: cannot-connect-linux-network.md
62-
- name: How to reset a local Linux password on Azure VMs
63-
href: reset-password.md
64-
- name: Reset network interface for Azure Linux VM
65-
href: reset-network-interface-azure-linux-vm.md
66-
- name: SSH connection fails due to permission and ownership issues
67-
href: linux-vm-sshconnectionissue-perms.md
68-
- name: Fail to connect to VM through SSH due to SELinux misconfiguration
69-
href: linux-selinux-troubleshooting.md
70-
- name: Debian Linux VM
71-
href: cannot-connect-debian-linux.md
72-
- name: Troubleshoot connectivity issues with UFW in Ubuntu
73-
href: ubuntu-ufw-guide.md
74-
- name: Troubleshoot "permissions are too open" error
75-
href: troubleshoot-ssh-permissions-too-open.md
76-
- name: Application access issues
77-
href: ../windows/troubleshoot-app-connection.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
78-
52+
- name: Common troubleshooting support
53+
items:
54+
- name: Basic SSH troubleshooting
55+
href: troubleshoot-ssh-connection.md
56+
- name: Detailed SSH troubleshooting
57+
href: detailed-troubleshoot-ssh-connection.md
58+
- name: Reset a local Linux password
59+
href: reset-password.md
60+
- name: Reset network interface
61+
href: reset-network-interface-azure-linux-vm.md
62+
- name: Advanced troubleshooting support
63+
items:
64+
- name: Network issues
65+
href: cannot-connect-linux-network.md
66+
- name: SSH connection fails due to permission and ownership issues
67+
href: linux-vm-sshconnectionissue-perms.md
68+
- name: Fail to connect to VM through SSH due to SELinux misconfiguration
69+
href: linux-selinux-troubleshooting.md
70+
- name: Debian Linux VM
71+
href: cannot-connect-debian-linux.md
72+
- name: Troubleshoot connectivity issues with UFW in Ubuntu
73+
href: ubuntu-ufw-guide.md
74+
- name: Troubleshoot "permissions are too open" error
75+
href: troubleshoot-ssh-permissions-too-open.md
76+
- name: Application access issues
77+
href: ../windows/troubleshoot-app-connection.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
78+
7979
- name: VM password reset
8080
items:
8181
- name: Reset a local Linux password on Azure VMs
@@ -118,11 +118,6 @@ items:
118118
- name: Troubleshoot Linux Memory performance issues
119119
href: troubleshoot-performance-memory-linux.md
120120

121-
- name: Windows Update and OS Updates
122-
items:
123-
- name: Upgrade VM to contain more than 64 vCPUs
124-
href: ../windows/vm-cannot-upgrade-64-vcpu.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
125-
126121
- name: Kernel issues
127122
items:
128123
- name: Can't restart after applying kernel changes
@@ -380,40 +375,50 @@ items:
380375
- name: Redeploy Linux virtual machine to new Azure node
381376
href: redeploy-to-new-node-linux.md
382377

383-
- name: VM Extensions not operating correctly
378+
- name: Linux VM Agent
384379
items:
385-
- name: Linux VM Agent
386-
items:
387-
- name: Azure Linux VM Agent overview
380+
- name: Overview
388381
href: /azure/virtual-machines/extensions/agent-linux?context=/troubleshoot/azure/virtual-machines/linux/context/context
389-
- name: Minimum version support for agents
382+
- name: Minimum version required
390383
href: ../windows/support-extensions-agent-version.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
391-
- name: Troubleshoot Linux VM agent
384+
- name: How to troubleshoot
392385
href: linux-azure-guest-agent.md
393-
- name: Extension status isn't reported
394-
href: linux-vm-extension-status-not-reported.md
395-
- name: Linux VM extensions stop running
396-
href: extensions-stop-running.md
397-
- name: Multiple certificates on IaaS VM that uses extensions
386+
- name: Troubleshooting tools (VM assist)
387+
href: linux-azure-guest-agent-tools-vmassist.md
388+
- name: Troubleshoot multiple certificates issues
398389
href: ../windows/multiple-certificates-iaas-vm-extensions.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
399-
- name: The host keys of Linux VM are written to ec2
400-
href: cloud-init-writes-vm-host-keys-as-ec2.md
401-
- name: Update awareness for Linux Image Provisioning Agent
402-
href: linux-image-provisioning-agent-update-awareness.md
403-
- name: Can't process extensions
404-
href: linux-agent-cannot-process-extensions.md
390+
- name: Troubleshoot extension certificate issues
391+
href: ../windows/troubleshoot-extension-certificates-issues-windows-vm.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
392+
393+
- name: VM Extensions
394+
items:
395+
- name: Overview
396+
href: /azure/virtual-machines/extensions/overview?context=/troubleshoot/azure/virtual-machines/windows/context/context
405397
- name: Supported operating systems
406-
href: ../windows/extension-supported-os.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
407-
- name: Removing Extensions NetApp CVO Image
408-
href: ../linux/removing-extensions-netapp-cvo.md
409-
- name: Cloud-init
410-
items:
411-
- name: Azure cloud-init support for Linux VMs
412-
href: cloud-init-support-linux-vms.md
413-
- name: General issues
414-
items:
415-
- name: Issues with Python 3-enabled Linux systems
416-
href: /azure/virtual-machines/extensions/issues-using-vm-extensions-python-3?context=/troubleshoot/azure/virtual-machines/linux/context/context
398+
href: ../windows/extension-supported-os.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
399+
- name: Supported extensions
400+
href: ../windows/support-agent-extensions.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
401+
- name: Troubleshoot extension issues
402+
href: /azure/virtual-machines/extensions/troubleshoot?context=/troubleshoot/azure/virtual-machines/windows/context/context
403+
- name: Common issues
404+
items:
405+
- name: Extension status isn't reported
406+
href: linux-vm-extension-status-not-reported.md
407+
- name: Linux VM extensions stop running
408+
href: extensions-stop-running.md
409+
- name: The host keys of Linux VM are written to ec2
410+
href: cloud-init-writes-vm-host-keys-as-ec2.md
411+
- name: Update awareness for Linux Image Provisioning Agent
412+
href: linux-image-provisioning-agent-update-awareness.md
413+
- name: Can't process extensions
414+
href: linux-agent-cannot-process-extensions.md
415+
- name: Removing Extensions NetApp CVO Image
416+
href: ../linux/removing-extensions-netapp-cvo.md
417+
- name: Issues with Python 3-enabled Linux systems
418+
href: /azure/virtual-machines/extensions/issues-using-vm-extensions-python-3?context=/troubleshoot/azure/virtual-machines/linux/context/context
419+
420+
- name: Azure cloud-init support for Linux VMs
421+
href: cloud-init-support-linux-vms.md
417422

418423
- name: Custom script extensions (CSE) for Linux
419424
items:
@@ -454,7 +459,4 @@ items:
454459
href: ../windows/failed-get-contents-log-error.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
455460
- name: GPU is disabled
456461
href: gpu-disabled-upgrade-ubuntu.md
457-
- name: VM stuck in failed state
458-
href: ../windows/vm-stuck-in-failed-state.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
459-
- name: VM is unavailable for 15 minutes
460-
href: ../windows/azure-vm-unavailable.md?context=/troubleshoot/azure/virtual-machines/linux/context/context
462+
Loading
57.9 KB
Loading
69.2 KB
Loading
69.2 KB
Loading
58.9 KB
Loading
Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: 'Windows Server 2003 End of Support (EOS) FAQ'
3+
description: Provides information about Windows Server 2003 End of Support (EOS) FAQ.
4+
ms.date: 08/26/2025
5+
ms.reviewer: v-liuamson
6+
ms.service: azure-virtual-machines
7+
ms.collection: windows
8+
ms.custom: sap:VM Admin - Windows (Guest OS)
9+
---
10+
# Windows Server 2003 End of Support (EOS) FAQ
11+
12+
**Applies to:** :heavy_check_mark: Windows VMs
13+
14+
_Original KB number:_   4010166
15+
16+
## Microsoft Windows Server 2003 End of Support (EOS)
17+
18+
Microsoft ended extended support for Windows Server 2003 on July 14, 2015. If you are running Windows Server 2003, this may put your applications and business at risk, since there may be no security or software updates. You can still move a Windows Server 2003 VM to Azure and receive assistance in troubleshooting issues that concern running Windows Server 2003 on Azure. However, this support is limited to issues that don't require OS-level troubleshooting or patch.
19+
20+
## Frequently asked questions
21+
22+
> [!NOTE]
23+
>The information provided in this section is specific to Windows Server 2003.
24+
25+
**When does extended support for Windows Server 2003 end?**
26+
27+
Windows Server 2003 extended support ended on July 14, 2015.
28+
29+
**Can I run existing Windows Server 2003 instances after the end of extended support?**
30+
31+
Yes.
32+
33+
**Can I create a new VM from the custom Windows Server 2003 image after the end of extended support?**
34+
35+
Yes. You can create a Windows Server 2003 Azure VM from specialized VHD only, not from generalized (Syspreped) VHD.
36+
37+
**Can I create a new Windows Server 2003 VM from the Azure Marketplace?**
38+
39+
For versions that are earlier than Windows Server 2008 R2, there is no Azure Marketplace support. you must provide your own specialized operating system VHD for new Windows Server 2003 VMs.
40+
41+
**Will Microsoft Azure support Windows Server 2003 after July 14, 2015?**
42+
43+
The Azure support team continues to offer assistance in troubleshooting issues that concern running Windows Server 2003 on Azure. However, this support is limited to issues that don't require OS-level troubleshooting or patches.
44+
45+
**Can I build custom images that contain updates provided by Microsoft through a custom support agreement?**
46+
47+
Yes. You can create and upload [specialized VHD](/azure/virtual-machines/windows/create-vm-specialized-portal)  only for your own use, including situations in which those images contain updates resulting from a custom support agreement.
48+
49+
**Will I be able to import new Windows Server 2003 virtual machines after the end of extended support?**
50+
51+
Yes.
52+
53+
**How can I migrate specifically the apps from Windows Server 2003?**
54+
55+
See [Migrate an enterprise web app to Azure App Service](https://azure.microsoft.com/migration/web-applications/).
56+
57+
**If I run Microsoft applications such as SQL Server 2005 on Windows Server 2003, will it be supported after the end of extended support?**
58+
59+
Yes. The applications running on Windows Server are supported based on their [lifecycle](https://support.microsoft.com/lifecycle). However, if the application issue requires OS-level troubleshooting or patches, Azure support may not be able to fully resolve the issue.
60+
61+
**Does Microsoft support in-place OS upgrades for my Windows Server 2003 instances?**
62+
No.
63+
64+
**Do I need to bring my own Windows Server 2003 license to Azure?**
65+
66+
Yes, you will need your own Windows Server 2003 license, and it must be valid. For more information, see [Prioritize Your Windows Server 2003 Migration Plans](https://azure.microsoft.com//blog/be-prepared-for-tomorrows-business-prioritize-your-windows-server-2003-migration-plans/).
67+
68+
**Does the Azure VM agent and extensions work in Windows Server 2003?**
69+
70+
No. The Azure VM agent and extensions do not support Windows Server 2003.
71+
72+
**What is the maximum number of virtual processors that Windows Serve 2003 Azure VM can support?**
73+
74+
The maximum supported VM size is two virtual processors. 64-bit OS has been reported to work with a larger number, but this configuration is not officially supported due to limited testing.
75+
76+
**Is 32-bit version of Windows Server 2003 supported on Azure?**
77+
78+
A: Windows Server 2003 32-bit has the same level of support as 64-bit, but both operating systems are past their end of support date. Microsoft does not support operating systems that are past their [End of Support date](https://support.microsoft.com/lifecycle/search) without a Custom Support Agreement (CSA). However, the Azure infrastructure is supported. See [Microsoft server software support for Microsoft Azure virtual machines](https://support.microsoft.com/help/2721672/microsoft-server-software-support-for-microsoft-azure-virtual-machines) for more information.
79+
80+
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

0 commit comments

Comments
 (0)