(Important) Verifying your MariaDB Version

Turbonomic supports MariaDB version 10.5.23 or MySQL 8.0.x for the historical database. This support includes comprehensive testing and quality control for Turbonomic usage.

If you are running Turbonomic installed as a VM image (OVA or VHD), and using the database that is included in that image installation, then you must use version 10.5.23. If you are updating your version of Turbonomic (instead of installing it for the first time), ensure that you are using the correct version of MariaDB with your installation.

Important:

It is a requirement that you run MariaDB version 10.5.23 or later. Turbonomic can operate with other versions of MariaDB; however, it is fully tested to operate with MariaDB version 10.5.23.

Because of a known issue, you must never use MariaDB versions 10.5.14, 10.5.15, or 10.6.7.

When you initially installed Turbonomic, that installation included MariaDB running a specific version. As you update your Turbonomic version, the MariaDB version remains the same. The first release of Turbonomic that included MariaDB 10.5.23 is 8.10.7. If you initially installed an earlier version, and did not update your MariaDB to 10.5.23, then you must do it now.

  • For VM image installations, it is possible to configure the installation to use a remote database (external to the VM). See Configuring a Remote Database

  • For installations on a Kubernetes cluster (not deployed as a Turbonomic VM image), you can find a download package at: https://archive.mariadb.org/mariadb-10.5.23/yum/rhel9-amd64.

Checking your MariaDB Version

Check the version of MariaDB running on your Turbonomic OVA.

  1. Open an SSH terminal session to your Turbonomic instance.

    Log in with the System Administrator that you set up when you installed Turbonomic:

    • Username: turbo

    • Password: [your_private_password]

  2. Check the MariaDB version.

    mysql -V

    The output is similar to the following example:

    mysql  Ver 15.1 Distrib 10.5.23-MariaDB, for Linux (x86_64) using readline 5.1

If the version is earlier than 10.5.23-MariaDB, then you must update your database.

If your version is equal to or greater than 10.5.23-MariaDB you do not need to update your MariaDB.

Updating your MariaDB

If you are using Turbonomic installed as a VM image, and you are using the default MariaDB that was installed with that image, you must run MariaDB version 10.5.23.

To update your MariaDB, you must first complete the Turbonomic upgrade process, then run the script to update the MariaDB database. For more information, see Updating Turbonomic to a New Version.

Important:

The Turbonomic update script updates the necessary MariaDB update scripts so it must be run before you update your MariaDB version.