All pages
Powered by GitBook
2 of 12

MaxScale 23.08 Release Notes

MariaDB MaxScale 23.08.10 Release Notes

Release 23.08.10 is a GA release.

This document describes the changes in release 23.08.10, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read the upgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

Bug fixes

  • MXS-5618 Maxctrl interactive mode doesn't use --tls-verify-server-cert=false

  • MXS-5613 The logout screen is shown when accessing the MaxGUI login view.

  • MXS-5608 optimistic_trx causes a query to hang

  • MXS-5599 Processing of conditional headers is incorrect

  • MXS-5598 MaxCtrl fails to read large inputs from stdin

  • MXS-5597 admin_oidc_url is documented to not be dynamic when in fact it is

  • MXS-5590 REST-API always sends a Connection: close header

  • MXS-5588 Signal 11 crash when enabling causal reads with Galera

  • MXS-5582 Add a Service with a CLUSTER as its target breaks CONFIG SYNC

  • MXS-5577 Aborted connection on backend mariadb with persistpool maxscale

  • MXS-5576 Maxctrl config permission check error message is misleading

  • MXS-5567 Wrong password in interactive mode is only seen after the first command

  • MXS-5566 --secretsdir has no default value

  • MXS-5563 Using PKCS#1 private key in the REST-API results in cryptic errors

  • MXS-5556 Trailing parts of large session command are not routed correctly

  • MXS-5542 kafkacdc commits offsets when it probes GTIDs from Kafka

  • MXS-5541 Logs Archive page doesn't show useful API error

  • MXS-5525 Masking with functions uses wrong rule settings

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

MariaDB MaxScale 23.08.9 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.9 Release Notes

MariaDB MaxScale 23.08.9 Release Notes

Release 23.08.9 is a GA release.

This document describes the changes in release 23.08.9, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

Bug fixes

  • MXS-5533 Remove session_trace parameter from services section

  • MXS-5529 Session commands with max_slave_connections=0 after switchover do not discard stale connections

  • MXS-5527 The "INSERT INTO...RETURNING" syntax breaks causal_reads

  • MXS-5522 config sync does not ignore port for listeners

  • MXS-5520 config_sync_password infinitely doubles after maxscale restart & alter command

  • MXS-5518 Documentation of switchover-force lacks warnings

  • MXS-5511 The Contact view in the GUI has outdated information

  • MXS-5508 Relationship selections auto-cleared when creating a new monitor object

  • MXS-5507 readwritesplit enables multi-statements regardless of the state of causal_reads

  • MXS-5493 Cluster tree is not visualized accurately

  • MXS-5492 idle_session_pool_time=0s does not fairly share connections

  • MXS-5488 Need Documentation updates for Maxscale install recommendation

  • MXS-5481 Galera Monitor does not log an error if "SHOW SLAVE STATUS" fails

  • MXS-5480 disable_sescmd_history=true causes a use-after-free

  • MXS-5466 MaxCtrl warnings are very verbose

  • MXS-5455 Errors during loading of users lack the service name

  • MXS-5450 maxctrl list queries fails

  • MXS-5449 Encrypted passwords cannot be used with maxctrl

  • MXS-5443 Log message: Unknown prepared statement handler given to MaxScale

  • MXS-5439 Backend connections with fail with EAGAIN

  • MXS-5437 Failed authentication warnings do not mention lack of client-side SSL as the reason of the failure

  • MXS-5432 MaxScale 24.02.04 not closing DB Connections properly

  • MXS-5430 Authentication errors are sometimes not read if backend TLS is enabled

  • MXS-5419 Duration types that only take seconds return ms as units instead of s

  • MXS-5415 retry_failed_reads is not affected by delayed_retry_timeout

  • MXS-5409 list session in GUI shows wrong amount of sessions

  • MXS-5408 rebuild-server does not work with MariaDB 11.4

  • MXS-5404 The monitor journal file is not discarded aggressively enough.

  • MXS-5403 Debug assertion on very large binary protocol prepared statements

  • MXS-5402 Monitor connections do not check SSL certificate host even when ssl_verify_peer_host is enabled for the server

  • MXS-5397 NVL and NVL2 are not detected as builtin functions outside of sql_mode=ORACLE

  • MXS-5395 Kafkacdc errors for wrong GTID positions are not clear

  • MXS-5382 Errors due to max_connections being exceeded are always fatal errors

  • MXS-5366 Certain special characters in the maxscale user causes async-rebuild-server to fail

  • MXS-5340 ed25519 socket droped when no user_mapping_file

  • MXS-5314 Resultset table not fully expanded for inactive query tab

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.8 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.8 Release Notes -- 2024-12-09

MariaDB MaxScale 23.08.8 Release Notes -- 2024-12-09

Release 23.08.8 is a GA release.

This document describes the changes in release 23.08.8, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

External CVEs resolved.

  • CVE-2023-0437 Fixed by MXS-5400 Upgrade MongoC library to 1.27.5

  • CVE-2024-7553 Fixed by MXS-5400 Upgrade MongoC library to 1.27.5

New Features

  • MXS-5177 Introduce a new core_file variable in MaxScale

Bug fixes

  • MXS-5398 Some log messages are not logged when session_trace is used

  • MXS-5394 Empty passwords are shown as non-empty if password encryption is enabled

  • MXS-5387 Crash in MariaDBParser::Helper::get_query_info()

  • MXS-5383 Alter table editor failed to assign table's collation value

  • MXS-5378 Nested listener parameters depend on protocol being defined

  • MXS-5377 Debug assert if backend fails during multi-packet query

  • MXS-5374 Kafkaimporter doesn't work with MariaDB 11

  • MXS-5372 timeout in kafkacdc is not a duration type

  • MXS-5364 Allow monitor ssh-parameters to be modified at runtime

  • MXS-5363 GDB stacktraces may hang

  • MXS-5361 Query editor: Column visibility filter shows wrong checkboxe values after search

  • MXS-5359 Transaction replay may deadlock with switchover

  • MXS-5357 Improve MariaDB Monitor documentation on auto_failover and auto_rejoin

  • MXS-5356 Readwritesplit master_reconnection is incompatible with GET_LOCK

  • MXS-5355 Switchover may cause two transaction replays to be started

  • MXS-5351 XA ROLLBACK is not treated as a rollback in MaxScale

  • MXS-5350 XA END is treated as the transaction commit instead of XA PREPARE

  • MXS-5344 Kafkaimporter constraint makes it difficult to use with kafkacdc

  • MXS-5343 Kafkacdc does not mention row-based replication as a requirement

  • MXS-5341 User account manager hangs on shutdown

  • MXS-5339 Slow servers may cause OOM situations if prepared statements are used

  • MXS-5338 Maxscale Admin Audit file should include ip address or host of calling session

  • MXS-5315 maxctrl destroy session takes only one ID as argument

  • MXS-5307 MaxScale kafkacdc logs "notice : Started replicating from [x.x.x.x]:3306 at GTID 'N-N-N' at every timeout/reconnection

  • MXS-5302 Prepared statements should never be removed from session command history

  • MXS-5298 Kafkacdc always reads last GTID from Kafka on startup

  • MXS-5296 New entity table is added without default collation

  • MXS-5273 The --config-check fails if /var/cache/maxscale cannot be read

  • MXS-5272 Monitor does not show broken external replication in "maxctrl list servers"

  • MXS-5268 Read-only error during read-write transaction should trigger transaction replay

  • MXS-5264 MaxScale installs scripts with non-standard file permissions

  • MXS-5263 Valgrind reports read from uninitialized GWBUF for ccrfilter

  • MXS-5259 Retrying of reads on the current primary unnecessarily requires delayed_retry

  • MXS-5258 delayed_retry should not retry interrupted writes

  • MXS-5256 SET statements multiple values are not parsed correctly

  • MXS-5248 Debug assertion due to non-existent dcall ID

  • MXS-5247 Remove obsolete prelink script

  • MXS-5245 MaxCtrl does not accept dot notation for nested parameters

  • MXS-5239 Listener with ssl=false allows user accounts created with REQUIRE SSL to log in

  • MXS-5236 wsrep_desync behavior is undocumented

  • MXS-5229 Master Stickiness status not displayed correctly with use_priority

  • MXS-5178 Replicas after maxscale binlog don't get updates

Known Issues and Limitations

In the previous version of MaxScale, maxctrl was implemented as a JavaScript script that was run using the node interpreter on the platform. That introduced a dependency on node that earlier was not present. In this version of MaxScale, maxctrl is again a native executable without that dependency.

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.7 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.7 Release Notes -- 2024-09-09

MariaDB MaxScale 23.08.7 Release Notes -- 2024-09-09

Release 23.08.7 is a GA release.

This document describes the changes in release 23.08.7, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

Bug fixes

  • MXS-5234 webpack warns about yargs

  • MXS-5232 Large batches of session commands may leave sessions alive for a long time

  • MXS-5231 Connections to servers in maintenance are sometimes not discarded

  • MXS-5227 MaxScale does not drop supplementary groups if --user is used

  • MXS-5226 LICENSE.TXT is a dangling symlink in RPMs

  • MXS-5222 Query Editor: Unable to fully see error result when previewing a table

  • MXS-5221 Query Editor: Unable to visualize preview data result set

  • MXS-5213 Erroneous "Cluster gtid domain is unknown" error message during failover

  • MXS-5209 Reads with max_slave_connections=0 after a switchover do not discard stale connections

  • MXS-5208 Table header row fails to expand to full width in ERD modeler

  • MXS-5206 Readwritesplit does not drop connections to severely lagging servers

  • MXS-5200 CMake 3.28.3 warnings

  • MXS-5198 Default logrotate config in .deb / docu missing params

  • MXS-5196 /maxscale/logs/data may return no data if maxlog=0 and syslog=1

  • MXS-5193 Multi-statement commands may end up being stored in the session command history

  • MXS-5191 Two cache filters in same service causes errors on session creation

  • MXS-5190 dotnet EntityFrameworkCore generates insert queries that are getting routed to all nodes as session write

  • MXS-5171 MaxScale does not have time to open the file during rotation for a new binlog

  • MXS-5167 Query Editor "Filter By" and "Group By" work improperly

  • MXS-5162 Post reboot binlog router entered stuck state

  • MXS-5161 Downgrading to 23.08 from 24.02 removes some required directories

  • MXS-5160 postinst script prints output while installing

  • MXS-5159 MaxScale does not use remote address sent in proxy header from client for authenticating the client

  • MXS-5146 23.08.6 build ppc64le fails

  • MXS-5135 The GUI should clear all http readonly cookies

  • MXS-5133 Memory leak in namedserverfilter

  • MXS-5132 Inbound proxy protocol does not generate the correct error if proxy_protocol_network is not defined

  • MXS-5131 comment filter uses the wrong module name

  • MXS-5127 DEALLOCATE PREPARE is not routed to all nodes

  • MXS-5126 Segfault in cache filter with default configuration

  • MXS-5125 Executing identical prepared statements may lose one of them on reconnection

  • MXS-5121 MaxScale detects wrong server character set

  • MXS-5109 A logout endpoint for the GUI to clear all http readonly cookies

  • MXS-4605 Monitor should drop the connection when faced with an Access Denied error

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.6 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.6 Release Notes -- 2024-06-03

MariaDB MaxScale 23.08.6 Release Notes -- 2024-06-03

Release 23.08.6 is a GA release.

This document describes the changes in release 23.08.6, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

New Features

  • MXS-5067 Add "enforce_read_only_servers" feature to MariaDB Monitor

Bug fixes

  • MXS-5106 Server version checks are overly pessimistic

  • MXS-5101 MariaDB Monitor can kill connections from other monitors during switchover

  • MXS-5095 Master Stickiness state is not documented

  • MXS-5094 Stacktraces fail to be generated when MaxScale is run from the terminal

  • MXS-5093 SQL API does not return binary data in resultsets

  • MXS-5091 admin_audit file name does not use log_dir value

  • MXS-5090 ability to setup .secrets file location

  • MXS-5085 max_slave_connections=0 may create slave connections after a switchover

  • MXS-5083 ssl_version in MaxScale and tls_version in MariaDB behave differently

  • MXS-5082 Password encryption format change in 2.5 is not documented very well

  • MXS-5081 The values of ssl_version in MaxScale and tls_version in MariaDB accept different values

  • MXS-5074 Warning about missing slashes around regular expressions is confusing

  • MXS-5068 users_refresh_time=0s does not work as documented

  • MXS-5063 Maxscale crash - "terminate called after throwing an instance of 'std::bad_alloc'"

  • MXS-5051 cmake does not check for unixodbc-dev

  • MXS-5048 Problem in hostname matching when using regex (%) for user authentication

  • MXS-5046 maxctrl alter admin_ssl_* not actually updating

  • MXS-5039 cooperative_monitoring_locks can leave stale locks on a server if network breaks

  • MXS-5038 Maxscale key limitations

  • MXS-5035 Setting a path argument to empty reads uninitialized memory

  • MXS-5034 REST-API TLS keys are not validated at runtime

  • MXS-5033 MaxScale should prevent incompatible TLS certificates from being configured

  • MXS-5031 enforce_read_only_slaves can set master to read_only

  • MXS-5023 kill user and transaction_replay don't play well together in Galera cluster

  • MXS-5021 gdb-stacktrace is incorrectly presented as a debug option

  • MXS-5010 Session commands that are executed early are not validated

  • MXS-5006 maxscale crash

  • MXS-4964 Simple sharding tutorial is out of date

  • MXS-4902 MariaDB Monitor command reset-replication can be started on a secondary MaxScale

  • MXS-4834 MaxScale should log a warning if failover may lose transactions

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.5 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.5 Release Notes -- 2024-03-11

MariaDB MaxScale 23.08.5 Release Notes -- 2024-03-11

Release 23.08.5 is a GA release.

This document describes the changes in release 23.08.5, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

External CVEs resolved.

  • CVE-2023-1667 Fixed by MXS-5011 Upgrade libssh to 0.10.6

  • CVE-2023-2283 Fixed by MXS-5011 Upgrade libssh to 0.10.6

  • CVE-2023-6004 Fixed by MXS-5011 Upgrade libssh to 0.10.6

  • CVE-2023-6918 Fixed by MXS-5011 Upgrade libssh to 0.10.6

  • CVE-2023-48795 Fixed by MXS-5011 Upgrade libssh to 0.10.6

New Features

  • MXS-4917 Add disk_space_ok option to master_conditions and slave_conditions

Bug fixes

  • MXS-5008 Log message on releasing exclusive locks when no lock majority is confusing

  • MXS-5007 Top-level service reconnection may cause a use-after-free

  • MXS-5001 Maxscale fail to initiate maxscale.service (Missing /var/run/maxscale) directory

  • MXS-4998 MaxScale may send two COM_QUIT packets

  • MXS-4997 MaxScale: BUILD/install_build_deps.sh: deprecated --force-yes

  • MXS-4996 Order of servers is different after restart if runtime modifications have been done

  • MXS-4995 The "static" property of an object is lost upon restart

  • MXS-4994 Multiple warnings from the REST-API are printed on the same line

  • MXS-4992 Documentation Link in GUI leads to 404 page not found

  • MXS-4988 maxscale doesn't properly close connections for TCP health check probes

  • MXS-4982 OpenSSL system call error is logged as ERROR when client disconnects abruptly

  • MXS-4981 Hang on shutdown when large batches of session command are pending

  • MXS-4979 COM_CHANGE_USER may leave stale IDs to be checked

  • MXS-4978 Read-only transactions are incorrectly tracked

  • MXS-4969 Can't create more than max_prepared_stmt_count statements

  • MXS-4968 REST-API TLS certificates can be reloaded but the path to them cannot be altered

  • MXS-4967 Log throttling is sometimes disabled too early

  • MXS-4961 Result of KILL CONNECTION_ID() does not propagate all the way to the client

  • MXS-4956 Session commands ignore delayed_retry_timeout

  • MXS-4948 Unable to see columns of view in the Query Editor

  • MXS-4947 Tables in information_schema are treated as a normal tables

  • MXS-4945 GUI doesn't validate object name uniqueness accurately

  • MXS-4943 delayed_retry timeout errors do not have enough information

  • MXS-4935 False protocol incompatibility error

  • MXS-4934 Use-after-free after service deletion

  • MXS-4930 'maxctrl reload tls' has the usage of 'maxctrl reload service'

  • MXS-4926 History length of sessions is not visible in the REST-API

  • MXS-4925 self link in /maxscale/logs/data is off by one page

  • MXS-4924 Very fast client and server may end up busy-looping a worker

  • MXS-4922 Memory growth for long-running sessions that use COM_CHANGE_USER

  • MXS-4921 Memory growth for long-running sessions that use prepared statements

  • MXS-4914 GUI dashboard's width is reduced unexpectedly

  • MXS-4912 Query classifier cache total-size book-keeping may be wrong

  • MXS-4910 readconnroute performance regression in 6.4

  • MXS-4907 Nested parameters in PATCH /v1/maxscale/ do not work correctly

  • MXS-4906 MonitorWorker::call_run_one_tick() called more often than intended

  • MXS-4903 Bad configuration in PATCH may partially configure monitors

  • MXS-4901 Turning on log_info causes parsing related errors and warnings

  • MXS-4900 maxctrl show qc_cache can easily overwhelm MaxScale

  • MXS-4898 MaxScale sends wrong character set (session tracking)

  • MXS-4896 Reducing the size of the query classifier cache does not cause excess entries to be freed.

  • MXS-4893 Query history retention period increases unexpectedly every time the setting dialog is opened

  • MXS-4891 Query editor schema explorer is disabled after reconnecting connections

  • MXS-4888 Unable to type custom row limit in the Query configuration dialog

  • MXS-4879 Transaction state viewed from the session is different from the transaction state as viewed from RWS.

  • MXS-4865 5.5.5- prefix should not be added if all backends are MariaDB 11

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.4 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.4 Release Notes -- 2023-12-05

MariaDB MaxScale 23.08.4 Release Notes -- 2023-12-05

Release 23.08.4 is a GA release.

This document describes the changes in release 23.08.4, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

New Features

  • MXS-4862 SSL_VERSION should have a way to disallow deprecated versions

Bug fixes

  • MXS-4881 Startup option --basedir mishandled

  • MXS-4869 Parameter table isn't refreshed after update in the GUI

  • MXS-4866 GUI doesn't show and allow to edit connection_metadata after a listener is created

  • MXS-4858 maxscale 23.08.3 crash with dump_last_statements=on_close set

  • MXS-4856 GUI failed to create a monitor in a monitored server detail page

  • MXS-4855 While writing query GUI response very slow

  • MXS-4851 No space or separator between 2 routing targets in the services dashboard

  • MXS-4818 Columns with the same name break sorting, filtering, and grouping features in Query Editor

  • MXS-4798 Broken slave promoted to master when no other servers are available

  • MXS-4789 GUI workspace caching doesn't work accurately

  • MXS-4728 Laggy issues on result data table

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.3 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.3 Release Notes -- 2023-11-06

MariaDB MaxScale 23.08.3 Release Notes -- 2023-11-06

Release 23.08.3 is a GA release.

This document describes the changes in release 23.08.3, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

Bug fixes

  • MXS-4847 Crash on maxctrl list sessions

  • MXS-4844 Relative paths do not work when defined in the configuration file

  • MXS-4803 Binlog encryption broken

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.2 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.2 Release Notes -- 2023-10-30

MariaDB MaxScale 23.08.2 Release Notes -- 2023-10-30

Release 23.08.2 is a GA release.

This document describes the changes in release 23.08.2, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

External CVEs resolved.

  • CVE-2022-1586 Fixed by MXS-4806 Update pcre2 to 10.42

  • CVE-2022-1587 Fixed by MXS-4806 Update pcre2 to 10.42

  • CVE-2022-41409 Fixed by MXS-4806 Update pcre2 to 10.42

New Features

  • MXS-4759 Force failover flag

Bug fixes

  • MXS-4831 Missing SQL error in server state change messages

  • MXS-4829 Query Editor doesn't assign active database to existing query tabs

  • MXS-4822 Chart pane width issue in Query Editor

  • MXS-4821 Multi-statement detection works differently on non-AVX2 CPUs

  • MXS-4817 maxscale crashes on maxsimd::generic::is_multi_stmt_imp

  • MXS-4815 @@last_gtid and @@last_insert_id are treated differently

  • MXS-4814 GTIDs used by causal_reads=global cannot be reset without restarting MaxScale

  • MXS-4812 More than one primary database in a monitor results in errors in MaxScale GUI

  • MXS-4811 Error handling differences between running maxctrl directly or in a subshell

  • MXS-4810 --timeout doesn't work with multiple values in --hosts

  • MXS-4808 connection_metadata checks for the wrong capability bit

  • MXS-4807 MaxScale does not always report the OS version correctly

  • MXS-4799 ConfigManager may spam the log with warnings

  • MXS-4797 NullFilter has not been extended to support all routing enumeration values.

  • MXS-4792 Semi-sync replication through MaxScale causes errors on STOP SLAVE

  • MXS-4790 Log version after log rotation

  • MXS-4788 Galeramon should use gtid_binlog_pos if gtid_current_pos is empty

  • MXS-4782 Kafkacdc logs warnings about the configuration

  • MXS-4781 cooperative_replication works even if cluster parameter is not used

  • MXS-4780 Shutdown may hang if cooperative_replication is used

  • MXS-4778 Aborts due to SystemD watchdog should tell if a DNS lookup was in progress

  • MXS-4777 Maxscale crash due to systemd timeout

  • MXS-4776 Sescmd target selection is sub-optimal with lazy_connect

  • MXS-4775 KafkaCDC: current_gtid.txt is moving but is behind

  • MXS-4772 Config sync status leaves origin field empty on restart

  • MXS-4771 Problem while linking libnosqlprotocol.so

  • MXS-4750 dynamic_node_detection=false does not work with server hostname, needs IP

  • MXS-4743 switchover-force should ignore replication delay

  • MXS-4718 Add replication_custom_options to enable replication TLS certification check

  • MXS-4686 Undefined behavior in ed25519 plugin

  • MXS-4604 Qlafilter doesn't handle pipelined queries correctly

  • MXS-4562 When MaxScalle is installed from tarball and starded without -d option --basedir=. is not parsed properly and full directory needs to be specified

  • MXS-4538 No valid servers in cluster 'MariaDB-Monitor'

  • MXS-4457 Duplicate values in servers are silently ignored

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08.1 Release Notes

MaxScale 23.08 MariaDB MaxScale 23.08.1 Release Notes -- 2023-09-21

MariaDB MaxScale 23.08.1 Release Notes -- 2023-09-21

Release 23.08.1 is a GA release.

This document describes the changes in release 23.08.1, when compared to the previous release in the same series.

If you are upgrading from an older major version of MaxScale, please read theupgrading document for this MaxScale version.

For any problems you encounter, please consider submitting a bug report on our Jira.

External CVEs resolved.

  • CVE-2023-27371 Fixed by MXS-4751 Update libmicrohttpd to version 0.9.76

New Features

  • MXS-3761 Visualize response_time_distribution

  • MXS-3753 Add option to run PAM authentication in a suid sanbox

Bug fixes

  • MXS-4762 REST-API generates too many errors for some endpoints

  • MXS-4760 Automatically ignored tables are not documented for schemarouter

  • MXS-4749 log_throttling should be disabled if log_info is on

  • MXS-4735 Connection IDs are missing from error messages

  • MXS-4724 slave_selection_criteria should accept lowercase version of the values

  • MXS-4723 Passthrough authentication does not support COM_CHANGE_USER

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL

MariaDB MaxScale 23.08 Release Notes

MariaDB MaxScale 23.08 Release Notes -- 2023-09-04

MariaDB MaxScale 23.08 Release Notes -- 2023-09-04

Release 23.08.0 is a Beta release.

This document describes the changes in release 23.08, when compared to release 23.02.

For any problems you encounter, please consider submitting a bug report on our Jira.

Changed Features

MXS-2744 Switchover improvements

During switchover, MariaDB-Monitor creates a new connection to the master with a long timeout, ignoring the limit of backend_read_timeout. This reduces the probability of long commands such as set global read_only=1 timing out. When kicking out super and read-only admin users, monitor prevent writes with "flush tables with read lock". Seemonitor documentation for more information.

MXS-4385 No newlines in logged messages

Earlier when the SQL sent by a client was logged due to log_info being enabled, the SQL was logged verbatim, which would cause the log to contain extra newlines in case the SQL did. From 23.08 forward, newlines are replaced with the text , so that a logged line will not contain any extra newlines.

connection_timeout renamed to wait_timeout

The connection_timeout parameter was renamed to wait_timeout and the old name is now an alias to the new name. The use of the old name is deprecated.

max_slave_replication_lag renamed to max_replication_lag

The Readwritesplit max_slave_replication_lag parameter was renamed tomax_replication_lag and the old name is now an alias for the new name. The use of the old name is deprecated.

Dropped Features

Deprecated Features

  • The configuration parameters query_classifier and query_classifier_args have been deprecated and are ignored.

  • The strip_db_esc parameter is deprecated and will be removed in a future release. The default behavior of stripping escape characters is in all known cases the correct thing to do and as such this parameter is never required.

New Features

MXS-3531 Lower regular expression matching limits

The PCRE2 library used by MaxScale now limits the heap memory to 1GB and the matching limit to 500000 matches. This change was done to prevent catastrophic backtracing that occurred when regular expressions used nested recursion e.g. SELECT.*.*FROM.*.*t1.

MXS-3664 Built-in caching in nosqlprotocol

The NoSQL protocol module now supports internal caching. Since this cache uses keys created from NoSQL protocol requests and stores NoSQL protocol responses, it is more efficient than the regular cache filter. More information about this functionality can be foundhere.

MXS-3983 Add switchover-force command

This version of switchover performs the switch even if the primary server is unresponsive i.e. responds to pings but does not perform any commands in a reasonable time. May lead to diverging replication on the old primary. Seemonitor documentation for more information.

MXS-4123 Fast universal causal reads

The causal_reads=fast_universal mode uses the same mechanism to retrieve the GTID position that the universal mode uses but behaves like the fast mode when routing queries.

MXS-4215 Manual schemarouter cache invalidation

The schemarouter database map cache can now be manually cleared with a MaxCtrl command:

maxctrl call command schemarouter clear <service>

This makes it possible to schedule the clearing of the caches for busy systems where the update of the map takes a long time.

MXS-4216 Stale cache usage in schemarouter

Stale entries in the schemarouter database map can now be used up tomax_staleness seconds. This reduces the impact that a shard update causes to the client applications.

MXS-4232 Remember old service password

When the service password is changed, MaxScale will remember and use the previous password if the new does not work. This makes it easier to manage the changing of the password, as the password in the backend and in MaxScale need not be changed simultaneously. More information about this functionality can be foundhere.

MXS-4277 Configurable iss field in JWTs

The iss field of the JWTs that the REST-API in MaxScale generates can now be configured with admin_jwt_issuer. This allows REST-API clients to see who issued the token.

MXS-4377 Common options

It is now possible to specify options in an include-section, to be included by other sections. This is useful, for instance, if there are multiple monitors that otherwise are identically configured, but for their list of servers. More information about this functionality can be foundhere.

MXS-4505 Safer replaying of about-to-commit transactions

The new transaction_replay_safe_commit variable controls whether about-to-commit transaction are replayed when transaction_replay is enabled. The new default is to not replay transactions that were being committed when the connection to the server was lost.

MXS-4506 Add passthrough authentication support for Xpand LDAP

Passthrough authentication mode for MariaDBAuth-module. Seeauthenticator documentation for more information.

MXS-4549 Queries with partially returned results can be replayed

If a query in a transaction is interrupted and the result was partially delivered to the client, readwritesplit will now retry the execution of the query and discard the already delivered part of the result.

MXS-4618 LOAD DATA LOCAL INFILE from S3

The LDI filter adds support for LOAD DATA LOCAL INFILE from S3 compatible storage.

MXS-4635 Early connection metadata

The new connection_metadata listener parameter controls the set of metadata variables that are sent to the client during connection creation.

By default the values of the system variables character_set_client,character_set_connection, character_set_results, max_allowed_packet,system_time_zone, time_zone and tx_isolation are sent as well as the current number of connections as the threads_connected variable and the real 64-bit connection ID as connection_id.

Compatible MariaDB connectors will use this information from MaxScale instead of querying the values of the variables from the database server which greatly speeds up connection creation.

MXS-4637 Bootstrap process for Xpand should be region-aware

It is now possible to limit the nodes the Xpand monitor dynamically detects to those residing in a specific region. See region_name and region_oid for more information.

MaxGUI

Numerous additions have been added and improvements made to MaxGUI. The most notable ones are listed here:

  • MXS-3735 Add ERD modeler to the workspace. Instructions on using it can be found here.

  • MXS-3991 Show schema objects insights. Instructions on using it can be found here.

  • MXS-4364 Auto choose active schema for new query tab.

Bug fixes

MXS-4477 Dashboard graphs refresh unnecessarily

Known Issues and Limitations

There are some limitations and known issues within this version of MaxScale. For more information, please refer to the Limitations document.

Packaging

RPM and Debian packages are provided for the supported Linux distributions.

Packages can be downloaded here.

Source Code

The source code of MaxScale is tagged at GitHub with a tag, which is identical with the version of MaxScale. For instance, the tag of version X.Y.Z of MaxScale is maxscale-X.Y.Z. Further, the default branch is always the latest GA version of MaxScale.

The source code is available here.

CC BY-SA / Gnu FDL