MySQLCluster7.3.6Released_MySQL

The binary and source versions of MySQL Cluster 7.3.6 have now been made available at http://www.mysql.com/downloads/cluster/ .

Release notes

MySQL Cluster NDB 7.3.6 is a new release of MySQL Cluster, based

on MySQL Server 5.6 and including features from version 7.3 of the

NDB storage engine, as well as fixing a number of recently

discovered bugs in previous MySQL Cluster releases.

Obtaining MySQL Cluster NDB 7.3. MySQL Cluster NDB 7.3 source

code and binaries can be obtained from

http://dev.mysql.com/downloads/cluster/ .

For an overview of changes made in MySQL Cluster NDB 7.3, see

MySQL Cluster Development in MySQL Cluster NDB 7.3

( http://dev.mysql.com/doc/refman/5.6/en/mysql-cluster-development-5-6-ndb-7-3.html ).

This release also incorporates all bugfixes and changes made in

previous MySQL Cluster releases, as well as all bugfixes and

feature changes which were added in mainline MySQL 5.6 through

MySQL 5.6.19 (see Changes in MySQL 5.6.19 (2014-05-30)

( http://dev.mysql.com/doc/relnotes/mysql/5.6/en/news-5-6-19.html )).

Functionality Added or Changed

• Cluster API: Added as an aid to debugging the ability to

  specify a human-readable name for a given Ndb object and later

  to retrieve it. These operations are implemented,

  respectively, as the setNdbObjectName() and getNdbObjectName()

  methods.

  To make tracing of event handling between a user application

  and NDB easier, you can use the reference (from getReference()

  followed by the name (if provided) in printouts; the reference

  ties together the application Ndb object, the event buffer,

  and the NDB storage engine’s SUMA block. (Bug #18419907)

Bugs Fixed

• Cluster API: When two tables had different foreign keys with
  the same name, ndb_restore considered this a name conflict and
  failed to restore the schema. As a result of this fix, a slash
  character (/) is now expressly disallowed in foreign key
  names, and the naming format parent_id/child_id/fk_name is now
  enforced by the NDB API. (Bug #18824753)
• Processing a NODE_FAILREP signal that contained an invalid
  node ID could cause a data node to fail. (Bug #18993037, Bug
  #73015)
  References: This bug is a regression of Bug #16007980.
• When building out of source, some files were written to the
  source directory instead of the build dir. These included the
  manifest.mf files used for creating ClusterJ jars and the
  pom.xml file used by mvn_install_ndbjtie.sh. In addition,
  ndbinfo.sql was written to the build directory, but marked as
  output to the source directory in CMakeLists.txt. (Bug
  #18889568, Bug #72843)
• Adding a foreign key failed with NDB Error 208 if the parent
  index was parent table’s primary key, the primary key was not
  on the table’s initial attributes, and the child table was not
  empty. (Bug #18825966)
• When an NDB table served as both the parent table and a child
  table for 2 different foreign keys having the same name,
  dropping the foreign key on the child table could cause the
  foreign key on the parent table to be dropped instead, leading
  to a situation in which it was impossible to drop the
  remaining foreign key. This situation can be modelled using
  the following CREATE TABLE statements:
  CREATE TABLE parent (
id INT NOT NULL,
PRIMARY KEY (id)
) ENGINE=NDB;
CREATE TABLE child (
id INT NOT NULL,
parent_id INT,
PRIMARY KEY (id),
INDEX par_ind (parent_id),
FOREIGN KEY (parent_id)
REFERENCES parent(id)
) ENGINE=NDB;
CREATE TABLE grandchild (
id INT,
parent_id INT,
INDEX par_ind (parent_id),
FOREIGN KEY (parent_id)
REFERENCES child(id)
) ENGINE=NDB;

  With the tables created as just shown, the issue occured when
  executing the statement ALTER TABLE child DROP FOREIGN KEY
  parent_id, because it was possible in some cases for NDB to
  drop the foreign key from the grandchild table instead. When
  this happened, any subsequent attempt to drop the foreign key
  from either the child or from the grandchild table failed.
  (Bug #18662582)
• ndbmtd supports multiple parallel receiver threads, each of
  which performs signal reception for a subset of the remote
  node connections (transporters) with the mapping of
  remote_nodes to receiver threads decided at node startup.
  Connection control is managed by the multi-instance TRPMAN
  block, which is organized as a proxy and workers, and each
  receiver thread has a TRPMAN worker running locally.
  The QMGR block sends signals to TRPMAN to enable and disable
  communications with remote nodes. These signals are sent to
  the TRPMAN proxy, which forwards them to the workers. The
  workers themselves decide whether to act on signals, based on
  the set of remote nodes they manage.
  The current isuue arises because the mechanism used by the
  TRPMAN workers for determining which connections they are
  responsible for was implemented in such a way that each worker
  thought it was responsible for all connections. This resulted
  in the TRPMAN actions for OPEN_COMORD, ENABLE_COMREQ, and
  CLOSE_COMREQ being processed multiple times.
  The fix keeps TRPMAN instances (receiver threads) executing
  OPEN_COMORD, ENABLE_COMREQ and CLOSE_COMREQ requests. In
  addition, the correct TRPMAN instance is now chosen when
  routing from this instance for a specific remote connection.
  (Bug #18518037)
• Executing ALTER TABLE … REORGANIZE PARTITION after
  increasing the number of data nodes in the cluster from 4 to
  16 led to a crash of the data nodes. This issue was shown to
  be a regression caused by previous fix which added a new dump
  handler using a dump code that was already in use (7019),
  which caused the command to execute two different handlers
  with different semantics. The new handler was assigned a new
  DUMP code (7024). (Bug #18550318)
  References: This bug is a regression of Bug #14220269.
• When running with a very slow main thread, and one or more
  transaction coordinator threads, on different CPUs, it was
  possible to encounter a timeout when sending a
  DIH_SCAN_GET_NODESREQ signal, which could lead to a crash of
  the data node. Now in such cases the timeout is avoided. (Bug
  #18449222)
• During data node failure handling, the transaction coordinator
  performing takeover gathers all known state information for
  any failed TC instance transactions, determines whether each
  transaction has been committed or aborted, and informs any
  involved API nodes so that they can report this accurately to
  their clients. The TC instance provides this information by
  sending TCKEY_FAILREF or TCKEY_FAILCONF signals to the API
  nodes as appropriate top each affected transaction.
  In the event that this TC instance does not have a direct
  connection to the API node, it attempts to deliver the signal
  by routing it through another data node in the same node group
  as the failing TC, and sends a GSN_TCKEY_FAILREFCONF_R signal
  to TC block instance 0 in that data node. A problem arose in
  the case of multiple transaction cooridnators, when this TC
  instance did not have a signal handler for such signals, which
  led it to fail.
  This issue has been corrected by adding a handler to the TC
  proxy block which in such cases forwards the signal to one of
  the local TC worker instances, which in turn attempts to
  forward the signal on to the API node. (Bug #18455971)
• A local checkpoint (LCP) is tracked using a global LCP state
  (c_lcpState), and each NDB table has a status indicator which
  indicates the LCP status of that table (tabLcpStatus). If the
  global LCP state is LCP_STATUS_IDLE, then all the tables
  should have an LCP status of TLS_COMPLETED.
  When an LCP starts, the global LCP status is LCP_INIT_TABLES
  and the thread starts setting all the NDB tables to
  TLS_ACTIVE. If any tables are not ready for LCP, the LCP
  initialization procedure continues with CONTINUEB signals
  until all tables have become available and been marked
  TLS_ACTIVE. When this initialization is complete, the global
  LCP status is set to LCP_STATUS_ACTIVE.
  This bug occurred when the following conditions were met:
  • An LCP was in the LCP_INIT_TABLES state, and some but not
    all tables had been set to TLS_ACTIVE.
  • The master node failed before the global LCP state
    changed to LCP_STATUS_ACTIVE; that is, before the LCP
    could finish processing all tables.
  • The NODE_FAILREP signal resulting from the node failure
    was processed before the final CONTINUEB signal from the
    LCP initialization process, so that the node failure was
    processed while the LCP remained in the LCP_INIT_TABLES
    state.
    Following master node failure and selection of a new one, the
    new master queries the remaining nodes with a MASTER_LCPREQ
    signal to determine the state of the LCP. At this point, since
    the LCP status was LCP_INIT_TABLES, the LCP status was reset
    to LCP_STATUS_IDLE. However, the LCP status of the tables was
    not modified, so there remained tables with TLS_ACTIVE.
    Afterwards, the failed node is removed from the LCP. If the
    LCP status of a given table is TLS_ACTIVE, there is a check
    that the global LCP status is not LCP_STATUS_IDLE; this check
    failed and caused the data node to fail.
    Now the MASTER_LCPREQ handler ensures that the tabLcpStatus
    for all tables is updated to TLS_COMPLETED when the global LCP
    status is changed to LCP_STATUS_IDLE. (Bug #18044717)