Installation

MariaDB Enterprise Server deployment methods include:

Method

Benefit

Binary Tarball

Uses in-house tooling, allows for in-house packaging and signing

Package Tarball

Allows import of MariaDB packages to local repository

Repository

Direct retrieval from MariaDB delivery infrastructure

Repository Mirror

Local copy of MariaDB package repository

MariaDB SkySQL

Installation-free deployment on expert-maintained cloud

Installation from Binary Tarball

MariaDB Corporation provides binary tarballs (bintar files) to support customers who leverage in-house tooling or produce in-house repositories or system images to distribute software to their servers.

Steps to download a binary tarball:

  1. Retrieve your access token at https://customers.mariadb.com/downloads/token/ and substitute for TOKEN in the following directions.

  2. Identify the download path of the desired file from the single-file download interface at https://dlm.mariadb.com/browse/mariadb_enterprise_server/ and substitute for FILE in the following directions. For example: mariadb-enterprise-server/10.4.6-1/bintar-ubuntu-1604/checksums/sha1sums.txt.asc

  3. Download the file using a web browser, or with command-line tools using your access token:

    $ wget https://dlm.mariadb.com/TOKEN/FILE
    $ curl -LO https://dlm.mariadb.com/TOKEN/FILE
    
  4. Validate cryptographic sums or signatures for the downloaded file after downloading the associated SHA sums (sha256sums.txt, sha512sums.txt) or GPG signatures (.asc files).

Secure system image storage and repositories to prevent outside access.

Installation from binary tarball requires you to account for steps typically handled by the package manager, including:

  • Copying of files to desired locations

  • File ownership

  • File permissions

  • Configuration of system policies, if applicable

  • Rebuild of OS caches

  • Execution of mariadb-install-db to initialize the data directory and perform hardening actions

Note: Installation results in the load of software to the system. This software requires configuration before the database server is ready for use. See Configuration.

Installation from Package Tarball

MariaDB Corporation provides package tarballs (.debs.tar, .rpms.tar) to support customers who leverage in-house package repositories to distribute software to their servers. Secure any such repository to prevent outside access.

Steps to download a package tarball:

  1. Go to the MariaDB Downloads page at https://mariadb.com/downloads/#mariadb_platform-enterprise_server

  2. Complete customer login

  3. Select the desired version and operating system, then click the Download button

Package tarballs download may alternately occur in the same manner as binary tarballs (as detailed in Installation from Binary Tarball).

Once downloaded and extracted, you may:

  • Install .rpm packages (RHEL/CentOS) using rpm -i

  • Install .deb packages (Debian/Ubuntu) using dpkg -i

  • Install from the simple package repositories included in the tarball using apt or yum, allowing the package manager to resolve missing dependencies. See the README file enclosed in the package tarball for more information.

  • Test packages before placement in an internal package repository for distribution to your servers. Secure this repository from outside access.

Note: Installation results in the load of software to the system. This software requires configuration before the database server is ready for use. See Configuration.

Installation from Repository

MariaDB Corporation provides APT (Debian/Ubuntu) and YUM (RHEL/CentOS) package repositories to enable customers to install MariaDB Enterprise Server.

Steps to installing from repository:

  1. Retrieve your access token and configure repositories. If using MariaDB repositories, use mariadb_es_repo_setup to perform repository configuration.

  2. Refresh the package cache, if necessary.

  3. Install MariaDB Enterprise Server using APT (Debian/Ubuntu) or YUM (RHEL/CentOS).

Note: Installation results in the load of software to the system. This software requires configuration before the database server is ready for use. See Configuration.

Install via APT (Debian/Ubuntu)

Retrieve your access token at https://customers.mariadb.com/downloads/token/ and substitute for customer_access_token in the following directions.

Installable versions of MariaDB Enterprise Server are 10.4, 10.3, and 10.2. Pass the version to install using the --mariadb-server-version flag to mariadb_es_repo_setup. The following directions reference 10.4.

# apt install wget

$ wget https://dlm.mariadb.com/enterprise-release-helpers/mariadb_es_repo_setup

$ echo "c288dcad9557d54505dcd5aa97c0509cfa050c2c97221ad290936e744e8c29d8  mariadb_es_repo_setup" \
    | sha256sum -c -

$ chmod +x mariadb_es_repo_setup

# ./mariadb_es_repo_setup --token="customer_access_token" --apply \
   --mariadb-server-version="10.4"

# apt update

# apt install mariadb-server mariadb-backup

To install MariaDB Enterprise Cluster: apt install galera-enterprise-4

Note: Installation results in the load of software to the system. This software requires configuration before the database server is ready for use. See Configuration.

Install via YUM (RHEL/CentOS)

Retrieve your access token at https://customers.mariadb.com/downloads/token/ and substitute for customer_access_token in the following directions.

Installable versions of MariaDB Enterprise Server are 10.4, 10.3, and 10.2. Pass the version to install using the --mariadb-server-version flag to mariadb_es_repo_setup. The following directions reference 10.4.

# yum install wget

$ wget https://dlm.mariadb.com/enterprise-release-helpers/mariadb_es_repo_setup

$ echo "c288dcad9557d54505dcd5aa97c0509cfa050c2c97221ad290936e744e8c29d8  mariadb_es_repo_setup" \
    | sha256sum -c -

$ chmod +x mariadb_es_repo_setup

# ./mariadb_es_repo_setup --token="customer_access_token" --apply \
   --mariadb-server-version="10.4"

# yum install MariaDB-server MariaDB-backup

To install MariaDB Enterprise Cluster: yum install galera-enterprise-4

Note: Installation results in the load of software to the system. This software requires configuration before the database server is ready for use. See Configuration.

Creating a Repository Mirror

MariaDB Platform repository mirroring enables you to distribute MariaDB software to your servers from a local repository you support. Secure any such repository mirror to prevent outside access.

  1. Retrieve your Repository Configuration (as detailed in Operating Procedures).

  2. Set up a repository mirroring tool, for example:

  3. Secure the repository mirror to prevent outside access.

  4. Configure your servers to use your repository mirror, and use apt or yum to install packages:

    # apt install mariadb-server mariadb-backup
    # yum install MariaDB-server MariaDB-backup
    
    # yum install galera-enterprise-4
    # apt install galera-enterprise-4
    

Deployment with MariaDB SkySQL

MariaDB SkySQL delivers MariaDB Platform, including MariaDB Enterprise Server, on expert-maintained cloud infrastructure from MariaDB Corporation.

This service is available to select customers during a closed beta. When this service becomes generally-available, it may be accessed at: