Merge pull request #74299 from MGoedtel/UpdateAzMonAgents423

updated agent manage article

Author: ktoliver

articles/azure-monitor/platform/agent-manage.md

@@ -11,13 +11,77 @@ ms.service: log-analytics
 ms.workload: na
 ms.tgt_pltfrm: na
 ms.topic: conceptual
-ms.date: 03/30/2018
+ms.date: 04/23/2019
 ms.author: magoedte
 ---
 
 # Managing and maintaining the Log Analytics agent for Windows and Linux
 
-After initial deployment of the Log Analytics Windows or Linux agent in Azure Monitor, you may need to reconfigure the agent, or remove it from the computer if has reached the retirement stage in its lifecycle. You can easily manage these routine maintenance tasks manually or through automation, which reduces both operational error and expenses.
+After initial deployment of the Log Analytics Windows or Linux agent in Azure Monitor, you may need to reconfigure the agent, upgrade it, or remove it from the computer if has reached the retirement stage in its lifecycle. You can easily manage these routine maintenance tasks manually or through automation, which reduces both operational error and expenses.
+
+## Upgrading agent
+
+The Log Analytics agent for Windows and Linux can be upgraded to the latest release manually or automatically depending on the deployment scenario and environment the VM is running in. The following methods can be used to upgrade the agent.
+
+| Environment | Installation Method | Upgrade method |
+|--------|----------|-------------|
+| Azure VM | Log Analytics agent VM extension for Windows/Linux | Agent is automatically upgraded by default unless you configured your Azure Resource Manager template to opt out by setting the property *autoUpgradeMinorVersion* to **false**. |
+| Custom Azure VM images | Manual install of Log Analytics agent for Windows/Linux | Updating VMs to the newest version of the agent needs to be performed from the command line running the Windows installer package or Linux self-extracting and installable shell script bundle.|
+| Non-Azure VMs | Manual install of Log Analytics agent for Windows/Linux | Updating VMs to the newest version of the agent needs to be performed from the command line running the Windows installer package or Linux self-extracting and installable shell script bundle. |
+
+### Upgrade Windows agent 
+
+To update the agent on a Windows VM to the latest version not installed using the Log Analytics VM extension, you either run from the Command Prompt, script or other automation solution, or by using the MMASetup-\<platform\>.msi Setup Wizard.  
+
+You can download the latest version of the Windows agent from your Log Analytics workspace, by performing the following steps.
+
+1. Sign in to the Azure portal.
+
+2. In the Azure portal, click **All services**. In the list of resources, type **Log Analytics**. As you begin typing, the list filters based on your input. Select **Log Analytics workspaces**.
+
+3. In your list of Log Analytics workspaces, select the workspace.
+
+4. In your Log Analytics workspace, select **Advanced settings**, then select **Connected Sources**, and finally **Windows Servers**.
+
+5. From the **Windows Servers** page, select the appropriate **Download Windows Agent** version to download depending on the processor architecture of the Windows operating system.
+
+>[!NOTE]
+>During the upgrade of the Log Analytics agent for Windows, it does not support configuring or reconfiguring a workspace to report to. To configure the agent, you need to follow one of the supported methods listed under [Adding or removing a workspace](#adding-or-removing-a-workspace).
+>
+
+#### To upgrade using the Setup Wizard
+
+1. Sign on to the computer with an account that has administrative rights.
+
+2. Execute **MMASetup-\<platform\>.exe** to start the Setup Wizard.
+
+3. On the first page of the Setup Wizard, click **Next**.
+
+4. In the **Microsoft Monitoring Agent Setup** dialog box, click **I agree** to accept the license agreement.
+
+5. In the **Microsoft Monitoring Agent Setup** dialog box, click **Upgrade**. The status page displays the progress of the upgrade.
+
+6. When the **Microsoft Monitoring Agent configuration completed successfully.** page appears, click **Finish**.
+
+#### To upgrade from the command line
+
+1. Sign on to the computer with an account that has administrative rights.
+
+2. To extract the agent installation files, from an elevated command prompt run `MMASetup-<platform>.exe /c` and it will prompt you for the path to extract files to. Alternatively, you can specify the path by passing the arguments `MMASetup-<platform>.exe /c /t:<Full Path>`.
+
+3. Run the following command, where D:\ is the location for the upgrade log file.
+
+    ```dos
+    setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1
+    ```
+
+### Upgrade Linux agent 
+
+Upgrade from prior versions (>1.0.0-47) is supported. Performing the installation with the `--upgrade` command will upgrade all components of the agent to the latest version.
+
+Run the following command to upgrade the agent.
+
+`sudo sh ./omsagent-*.universal.x64.sh --upgrade`
 
 ## Adding or removing a workspace
 
@@ -26,10 +90,15 @@ After initial deployment of the Log Analytics Windows or Linux agent in Azure Mo
 #### Update settings from Control Panel
 
 1. Sign on to the computer with an account that has administrative rights.
+
 2. Open **Control Panel**.
+
 3. Select **Microsoft Monitoring Agent** and then click the **Azure Log Analytics** tab.
+
 4. If removing a workspace, select it and then click **Remove**. Repeat this step for any other workspace you want the agent to stop reporting to.
+
 5. If adding a workspace, click **Add** and on the **Add a Log Analytics Workspace** dialog box, paste the Workspace ID and Workspace Key (Primary Key). If the computer should report to a Log Analytics workspace in Azure Government cloud, select Azure US Government from the Azure Cloud drop-down list.
+
 6. Click **OK** to save your changes.
 
 #### Remove a workspace using PowerShell
@@ -104,8 +173,11 @@ To configure the agent to communicate to the service through a proxy server or [
 #### Update settings using Control Panel
 
 1. Sign on to the computer with an account that has administrative rights.
+
 2. Open **Control Panel**.
+
 3. Select **Microsoft Monitoring Agent** and then click the **Proxy Settings** tab.
+
 4. Click **Use a proxy server** and provide the URL and port number of the proxy server or gateway. If your proxy server or Log Analytics gateway requires authentication, type the username and password to authenticate and then click **OK**.
 
 #### Update settings using PowerShell
@@ -160,7 +232,9 @@ Use one of the following procedures to uninstall the Windows or Linux agent usin
 
 #### Uninstall from Control Panel
 1. Sign on to the computer with an account that has administrative rights.
+
 2. In **Control Panel**, click **Programs and Features**.
+
 3. In **Programs and Features**, click **Microsoft Monitoring Agent**, click **Uninstall**, and then click **Yes**.
 
 >[!NOTE]
@@ -170,7 +244,9 @@ Use one of the following procedures to uninstall the Windows or Linux agent usin
 The downloaded file for the agent is a self-contained installation package created with IExpress. The setup program for the agent and supporting files are contained in the package and need to be extracted in order to properly uninstall using the command line shown in the following example.
 
 1. Sign on to the computer with an account that has administrative rights.
+
 2. To extract the agent installation files, from an elevated command prompt run `extract MMASetup-<platform>.exe` and it will prompt you for the path to extract files to. Alternatively, you can specify the path by passing the arguments `extract MMASetup-<platform>.exe /c:<Path> /t:<Path>`. For more information on the command-line switches supported by IExpress, see [Command-line switches for IExpress](https://support.microsoft.com/help/197147/command-line-switches-for-iexpress-software-update-packages) and then update the example to suit your needs.
+
 3. At the prompt, type `%WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb`.
 
 ### Linux agent
@@ -186,14 +262,23 @@ Perform the following steps to configure the Log Analytics agent for Windows to
 [!INCLUDE [log-analytics-agent-note](../../../includes/log-analytics-agent-note.md)]
 
 1. Sign on to the computer with an account that has administrative rights.
+
 2. Open **Control Panel**.
+
 3. Click **Microsoft Monitoring Agent** and then click the **Operations Manager** tab.
+
 4. If your Operations Manager servers have integration with Active Directory, click **Automatically update management group assignments from AD DS**.
+
 5. Click **Add** to open the **Add a Management Group** dialog box.
+
 6. In **Management group name** field, type the name of your management group.
+
 7. In the **Primary management server** field, type the computer name of the primary management server.
+
 8. In the **Management server port** field, type the TCP port number.
+
 9. Under **Agent Action Account**, choose either the Local System account or a local domain account.
+
 10. Click **OK** to close the **Add a Management Group** dialog box and then click **OK** to close the **Microsoft Monitoring Agent Properties** dialog box.
 
 ### Linux agent
@@ -202,7 +287,9 @@ Perform the following steps to configure the Log Analytics agent for Linux to re
 [!INCLUDE [log-analytics-agent-note](../../../includes/log-analytics-agent-note.md)]
 
 1. Edit the file `/etc/opt/omi/conf/omiserver.conf`
+
 2. Ensure that the line beginning with `httpsport=` defines the port 1270. Such as: `httpsport=1270`
+
 3. Restart the OMI server: `sudo /opt/omi/bin/service_control restart`
 
 ## Next steps