A.2. Tungsten Clustering 6.1.13 GA (27 May 2021)

Version End of Life. Not Yet Set

Release 6.1.13 contains a number of bug fixes, and contains a new Connector feature: Support for Proxy Protocol v1 (if supported by your underlying MySQL release)

Behavior Changes

The following changes have been made to Tungsten Cluster and may affect existing scripts and integration tools. Any scripts or environment which make use of these tools should check and update for the new configuration:

  • Command-line Tools

    • The tpm diag command now gathers tungsten-manager/log/console.log* files.

      Issues: CT-1500

    • The tpm diag command now gathers the tungsten-manager/log/cctrl.log file.

      Issues: CT-1510

    • Ensure that all tools are available in the appropriate software packages.

      Issues: CT-1518

  • Tungsten Connector

    • In a Composite Active/Active topology, connectors within both sites have read and write affinity set to the local site by default.

      Issues: CT-1502, CT-1505

Improvements, new features and functionality

  • Command-line Tools

    • A new utility, tungsten_skip_seqno has been added which allows events to be skipped based on filters, allowing the Tungsten Replicator to come back online with less manual intervention.

      Issues: CT-42, CT-1087, CT-1453, CT-1511

  • Tungsten Connector

    • Full support for proxy-protocol v1 has been added to Tungsten Connector.

      Proxy protocol specifications can found here: http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt

      Enabling proxy-protocol:

      • You first need a compatible server, like MariaDB 10.3+ or Percona-5.6.25-73.0+, with the proxy protocol functionality enabled, for example in my.cnf: proxy-protocol-networks=*

      • Then install or update Tungsten with --connector-enable-proxy-protocol=true

      You should now see the origin IP of the connecting application in place of the connector IP in show processlist and tungsten show processlist commands.

      Furher reading:

      Issues: CT-1533

Bug Fixes

  • Command-line Tools

    • This release includes a wide range of improvements and bug fixes for tpm and other command-line tools.

      Issues: CT-1509

    • Fixes an issue where the undeployall command would create a root owned wrapper.log in the ./tools directory.

      Issues: CT-1516

    • Fixed a tpm call to systemd services listing which was making tpm wrongly fall back to init.d. This issue was found when testing MariaDB 10.0.

      Issues: CT-1524

    • tpm now supports new MariaDB my_print_defaults flag --defaults-file

      Issues: CT-1528

  • Core Replicator

    • Fixes an issue where null values in JSON structures were incorrectly quoted once replicated.

      For example :

      [{"example":null}]

      would be replicated as

      [{"example":"null"}]

      Issues: CT-1523

  • Tungsten Connector

    • Now properly supporting negative write affinity in Composite Active/Active clusters. For example you can now specify affinity=localSite,-remoteSite:localSite This allows access only to local sites for writes but still allows reads from remote sites if the local one goes down.

      Issues: CT-1507

  • Tungsten Manager

    • Fixes an issue in Composite Active/Active environments that would occasionally cause the primary node to be set to read only.

      Issues: CT-1424