Skip to content

Commit 25ea367

Browse files
authored
Merge pull request #466 from percona/ps-9677
PS-9677 [DOCS] - add DNF to YUM documentation 8.0
2 parents f07e424 + 16f5edc commit 25ea367

5 files changed

+50
-46
lines changed

docs/quickstart-yum.md docs/quickstart-dnf.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Install with YUM
1+
# Install with DNF
22

3-
Use the [Percona repositories] to install using YUM.
3+
Use the [Percona repositories] to install using DNF.
44

55
## Prerequisits
66

@@ -13,10 +13,10 @@ Use the [Percona repositories] to install using YUM.
1313
The "expected output" depends on the operating system. The following examples are based on Oracle Linux 9.3.
1414
{.power-number}
1515

16-
1. Use the YUM package manager to install `percona-release`.
16+
1. Use the DNF package manager to install `percona-release`.
1717

1818
```{.bash data-prompt="$"}
19-
$ sudo yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
19+
$ sudo dnf install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
2020
```
2121

2222
??? example "Expected output"
@@ -92,7 +92,7 @@ The "expected output" depends on the operating system. The following examples ar
9292
4. Install the latest version of Percona Server for MySQL 8.0. This installation may take some time.
9393

9494
```{.bash data-prompt="$"}
95-
$ sudo yum install -y percona-server-server
95+
$ sudo dnf install -y percona-server-server
9696
```
9797

9898
??? example "Expected output"
@@ -418,11 +418,11 @@ mysql> SELECT id, name, email, country FROM employees WHERE id > 10;
418418

419419
Installation:
420420

421-
* Verify repository is enabled: `sudo yum repolist`
421+
* Verify repository is enabled: `sudo dnf repolist`
422422

423-
* Check for package conflicts: `sudo yum deplist percona-server-server`
423+
* Check for package conflicts: `sudo dnf repoquery --deplist percona-server-server`
424424

425-
* Consult package logs: `sudo journalctl -u yum`
425+
* Consult package logs: `sudo journalctl -u dnf`
426426

427427
MySQL startup:
428428

@@ -432,8 +432,8 @@ MySQL startup:
432432

433433
## Security Steps:
434434

435-
* Keep software updated: `sudo yum update` regularly.
436-
435+
* Keep software updated: `sudo DNF update` regularly.
436+
437437
* Strong root password: Set a complex, unique password using [`mysql_secure_installation`](#secure-the-installation).
438438

439439
* Disable unused accounts and databases: Remove unnecessary elements.

docs/quickstart-overview.md

+5-9
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
Percona Server for MySQL is a freely available, fully compatible, enhanced, and open source drop-in replacement for any MySQL database and provides enterprise-grade features in security, availability, data management, visibility, instrumentation, and performance.
44

5-
To start with Percona Server for MySQL quickly, this Quickstart guide focuses on either using Docker, or installing with APT or YUM.
5+
To start with Percona Server for MySQL quickly, this Quickstart guide focuses on either using Docker, or installing with APT or DNF.
66

7-
You can explore alternative installation options in the [Install] section of the Percona Server for MySQL documentation.
7+
You can explore alternative installation options in the [Install](installation.md) topic in the Percona Server for MySQL documentation.
88

99
Review [Get more help](get-help.md) for ways that we can work with you.
1010

1111
## Purpose of the Quickstart
1212

13-
This document guides you through the initial setup process, including setting a root password in either APT or YUM, creating a database.
13+
This document guides you through the initial setup process, including setting a root password in either APT or DNF, creating a database.
1414

1515
You can also do the following:
1616

@@ -23,21 +23,17 @@ You can also do the following:
2323

2424
The following guides walk you through the setup process and working with a database for a developer. Select the installation method that works best in your environment.
2525

26-
2726
## Next steps
2827

2928
[Run Percona Server for MySQL 8.0 in a Docker container:material-arrow-right:](quickstart-docker.md){.md-button}
3029

3130
[Install using APT:material-arrow-right:](quickstart-apt.md){.md-button}
3231

33-
[Install using YUM:material-arrow-right:](quickstart-yum.md){.md-button}
32+
[Install using DNF:material-arrow-right:](quickstart-dnf.md){.md-button}
3433

3534
[Choose your next steps:material-arrow-right:](quickstart-next-steps.md){.md-button}
3635

37-
38-
39-
40-
36+
4137
[the Quickstart for the Percona Operator for MySQL based on the Percona Server for MySQL using Helm]: https://docs.percona.com/percona-operator-for-mysql/ps/helm.html
4238

4339
[the Quickstart for the Percona Operator for MySQL based on the Percona Server for MySQL using Minikube]: https://docs.percona.com/percona-operator-for-mysql/ps/minikube.html

docs/yum-download-rpm.md

+22-22
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
You should be aware that when you install packages manually, you must resolve and install any dependencies. This process may involve finding and installing the necessary dependencies before installing the packages. Dependencies are other packages that a package may need to function correctly. For example, a package may rely on a specific library. If that library is not installed, or if the installed library is the wrong version, the package may not work correctly.
44

5-
Package managers, like `APT` or `YUM` install the dependencies for you.
5+
Package managers, like `APT` or `DNF` install the dependencies for you.
66

77
Download the packages from [Percona Product Downloads](https://www.percona.com/downloads). If needed, [Instructions for the Percona Product Download](download-instructions.md) are available.
88

@@ -12,12 +12,12 @@ Starting with Percona Server 8.0.33-25, the RPM builds for *RHEL* 8 and *RHEL* 9
1212

1313
## Download and install RPM packages
1414

15-
The following example downloads *Percona Server for MySQL* 8.0.32-24 release packages for *RHEL* 8.
15+
The following example downloads *Percona Server for MySQL* {{release}} release packages for *RHEL* 8.
1616

1717
1. Using [`Wget`](https://www.gnu.org/software/wget/), the following command downloads a specific version of Percona Server for MySQL on Red Hat Enterprise Linux 8 from the Percona website.
1818

1919
```{.bash data-prompt="$"}
20-
$ wget https://downloads.percona.com/downloads/Percona-Server-8.0/Percona-Server-8.0.32-24/binary/redhat/8/x86_64/Percona-Server-8.0.32-24-re5c6e9d2-el8-x86_64-bundle.tar
20+
$ wget https://downloads.percona.com/downloads/Percona-Server-8.0/Percona-Server-{{release}}/binary/redhat/8/x86_64/Percona-Server-{{release}}-re5c6e9d2-el8-x86_64-bundle.tar
2121
```
2222

2323
2. The following command extracts the contents of Percona Server for MySQL tarball. The `tar` command uses these options for the extraction:
@@ -29,7 +29,7 @@ The following example downloads *Percona Server for MySQL* 8.0.32-24 release pac
2929
* `f` - name of the archive file
3030

3131
```{.bash data-prompt="$"}
32-
$ tar xvf Percona-Server-8.0.32-24-re5c6e9d2-el8-x86_64-bundle.tar
32+
$ tar xvf Percona-Server-{{release}}-re5c6e9d2-el8-x86_64-bundle.tar
3333
```
3434

3535
3. The following command uses the `ls` utility to list the RPM files in the current directory. The command uses the `*.rpm` pattern. The `*` is a wildcard that matches any number of characters. The `.rpm` specifies that we only want the files that end in this extension.
@@ -42,23 +42,23 @@ The following example downloads *Percona Server for MySQL* 8.0.32-24 release pac
4242
??? example "Expected output"
4343

4444
```text
45-
percona-icu-data-files-8.0.32-24.1.el8.x86_64.rpm
46-
percona-mysql-router-8.0.32-24.1.el8.x86_64.rpm
47-
percona-mysql-router-debuginfo-8.0.32-24.1.el8.x86_64.rpm
48-
percona-server-client-8.0.32-24.1.el8.x86_64.rpm
49-
percona-server-client-debuginfo-8.0.32-24.1.el8.x86_64.rpm
50-
percona-server-debuginfo-8.0.32-24.1.el8.x86_64.rpm
51-
percona-server-debugsource-8.0.32-24.1.el8.x86_64.rpm
52-
percona-server-devel-8.0.32-24.1.el8.x86_64.rpm
53-
percona-server-rocksdb-8.0.32-24.1.el8.x86_64.rpm
54-
percona-server-rocksdb-debuginfo-8.0.32-24.1.el8.x86_64.rpm
55-
percona-server-server-8.0.32-24.1.el8.x86_64.rpm
56-
percona-server-server-debuginfo-8.0.32-24.1.el8.x86_64.rpm
57-
percona-server-shared-8.0.32-24.1.el8.x86_64.rpm
58-
percona-server-shared-compat-8.0.32-24.1.el8.x86_64.rpm
59-
percona-server-shared-debuginfo-8.0.32-24.1.el8.x86_64.rpm
60-
percona-server-test-8.0.32-24.1.el8.x86_64.rpm
61-
percona-server-test-debuginfo-8.0.32-24.1.el8.x86_64.rpm
45+
percona-icu-data-files-{{release}}.1.el8.x86_64.rpm
46+
percona-mysql-router-{{release}}.1.el8.x86_64.rpm
47+
percona-mysql-router-debuginfo-{{release}}.1.el8.x86_64.rpm
48+
percona-server-client-{{release}}.1.el8.x86_64.rpm
49+
percona-server-client-debuginfo-{{release}}.1.el8.x86_64.rpm
50+
percona-server-debuginfo-{{release}}.1.el8.x86_64.rpm
51+
percona-server-debugsource-{{release}}.1.el8.x86_64.rpm
52+
percona-server-devel-{{release}}.1.el8.x86_64.rpm
53+
percona-server-rocksdb-{{release}}.1.el8.x86_64.rpm
54+
percona-server-rocksdb-debuginfo-{{release}}.1.el8.x86_64.rpm
55+
percona-server-server-{{release}}.1.el8.x86_64.rpm
56+
percona-server-server-debuginfo-{{release}}.1.el8.x86_64.rpm
57+
percona-server-shared-{{release}}.1.el8.x86_64.rpm
58+
percona-server-shared-compat-{{release}}.1.el8.x86_64.rpm
59+
percona-server-shared-debuginfo-{{release}}.1.el8.x86_64.rpm
60+
percona-server-test-{{release}}.1.el8.x86_64.rpm
61+
percona-server-test-debuginfo-{{release}}.1.el8.x86_64.rpm
6262
```
6363

6464
4. [Optional] Install `jemalloc`. The following command downloads a specific version of `jemalloc` for RHEL 8 from the Percona repository.
@@ -70,7 +70,7 @@ The following example downloads *Percona Server for MySQL* 8.0.32-24 release pac
7070
5. An EL8-based RHEL distribution or derivatives package installation requires you to disable the `mysql` module. We are installing a different version than the one provided by the module, so we must disable the module before installation.
7171

7272
```{.bash data-prompt="$"}
73-
$ sudo yum module disable mysql
73+
$ sudo dnf module disable mysql
7474
```
7575

7676
6. The following command uses superuser privileges to install RPM packages in the current directory using the `rpm` command. The `rpm` command uses the following options:

docs/yum-repo.md

+12-4
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Ready-to-use packages are available from the Percona Server for MySQL software
44
repositories and the [download page](https://www.percona.com/downloads).
55

6-
The Percona yum repository supports popular RPM-based
6+
The Percona YUM repository supports popular RPM-based
77
operating systems. The easiest way to install the Percona RPM repository is to install an RPM configuring yum and installing the [Percona GPG key](https://repo.percona.com/yum/PERCONA-PACKAGING-KEY).
88

99
We gather [Telemetry data] in the Percona packages and Docker images.
@@ -32,11 +32,19 @@ RHEL 8 and other EL8 systems enable the MySQL module by default. This module hid
3232
$ sudo yum module disable mysql
3333
```
3434

35+
If you are using the DNF package manager, you can disable the module using the following command:
36+
37+
```{.bash data-prompt="$"}
38+
$ sudo dnf module disable mysql
39+
```
40+
3541
## Install
3642

3743
Install from Percona Software Repository
3844
For more information on the Percona Software repositories and configuring Percona Repositories with `percona-release`, see the [Percona Software Repositories Documentation]. Run the following commands as a `root` user or with sudo.
3945

46+
DNF is the default package manager in RHEL 8 and newer versions, providing a more robust and efficient package management experience.
47+
4048
=== "Install on Red Hat 7"
4149

4250
The first command uses `yum` to install the Percona repository from the Percona website. The second command enables the `ps-80` release series of the Percona Server. The third command allows the `tools` repository. This repository contains additional Percona software. The fourth command installs Percona Server for MySQL.
@@ -52,9 +60,9 @@ For more information on the Percona Software repositories and configuring Percon
5260
The first command uses `yum` to install the Percona repository from the Percona website. The second command uses the `percona-release` script to set up the `ps-80` release series of Percona Server. The third command installs Percona Server for MySQL.
5361

5462
```{.bash data-prompt="$"}
55-
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
63+
$ sudo dnf install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
5664
$ sudo percona-release setup ps-80
57-
$ sudo yum install percona-server-server
65+
$ sudo dnf install percona-server-server
5866
```
5967

6068
## Available storage engines
@@ -67,7 +75,7 @@ For information on how to install and configure TokuDB, refer to the [TokuDB Ins
6775

6876
For information on how to install and configure MyRocks, refer to the [Percona MyRocks Installation guide].
6977

70-
### Percona yum Testing repository
78+
### Percona YUM testing repository
7179

7280
Percona offers pre-release builds from our testing repository.
7381

mkdocs-base.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -226,7 +226,7 @@ nav:
226226
- quickstart-overview.md
227227
- quickstart-docker.md
228228
- quickstart-apt.md
229-
- quickstart-yum.md
229+
- quickstart-dnf.md
230230
- quickstart-next-steps.md
231231

232232
- Install:

0 commit comments

Comments
 (0)