4.1. Tungsten Clustering 7.2.0 GA (Not Yet Set)

Version End of Life. Not Yet Set

Release 7.2.0 contains a number of key bug fixes and improvements.

Deprecation Notices

The following features/tools have been deprecated from this release and will be removed in future releases. Any self written scripts that utilise these features should be updated.

  • Command-line Tools

    • tungsten_health_check and tungsten_provision_thl have been deprecated and will be removed in a future release.

      Issues: CT-2506

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:

  • Installation and Deployment

    • All Tungsten components now use log4j version 2

      Issues: CT-1410, CT-1412

  • Command-line Tools

    • The tungsten_send_diag command has been updated with new security keys and the ability to accept security keys on the CLI.

      Issues: CT-2438

    • Removed sigtrap module dependency from tungsten_find_orphaned.

      Issues: CT-2451

    • The tpm ask command now returns the appropriate values for keys: stagingdir, stagingpath, staginghost and staginguser.

      Additionally, the tpm ask staging command will return a JSON structure with all values. All values are the same as the output of the tpm query staging command, just presented differently for easier machine usage.

      Issues: CT-2510

    • The tpm cert info command now provides better error messages when a specified typeSpec file does not exist.

      Issues: CT-2530

  • Tungsten Connector

    • Connector now always reads its dynamic (auto-detect) configuration from primary node by default.

      Issues: CT-2527

  • API

    • The Manager APIv2 now returns a 404 error instead of 500 when a task status is requested for a TaskID that does not exist inside that Manager process.

      Issues: CT-2430

Improvements, new features and functionality

  • Installation and Deployment

  • Command-line Tools

    • The new tpm ini command allows for easy creation, checking and administration of the /etc/tungsten/tungsten.ini configuration file.

      Issues: CT-2366

    • The tpm ask command now supports the -s|--service option for dsrole, dsstate, trrole and trstate keys. The option alias for --short is now -S (capitalized), was previously lower-case. Example: tpm ask dsrole --service east_from_west

      Issues: CT-2400

    • The tpm cert command will now handle public key files. The command tpm cert gen public will create $CONTINUENT_HOME/generated/tungsten_public.jks from the $CONTINUENT_HOME/share/tungsten_keystore.jks file and the tpm cert list public command will show the contents, etc.

      Issues: CT-2434

    • The tpm diag command now gathers the output of the tpm ini check -x command as the tpmINICheck call.

      Issues: CT-2499

    • The tpm ini command now handles all new tpm options.

      Issues: CT-2543

    • The tpm ask command will now convert values 0 and false to No and values 1 and true to Yes as human output when given --human or -n cli args.

      Issues: CT-2559

  • Core Replicator

  • Tungsten Connector

    • Fixed a bug where connections properly disconnecting with quit command would get an empty database change request.

      Issues: CT-2395

    • Connector now recognizes the new MySQL 8.4 show replica status syntax (As well as show slave status) and will run replacement configured request appropriately.

      Issues: CT-2401

Bug Fixes

  • Installation and Deployment

    • The tpm update command no longer displays the message "common::diffPasswordsDotStore: No custom source passwords.store file defined - SKIPPING"

      Issues: CT-2406

    • tpm now properly detects MariaDB default settings.

      Issues: CT-2424

    • tpm flags datasource-log-directory and repl-direct-datasource-log-directory will now use the value of each other as a default if only one is specified

      Issues: CT-2425

  • Command-line Tools

    • The tpm diag command no longer displays a NOTICE for missing optional files.

      Issues: CT-2355

    • The tpm check ports and tpm check ports -c commands are now able to handle replicator-only nodes. By default, it will automatically try to discover the node type, and you may manually specify the node type with -r|--replicator or -c|--cluster.

      Issues: CT-2356

    • The tapi command now creates proper URL's for these standard endpoints when -C, -M or -R are specified along with one of the following strings: ping, tungstenVersion, createAdminUser, deleteAdminUser, listAdminUsers, rmiSecurity or user.

      Issues: CT-2391

    • The tpm diag command now gathers:

      • tungsten-replicator/log/replicator-api.log

      • tungsten-connector/log/connector-api.log

      • tungsten-manager/log/manager-api.log

      Issues: CT-2397

    • The tpm delete-service and tpm update commands now correctly remove Composite Active/Active cross-site subservices from cctrl

      Issues: CT-2404

    • The tungsten_get_status command now passes the correct number of arguments to the printf function in various places, preventing "Redundant argument" warnings.

      Issues: CT-2407

    • The tapi command now accepts non-standard ports on the command line, and also properly accepts a user/password pair on the CLI.

      Issues: CT-2420

    • The tpm update command now properly identifies and removes services with mixed-case service names.

      Issues: CT-2426

    • The tpm keep command is now properly called by tpm uninstall, and a regression in a call to the mysql cli has been fixed as well.

      Issues: CT-2462

    • executable-prefix is now applied to deployall and undeployall script names. For example, when executable-prefix=mm, deployall would be named mm_deployall.

      Issues: CT-2467

    • The tpm ask version and tpm ask versions commands now display values.

      Issues: CT-2475

    • During a tpm uninstall, when skipping data services not managed locally, tpm will now print a notice rather than a warning, since this is the expected behavior

      Issues: CT-2479

    • The tungsten_send_diag command now handles curl and AWS S3 errors separately and displays the proper message back.

      Issues: CT-2488

    • Fixes an issue where dsctl set with the -reset option could show warnings when run several times in a row, as shown:

      WARNING: Could not execute query DROP TABLE `tungsten_alpha`.`heartbeat` : Unknown table 'tungsten_alpha.heartbeat'

      Issues: CT-2502

    • The tpm cert aliases --running command now properly handles the tls_passwordstore and jmx_passwordstore typeSpecs.

      Issues: CT-2512

    • The tpm cert info command now properly handles all available typeSpecs.

      Issues: CT-2532

    • The tpm delete-service command now sets MAINTENANCE mode before operations, then sets back to AUTOMATIC if it was AUTOMATIC to start with.

      Issues: CT-2555

    • The tpm purge-thl command now works properly when run against environments where there are multiple THL files, but the lowest seqno returned exists in the very first THL file.

      Issues: CT-2561

  • Core Replicator

    • Fixed an issue that would wrongly flag a SQL statement starting with a # comment as bidi_unsafe

      Issues: CT-2405

    • The replicator will now properly rollback an XA transaction in case of failure.

      Issues: CT-2410

    • Fixed an issue where a cluster could display a wrong latency after MySQL and the replicator were stopped and restarted. This would only show under no load conditions.

      Issues: CT-2485

  • Tungsten Connector

    • Fixed an issue with PHP and caching_sha2_password when using proxy mode: the protocol part "fast path" was not handled properly by the connector, php would hang after reading an unexpected packet. Workaround for this issue (for earlier tungsten versions) is to set property=defaultAuthPlugin=mysql_native_password within /etc/tungsten/tungsten.ini.

      Issues: CT-2471

    • In active/active setups, no longer using global data service for show slave latency connector intercept.

      Issues: CT-2554