Skip to content

Commit

Permalink
Merge pull request #382 from percona/ps-9367
Browse files Browse the repository at this point in the history
PS-9367 Update installation commands for 8.4
  • Loading branch information
patrickbirch authored Aug 29, 2024
2 parents 3921b8b + 8e4acb3 commit 61081fc
Show file tree
Hide file tree
Showing 6 changed files with 12 additions and 38 deletions.
8 changes: 1 addition & 7 deletions docs/additional-selinux-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,7 @@

## Installing SELinux management tools

To install SELinux management tools on RHEL 7, use the following command as root:

```{.bash data-prompt="$"}
$ yum -y install policycoreutils-python
```

On RHEL 8, utilize the following command as root:
To install SELinux management tools on Red Hat Enterprise Linux 8 or later, run the following command as root:

```{.bash data-prompt="$"}
$ yum -y install policycoreutils-python-utils
Expand Down
12 changes: 7 additions & 5 deletions docs/apt-repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ Specific information on the supported platforms, products, and versions is descr

We gather [Telemetry data] in the Percona packages and Docker images.

## ARM support

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.

## Install Percona Server for MySQL using APT

To install Percona Server for MySQL using APT, do the following steps:
Expand Down Expand Up @@ -62,14 +66,12 @@ See [Configuring Percona repositories with `percona-release`](https://docs.perco

--8<--- "storage-engines.md"

Percona Server for MySQL contains user-defined functions from [Percona Toolkit](https://docs.percona.com/percona-toolkit/). These user-defined functions provide faster checksums. For more details on the user-defined functions, see [Percona Toolkit UDF functions](udf-percona-toolkit.md).
Percona Server for MySQL contains user-defined functions from [Percona Toolkit](https://docs.percona.com/percona-toolkit/). These user-defined functions, `fnv_64`, `fnv1a_64`, `murmur_hash`, provide faster checksums. For more details on the user-defined functions, see [Percona Toolkit UDF functions](udf-percona-toolkit.md).

After the installation completes, run the following commands to create these functions:
After the installation completes, run the following command to create these functions:

```mysql
mysql -e "CREATE FUNCTION fnv1a_64 RETURNS INTEGER SONAME 'libfnv1a_udf.so'"
mysql -e "CREATE FUNCTION fnv_64 RETURNS INTEGER SONAME 'libfnv_udf.so'"
mysql -e "CREATE FUNCTION murmur_hash RETURNS INTEGER SONAME 'libmurmur_udf.so'"
mysql -e "INSTALL COMPONENT 'file://component_percona_udf'"
```

## Install the Percona Testing repository using APT
Expand Down
8 changes: 1 addition & 7 deletions docs/selinux.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ The SELinux policy for MySQL ensures that the MySQL server process operates with

## Compatibility of Percona Server for MySQL with SELinux Policies

Percona Server for MySQL is a drop-in replacement for MySQL that offers enhanced performance, scalability, and other features. When running Percona Server for MySQL on Red Hat Enterprise Linux (RHEL) 7, RHEL 8, RHEL 9, or their derivatives, compatibility with SELinux policies is essential for ensuring secure and reliable operation.
Percona Server for MySQL is a drop-in replacement for MySQL that offers enhanced performance, scalability, and other features. When running Percona Server for MySQL on Red Hat Enterprise Linux (RHEL) 8, RHEL 9, or their derivatives, compatibility with SELinux policies is essential for ensuring secure and reliable operation.

Percona Server for MySQL is designed to be compatible with SELinux policies on these Linux distributions. This means that Percona Server for MySQL can seamlessly integrate with SELinux, allowing administrators to enforce security policies and restrictions without sacrificing the functionality or performance of the database server.

Expand Down Expand Up @@ -179,12 +179,6 @@ On boot, to disable SELinux, set the `selinux=0` kernel option. The kernel does

Install the SELinux management tools, such as `semanage` or `sesearch`, if needed.

On RHEL 7 or compatible operating systems, use the following command as root:

```{.bash data-prompt="$"}
$ yum -y install policycoreutils-python
```

On RHEL 8 or compatible operating systems, use the following command as root:

```{.bash data-prompt="$"}
Expand Down
18 changes: 1 addition & 17 deletions docs/yum-repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,24 +20,9 @@ Percona Server for MySQL is certified for Red Hat Enterprise Linux 8. This certi

The RPM builds for *RHEL* 8 and *RHEL* 9 contain ARM packages with the `aarch64.rpm` extension. This means that Percona Server for MySQL is available for users on ARM-based systems.

## Limitations

The RPM packages for Red Hat Enterprise Linux 7 and the compatible derivatives do not support TLSv1.3, as it requires OpenSSL 1.1.1, which is currently not available on this platform.

## Install

Install from Percona Software Repository
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.

=== "Install on Red Hat 7"

```{.bash data-prompt="$"}
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
$ sudo percona-release enable-only {{pkg}} release
$ sudo percona-release enable tools release
$ sudo yum install percona-server-server
```
=== "Install on Red Hat 8 or later"
To install using the Percona Software repository, run the following commands either as a `root` user or, as in the example, using `sudo`.

```{.bash data-prompt="$"}
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
Expand All @@ -59,6 +44,5 @@ set both `percona-testing-$basearch` and `percona-testing-noarch`
to `enabled = 1` (Note that there are three sections in this file:
release, testing, and experimental - in this case, it is the second section that requires updating).

You must install the Percona repository first if the installation has not been done already.

[Telemetry data]: telemetry.md
2 changes: 1 addition & 1 deletion snippets/storage-engines.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@

Percona Server for MySQL 8.2 comes with the MyRocks storage engine. This storage engine is installed as a plugin. For information on installing and configuring MyRocks, refer to the [Percona MyRocks Installation Guide](install-myrocks.md).
Percona Server for MySQL 8.4.x comes with the MyRocks storage engine. This storage engine is installed as a plugin. For information on installing and configuring MyRocks, refer to the [Percona MyRocks Installation Guide](install-myrocks.md).
2 changes: 1 addition & 1 deletion variables.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
release: '8.4.0-1'
version: '8.4'
vers: '8.4' # we are going to use it instead of version
pkg: '84'
pkg: 'ps-84-lts'
release_date: '2024-08-28'
title_date: '2024-08-28'

0 comments on commit 61081fc

Please sign in to comment.