Skip to content

Commit 9f9fca2

Browse files
Update azure-monitor-agent-mma-removal-tool.md
1 parent 6961020 commit 9f9fca2

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

articles/azure-monitor/agents/azure-monitor-agent-mma-removal-tool.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,29 +11,29 @@ ms.custom:
1111
---
1212
# MMA/OMS Discovery and Removal Utility
1313

14-
After you migrate your machines to the Azure Monitor Agent (AMA), remove the legacy Log Analytics Agent, MMA or OMS depending on your operating systems, to avoid duplication of logs. The legacy Discovery and Removal Utility can remove the extensions from Azure Virtual Machines (VMs), Azure Virtual Machine Scale Sets (VMSSs), and Azure Arc servers from a single subscription.
14+
After you migrate your machines to the Azure Monitor Agent (AMA), remove the legacy Log Analytics Agent, MMA, or OMS depending on your operating systems, to avoid duplication of logs. The legacy Discovery and Removal Utility can remove the extensions from Azure Virtual Machines (VMs), Azure Virtual Machine Scale Sets (VMSSs), and Azure Arc servers from a single subscription.
1515

1616
The utility works in two steps:
1717

18-
1. *Discovery*: The utility creates an inventory of all machines that have a legacy agent installed in a simple CSV file. We recommend that you don't create any new VMs, virtual machine scale sets, or Azure Arc servers with the legacy agent extension while the utility is running.
18+
1. *Discovery*: The utility creates an inventory of all machines that have a legacy agent installed in a simple CSV file. We recommend that you don't create any new VMs while the utility is running.
1919

2020
2. *Removal*: The utility removes the legacy agent from machines listed in the CSV file. You should edit the list of machine in the CSV file to ensure that only machines you want the agent removed from are present.
2121

2222
## Prerequisites
2323
Do all the setup steps on an Internet connected machine. You need:
2424

2525
- Windows 10 or later, or Windows Server 2019 or later.
26-
- [PowerShell 7.0 or later.](/powershell/scripting/install/installing-powershell?view=powershell-7.4&preserve-view=true) This allows for parallel execution that speeds the process up.
26+
- [PowerShell 7.0 or later.](/powershell/scripting/install/installing-powershell?view=powershell-7.4&preserve-view=true), which enables parallel execution that speeds the process up.
2727
- Azcli must be installed to communicate with the [Azure Graph API.](/cli/azure/install-azure-cli-windows?tabs=azure-cli).
2828
1. Open PowerShell as administrator:
2929
2. Run the command: `Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile AzureCLI.msi`.
3030
3. Run the command: `Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'`.
31-
4. The latest version of Azure CLI will be downloaded and installed.
31+
4. The latest version of Azure CLI will download and install.
3232
- A [user-assigned managed identity](/azure/active-directory/managed-identities-azure-resources/overview) that has**User Access Administrator**, **Reader**, **Virtual Machine Contributor**, and **Azure Arc ScVmm VM Contributor** access on the target scopes.
3333

3434

3535
## Step 1 Login and set subscription
36-
The tool works one subscription at a time. You must login and set the subscription to do the removal. Open a PowerShell command prompt as administrator and login.
36+
The tool works one subscription at a time. You must log in and set the subscription to do the removal. Open a PowerShell command prompt as administrator and login.
3737

3838
``` PowerShell
3939
az login
@@ -44,9 +44,9 @@ Next you must set your subscription.
4444
Az account set --subscription {subscription_id or “subscription_name”}
4545
```
4646
## Step 2 Copy the script
47-
You will use the following script for agent removal. Open a file in your local directory named MMAUnistallUtilityScript.ps1 and copy the script into the file.
47+
You will use the followng script for agent removal. Open a file in your local directory named MMAUnistallUtilityScript.ps1 and copy the script into the file.
4848
``` PowerShell
49-
# This is per subscription, the customer has to set the az subscription before running this.
49+
# This is per subscription, the customer has to set the az subscription before running this.
5050
# az login
5151
# az account set --subscription <subscription_id/subscription_name>
5252
# This script uses parallel processing, modify the $parallelThrottleLimit parameter to either increase or decrease the number of parallel processes
@@ -234,22 +234,22 @@ switch ($args.Count)
234234
```
235235

236236
## Step 3 Get inventory
237-
You must collect a list of all legacy agents, both MMA and OMS, on all VM, VMSS and Arc enabled server in the subscription. Run the script you downloaded to your file to product and inventory of legacy agents in your subscription.
237+
You'll collect a list of all legacy agents, both MMA and OMS, on all VM, VMSSs and Arc enabled server in the subscription. You'll run the script you downloaded an inventory of legacy agents in your subscription.
238238
``` PowerShell
239239
.\MMAUnistallUtilityScript.ps1 GetInventory
240240
```
241-
The script will report the total VM, VMSS, or Arc enables servers seen in the subscription. It will take several minutes to run. You will see a progress bar in the console window. Once complete there will be a CSV file called MMAInventory.csv in the local directory with the following format.
241+
The script reports the total VM, VMSSs, or Arc enables servers seen in the subscription. It takes several minutes to run. You see a progress bar in the console window. Once complete, you are able to see a CSV file called MMAInventory.csv in the local directory with the following format.
242242

243243
|Resource_Group | Resource_Type | Name | Install_Type |Extension_Name |
244244
|---|---|---|---|---|
245245
| Linux-AMA-E2E | VM | Linux-ama-e2e-debian9 | Extension | OmsAgentForLinux |
246246
|AMA-ADMIN | VM | test2012-r2-da | Extension | MicrosoftMonitorAgent |
247247

248248
## Step 4 Uninstall inventory
249-
This script iterates through the list of VM, VMSS, and Arc enabled servers and uninstalls the legacy agent. If the VM, VMSS, or Arc enabled server is not running you will not be able to remove the agent.
249+
This script iterates through the list of VM, VMSS, and Arc enabled servers and uninstalls the legacy agent. If the VM, VMSS, or Arc enabled server isn't running, they won't be remove.
250250
``` PowerShell
251251
.\MMAUnistallUtilityScript.ps1 UninstallMMAExtension
252252
```
253-
Once the script is complete you will be able to see the removal status for your VM, VMSS and Arc enabled servers in the MMAInventory.csv file.
253+
Once the script is complete you'll be able to see the removal status for your VM, VMSS and Arc enabled servers in the MMAInventory.csv file.
254254

255255
---

0 commit comments

Comments
 (0)