Setting up and using the MariaDB Package Repository
Overview
A convenient shell script to set up MariaDB repositories is available at https://downloads.mariadb.com/MariaDB/mariadb_repo_setup. It can be executed like this:
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
The script supports GNU/Linux operating systems officially supported under MariaDB Enterprise subscriptions (though a MariaDB Enterprise subscription is not required to use the repository). As of May 2017, these include:
- Red Hat Enterprise Linux (RHEL)/CentOS 6 and 7
- Debian 7 (wheezy) and 8 (jessie)
- Ubuntu 14.04 LTS (trusty) and 16.04 LTS (xenial)
- SUSE Linux Enterprise Server (SLES) 12
The script will will set up 3 packages repositories in a single repository definition file:
- MariaDB Server/Cluster
- MariaDB MaxScale
- a tools repository that includes Percona XtraBackup and its dependencies
The script will also install trusted keys used to sign MariaDB software packages (see --skip-key-import below if you want to avoid that behavior).
If you want to see the repository file that will be created without needing to run the script as root, use the --write-to-stdout option.
Options
To provide options to the script, you must tell bash to expect them by executing bash with the options -s --, like this:
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash -s -- --help
| Option | Description |
|---|---|
--help | Display a usage message and exit. |
--mariadb-server-version=<version> | Override the default MariaDB Server version. By default, the script will use 'mariadb-10.1'. |
--mariadb-maxscale-version=<version> | Override the default MariaDB MaxScale version. By default, the script will use 'latest'. |
--skip-key-import | Skip importing GPG signing keys. |
--skip-server | Skip the 'MariaDB Server' repository. |
--skip-maxscale | Skip the 'MaxScale' repository. |
--skip-tools | Skip the 'Tools' repository. |
--write-to-stdout | Write output to stdout instead of to the OS's repository configuration. This will also skip importing GPG keys and updating the package cache on platforms where that behavior exists. |
--mariadb-server-version
By default, the repository will be set up to install the latest GA version of MariaDB Server/Cluster at the time you run the script, currently MariaDB Server/Cluster 10.1. If a new major GA release occurs, you will need to manually edit the repository definition, or fetch and run the mariadb_repo_setup script again.
The MariaDB Server/Cluster version used can be specified using the --mariadb-server-version option to the script. To specify a different version of MariaDB Server/Cluster, use --mariadb-server-version, prepending mariadb- to the version number you want, for example mariadb-10.2.
Major versions mariadb-5.5, mariadb-galera-5.5, mariadb-10.0, mariadb-galera-10.0, mariadb-10.1, and mariadb-10.2 are supported. You can also specify a specific minor version, such as mariadb-5.5.55, if you don't want upgrades for automatic security fixes (this is not recommended).
MariaDB until 10.0
Galera Cluster is included in the standard MariaDB Server packages from 10.1, but for previous versions, you must explicitly specify that you want to use the "galera" repository. Do this by setting --mariadb-server-version to either mariadb-galera-5.5 or mariadb-galera-10.0.
--mariadb-maxscale-version
By default, the repository will be set up to install the latest GA version of MariaDB MaxScale. If a new version of MaxScale is released after you create the repository, your package manager will automatically upgrade you to that new GA version. In some cases, this can introduce incompatibilities; please consult the MaxScale release notes for more information.
Examples
To set up the MariaDB Repository to install MariaDB Server 10.0, execute mariadb_repo_setup like this:
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash -s -- --mariadb-server-version=mariadb-10.0
