Step 7: Install MariaDB MaxScale

Overview

This page details step 7 of the 9-step procedure "Deploy Xpand Storage Engine Topology".

This step installs MaxScale.

The MaxScale node must meet requirements.

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). 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.

Repository Setup

MariaDB Corporation provides an Enterprise Repository for CentOS and RHEL to use to install MariaDB MaxScale with the YUM package manager.

This action is performed on the MaxScale node.

To configure YUM to use the MariaDB Enterprise Repository:

  1. Install the prerequisites for downloading the software from the Web:

    $ sudo yum install wget
    
  2. Configure package repositories and specify MariaDB MaxScale 2.5:

    $ wget https://dlm.mariadb.com/enterprise-release-helpers/mariadb_es_repo_setup
    
    $ echo "5feb2aac767c512cc9e2af674d1aef42df0b775ba2968fffa8700eb42702bd44  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

Install Maxscale using YUM from the MariaDB Enterprise Repository.

This action is performed on the MaxScale node.

To install MaxScale:

$ sudo yum install maxscale

Next Step

Navigation in the procedure "Deploy Xpand Storage Engine Topology":

  • This page was step 7 of 9.