Continuent Documentation

Manual Home
Release Notes

2.25. Tungsten Replicator 5.0.1 GA (23 February 2017)

Version End of Life. 30 June 2018

Tungsten Replicator 5.0.1 is a bugfix release that contains critical fixes and improvements from the Tungsten Replicator 5.0.0 release. Specifically, it changes the default security and other settings to make upgrades from previous releases easier, and other fixes and improvements to the Oracle support and command-line tools.

Behavior Changes

The following changes have been made to Continuent Replicator 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:

  • The default security configuration for new installations is for security, including SSL and TLS and authentication, to be disabled. In 5.0.0 the default was to enable full security on all components which could lead to problems and difficulty when upgrading.

    Issues: CT-18

  • The Ruby Net::SSH module, which has been bundled with Tungsten Replicator in past releases, is no longer included. This is due to the wide range of Ruby versions and deployment environments that we support, and differences in the Net::SSH module supported and used with different Ruby versions. In order to simplify the process and ensure that the platforms we support operate correctly, the Net::SSH module has been removed and will now need to be installed before deployment.

    To ensure you have the correct environment before deployment, ensure both the Net::SSH and Net::SCP Ruby modules are installed using gem:

    shell> gem install net-ssh
    shell> gem install net-scp

    Depending on your environment, you may also need to install the io-console module:

    shell> gem install io-console

    If during installation you get an error similar to this:

    mkmf.rb can't find header files for ruby at /usr/lib/ruby/include/ruby.h

    It indicates that you do not have the Ruby development headers installed. Use your native package management interface (for example yum or apt and install the ruby-dev package. For example:

    shell> sudo apt install ruby-dev

    Issues: CT-88

  • The replicator (in [Tungsten Replicator 5.0 Manual]) is no longer restarted when updating the configuration with tpm (in [Tungsten Replicator 5.0 Manual]) when using the --replace-tls-certificate (in [Tungsten Replicator 5.0 Manual]) option.

    Issues: CT-120

  • For compatibility with MySQL 5.7, the tpm (in [Tungsten Replicator 5.0 Manual]) command will now check for the super_read_only setting and warn if this setting is enabled.

    Issues: CONT-1039

  • For compatibility with MySQL 5.7, the tpm (in [Tungsten Replicator 5.0 Manual]) command will use the authentication_string field for validating passwords.

    Issues: CONT-1058

  • For compatibility with MySQL 5.7, the tpm (in [Tungsten Replicator 5.0 Manual]) command will now ignore the sys schema.

    Issues: CONT-1059

Improvements, new features and functionality

  • Installation and Deployment

    • Tungsten Replicator is now certified for deployment on systems running Java 8.

      Issues: CT-27

  • Core Replicator

    • The replicator will now generate a detailed heap dump in the event of a failure. This will help during debugging and identifying any issues.

      Issues: CT-11

  • Filters

    • The Rhino JS, which is incorporated for use by the filtering and batch loading mechanisms, has been updated to Rhino 1.7R4. This addresses a number of different issues with the embedded library, including a performance issue that could lead to increased latency during filter operations.

      Issues: CT-21

Bug Fixes

  • Installation and Deployment

    • The Ruby Net::SSH libraries used by tpm (in [Tungsten Replicator 5.0 Manual]) have been updated to the latest version. This addresses issues with SSH and staging based deployments, including KEX algorithm errors.

      Issues: CT-16

    • On some platforms the keytool command could fail to be found, causing an error within the installation when generating certificates.

      Issues: CT-73

  • Command-line Tools

    • The tpasswd (in [Tungsten Replicator 5.0 Manual]) could create a log file with the wrong permissions.

      Issues: CT-117

  • Core Replicator

    • Checksums in MySQL could cause problems when parsing the MySQL binary log due to a change in the way the checksum information is recorded within the binary log. This would cause the replicator to become unable to come online.

      Issues: CT-72

Known Issues

  • Behavior Changes

    • Due to new requirements of the embedded and included Ruby Net::SSH module, the Ruby io-console module may need to be installed before installation or upgrade. This can be achieved using:

      shell> gem install io-console