Skip to content

Commit 055df0c

Browse files
Merge pull request #10161 from ScottAzure/new-tools
AB#8287: add new tools to help customers
2 parents 98a722e + d87c0dc commit 055df0c

File tree

47 files changed

+523
-290
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

47 files changed

+523
-290
lines changed

support/azure/virtual-machines/linux/extensions-stop-running.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ ms.collection: linux
1313

1414
_Original KB number:_   4099558
1515

16-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
16+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
1717

1818
## Symptoms
1919

20-
The Linux VM Agent fails to process extensions. This causes some extensions to stop running, which affects some dependent Azure services, such as Azure Backup Azure Site Recovery.
20+
The Linux VM Agent doesn't process extensions. Because of this failure, some extensions stop running. This issue affects some dependent Azure services, such as Azure Backup Azure Site Recovery.
2121

22-
You will see extension downgrade errors similar to this recorded in /var/log/waagent.log:
22+
When this issue occurs, you see extension downgrade error entries in /var/log/waagent.log that resemble the following example:
2323

2424
> 2018/03/16 12:00:46.196121 ERROR Event: name=extensionName, op=None, message=[ExtensionError] Downgrade not allowed, duration=0
2525
@@ -28,7 +28,7 @@ You will see extension downgrade errors similar to this recorded in /var/log/wa
2828
2929
## Status
3030

31-
Microsoft is taking steps to automatically resolve this issue for affected VMs. On those VMs you will see an additional Microsoft extension installed:
31+
Microsoft is taking steps to automatically resolve this issue for affected VMs. On those VMs, an additional Microsoft extension is being installed:
3232

3333
- Extension Publisher: Microsoft.CPlat.Core
3434
- Extension Type: RunCommandLinux

support/azure/virtual-machines/linux/how-to-use-perfInsights-linux.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,6 @@ ms.author: jarrettr
1919

2020
**Applies to:** :heavy_check_mark: Linux VMs
2121

22-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
23-
2422
[PerfInsights Linux](https://aka.ms/perfinsightslinuxdownload) is a self-help diagnostics tool that collects and analyzes the diagnostic data, and provides a report to help troubleshoot Linux virtual machine performance problems in Azure. Use Performance Diagnostics to identify and troubleshoot performance issues in one of two modes:
2523

2624
- **Continuous diagnostics** collects data at five-second intervals and reports actionable insights about high resource usage every five minutes.
@@ -31,6 +29,8 @@ This article explains how to download the Performance Diagnostics extension to y
3129

3230
If you are experiencing performance problems with virtual machines, before contacting support, run this tool.
3331

32+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
33+
3434
## Supported troubleshooting scenarios
3535

3636
You can use Performance Diagnostics to troubleshoot various scenarios. The following sections describe common scenarios for using Continuous and On-Demand Performance Diagnostics to identify and troubleshoot performance issues. For a comparison of Continuous and On-Demand Performance Diagnostics, see [Performance Diagnostics insights and reports](../windows/performance-diagnostics.md).

support/azure/virtual-machines/linux/linux-agent-cannot-process-extensions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,10 @@ ms.collection: linux
1313

1414
_Original KB number:_   3200481
1515

16-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
17-
1816
This article provides information about resolving a problem in which Azure Linux VMs that are running Azure Linux VM Agent 2.1.5 or 2.1.6 cannot process extensions.
1917

18+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
19+
2020
## Symptoms
2121

2222
Azure Linux virtual machines (VMs) that are running Azure Linux VM Agent 2.1.5 or 2.1.6 experience the following issues if they receive more than one automatic update of Azure Linux VM Agent:

support/azure/virtual-machines/linux/linux-azure-guest-agent.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,13 @@ ms.author: axelg
1919

2020
[!INCLUDE [Feedback](../../../includes/feedback.md)]
2121

22-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
23-
2422
The [Azure Linux Agent](/azure/virtual-machines/extensions/agent-linux) enables a virtual machine (VM) to communicate with the Fabric Controller (the underlying physical server on which the VM is hosted) on IP address 168.63.129.16.
2523

2624
>[!NOTE]
2725
>This IP address is a virtual public IP address that facilitates communication and should not be blocked. For more information, see [What is IP address 168.63.129.16?](/azure/virtual-network/what-is-ip-address-168-63-129-16).
2826
27+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
28+
2929
## Before you begin
3030

3131
Check the agent status and version to make sure it is still supported. See [Minimum version support for virtual machine agents in Azure](../windows/support-extensions-agent-version.md) to check version support, or see [WALinuxAgent FAQ](https://github.com/Azure/WALinuxAgent/wiki/FAQ#what-does-goal-state-agent-mean-in-waagent---version-output) for steps to find the status and version.

support/azure/virtual-machines/linux/linux-custom-image-provisioning-errors.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@ ms.reviewer: srijangupta, scotro, maries, jarrettr, v-weizhu
1010

1111
**Applies to:** :heavy_check_mark: Linux VMs
1212

13-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
14-
1513
## Overview
1614

1715
When you upload or capture a generalized virtual machine (VM) image as a specialized VM image, a [provisioning timeout error](#provisioning-timeout-error-during-an-upload-process) will occur.
@@ -25,6 +23,8 @@ This article covers the possible combinations of generalized and specialized ima
2523
> [!NOTE]
2624
> For descriptions and comparison of generalized and specialized images, see [Generalized and specialized](/azure/virtual-machines/linux/imaging#generalized-and-specialized).
2725
26+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
27+
2828
## Upload combinations of generalized and specialized images
2929

3030
- If the operating system (OS) is a generalized Linux image uploaded using the generalized setting, the upload and deployment will succeed.
Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Linux Image Provisioning Agent update awareness
2+
title: Linux Image Provisioning Agent Update Awareness
33
description: Provides the update awareness and frequently asked questions about Linux Image Provisioning Agent.
44
ms.date: 09/15/2025
55
ms.service: azure-virtual-machines
@@ -15,41 +15,40 @@ ms.reviewer:
1515

1616
_Original KB number:_   4538386
1717

18-
19-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
20-
2118
## Summary
2219

23-
Many Linux Azure Marketplace images contain an **Azure Linux Agent**, which is responsible for completing the setup of the newly created Virtual Machine (VM), such as setting the hostname, username, password/ ssh keys, and mounting an ephemeral disk. This setup process is known as 'provisioning'. In addition, the agent provides support for Azure VM Extensions.
20+
Many Linux Azure Marketplace images contain an **Azure Linux Agent** that's responsible for completing the setup of the newly created virtual machine (VM). The setup includes setting the hostname, username, and password/ ssh keys, and mounting an ephemeral disk. This setup process is known as 'provisioning'. Additionally, the agent provides support for Azure VM extensions.
2421

25-
The images themselves will be updated to be provisioned using an open-source provisioning agent, [cloud-init](/azure/virtual-machines/linux/using-cloud-init). cloud- init offers many additional benefits over the Linux Agent, including:
22+
The images themselves are updated to be provisioned by using an open source provisioning agent, [cloud-init](/azure/virtual-machines/linux/using-cloud-init). The cloud- init agent offers many additional benefits over the Linux Agent, including:
2623

2724
- Performance - Using cloud-init with Azure, you can see improved reduced VM creation times in most cases.
28-
- VM customization - cloud-init allows you to pass down VM configurations to cloud-init via [custom-data](/azure/virtual-machines/linux/using-cloud-init#deploying-a-cloud-init-enabled-virtual-machine), such as running scripts, installing packages, and adding users.
29-
- Migration - If you are migrating from other clouds, you can migrate cloud- init configurations, and modify them where necessary to work with your Azure deployments.
25+
- VM customization - cloud-init enables you to pass down VM configurations to cloud-init through [custom-data](/azure/virtual-machines/linux/using-cloud-init#deploying-a-cloud-init-enabled-virtual-machine). This process includes such actions as running scripts, installing packages, and adding users.
26+
- Migration - If you're migrating from other clouds, you can migrate cloud-init configurations, and modify them where necessary to work with together your Azure deployments.
27+
28+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
3029

3130
## More information
3231

33-
### What do you need to do?
32+
### Necessary actions
3433

35-
- If you deploy these Azure Marketplace images, then there is nothing further that you need to do. You can immediately take advantage of the benefits after the update.
36-
- If you are creating custom images that derive from these images, and use the Linux Agent to process custom-data, check that your images still work correctly.
34+
- If you deploy these Azure Marketplace images, then there is nothing more that you have to do. You can immediately take advantage of the benefits after the update.
35+
- If you create custom images from these images, and use the Linux Agent to process custom data, verify that your images still work correctly.
3736

38-
cloud- init supports multiple input types, including a bash script or a cloud- init config. Review the 'cloud- init'[user-data](https://cloudinit.readthedocs.io/en/latest/topics/format.html) documentation.
39-
- See [this](/azure/virtual-machines/linux/using-cloud-init#cloud-init-overview) page for details on which images will be updated, and the timeline on when the updates will take place.
37+
cloud-init supports multiple input types, including a bash script or a cloud-init config. Review the 'cloud-init'[user-data](https://cloudinit.readthedocs.io/en/latest/topics/format.html) documentation.
38+
- See [this](/azure/virtual-machines/linux/using-cloud-init#cloud-init-overview) page for details about which images will be updated, and the timeline for when the updates occur.
4039

4140
## Frequently asked questions
4241

43-
Q1. Will the Azure Linux Agent still be installed in the images?  
42+
Q1. Is the Azure Linux Agent still installed in the images?  
4443

45-
A1. Yes, the Azure Linux Agent is required for Azure VM extensions. The provisioning functionality will be disabled.  
44+
A1. Yes, the Azure Linux Agent is required for Azure VM extensions. The provisioning functionality is disabled.  
4645

4746
Q2. Can the Azure Linux Agent and cloud-init be installed in the same image?  
4847

49-
A2. Yes. To ensure that there is no conflict, the Linux Agent provisioning code is disabled and will not run.  
48+
A2. Yes. To ensure that there is no conflict, the Linux Agent provisioning code is disabled and won't run.  
5049

51-
Q3. How can I tell if my image has been provisioned by cloud-init?  
50+
Q3. How can I tell whether my image is provisioned by cloud-init?  
5251

53-
A3. Run `cloud-init status` to see if cloud-init has run.
52+
A3. Run `cloud-init status` to learn whether cloud-init ran.
5453

5554
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/virtual-machines/linux/linux-vm-extension-status-not-reported.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Linux VM extension status isn't reported after Azure Linux Agent 2.2.19 update
2+
title: Linux VM Extension Status Isn't Reported After Azure Linux Agent 2.2.19 Update
33
description: Discusses a problem in which the Linux VM extension status is not reported after an Azure Linux Agent update to version 2.2.19.
44
ms.date: 07/21/2020
55
ms.reviewer: danis, danis
@@ -13,26 +13,26 @@ ms.collection: linux
1313

1414
_Original KB number:_   4077547
1515

16-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
16+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
1717

18-
This article provides a solution to an issue in which the Linux VM extension status is not reported after an Azure Linux Agent update to version 2.2.19.
18+
This article provides a solution to a problem in which the Linux VM extension status is not reported after an Azure Linux Agent update to version 2.2.19.
1919

2020
## Symptoms
2121

22-
On a Linux virtual machine (VM) that's running on an instance of Microsoft Azure that has Azure Linux Agent 2.2.19 installed, you don't see the extension status being reported by using either the portal or Azure Command-Line Interface (Azure CLI).
22+
On a Linux virtual machine (VM) that's running on an instance of Microsoft Azure that has Azure Linux Agent 2.2.19 installed, you don't see the extension status reported. This problem occurs in both the Azure portal or Azure Command-Line Interface (Azure CLI).
2323

2424
## Cause
2525

2626
This problem occurs because of a [known issue](https://github.com/Azure/WALinuxAgent/wiki/Known-Issues#2219---protocolerror-varlibwaagentgoalstate1xml-is-missing).
2727

2828
## Resolution
2929

30-
Microsoft is taking steps to automatically resolve this problem. For VMs that have been automatically resolved, you will see the following additional Microsoft extension installed on the affected VMs:
30+
Microsoft is taking steps to automatically resolve this problem. For VMs that were automatically resolved, you see the following additional Microsoft extension installed on the affected VMs:
3131

3232
- **Extension publisher:** Microsoft.CPlat.Core
3333
- **Extension type:** RunCommandLinux
3434

35-
You can use [Azure CLI](/cli/azure/install-azure-cli)  to query the extensions that are assigned to a VM. To do this, run the following command:
35+
You can use [Azure CLI](/cli/azure/install-azure-cli) to query the extensions that are assigned to a VM. To use this query, run the following command:
3636

3737
```Azure CLI
3838
az vm extension list --vm-name <vmName> -g <resGroupName>

support/azure/virtual-machines/linux/linux-vm-sshconnectionissue-perms.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,10 @@ ms.collection: linux
1313

1414
**Applies to:** :heavy_check_mark: Linux VMs
1515

16-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
17-
1816
This article provides solutions to an issue in which connecting to a Linux virtual machine (VM) via Secure Shell (SSH) fails because the _/var/empty/sshd_ directory in RHEL, the _/var/lib/empty_ directory in SUSE, or the _/var/run/sshd_ directory in Ubuntu, doesn't exist, or it isn't owned by the root user, or it's group-writable or world-writable.
1917

18+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
19+
2020
## Symptoms
2121

2222
When you connect to a Linux virtual machine (VM) via SSH, the connection fails. You may receive the following error message about the affected directory, depending on your Linux distribution.

support/azure/virtual-machines/linux/reset-password.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,10 @@ ms.reviewer: msaenzbo, divargas, v-six
2020

2121
**Applies to:** :heavy_check_mark: Linux VMs
2222

23-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
24-
2523
This article provides three methods to reset local Linux Virtual Machine (VM) passwords. If the user account is expired or you want to create a new account, you can use the following methods to create a new local admin account and regain access to the VM.
2624

25+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
26+
2727
## Reset the password by using Azure Linux Agent
2828

2929
You can reset the password without attaching the OS disk to another VM. This method requires that the [Azure Linux Agent](/azure/virtual-machines/extensions/agent-linux) be installed on the affected VM.

support/azure/virtual-machines/linux/serial-console-grub-proactive-configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ ms.author: jarrettr
1919

2020
**Applies to:** :heavy_check_mark: Linux VMs
2121

22-
[!INCLUDE [VM assist troubleshooting tools](../../../includes/vmassist-include.md)]
22+
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
2323

2424
Having access to the Serial Console and GRUB will improve recovery times of your IaaS Linux Virtual Machine in most cases. GRUB offers recovery options that otherwise would take longer to recover your VM.
2525

0 commit comments

Comments
 (0)