Skip to content
Merged
Show file tree
Hide file tree
Changes from all 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
File renamed without changes.
19 changes: 19 additions & 0 deletions archive-docs/legacy-platforms.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Legacy Platform Information - Red Hat Enterprise Linux 7

## Limitations

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

**Note:** Red Hat Enterprise Linux 7 reached End of Life (EOL) on June 30, 2024. This information is archived for historical reference.

## Install on Red Hat 7

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.

```{.bash data-prompt="$"}
$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
$ sudo percona-release enable-only ps-80 release
$ sudo percona-release enable tools release
$ sudo yum install percona-server-server
```

File renamed without changes.
File renamed without changes.
File renamed without changes.
46 changes: 30 additions & 16 deletions docs/apt-repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,20 @@ Starting with [Percona Server 8.0.37-29](release-notes/8.0.37-29.md), the follow

## Install Percona Server for MySQL using APT

Run the following commands as a `root` user or with sudo:

```{.bash}
sudo apt update
sudo apt install curl
curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb
sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb
sudo apt update
sudo percona-release setup ps80
sudo apt install percona-server-server
```

The following sections provide detailed explanations for each step:

1. This command line instruction uses the `apt` command to update the package lists for upgrades and new package installations.

* `sudo` is a command that allows you to run programs with the security privileges of another user, by default, as the superuser. Updating the package lists typically requires superuser or 'root' privileges.
Expand All @@ -34,50 +48,50 @@ Starting with [Percona Server 8.0.37-29](release-notes/8.0.37-29.md), the follow
* `update` option resynchronizes the package index files from the sources specified in the system's `sources.list` file. You should run this command regularly to get the latest package updates.


```{.bash data-prompt="$"}
$ sudo apt update
```{.bash}
sudo apt update
```

2. This command line instruction uses superuser privileges to install the `curl` package using the `apt` package manager. `curl` is a command-line tool used to transfer data using various network protocols.

```{.bash data-prompt="$"}
$ sudo apt install curl
```{.bash}
sudo apt install curl
```

3. This command line instruction uses `curl` to download the `percona-release_latest.generic_all.deb` file from the `https://repo.percona.com/apt` location.

The `-0` option saves the downloaded file with the same name used in the URL.

```{.bash data-prompt="$"}
$ curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb
```{.bash}
curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb
```

4. The following command uses the `apt` command to install multiple packages. `gnupg2` is the GNU Privacy Guard that provides cryptographic privacy and authentication. `lsb-release` is a Linux utility that provides certain Linux Standard Base (LSB) and distribution-specific information. `./percona-release_latest.generic_all.deb` is a Debian package in the current directory.


```{.bash data-prompt="$"}
$ sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb
```{.bash}
sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb
```


5. The following command uses superuser privileges to update the package lists from the repositories so that the system knows about the latest versions of packages and their dependencies.

```{.bash data-prompt="$"}
$ sudo apt update
```{.bash}
sudo apt update
```

6. This command line instruction uses `percona-release` command, a tool provided by Percona, to set up a specific Percona Server version.

```{.bash data-prompt="$"}
$ sudo percona-release setup ps80
```{.bash}
sudo percona-release setup ps80
```

7. You can check the repository setup for the Percona original release list in `/etc/apt/sources.list.d/percona-original-release.list`. The APT system uses this file to know where to find updates and new packages for Percona software.

8. This command uses the `apt` command to install the `percona-server-server` package.

```{.bash data-prompt="$"}
$ sudo apt install percona-server-server
```{.bash}
sudo apt install percona-server-server
```

See [Configuring Percona repositories with `percona-release`](https://docs.percona.com/percona-software-repositories/percona-release.html) for more information.
Expand All @@ -99,8 +113,8 @@ mysql -e "CREATE FUNCTION murmur_hash RETURNS INTEGER SONAME 'libmurmur_udf.so'"

Percona offers pre-release builds from the testing repository. As a superuser, run `percona-release` with the `testing` argument to enable it.

```{.bash data-prompt="$"}
$ sudo percona-release enable ps80 testing
```{.bash}
sudo percona-release enable ps80 testing
```

Do not run testing repository builds in production. The build may not contain all the features available in the final release and may change without notice.
Expand Down
4 changes: 2 additions & 2 deletions docs/binary-tarball-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,12 @@ Fetch and extract the correct binary tarball. For example, for Debian 10:
$ wget https://downloads.percona.com/downloads/Percona-Server-8.0/Percona-Server-8.0.26-16/binary/tarball/Percona-Server-8.0.26-16-Linux.x86_64.glibc2.12.tar.gz
```

## Install Percona Server for MySQL Pro from a binary tarball
<!-- ## Install Percona Server for MySQL Pro from a binary tarball

You can download the required binary tarball for Percona Server for MySQL Pro using your `CLIENTID` and `TOKEN` in the following link https://repo.percona.com/private/[CLIENTID]-[TOKEN]/ps-80-pro/tarballs/.

Fetch and extract the correct binary tarball using your `CLIENTID` and `TOKEN`. For example, for Oracle Linux 9:

```{.bash data-prompt="$"}
wget https://repo.percona.com/private/[CLIENTID]-[TOKEN]/ps-80-pro/tarballs/Percona-Server-{{pro_release}}/Percona-Server-Pro-{{pro_release}}-Linux.x86_64.glibc2.34-debug.tar.gz
```
``` -->
3 changes: 2 additions & 1 deletion docs/binary-tarball-names.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ If the `glibc2` version from your operating system is not listed, then this Perc
| Debug | Percona-Server-&lt;version-number&gt;-Linux.x86_64.&lt;glibc2-version&gt;-debug.tar.gz | Contains the minimal build files and test files, and debug symbols |
| Zenfs | Percona-Server-&lt;version-number&gt;-Linux.x86_64.&lt;glibc2-version&gt;-zenfs.tar.gz | Contains the zenfs files and can be either a full or minimal installation |

=== "Pro builds"
<!-- === "Pro builds"

The following binary tarballs are available for Percona Server for MySQL Pro builds from version 8.0.35-27 and later.

Expand All @@ -60,6 +60,7 @@ If the `glibc2` version from your operating system is not listed, then this Perc
|---|---|---|
| Full | Percona-Server-Pro-&lt;version-number&gt;-Linux.x86_64.&lt;glibc2-version&gt;.tar.gz | Contains all files available |
| Minimal | Percona-Server-Pro&lt;version-number&gt;-Linux.x86_64.&lt;glibc2-version&gt;.minimal.tar.gz | Contains binaries and libraries |
-->

=== "Zenfs"

Expand Down
12 changes: 6 additions & 6 deletions docs/fips.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# FIPS compliance

Percona Server for MySQL Pro includes the [capabilities](psmysql-pro.md#capabilities) that are typically requested by large enterprises. Percona Server for MySQL Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription.
<!-- Percona Server for MySQL Pro includes the [capabilities](psmysql-pro.md#capabilities) that are typically requested by large enterprises. Percona Server for MySQL Pro contains packages created and tested by Percona. These packages are supported only for Percona Customers with a subscription. -->

[Become a Percona Customer](https://www.percona.com/about/contact){.md-button}
<!-- [Become a Percona Customer](https://www.percona.com/about/contact){.md-button} -->


Introduced in Percona Server for MySQL Pro 8.0.35-27, Percona Server for MySQL Pro implements the same level of FIPS support as MySQL. Percona Server for MySQL can run in FIPS mode if a FIPS-enabled OpenSSL library and FIPS Object Module are available at runtime or if compiled using a FIPS-validated version of OpenSSL. You can also receive this functionality by [building Percona Server for MySQL from source code](compile-percona-server.md).
<!-- Introduced in Percona Server for MySQL Pro 8.0.35-27, Percona Server for MySQL Pro implements the same level of FIPS support as MySQL. --> Percona Server for MySQL can run in FIPS mode if a FIPS-enabled OpenSSL library and FIPS Object Module are available at runtime or if compiled using a FIPS-validated version of OpenSSL. You can also receive this functionality by [building Percona Server for MySQL from source code](compile-percona-server.md).

The Federal Information Processing Standards (FIPS) are a set of regulations mandated by the United States government that ensure the security of computer systems for non-military government agencies and their contractors. These standards specify how to perform cryptographic operations, such as encryption, hashing, and digital signatures. FIPS mode is a mode of operation that enforces these standards and rejects any non-compliant algorithms or parameters.

Expand All @@ -29,7 +29,7 @@ To prepare Percona Server for MySQL for FIPS certification, do the following:

If you enable FIPS on Ubuntu Pro with `$ sudo pro enable fips-updates` and then disable FIPS with `$ sudo pro disable fips-updates`, Percona Server for MySQL may stop operating properly. For example, if you disable FIPS on Ubuntu Pro with `$ sudo pro disable fips-updates` and enable the FIPS mode on Percona Server with `ssl-fips-mode=ON`, Percona Server may not load the SSL certificate.

* Deploy [Percona Server for MySQL from the Pro build](psmysql-pro.md), which is built and tested on operating systems with FIPS pre-approved OpenSSL packages.
<!-- * Deploy [Percona Server for MySQL from the Pro build](psmysql-pro.md), which is built and tested on operating systems with FIPS pre-approved OpenSSL packages. -->

## The FIPS mode variables

Expand Down Expand Up @@ -69,13 +69,13 @@ To ensure that the FIPS mode is enabled, do the following:
A FIPS-approved version of the OpenSSL cryptographic library has been detected in the operating system with a properly configured FIPS module available for loading. Percona Server for MySQL will load this module and run in FIPS mode.
```

## Next steps
<!-- ## Next steps

[Install Percona Server for MySQL Pro](install-pro.md){.md-button}

If you already use Percona Server for MySQL, you can

[Upgrade to Percona Server for MySQL Pro](upgrade-pro.md){.md-button}
[Upgrade to Percona Server for MySQL Pro](upgrade-pro.md){.md-button} -->



Expand Down
10 changes: 5 additions & 5 deletions docs/index-contents.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@
- [Differences between Percona MyRocks and Facebook MyRocks](differences.md)
- [Disable Audit Log Filter logging](disable-audit-log-filter.md)
- [Docker environment variables](docker-config.md)
- [Downgrade from Percona Server for MySQL Pro](downgrade-from-pro.md)
<!-- - [Downgrade from Percona Server for MySQL Pro](downgrade-from-pro.md) -->
- [Downgrade Percona Server for MySQL](downgrade.md)
- [Encrypt Binary Log Files and Relay Log Files](encrypting-binlogs.md)
- [Encrypt doublewrite buffers](encrypting-doublewrite-buffers.md)
Expand All @@ -56,7 +56,7 @@
- [Extended SHOW GRANTS](extended-show-grants.md)
- [Fast updates with TokuDB](fast-updates.md)
- [FIDO authentication plugin](fido-authentication-plugin.md)
- [Files in packages built for Percona Server for MySQL Pro](pro-files.md)
<!-- - [Files in packages built for Percona Server for MySQL Pro](pro-files.md) -->
- [Files in the DEB package built for Percona Server for MySQL 8.0](apt-files.md)
- [Files in the RPM package built for Percona Server for MySQL 8.0](yum-files.md)
- [Filter the Audit Log Filter logs](filter-audit-log-filter-files.md)
Expand All @@ -83,7 +83,7 @@
- [Install Percona Server for MySQL 8.0 from a binary tarball](binary-tarball-install.md)
- [Install Percona Server for MySQL 8.0 using downloaded DEB packages](apt-download-deb.md)
- [Install Percona Server for MySQL from a source tarball](source-tarball.md)
- [Install Percona Server for MySQL Pro](install-pro.md)
<!-- - [Install Percona Server for MySQL Pro](install-pro.md) -->
- [Install Percona Server for MySQL using downloaded RPM packages](yum-download-rpm.md)
- [Install the Audit Log Filter](install-audit-log-filter.md)
- [Install the data masking component](install-data-masking-component.md)
Expand Down Expand Up @@ -119,7 +119,7 @@
- [Percona Server for MySQL 8.0 - Documentation](index.md)
- [Percona Server for MySQL feature comparison](feature-comparison.md)
- [Percona Server for MySQL in-place upgrade guide: from 5.7 to 8.0](in-place-upgrade-guide.md)
- [Percona Server for MySQL Pro](psmysql-pro.md)
<!-- - [Percona Server for MySQL Pro](psmysql-pro.md) -->
- [Percona TokuBackup](toku-backup.md)
- [Percona Toolkit UDFs](udf-percona-toolkit.md)
- [Percona Tools that can help with an upgrade](upgrade-pt.md)
Expand Down Expand Up @@ -178,7 +178,7 @@
- [Upgrade from 5.7 to 8.0 overview](upgrade.md)
- [Upgrade from systems that use the MyRocks or TokuDB storage engine and partitioned tables](upgrade-tokudb-myrocks.md)
- [Upgrade strategies](upgrade-strategies.md)
- [Upgrade to Percona Server for MySQL Pro](upgrade-pro.md)
<!-- - [Upgrade to Percona Server for MySQL Pro](upgrade-pro.md) -->
- [Upgrade using Standalone Packages](upgrade-standalone-packages.md)
- [Upgrade using the Percona repositories](upgrade-percona-repos.md)
- [Use an APT repository to install Percona Server for MySQL 8.0](apt-repo.md)
Expand Down
6 changes: 3 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,11 @@ Find the best installation solution with our step-by-step installation instructi

</div><div data-banner markdown>

### :material-backup-restore: Percona Server for MySQL Pro { .title }
### :material-arrow-up: Upgrade instructions { .title }

Enjoy the benefits of Percona Server for MySQL Pro build.
Upgrade your Percona Server for MySQL installation with our comprehensive upgrade guides.

[Percona Server for MySQL Pro](psmysql-pro.md){ .md-button }
[Upgrade instructions](upgrade.md){ .md-button }

</div><div data-banner markdown>

Expand Down
8 changes: 4 additions & 4 deletions docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,13 @@ The following guides describe the installation procedures for using the official

* [Install Percona Server for MySQL on Red Hat Enterprise Linux and derivatives](yum-repo.md)

## Install Percona Server for MySQL Pro
<!-- ## Install Percona Server for MySQL Pro

[Install Percona Server for MySQL Pro](install-pro.md){.md-button}
[Install Percona Server for MySQL Pro](install-pro.md){.md-button} -->

## Upgrade to Percona Server for MySQL Pro
<!-- ## Upgrade to Percona Server for MySQL Pro

If you already use Percona Server for MySQL, you can [Upgrade to Percona Server for MySQL Pro](upgrade-pro.md)
If you already use Percona Server for MySQL, you can [Upgrade to Percona Server for MySQL Pro](upgrade-pro.md) -->

[Telemetry data]: telemetry.md
[Percona Software repositories and the percona-release tool]:percona-release.md
Expand Down
Loading
Loading