Skip to content

Commit 3696181

Browse files
Merge branch 'new-tools' of https://github.com/scottazure/supportarticles-docs-pr into pr/ScottAzure/10161
2 parents 3e0f079 + beb3977 commit 3696181

13 files changed

Lines changed: 135 additions & 131 deletions

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ _Original KB number:_   4099558
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
Lines changed: 15 additions & 15 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
@@ -17,38 +17,38 @@ _Original KB number:_   4538386
1717

1818
## Summary
1919

20-
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.
2121

22-
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:
2323

2424
- Performance - Using cloud-init with Azure, you can see improved reduced VM creation times in most cases.
25-
- 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.
26-
- 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.
2727

2828
[!INCLUDE [VM assist troubleshooting tools](~/includes/azure/vmassist-include.md)]
2929

3030
## More information
3131

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

34-
- 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.
35-
- 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.
3636

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

4040
## Frequently asked questions
4141

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

44-
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.  
4545

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

48-
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.  
4949

50-
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?  
5151

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

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

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

Lines changed: 5 additions & 5 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
@@ -15,24 +15,24 @@ _Original KB number:_   4077547
1515

1616
[!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>

0 commit comments

Comments
 (0)