Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Merged
merged 21 commits into from
Jul 9, 2024
Merged
Changes from 16 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 28 additions & 1 deletion docs/how-to/upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,34 @@ If one is available, click the update button to update to the version indicated.

## Updating a PMM-Agent

PMM-Agent can be updated from tarball:
### Package Manager

The most convenient and efficient way to manage the installation and updates of the PMM Agent is by leveraging your operating system's package manager. 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.```

PMM Agent is available from the `tools` repository. To deploy a new version of the Agent, you have two options:
- If you are using a package manager, you can install the latest version of the PMM Agent directly.
- If you initially installed the PMM Agent from a tarball, you can replace the currently installed package with the latest version.

For example, to install the latest version of the PMM Agent on Red Hat or its derivatives, you can use the following commands:
```
percona-release enable tools
catalinaadam marked this conversation as resolved.
Show resolved Hide resolved
yum update pmm2-client
```
By running these commands, your existing agent configuration will be preserved during the update process.

To deploy a specific version, you can check the available versions and then provide the full name of the package, for example:
```
yum --showduplicates search pmm2-client
pmm2-client-2.36.0-6.el7.x86_64 : PMM-agent
pmm2-client-2.37.0-6.el7.x86_64 : PMM-agent
pmm2-client-2.37.1-6.el7.x86_64 : PMM-agent

yum update pmm2-client-2.37.1-6.el7.x86_64
```

### Tarball

PMM-Agent can also be updated from tarball:

1. Download `tar.gz` with `pmm2-client`.
2. Extract it.
Expand Down
Loading