On SLES, OpenSUSE, and other similar Linux distributions, it is highly recommended to install the relevant RPM packages from MariaDB's repository using zypper.
This page walks you through the simple installation steps using zypper.
We currently have ZYpp repositories for the following Linux distributions:
If you want to install MariaDB with zypper, then you can configure zypper to install from MariaDB Corporation's MariaDB Package Repository by using the MariaDB Package Repository setup script.
MariaDB Corporation provides a MariaDB Package Repository for several Linux distributions that use zypper to manage packages. This repository contains software packages related to MariaDB Server, including the server itself, clients and utilities, client libraries, plugins, and Mariabackup. The MariaDB Package Repository setup script automatically configures your system to install packages from the MariaDB Package Repository.
To use the script, execute the following command:
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
Note that this script also configures a repository for MariaDB MaxScale and a repository for MariaDB Tools, which currently only contains Percona XtraBackup and its dependencies.
See MariaDB Package Repository Setup and Usage for more information.
If you want to install MariaDB with zypper, then you can configure zypper to install from MariaDB Foundation's MariaDB Repository by using the MariaDB Repository Configuration Tool.
The MariaDB Foundation provides a MariaDB repository for several Linux distributions that use zypper to manage packages. This repository contains software packages related to MariaDB Server, including the server itself, clients and utilities, client libraries, plugins, and Mariabackup. The MariaDB Repository Configuration Tool can easily generate the appropriate commands to add the repository for your distribution.
For example, if you wanted to use the repository to install MariaDB 10.3 on SLES 15, then you could use the following commands to add the MariaDB zypper repository:
sudo zypper addrepo --gpgcheck --refresh https://yum.mariadb.org/10.3/sles/15/x86_64 mariadb sudo zypper --gpg-auto-import-keys refresh
If you wish to pin the zypper repository to a specific minor release, or if you would like to downgrade to a specific minor release, then you can create a zypper repository with the URL hard-coded to that specific minor release.
The MariaDB Foundation archives repositories of old minor releases at the following URL:
So if you can't find the repository of a specific minor release at yum.mariadb.org, then it would be a good idea to check the archive.
For example, if you wanted to pin your repository to MariaDB 10.3.14 on SLES 15, then you could use the following commands to add the MariaDB zypper repository:
sudo zypper removerepo mariadb sudo zypper addrepo --gpgcheck --refresh https://yum.mariadb.org/10.3.14/sles/15/x86_64 mariadb
MariaDB's zypper repository can be updated to a new major release. How this is done depends on how you originally configured the repository.
If you configured zypper to install from MariaDB Corporation's MariaDB Package Repository by using the MariaDB Package Repository setup script, then you can update the major release that the repository uses by running the script again.
If you configured zypper to install from MariaDB Foundation's MariaDB Repository by using the MariaDB Repository Configuration Tool, then you can update the major release that the repository uses by removing the repository for the old version and adding the repository for the new version.
First, you can remove the repository for the old version by executing the following command:
sudo zypper removerepo mariadb
After that, you can add the repository for the new version. For example, if you wanted to use the repository to install MariaDB 10.3 on SLES 15, then you could use the following commands to add the MariaDB zypper repository:
sudo zypper addrepo --gpgcheck --refresh https://yum.mariadb.org/10.3/sles/15/x86_64 mariadb sudo zypper --gpg-auto-import-keys refresh
After that, the repository should refer to MariaDB 10.3.
Before MariaDB can be installed, you also have to import the GPG public key that is used to verify the digital signatures of the packages in our repositories. This allows the the zypper and rpm utilities to verify the integrity of the packages that they install.
The id of our GPG public key is 0xcbcb082a1bb943db. The short form of the id is 0x1BB943DB. The full key fingerprint is:
1993 69E5 404B D5FC 7D2F E43B CBCB 082A 1BB9 43DB
The rpm utility can be used to import this key. For example:
sudo rpm --import https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
Once the GPG public key is imported, you are ready to install packages from the repository.
After the zypper repository is configured, you can install MariaDB by executing the zypper command. The specific command that you would use would depend on which specific packages that you want to install.
In MariaDB 10.4 and later, to Install the most common packages, execute the following command:
sudo zypper install MariaDB-server galera-4 MariaDB-client MariaDB-shared MariaDB-backup MariaDB-common
In MariaDB 10.3 and before, to Install the most common packages, execute the following command:
sudo zypper install MariaDB-server galera MariaDB-client MariaDB-shared MariaDB-backup MariaDB-common
To Install MariaDB Server, execute the following command:
sudo zypper install MariaDB-server
The process to install MariaDB Galera Cluster with the MariaDB zypper repository is practically the same as installing standard MariaDB Server.
In MariaDB 10.1 and later, Galera Cluster support has been included in the standard MariaDB Server packages, so you will need to install the MariaDB-server package, as you normally would.
In MariaDB 10.4 and later, you also need to install the galera-4 package to obtain the Galera 4 wsrep provider library.
In MariaDB 10.3 and before, you also need to install the galera package to obtain the Galera 3 wsrep provider library.
In MariaDB 10.4 and later, to install MariaDB Galera Cluster, you could execute the following command:
sudo zypper install MariaDB-server MariaDB-client galera-4
In MariaDB 10.3 and before, to install MariaDB Galera Cluster, you could execute the following command:
sudo zypper install MariaDB-server MariaDB-client galera
If you haven't yet imported the MariaDB GPG public key, then zypper will prompt you to import it after it downloads the packages, but before it prompts you to install them.
See MariaDB Galera Cluster for more information on MariaDB Galera Cluster.
In MariaDB 10.2 and later, MariaDB Connector/C has been included as the client library. However, the package name for the client library has not been changed.
To Install the clients and client libraries, execute the following command:
sudo zypper install MariaDB-client MariaDB-shared
To install Mariabackup, execute the following command:
sudo zypper install MariaDB-backup
Some plugins may also need to be installed.
For example, to install the cracklib_password_check password validation plugin, execute the following command:
sudo zypper install MariaDB-cracklib-password-check
The MariaDB zypper repository first added debuginfo packages in MariaDB 5.5.64, MariaDB 10.1.39, MariaDB 10.2.23, MariaDB 10.3.14, and MariaDB 10.4.4.
The MariaDB zypper repository also contains debuginfo packages. These package may be needed when debugging a problem.
To install debuginfo for the most common packages, execute the following command:
sudo zypper install MariaDB-server-debuginfo MariaDB-client-debuginfo MariaDB-shared-debuginfo MariaDB-backup-debuginfo MariaDB-common-debuginfo
To install debuginfo for MariaDB Server, execute the following command:
sudo zypper install MariaDB-server-debuginfo
In MariaDB 10.2 and later, MariaDB Connector/C has been included as the client library. However, the package name for the client library has not been changed.
To install debuginfo for the clients and client libraries, execute the following command:
sudo zypper install MariaDB-client-debuginfo MariaDB-shared-debuginfo
To install debuginfo for Mariabackup, execute the following command:
sudo zypper install MariaDB-backup-debuginfo
For some plugins, debuginfo may also need to be installed.
For example, to install debuginfo for the cracklib_password_check password validation plugin, execute the following command:
sudo zypper install MariaDB-cracklib-password-check-debuginfo
The MariaDB zypper repository contains the last few versions of MariaDB. To show what versions are available, use the following command:
zypper search --details MariaDB-server
In the output you will see the available versions.
To install an older version of a package instead of the latest version we just need to specify the package name, a dash, and then the version number. And we only need to specify enough of the version number for it to be unique from the other available versions.
However, when installing an older version of a package, if zypper has to install dependencies, then it will automatically choose to install the latest versions of those packages. To ensure that all MariaDB packages are on the same version in this scenario, it is necessary to specify them all.
The packages that the MariaDB-server package depend on are: MariaDB-client, MariaDB-shared, and MariaDB-common. Therefore, to install MariaDB 10.3.14 from this zypper repository, we would do the following:
sudo zypper install MariaDB-server-10.3.14 MariaDB-client-10.3.14 MariaDB-shared-10.3.14 MariaDB-backup-10.3.14 MariaDB-common-10.3.14
The rest of the install and setup process is as normal.
After the installation is complete, you can start MariaDB.
If you are using MariaDB Galera Cluster, then keep in mind that the first node will have to be bootstrapped.
© 2019 MariaDB
Licensed under the Creative Commons Attribution 3.0 Unported License and the GNU Free Documentation License.
https://mariadb.com/kb/en/installing-mariadb-with-zypper/