You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/apt-download-deb.md
+84-4Lines changed: 84 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,91 @@
1
-
# Install Percona Server for MySQL {{vers}} using downloaded DEB packages
1
+
# Download and install Percona Server for MySQL from a .tar file
2
2
3
-
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.
3
+
Percona provides `.tar` files built for different system architectures (like AMD64 or ARM64) and glibc versions.
4
+
To avoid errors when running Percona Server for MySQL, make sure your system matches the architecture and glibc version of the file you download.
4
5
5
-
The following example downloads Percona Server for MySQL {{release}} release packages for Ubuntu 22.04:
6
+
!!! note "Why use a `.tar` file instead of APT or DNF?"
7
+
8
+
There are several reasons why you might download and install Percona Server for MySQL using a `.tar` file instead of your system’s package manager:
9
+
10
+
* You need a version not available in your OS repositories – `.tar` files often include newer or custom Percona builds.
11
+
12
+
* You're on a Linux distro not officially supported – such as Alpine, Arch, or Amazon Linux.
13
+
14
+
* You want more control over installation – choose the install path, skip auto-start, and configure manually.
15
+
16
+
* You want to avoid modifying the system package database – useful in environments with limited or no root access.
17
+
18
+
* You're using containers or minimal images – ideal for Docker or systems without APT or DNF.
19
+
20
+
⚠️ When using a `.tar` file, you must manage dependencies manually. This method is best for advanced users, test environments, or container builds—not always recommended for production.
21
+
22
+
Download the `.tar` file from the [Percona Downloads](https://www.percona.com/downloads) page.
23
+
24
+
If you need help using the download page, see [Instructions for the Percona Product Download](download-instructions.md).
25
+
26
+
## Recommended downloads
27
+
28
+
| Package Type | Glibc Version | File Name | Size |
### Check your system architecture and glibc version
41
+
42
+
Before you download a Percona `.tar` file, check your system architecture and glibc version to make sure you choose a compatible build.
43
+
44
+
45
+
#### Step 1: Check your system architecture
46
+
47
+
Run the following command to see what type of CPU your system uses:
48
+
49
+
```
50
+
$ uname -m
51
+
```
52
+
53
+
This command shows what type of processor your system uses:
54
+
55
+
*`x86_64` means your system uses AMD64 architecture (Intel or AMD).
56
+
57
+
*`aarch64` means your system uses ARM64 architecture (Apple Silicon or ARM-based servers).
58
+
59
+
??? example "Expected output"
60
+
61
+
```{.text .no-copy}
62
+
x86_64
63
+
```
64
+
65
+
#### Step 2: Check your glibc version
66
+
67
+
Run this command to see which version of the GNU C Library (glibc) your system is using:
68
+
69
+
```
70
+
$ getconf GNU_LIBC_VERSION
71
+
```
72
+
73
+
The glibc version must match or exceed the version required by the Percona tarball.
74
+
75
+
76
+
??? example "Expected output"
77
+
78
+
```{.text .no-copy}
79
+
glibc 2.35
80
+
```
81
+
82
+
83
+
> 🧠 **Tip:** If the architecture or glibc version doesn't match, the binary may not run, and you could see errors like `wrong ELF class` or `version 'GLIBC_x.x' not found`.
84
+
85
+
The following example downloads Percona Server for MySQL {{release}} packages for Ubuntu 22.04 on a AMD64 server:
# Apt pinning the Percona Server for MySQL {{vers}} packages
2
2
3
-
Pinning allows you to stay on a release and get packages from a different version. In some cases, you can pin selected packages and avoid accidentally upgrading all the packages.
3
+
Apt pinning helps you control which version of a package is installed from different repositories. This is useful when you want to stay on a specific release such as Percona Server for MySQL 8.4 and avoid automatic upgrades from other sources.
4
4
5
-
The pinning takes place in the `preference` file. To pin a package, set the `Pin-Priority` to higher numbers.
6
-
7
-
Make a new file `/etc/apt/preferences.d/00percona.pref`. For example, add the following to the `preference` file:
5
+
To pin the Percona Server for MySQL 8.4 packages, follow these steps:
6
+
{.power-number}
8
7
9
-
```text
10
-
Package:
11
-
Pin: release o=Percona Development Team
12
-
Pin-Priority: 1001
13
-
```
8
+
1. Create a preferences file in `/etc/apt/preferences.d/` named `00percona.pref`:
14
9
15
-
For more information about the pinning, you can check the official [debian wiki](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
10
+
```{.bash data-prompt="$"}
11
+
$ sudo nano /etc/apt/preferences.d/00percona.pref
12
+
```
13
+
14
+
2. Add the pinning configuration content to the file:
15
+
16
+
```ini
17
+
Package: percona-server-server
18
+
Pin: release o=Percona Development Team,a=stable
19
+
Pin-Priority: 1001
20
+
```
21
+
22
+
* The `Package` field specifies the exact name of the package.
23
+
* The `Pin` field identifies the origin of the package, which is the Percona repository.
24
+
* The `Pin-Priority` field sets the priority level. A value above 1000 ensures this version is preferred over others.
25
+
26
+
Save and close the file.
27
+
28
+
3. Update package lists to refresh your package sources:
29
+
30
+
```{.bash data-prompt="$"}
31
+
$ sudo apt update
32
+
```
33
+
34
+
4. Install Percona Server for MySQL 8.4 using the following command:
35
+
36
+
```{.bash data-prompt="$"}
37
+
$ sudo apt install percona-server-server
38
+
```
39
+
40
+
Your system prioritizes the version from the Percona repository according to your pinning settings.
41
+
42
+
## Learn more
43
+
44
+
For additional details, visit the [debian wiki](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
# Use an APT repository to install Percona Server for MySQL {{vers}}
1
+
# Install Percona Server for MySQL {{vers}} Using APT on Debian/Ubuntu
2
2
3
-
Ready-to-use packages are available from the Percona Server for MySQL software
4
-
repositories and the [Percona downloads] page.
3
+
Percona provides ready-to-use packages for Percona Server for MySQL 8.4 through its APT repositories, offering seamless updates and dependency resolution for Debian-based systems.
5
4
6
-
Specific information on the supported platforms, products, and versions is described in [Percona Software and Platform Lifecycle](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
5
+
If you need help with installation or configuration, [Percona Support](https://www.percona.com/services/support) is available to assist you.
6
+
7
+
Specific information on the supported platforms, products, and versions are available in [Percona Software and Platform Lifecycle](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
8
+
9
+
Percona packages and Docker images collect anonymous telemetry data to improve product quality. For details on what is collected and how to opt out, see [Telemetry in Percona Server for MySQL].
7
10
8
-
We gather [Telemetry data] in the Percona packages and Docker images.
9
11
10
-
--8<--- "get-help-snip.md"
11
12
12
13
## ARM support
13
14
14
-
The DEB builds for Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04, DEBIAN 11, and DEBIAN 12 contain ARM packages with the `aarch64.rpm` extension. This means that Percona Server for MySQL is available for users on ARM-based systems.
15
+
Percona Server for MySQL 8.4 includes native support for the ARM64 (aarch64) architecture in its DEB packages. These packages are available for Ubuntu starting with version 20.04 and for Debian starting with version 11.
16
+
15
17
16
18
## Install Percona Server for MySQL using APT
17
19
18
20
To install Percona Server for MySQL using APT, do the following steps:
19
21
{.power-number}
20
22
21
-
1. Update the package repositories:
23
+
1. Update the package index and install `curl`:
22
24
23
25
```{.bash data-prompt="$"}
24
-
$ sudo apt update
26
+
$ sudo apt update && sudo apt install curl
25
27
```
26
28
27
-
2. Install the `curl` download utility if needed:
28
-
29
-
```{.bash data-prompt="$"}
30
-
$ sudo apt install curl
31
-
```
32
-
33
-
3. Download the `percona-release` repository package:
29
+
2. Download the `percona-release` repository package:
7.You can check the repository setup for the Percona original release list in `/etc/apt/sources.list.d/percona-original-release.list`.
54
+
6.[Optional]You can check the repository setup for the Percona original release list in ```cat /etc/apt/sources.list.d/percona-original-release.list```.
60
55
61
-
8. Install the server package with the `percona-release` command:
56
+
8. Install the server:
62
57
63
58
```{.bash data-prompt="$"}
64
59
$ sudo apt install percona-server-server
@@ -68,7 +63,7 @@ See [Configuring Percona repositories with `percona-release`](https://docs.perco
68
63
69
64
--8<--- "storage-engines.md"
70
65
71
-
Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit](https://docs.percona.com/percona-toolkit/). These UDFs, `fnv_64`, `fnv1a_64`, `murmur_hash`, offer faster checksum calculations compared to standard methods. For detailed information about these user-defined functions, see[Percona Toolkit UDF functions](udf-percona-toolkit.md).
66
+
Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit](https://docs.percona.com/percona-toolkit/) for faster checksum calculations. Learn more in[Percona Toolkit UDF functions](udf-percona-toolkit.md).
72
67
73
68
Once the installation completes, execute the following command to install these functions:
74
69
@@ -89,4 +84,4 @@ These builds should not be run in production. This build may not contain all of
0 commit comments