Install MariaDB Connector/C

Overview

MariaDB Connector/C supports several Linux distributions and Microsoft Windows.

Configure Package Repository (Linux)

To install MariaDB Connector/C on Linux using APT, YUM, or ZYpp, you must configure your system to use either the ES Package Repository or the CS Package Repository.

If your system is already configured to use one of these package repositories, you can skip to install MariaDB Connector/C.

Choose a package repository to configure:

Package Repository

Description

ES Package Repository

  • MariaDB Enterprise Server package repository

  • Available to customers of MariaDB Corporation

  • Available for APT, YUM, and ZYpp on supported Linux distributions

  • Configured with the mariadb_es_repo_setup utility

CS Package Repository

  • MariaDB Community Server package repository

  • Publicly available

  • Available for APT, YUM, and ZYpp on supported Linux distributions

  • Configured with the mariadb_repo_setup utility

ES Package Repository

MariaDB Connector/C is available from the same package repository as MariaDB Enterprise Server.

To configure the ES package repository:

  1. Install wget.

    Install via APT on Debian, Ubuntu:

    $ sudo apt install wget

    Install via YUM on CentOS, RHEL, Rocky Linux:

    $ sudo yum install wget

    Install via ZYpp on SLES:

    $ sudo zypper install wget

  2. Download the mariadb_es_repo_setup utility, validate its checksum, and ensure that its permissions allow it to be executed:

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

    $ echo "8dfef0ec98eb03a4455df07b33107a6d4601425c9df0ab5749b8f10bf3abdcbb  mariadb_es_repo_setup" \
    | sha256sum -c -

    $ chmod +x mariadb_es_repo_setup

  3. Retrieve your Customer Download Token at https://cloud.mariadb.com/csm?id=my_customer_token and substitute your token for CUSTOMER_DOWNLOAD_TOKEN in the following step.

  4. Configure the ES package repository using the mariadb_es_repo_setup utility:

    $ sudo ./mariadb_es_repo_setup --token="CUSTOMER_DOWNLOAD_TOKEN" --apply \
   --mariadb-server-version="10.6"

    • All major releases of ES contain the same version of MariaDB Connector/C.

    • By default, the mariadb_es_repo_setup utility will configure your system to use the package repository for ES 10.6.

    • To configure your system to use the ES package repository for a specific major release, use the --mariadb-server-version option.

  5. Install MariaDB Connector/C using the package repository.

CS Package Repository

MariaDB Connector/C is available from the same package repository as MariaDB Community Server.

To configure the CS package repository:

  1. Install wget.

    Install via APT on Debian, Ubuntu:

    $ sudo apt install wget

    Install via YUM on CentOS, RHEL, Rocky Linux:

    $ sudo yum install wget

    Install via ZYpp on SLES:

    $ sudo zypper install wget

  2. Download the mariadb_repo_setup utility, validate its checksum, and ensure that its permissions allow it to be executed:

    $ wget https://r.mariadb.com/downloads/mariadb_repo_setup

    $ echo "ad125f01bada12a1ba2f9986a21c59d2cccbe8d584e7f55079ecbeb7f43a4da4  mariadb_repo_setup" \
    | sha256sum -c -

    $ chmod +x mariadb_repo_setup

  3. Configure the CS package repository using the mariadb_repo_setup utility:

    $ sudo ./mariadb_repo_setup \
   --mariadb-server-version="mariadb-10.6"

    • All major releases of CS contain the same version of MariaDB Connector/C.

    • By default, the mariadb_repo_setup utility will configure your system to use the package repository for CS 10.6.

    • To configure your system to use the CS package repository for a specific major release, use the --mariadb-server-version option.

  4. Install MariaDB Connector/C using the package repository.

Installation via Package Repository (Linux)

On supported Linux distributions, MariaDB Connector/C can be installed using APT, YUM, or ZYpp if the system is configured to use the ES Package Repository or the CS Package Repository.

Install on CentOS, RHEL, Rocky Linux

To install MariaDB Connector/C on CentOS, RHEL, and Rocky Linux, you can use YUM if you have the ES Package Repository or CS Package Repository configured.

Install MariaDB Connector/C and package dependencies:

$ sudo yum install MariaDB-shared MariaDB-devel

Install on Debian, Ubuntu

To install MariaDB Connector/C on Debian and Ubuntu, you can use APT if you have the ES Package Repository or CS Package Repository configured.

Install MariaDB Connector/C and package dependencies:

$ sudo apt install libmariadb3 libmariadb-dev

Install on SLES

To install MariaDB Connector/C on SLES, you can use ZYpp if you have the ES Package Repository or CS Package Repository configured.

Install MariaDB Connector/C and package dependencies:

$ sudo zypper install MariaDB-shared MariaDB-devel

Install via Binary Tarball (Linux)

MariaDB Connector/C can be installed on supported Linux distributions via a binary tarball package:

  1. Go to the MariaDB Connector/C download page

  2. Ensure the "Product" dropdown reads "C connector".

  3. In the "Version" dropdown, select the version you want to download.

  4. In the "OS" dropdown, select your Linux distribution.

  5. Click on the "Download" button to download the binary tarball package.

Install via MSI (Windows)

MariaDB Connector/C can be installed on Microsoft Windows via an MSI package:

  1. Go to the MariaDB Connector/C download page

  2. Ensure the "Product" dropdown reads "C connector".

  3. In the "Version" dropdown, select the version you want to download.

  4. In the "OS" dropdown, select either "MS Windows (64-bit)" or "MS Windows (32-bit)", depending on whether you need a 64-bit or 32-bit connector.

  5. Click on the "Download" button to download the MSI package.

  6. When the MSI package finishes downloading, run it and follow the on-screen instructions.