Step 4: Install MariaDB MaxScale

Overview

This page details step 4 of the 6-step procedure "Deploy Galera Cluster Topology".

This step installs MariaDB MaxScale.

MariaDB Enterprise Cluster requires 1 or more MaxScale nodes.

Interactive commands are detailed. Alternatively, the described operations can be performed using automation.

Retrieve Customer Download Token

MariaDB Corporation provides package repositories for YUM (RHEL / CentOS), APT (Debian / Ubuntu), and ZYpp (SLES). A download token is required to access the MariaDB Enterprise Repository.

Customer Download Tokens are customer-specific and are available through the MariaDB Customer Portal.

To retrieve the token for your account:

  1. Navigate to https://customers.mariadb.com/downloads/token/

  2. Log in.

  3. Copy the Customer Download Token.

Substitute your token for CUSTOMER_DOWNLOAD_TOKEN when configuring the package repositories.

Set Up Repository

  1. On the MaxScale node, install the prerequisites for downloading the software from the Web.

    Install on CentOS / RHEL (YUM):

    $ sudo yum install curl
    

    Install on Debian / Ubuntu (APT):

    $ sudo apt install curl apt-transport-https
    

    Install on SLES (ZYpp):

    $ sudo zypper install curl
    
  2. On the MaxScale node, configure package repositories and specify MariaDB MaxScale 2.5:

    $ curl -LsSO https://dlm.mariadb.com/enterprise-release-helpers/mariadb_es_repo_setup
    
    $ echo "97e5ef25b4c4a4bd70b30da46b1eae0b57db2f755ef820a28d254e902ab5a879  mariadb_es_repo_setup" \
           | sha256sum -c -
    
    $ chmod +x mariadb_es_repo_setup
    
    $ sudo ./mariadb_es_repo_setup --token="CUSTOMER_DOWNLOAD_TOKEN" --apply \
          --skip-server \
          --skip-tools \
          --mariadb-maxscale-version="2.5"
    

Install MaxScale

On the MaxScale node, install MariaDB MaxScale.

Install on CentOS / RHEL (YUM):

$ sudo yum install maxscale

Install on Debian / Ubuntu (APT):

$ sudo apt install maxscale

Install on SLES (ZYpp):

$ sudo zypper install maxscale

Next Step

Navigation in the procedure "Deploy Galera Cluster Topology":

  • This page was step 4 of 6.