Release Notes for MariaDB MaxScale 2.4.1


MariaDB MaxScale is an advanced database proxy, firewall, and query router.

MariaDB MaxScale 2.4.1 was released on 2019-08-20. This release is of General Availability (GA) maturity.

New Features

  • Support added for the Clustrix monitor.

  • Support added for the Smart Router.

  • Support added to MaxCtrl for draining servers.

  • Support added for socket parameter, allowing MaxScale to use UNIX domain sockets for server modules.

  • Support added for cluster parameter for services.

  • Support added for suffixes h, m, s, and ms for specifying duration in configuration files.

  • Query Classifier Cache can now be examined through MaxCtrl or the REST API.

  • Support added for throttling connection attempts.

  • Default version for REST API and MaxCtrl is optional. Defaults to /v1

  • Support added to REST API and MaxCtrl for --force option with set server command. Closes all connections to given server when it's set in maintenance mode.

  • Support added for command history to MaxCtrl.

  • MaxCtrl alter now supports multiple key-value pairs in one command.

  • Read/Write Splitter now applies transaction replays in conjunction with server initiated transaction rollbacks.

  • Adds the transaction_replay_attempts parameter, to set the number of errors can occur before the Read/Write Splitter ceases replay attempts.

  • Adds the lazy_connect parameter, delaying the opening of all connections for the Read/Write Splitter until they're needed.

  • New connections created by Read/Write Splitter at start of session are now always used in connection counts.

  • Read/Write Splitter now load balances connections to Primary Server in cases where there are multiple Primary Servers.

  • Read/Write Splitter now allows open transactions to finish if the Primary Server is put in maintenance mode.

  • Galera Monitor now correctly assigns Replica status when the Replica Server treats a Cluster Node as its Primary Server.

  • Cluster Nodes now display their Global Transaction ID positions in MaxCtrl list servers output.

  • Avro Router now supports direct replication.

  • MariaDB Monitor now supports enforce_simple_topology parameter.

Notable Changes

  • MaxScale fails to start if section or object names begin with @@, this is now reserved for MaxScale itself.

  • MaxScale fails to start if section or object names contain whitespace (deprecated in 2.2).

  • Support added for SO_REUSEPORT capability offered by Linux kernel 3.9+. Allows multiple MaxScale instances running on the same server to bind on the same listener port.

  • MaxScale now stores user passwords as SHA2-512 hashes. New users use the stronger algorithm. Existing users continue to use MD5 hashes. Recreate the user to upgrade.

  • REST API now requires the protocol parameter when creating a server module.

  • Encrypting connections to the server requires that you define the TLS parameters when creating a server module.

  • The weightby option for server modules replaced by the rank option.

Deprecated Features

  • MaxAdmin no longer supports enabling TLS at runtime. Use MaxCtrl to create servers with TLS configuration.

  • Removed the debugcli router.

  • Removed the telenetd protocol.

  • Removed the ndbclustermon monitor.

  • Removed the mmmon monitor.

  • Removed the mysql51_replication, multimaster, and allow_cluster_recovery options from the mariadbmon monitor

  • Deprecates the mqfilter filter. It will be removed in a future release.

  • Removed example scripts and configuration files for Nagios.