Release notes for the MariaDB ColumnStore Cluster Management API (CMAPI)
Cluster Management API (CMAPI) 1.6.0 is a maintenance release of CMAPI. CMAPI is a REST API for administering MariaDB Enterprise ColumnStore in multi-node topologies.
Cluster Management API 1.6.0 was released on 2021-12-13. This release is of General Availability (GA) maturity.
CMAPI 1.6.0 is compatible with MariaDB Enterprise ColumnStore 5.6 and 6. CMAPI 1.6.0 was first released with MariaDB Enterprise ColumnStore 5.6.3 and MariaDB Enterprise ColumnStore 6.2.2.
CMAPI now disables the ExeMgr process on replica nodes to avoid unnecessary CPU usage. (MCOL-4860)
To avoid conflicts between systemd and CMAPI, the mariadb-columnstore systemd unit is disabled when CMAPI is installed and re-enabled when CMAPI is uninstalled. (MCOL-4938)
Some CMAPI Log messages have been clarified. (MCOL-4851)
CMAPI properly applies configuration changes to multiple nodes. (MCOL-4851)
Behavior for DBRM socket send and receive has been fixed. (MCOL-4851)
The CMAPI configuration file is now automatically created by default if it is not found. (MCOL-4851)
In alignment with the MariaDB Corporation Engineering Policy, CMAPI 1.6.0 is provided for:
CentOS 7 (x86_64)
Debian 9 (x86_64)
Debian 10 (x86_64)
Red Hat Enterprise Linux 7 (x86_64)
Red Hat Enterprise Linux 8 (x86_64)
SUSE Linux Enterprise Server 12 (x86_64)
SUSE Linux Enterprise Server 15 (x86_64)
Ubuntu 18.04 (x86_64)
Ubuntu 20.04 (x86_64)
This page is: Copyright © 2025 MariaDB. All rights reserved.
Cluster Management API (CMAPI) 1.6.2 is a maintenance release of CMAPI. CMAPI is a REST API for administering MariaDB Enterprise ColumnStore in multi-node topologies.
Cluster Management API 1.6.2 was released on 2022-02-23. This release is of General Availability (GA) maturity.
CMAPI 1.6.2 is compatible with MariaDB Enterprise ColumnStore 5.6 and 6. CMAPI 1.6.2 was first released with MariaDB Enterprise ColumnStore 5.6.5 and MariaDB Enterprise ColumnStore 6.2.3.
Compatibility added for MariaDB ColumnStore 6.2.3. (MCOL-4954)
Compatibility added for Enterprise ColumnStore 6.2.3 cross engine join encrypted passwords. (MCOL-4978)
Added support for using a custom port for cross engine join support. (MCOL-4898)
During upgrade CMAPI configuration information is lost. Customer data is not impacted. (MCOL-4979)
mcsStatus incorrectly returns "cluster_mode": null. This is a cosmetic issue that does not affect operation. (MCOL-4973)
In alignment to the MariaDB Corporation Engineering Policy, CMAPI 1.6.2 is provided for:
CentOS 7 (x86_64)
Debian 10 (x86_64)
Red Hat Enterprise Linux 7 (x86_64)
Red Hat Enterprise Linux 8 (x86_64)
Ubuntu 18.04 (x86_64)
Ubuntu 20.04 (x86_64)
This page is: Copyright © 2025 MariaDB. All rights reserved.
Cluster Management API (CMAPI) 1.6.3 is a maintenance release of CMAPI. CMAPI is a REST API for administering MariaDB Enterprise ColumnStore in multi-node topologies.
Cluster Management API 1.6.3 was released on 2022-04-20. This release is of General Availability (GA) maturity.
CMAPI 1.6.3 is compatible with MariaDB Enterprise ColumnStore 5.6 and 6. CMAPI 1.6.3 was first released with MariaDB Enterprise ColumnStore 5.6.5 and MariaDB Enterprise ColumnStore 6.2.3.
When a node is added to the cluster using a DNS name, the node's DNS name is added to Columnstore.xml instead of the node's IP address. (MCOL-4804)
Prior to this release, when a node's IP address changed after it was added to the cluster, Columnstore.xml still contained the node's old IP address.
Starting with this release, CMAPI can adapt to changing IP addresses when the DNS name in Columnstore.xml resolves to the new IP address.
After the primary server is killed and restarted, MaxScale and CMAPI could each choose different primary servers. (MCOL-5052)
In alignment to the MariaDB Corporation Engineering Policy, CMAPI 1.6.3 is provided for:
CentOS 7 (x86_64)
Debian 10 (x86_64)
Red Hat Enterprise Linux 7 (x86_64)
Red Hat Enterprise Linux 8 (x86_64)
Ubuntu 18.04 (x86_64)
Ubuntu 20.04 (x86_64)
This page is: Copyright © 2025 MariaDB. All rights reserved.
Cluster Management API (CMAPI) 22.08.1 is a maintenance release of CMAPI. CMAPI is a REST API for administering MariaDB Enterprise ColumnStore in multi-node topologies.
Cluster Management API 22.08.1 was released on 2022-09-12. This release is of General Availability (GA) maturity.
CMAPI 22.08.1 is compatible with MariaDB Enterprise ColumnStore 22.08. CMAPI 22.08.1 was first released with MariaDB Enterprise ColumnStore 22.08.1.
CMAPI configures ColumnStore to allow read queries to be executed on any node. (MCOL-4770)
In previous releases, CMAPI only added an ExeMgr section for the primary node to Columnstore.xml.
Starting with this release, CMAPI adds an ExeMgr section for every node to Columnstore.xml, which means that any node can execute read queries.
Since Enterprise ColumnStore 22.08 merges the ExeMgr process into the PrimProc process, CMAPI no longer tries to start ExeMgr on a node when the binary is not present. (MCOL-5138)
Some redundant log messages have been removed from the CMAPI log. (MCOL-5157)
In alignment to the MariaDB Corporation Engineering Policy, CMAPI 22.08.1 is provided for:
CentOS 7 (x86_64)
Debian 10 (x86_64, ARM64)
Debian 11 (x86_64, ARM64)
Red Hat Enterprise Linux 7 (x86_64)
Red Hat Enterprise Linux 8 (x86_64, ARM64)
Red Hat Enterprise Linux 9 (x86_64, ARM64)
Rocky Linux 8 (x86_64, ARM64)
Rocky Linux 9 (x86_64, ARM64)
Ubuntu 20.04 (x86_64, ARM64)
Ubuntu 22.04 (x86_64, ARM64)
This page is: Copyright © 2025 MariaDB. All rights reserved.
Cluster Management API (CMAPI) 22.08.2 is a maintenance release of CMAPI. CMAPI is a REST API for administering MariaDB Enterprise ColumnStore in multi-node topologies.
Cluster Management API 22.08.2 was released on 2022-11-15. This release is of General Availability (GA) maturity.
CMAPI 22.08.2 is compatible with MariaDB Enterprise ColumnStore 22.08. CMAPI 22.08.2 was first released with MariaDB Enterprise ColumnStore 22.08.3.
Users of CMAPI 22.08.1 are encouraged to upgrade.
The cluster is not correctly reconfigured when a PM fails and recovers: (MCOL-5286)
DDL will fail after a PM fails.
Selects will fail after the PM recovers.
In alignment to the MariaDB Corporation Engineering Policy, CMAPI 22.08.2 is provided for:
CentOS 7 (x86_64)
Debian 11 (x86_64, ARM64)
Red Hat Enterprise Linux 7 (x86_64)
Red Hat Enterprise Linux 8 (x86_64, ARM64)
Red Hat Enterprise Linux 9 (x86_64, ARM64)
Rocky Linux 8 (x86_64, ARM64)
Rocky Linux 9 (x86_64, ARM64)
Ubuntu 20.04 (x86_64, ARM64)
Ubuntu 22.04 (x86_64, ARM64)
This page is: Copyright © 2025 MariaDB. All rights reserved.
Cluster Management API (CMAPI) 6.4.1 is a maintenance release of CMAPI. CMAPI is a REST API for administering MariaDB Enterprise ColumnStore in multi-node topologies.
Cluster Management API 6.4.1 was released on 2022-07-12. This release is of General Availability (GA) maturity.
CMAPI 6.4.1 is compatible with MariaDB Enterprise ColumnStore 6. CMAPI 6.4.1 was first released with MariaDB Enterprise ColumnStore 6.4.1.
Failover can now be disabled in the CMAPI configuration file. (MCOL-4939)
The auto_failover option can be set to True or False in the [application] section:
[application]
auto_failover = FalseThe default value of the auto_failover option is True.
The auto_failover option should be set to False when non-shared local storage is used.
The format and logic of CMAPI logging has been improved. (MCOL-4907)
Transaction IDs are included more consistently in exception messages. (MCOL-4921)
The status endpoint returns the "dbroots" attribute as an empty array even when ColumnStore is working. (MCOL-4762)
When CMAPI tries to verify a node's hostname, the verification can fail if the short hostname was provided, but the fully qualified domain name (FQDN) is in /etc/hosts. (MCOL-4865)
In alignment to the MariaDB Corporation Engineering Policy, CMAPI 6.4.1 is provided for:
CentOS 7 (x86_64)
Debian 10 (x86_64)
Red Hat Enterprise Linux 7 (x86_64)
Red Hat Enterprise Linux 8 (x86_64)
Rocky Linux 8 (x86_64)
Ubuntu 18.04 (x86_64)
Ubuntu 20.04 (x86_64)
This page is: Copyright © 2025 MariaDB. All rights reserved.