Install Percona XtraDB Cluster Pro

This document provides guidelines how to install Pro packages of Percona XtraDB Cluster from Percona repositories. Check files in packages built for Percona XtraDB Cluster Pro

Version changes

Percona XtraDB Cluster 8.0.41-32 Pro build is available for the Amazon Linux 2023 (AL2023) platform. We support both AMD64 and ARM64 versions of Amazon Linux 2023.

Prerequisites

• You need to have root access on the node where you will be installing Percona XtraDB Cluster (either logged in as a user with root privileges or be able to run commands with sudo).

• Make sure that the following ports are not blocked by firewall or used by other software. Percona XtraDB Cluster requires them for communication.

  • 3306

  • 4444

  • 4567

  • 4568

See also

For more information, see Enabling AppArmor.

Procedure

1. Request the access to the pro repository from Percona Support. You will receive the client ID and the access token which you use when downloading the packages.

2. Configure the repository and install Percona XtraDB Cluster packages

   On Debian or UbuntuOn RHEL or Amazon Linux 2023 or derivatives

   Use the following steps to install the PRO version of Percona XtraDB Cluster on Debian or Ubuntu.

   1. Use the apt package manager to dowload percona-release

      $ sudo apt update
      

   2. Install the necessary packages

      $ sudo apt install -y wget gnupg2 lsb-release curl
      

   3. Download the percona-release repository package

      $  wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
      

   4. Install the package with dpkg:

      $ sudo dpkg -i percona-release_latest.generic_all.deb
      

   5. Refresh the local cache to update the package information

      $ sudo apt update
      

   6. Enable the specific percona-release product.

      $ sudo percona-release setup pxc-80-pro --user_name=<Your PRO repository user name> --repo_token=<Your PRO repository token>
      

   7. Install the cluster:

      $ sudo apt install -y percona-xtradb-cluster-pro-80
      

   Install other required packages. Check files in the DEB package built for Percona XtraDB Cluster 8.0.

   RHEL 8 and other EL8 systems enable the MySQL module by default. This module hides the Percona-provided packages, and the module must be disabled to make these packages visible. The following command disables the module:

   $ sudo dnf module disable mysql
   

   Use the following commands to install on RHEL or derivatives.

   $ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
   $ sudo percona-release setup pxc-80-pro --user_name=<Your PRO repository user name> --repo_token=<Your PRO repository token>
   $ sudo yum install percona-xtradb-cluster-pro-80
   

After installation

After the installation, start the mysql service and find the temporary password using the grep command.

$ sudo service mysql start
$ sudo grep 'temporary password' /var/log/mysqld.log

Use the temporary password to log into the server:

$ mysql -u root -p

Run an ALTER USER statement to change the temporary password, exit the client, and stop the service.

mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'rootPass';
mysql> exit
$ sudo service mysql stop

Next step

Enable the FIPS mode