Upgrade Datanode servers to v5.2

In a HA environment, RabbitMQ and MySQL may be together on a Datanode server.

Abiquo will upgrade to new versions of RabbitMQ and MySQL that require a manual upgrade path of dependencies.

(warning) These steps are for a server that contains RabbitMQ AND MySQL


  1. Shut down the Galera cluster. See Stop and start HA configuration.

  2. Remove the Erlang and Galera packages.

    yum remove erlang* galera
    yum clean all && yum makecache
  3. Install new RabbitMQ and MariaDB server

    yum install rabbitmq-server MariaDB-server

    Before you confirm, check that the packages will be installed from the abiquo-base repository

    1. rabbitmq-server: 3.8.2.1
    2. MariaDB-server: 10.4.10.1
  4. Upgrade Abiquo to 5.2.x

    yum update

    Before you confirm, check the following packages will be installed from the abiquo-base repository:

    1. jdk: 11.0.6u10
    2. redis: 5.0.7.1
  5. Enable the new services

    systemctl enable mariadb
    systemctl enable rabbitmq-server
  6. Edit the MySQL configuration to use the new version of Galera.

    The configuration file can be found at

    /etc/my.cnf.d/galera.cnf

    Change the wsrep_provider line to use the new version of Galera (in the galera-4 folder)

    wsrep_provider=/usr/lib64/galera-4/libgalera_smm.so
  7. Start Galera, which will also start MySQL.

    Check the Galera state data.

    cat /var/lib/mysql/grastate.dat

    Find the server which is safe to bootstrap

    safte_to_bootstrap: 1

    Start Galera

    galera_new_cluster

    On the other servers in the cluster, start MariaDB

    systemctl start mariadb

    For more details see Stop and start HA configuration

  8. Start RabbitMQ on all datanode servers

    systemctl start rabbitmq-server
  9. Upgrade MySQL on all datanode servers

    mysql_upgrade

    The mysql_upgrade step may detect errors that trigger messages such as the following:

    kinton_accounting.ACCOUNT_PERIOD_USAGE_VW Error : Column count of mysql.proc is wrong. Expected 21, found 20. Created with MariaDB 100129, now running 100410. Please use mysql_upgrade to fix this error

    These messages are expected and this same mysql_upgrade process will automatically fix these errors in its next stages.

    Check that the mysql_upgrade process completes correctly.


  10. Check that your hostname is in your DNS or in your /etc/hosts file

  11. Upgrade the Abiquo API databases. This script is available on the API Server.

    abiquo-db [-h DB hostname] [-P DB port] [-u user] [-p password] update

    If the liquibase update fails with a message similar to the following: 

    Liquibase update Failed: Validation Failed:
    1 change sets check sum
    src/X.X.X-XX/kinton-X.X.X.xml::ABICLOUDPREMIUM-XXXX-XxxxxxxxXXxXxxxxxxXxxxxx::XXXXXXXXX is now: 7:ee2fa6e058ec76c7abf801567898917d
    For more information, use the --logLevel flag

    Do the following steps

    1. Clear the database checksums

      abiquo-db clearCheckSums
    2. Retry the above abiquo-db update command.

Copyright © 2006-2024, Abiquo Holdings SL. All rights reserved