Skip to content
logo
Percona XtraDB Cluster
Install Percona XtraDB Cluster on Debian or Ubuntu
Initializing search
    percona/pxc-docs
    percona/pxc-docs
    • Home
      • About Percona XtraDB Cluster
      • Percona XtraDB Cluster limitations
      • Understand version numbers
      • Quick start guide for Percona XtraDB Cluster
      • Install Percona XtraDB Cluster
      • Configure nodes for write-set replication
      • Bootstrap the first node
      • Add nodes to cluster
      • Verify replication
      • High availability
      • PXC strict mode
      • Online schema upgrade
      • Non-Blocking Operations (NBO) method for Online Scheme Upgrades (OSU)
      • Security basics
      • Secure the network
      • Encrypt PXC traffic
      • Enable AppArmor
      • Enable SELinux
      • State snapshot transfer
      • Percona XtraBackup SST configuration
      • Restart the cluster nodes
      • Cluster failover
      • Monitor the cluster
      • Certification in Percona XtraDB Cluster
      • Percona XtraDB Cluster threading model
      • Understand GCache and Record-Set cache
      • GCache encryption and Write-Set cache encryption
      • Perfomance Schema instrumentation
      • Data at Rest Encryption
      • Upgrade Percona XtraDB Cluster
      • Crash recovery
      • Configure Percona XtraDB Cluster on CentOS
      • Configure Percona XtraDB Cluster on Ubuntu
      • Set up Galera arbitrator
      • How to set up a three-node cluster on a single box
      • How to set up a three-node cluster in EC2 environment
      • Load balancing with HAProxy
      • Load balancing with ProxySQL
      • ProxySQL admin utilities
      • Setting up a testing environment with ProxySQL
      • Release notes index
      • Percona XtraDB Cluster 8.0.31-23 (2023-03-14)
      • Percona XtraDB Cluster 8.0.30-22.md (2022-12-28)
      • Percona XtraDB Cluster 8.0.29-21 (2022-09-12)
      • Percona XtraDB Cluster 8.0.28-19.1 (2022-07-19)
      • Percona XtraDB Cluster 8.0.27-18.1
      • Percona XtraDB Cluster 8.0.26-16.1
      • Percona XtraDB Cluster 8.0.25-15.1
      • Percona XtraDB Cluster 8.0.23-14.1
      • Percona XtraDB Cluster 8.0.22-13.1
      • Percona XtraDB Cluster 8.0.21-12.1
      • Percona XtraDB Cluster 8.0.20-11
      • Percona XtraDB Cluster 8.0.20-11.3
      • Percona XtraDB Cluster 8.0.20-11.2
      • Percona XtraDB Cluster 8.0.19-10
      • Percona XtraDB Cluster 8.0.18-9.3
      • Index of wsrep status variables
      • Index of wsrep system variables
      • Index of wsrep_provider options
      • Index of files created by PXC
      • Frequently asked questions
      • Glossary
      • Copyright and licensing information
      • Trademark policy

    • Prerequisites
    • Install from Repository
    • Next steps

    Install Percona XtraDB Cluster on Debian or Ubuntu¶

    Specific information on the supported platforms, products, and versions is described in Percona Software and Platform Lifecycle.

    The packages are available in the official Percona software repository and on the download page. It is recommended to install Percona XtraDB Cluster from the official repository using apt.

    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.

    Install from Repository¶

    1. Update the sytem:

      sudo apt update
      
    2. Install the necessary packages:

      sudo apt install -y wget gnupg2 lsb-release curl
      
    3. Download the 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 release repository for Percona XtraDB Cluster:

      sudo percona-release setup pxc80
      
    7. Install the cluster:

      sudo apt install -y percona-xtradb-cluster
      

    During the installation, you are requested to provide a password for the root user on the database node.

    Note

    If needed, you could also install the percona-xtradb-cluster-full meta-package, which includes the following additional packages:

    • libperconaserverclient21

    • libperconaserverclient21-dev

    • percona-xtradb-cluster

    • percona-xtradb-cluster-client

    • percona-xtradb-cluster-common

    • percona-xtradb-cluster-dbg

    • percona-xtradb-cluster-full

    • percona-xtradb-cluster-garbd

    • percona-xtradb-cluster-garbd-debug

    • percona-xtradb-cluster-server

    • percona-xtradb-cluster-server-debug

    • percona-xtradb-cluster-source

    • percona-xtradb-cluster-test

    Next steps¶

    After you install Percona XtraDB Cluster and stop the mysql service, configure the node according to the procedure described in Configuring Nodes for Write-Set Replication.

    Contact us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.


    Last update: 2023-01-20
    Percona LLC and/or its affiliates, © 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.