PMM-11192 [DOC] PMM Client upgrade documentation for different distribution methods - Packages

docs/how-to/upgrade.md

@@ -19,10 +19,9 @@ This sequential upgrading process ensures that PMM's internal components are mig
 ## Update the Server
 
 !!! caution alert alert-warning "Known issues for older versions"
-    - Upgrading to PMM 2.32.0 from older versions fails. We recommend upgrading directly to2.33 or latest version. For more information, see the [troubleshooting topic](../how-to/troubleshoot.md#pmm-server-fails-while-upgrading).
-
-    - PMM versions prior to 2.33.0 may not show the latest versions available with instances created from the AWS marketplace in specific environments, including AWS. For solution, see the [troubleshooting](../how-to/troubleshoot.md#pmm-server-not-showing-latest-versions-available-with-the-instances-created-from-aws) section.
+    - Upgrading to PMM 2.32.0 from older versions fails. We recommend upgrading directly to 2.33 or the latest version. For more information, see the [troubleshooting topic](../how-to/troubleshoot.md#pmm-server-fails-while-upgrading).
 
+    - PMM versions prior to 2.33.0 may not show the latest versions available with instances created from the AWS marketplace in specific environments, including AWS. For a solution, see the [troubleshooting](../how-to/troubleshoot.md#pmm-server-not-showing-latest-versions-available-with-the-instances-created-from-aws) section.
 
 Client and server components are installed and updated separately.
 
@@ -38,19 +37,57 @@ The panel shows:
 - whether the server is up to date;
 - the last time a check was made for updates.
 
-Click the refresh button to manually check for updates.
-
-If one is available, click the update button to update to the version indicated.
+Click the refresh button to manually check for updates. If an update is available, click the Update button to install the indicated version.
 
 !!! seealso alert alert-info "See also"
     [PMM Server Docker upgrade](../setting-up/server/docker.md#upgrade)
 
 ## Updating a PMM-Agent
 
-PMM-Agent can be updated from tarball:
+There are two primary methods to update the PMM Agent, depending on your initial installation method:
+
+1. Using your operating system's package manager.
+2. Updating from a tarball.
+
+### 1. Package Manager method
+
+The package manager method is generally more convenient and efficient. Percona provides the [percona-release](https://docs.percona.com/percona-software-repositories/installing.html) package, which helps you install Percona software, including the PMM Agent. The PMM Agent is available from the `pmm-client` repository.
+
+To deploy a new version of the Agent via package manager, simply replace the currently installed package with the latest version of the PMM Agent or with a specific version.
+
+#### Install the latest PMM Agent version
+
+Run the commands below to install the latest PMM Agent version via package manager and keep your existing Agent configuration during the update process.
+
+For example, to install the latest version of the PMM Agent on Red Hat or its derivatives:
+
+    ```
+    percona-release enable pmm2-client
+    yum update pmm2-client
+    ```
+#### Deploy a specific version
+
+To deploy a specific version of the PMM Agent via package manager, check the available versions and then provide the full name of the package. For example:
+
+    ```
+    yum --showduplicates search pmm2-client
+    pmm2-client-2.39.0-6.el9.x86_64 : Percona Monitoring and Management Client (pmm-agent)
+    pmm2-client-2.40.0-6.el9.x86_64 : Percona Monitoring and Management Client (pmm-agent)
+    pmm2-client-2.40.1-6.el9.x86_64 : Percona Monitoring and Management Client (pmm-agent)
+    pmm2-client-2.41.0-6.el9.x86_64 : Percona Monitoring and Management Client (pmm-agent)
+    pmm2-client-2.41.1-6.el9.x86_64 : Percona Monitoring and Management Client (pmm-agent)
+    pmm2-client-2.41.2-6.el9.x86_64 : Percona Monitoring and Management Client (pmm-agent)
+    pmm2-client-2.42.0-6.el9.x86_64 : Percona Monitoring and Management Client (pmm-agent)
+
+    yum update pmm2-client-2.41.2-6.el9.x86_64
+    ```
+
+### Tarball method
+
+If you initially installed the PMM Agent from a tarball, you can update it by replacing the currently installed package with the latest version:
 
  1. Download `tar.gz` with `pmm2-client`.
- 2. Extract it.
+ 2. Extract the tarball.
  3. Run `./install_tarball` script with the `-u` flag.
 
 !!! caution alert alert-warning "Important"