Release Notes for MariaDB MaxScale 2.5.27
This page is part of MariaDB's Documentation.
The parent of this page is: Release Notes for MariaDB MaxScale 2.5
Topics on this page:
Overview
MariaDB MaxScale is an advanced database proxy and query router.
MariaDB MaxScale 2.5.27 was released on 2023-07-27. This release is of General Availability (GA) maturity.
Notable Changes
The
--load-all
option has been added to provide a way to show details about all supported MaxScale modules via REST API and/or MaxCtrl (MXS-4541)Starting with this release, the option
--load-all
can be used with thelist modules
command to show all supported MaxScale modules. When used without theload-all
option, thelist modules
command shows only the modules that are configured.maxctrl list modules --load-all
Issues Fixed
Can result in a hang or crash
The Cache Filter (
cache
) hangs if a statement is split across multiple packets. (MXS-4659)In previous releases, if a statement is split across multiple packets, the cache filter will forward the first packet and wait for a server response before sending the following ones, thus causing the session to hang.
Starting with this release, if a protocol command is split across multiple packets, the subsequent packets are sent forward without waiting for a response.
Setting
session_track_trx_state=true
whentransaction_replay=true
andoptimistic_trx=true
could result in excessive memory consumption and the process being killed by the OOM (out-of-memory) killer. (MXS-4656)Starting with this release, when
session_track_trx_state
is enabled,transaction_replay
andoptimistic_trx
will be disabled.
Can result in unexpected behavior
When unsuccessfully starting a listener, a bad configuration could be persisted on disk. The error message generated by the unsuccessful start is misleading and incorrectly logged in the MaxScale log instead of being captured and sent to the REST API client. (MXS-4665)
Starting with this release, the following message is sent to the REST API client:
Listener 'NAME' was created but failed to start it.
REST API
404
errors do not provide enough information about the cause of a problem. (MXS-4657)Added a clarification to the MaxCtrl error message whenever an HTTP 404 response is given. Since the endpoints themselves should always be correct, the only thing that can go wrong is the object name or type.
The new error message is:
Check that the object exists and that it is of the correct type.
Platforms
In alignment to the MariaDB Corporation Engineering Policy, MariaDB MaxScale 2.5.27 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) SUSE Linux Enterprise Server 15 (x86_
64, ARM64) Ubuntu 20.04 (x86_
64, ARM64)