| CARVIEW |
The world's most popular open source database
- Documentation Library
- Table of Contents
- MySQL 6.0 Reference Manual
- MySQL 5.1 Reference Manual
- MySQL 5.0 Reference Manual
- MySQL 3.23/4.0/4.1 Manual
- Table of Contents
- Preface
- 1 General Information
- 2 Installing and Upgrading MySQL
- 3 Tutorial
- 4 MySQL Programs
- 5 MySQL Server Administration
- 6 Backup and Recovery
- 7 Optimization
- 8 Language Structure
- 9 Internationalization and Localization
- 10 Data Types
- 11 Functions and Operators
- 12 SQL Statement Syntax
- 13 Storage Engines
- 14 High Availability and Scalability
- 15 MySQL Enterprise Monitor
- 16 Replication
- 17 MySQL Cluster NDB 6.x
- 17.1 MySQL Cluster Overview
- 17.2 MySQL Cluster Multi-Computer How-To
- 17.3 MySQL Cluster Configuration
- 17.4 MySQL Cluster Options and Variables
- 17.5 Upgrading and Downgrading MySQL Cluster
- 17.6 Process Management in MySQL Cluster
- 17.7 Management of MySQL Cluster
- 17.8 MySQL Cluster Security Issues
- 17.9 MySQL Cluster Utility Programs
- 17.10 MySQL Cluster Replication
- 17.11 MySQL Cluster Disk Data Tables
- 17.12 Using High-Speed Interconnects with MySQL Cluster
- 17.13 Known Limitations of MySQL Cluster
- 17.14 MySQL Cluster Development Roadmap
- 17.15 MySQL Cluster Glossary
- 17.16 Changes in MySQL Cluster NDB 6.x
- 18 Partitioning
- 19 Stored Programs and Views
- 20 INFORMATION_SCHEMA Tables
- 21 Connectors and APIs
- 22 Extending MySQL
- A MySQL 5.1 Frequently Asked Questions
- B Errors, Error Codes, and Common Problems
- C MySQL Change History
- D Restrictions and Limits
- Index
Table of Contents [+/-]
- 17.1. MySQL Cluster Overview [+/-]
- 17.2. MySQL Cluster Multi-Computer How-To [+/-]
- 17.2.1. MySQL Cluster Hardware, Software, and Networking Requirements
- 17.2.2. MySQL Cluster Multi-Computer Installation
- 17.2.3. MySQL Cluster Multi-Computer Configuration
- 17.2.4. Initial Startup of MySQL Cluster
- 17.2.5. Loading Sample Data into MySQL Cluster and Performing Queries
- 17.2.6. Safe Shutdown and Restart of MySQL Cluster
- 17.3. MySQL Cluster Configuration [+/-]
- 17.3.1. Building MySQL Cluster from Source Code
- 17.3.2. Installing MySQL Cluster Software
- 17.3.3. Quick Test Setup of MySQL Cluster
- 17.3.4. MySQL Cluster Configuration Files
- 17.3.5. Overview of MySQL Cluster Configuration Parameters
- 17.3.6. Configuring MySQL Cluster Parameters for Local Checkpoints
- 17.3.7. Configuring MySQL Cluster Send Buffer Parameters
- 17.4. MySQL Cluster Options and Variables [+/-]
- 17.5. Upgrading and Downgrading MySQL Cluster [+/-]
- 17.6. Process Management in MySQL Cluster [+/-]
- 17.6.1. MySQL Server Process Usage for MySQL Cluster
- 17.6.2. ndbd — The Storage Engine Node Process
- 17.6.3. ndbmtd — The MySQL Cluster Storage Engine Node Process (Multi-Threaded)
- 17.6.4. ndb_mgmd — The Management Server Process
- 17.6.5. ndb_mgm — The Management Client Process
- 17.6.6. Command Options for MySQL Cluster Processes
- 17.7. Management of MySQL Cluster [+/-]
- 17.7.1. Summary of MySQL Cluster Start Phases
- 17.7.2. Commands in the MySQL Cluster Management Client
- 17.7.3. Online Backup of MySQL Cluster
- 17.7.4. Event Reports Generated in MySQL Cluster
- 17.7.5. MySQL Cluster Log Messages
- 17.7.6. MySQL Cluster Single User Mode
- 17.7.7. Quick Reference: MySQL Cluster SQL Statements
- 17.7.8. Adding MySQL Cluster Data Nodes Online
- 17.8. MySQL Cluster Security Issues [+/-]
- 17.9. MySQL Cluster Utility Programs [+/-]
- 17.9.1. ndb_config — Extract MySQL Cluster Configuration Information
- 17.9.2. ndb_cpcd — Automate Testing for NDB Development
- 17.9.3. ndb_delete_all — Delete All Rows from an NDB Table
- 17.9.4. ndb_desc — Describe NDB Tables
- 17.9.5. ndb_drop_index — Drop Index from an NDB Table
- 17.9.6. ndb_drop_table — Drop an NDB Table
- 17.9.7. ndb_error_reporter — NDB Error-Reporting Utility
- 17.9.8. ndb_print_backup_file — Print NDB Backup File Contents
- 17.9.9. ndb_print_schema_file — Print NDB Schema File Contents
- 17.9.10. ndb_print_sys_file — Print NDB System File Contents
- 17.9.11. ndbd_redo_log_reader — Check and Print Content of Cluster Redo Log
- 17.9.12. ndb_select_all — Print Rows from an NDB Table
- 17.9.13. ndb_select_count — Print Row Counts for NDB Tables
- 17.9.14. ndb_show_tables — Display List of NDB Tables
- 17.9.15. ndb_size.pl — NDBCLUSTER Size Requirement Estimator
- 17.9.16. ndb_waiter — Wait for MySQL Cluster to Reach a Given Status
- 17.10. MySQL Cluster Replication [+/-]
- 17.10.1. Abbreviations and Symbols
- 17.10.2. Assumptions and General Requirements
- 17.10.3. Known Issues in MySQL Cluster Replication
- 17.10.4. Cluster Replication Schema and Tables
- 17.10.5. Preparing the Cluster for Replication
- 17.10.6. Starting Replication (Single Replication Channel)
- 17.10.7. Using Two Replication Channels
- 17.10.8. Implementing Failover with MySQL Cluster
- 17.10.9. MySQL Cluster Backups With Replication
- 17.10.10. Multi-Master and Circular Replication
- 17.10.11. MySQL Cluster Replication Conflict Resolution
- 17.11. MySQL Cluster Disk Data Tables [+/-]
- 17.12. Using High-Speed Interconnects with MySQL Cluster [+/-]
- 17.13. Known Limitations of MySQL Cluster [+/-]
- 17.13.1. Non-Compliance with SQL Syntax in MySQL Cluster
- 17.13.2. Limits and Differences of MySQL Cluster from Standard MySQL Limits
- 17.13.3. Limits Relating to Transaction Handling in MySQL Cluster
- 17.13.4. MySQL Cluster Error Handling
- 17.13.5. Limits Associated with Database Objects in MySQL Cluster
- 17.13.6. Unsupported or Missing Features in MySQL Cluster
- 17.13.7. Limitations Relating to Performance in MySQL Cluster
- 17.13.8. Issues Exclusive to MySQL Cluster
- 17.13.9. Limitations Relating to MySQL Cluster Disk Data Storage
- 17.13.10. Limitations Relating to Multiple MySQL Cluster Nodes
- 17.13.11. Previous MySQL Cluster Issues Resolved in MySQL 5.1 and MySQL Cluster NDB 6.x
- 17.14. MySQL Cluster Development Roadmap [+/-]
- 17.15. MySQL Cluster Glossary
- 17.16. Changes in MySQL Cluster NDB 6.x [+/-]
This chapter contains information about MySQL Cluster NDB
6.x, which is a high-availability, high-redundancy
version of MySQL adapted for the distributed computing environment,
using version 6 of the NDBCLUSTER
storage engine (also known as NDB) to
enable running several computer with MySQL servers and other
software in a cluster.
Beginning with MySQL 5.1.24, support for the
NDBCLUSTER storage engine was
removed from the standard MySQL server binaries built by MySQL.
Instead, users of MySQL Cluster binaries built by MySQL should
upgrade to the most recent binary release of MySQL Cluster NDB 6.2
or MySQL Cluster 6.3 for supported platforms — these include
RPMs that should work with most Linux distributions. MySQL Cluster
users who build from source should be aware that, also beginning
with MySQL 5.1.24, NDBCLUSTER sources
in the standard MySQL 5.1 tree are no longer maintained; these users
should use the sources provided for MySQL Cluster NDB 6.2 or later.
(Locations where the sources can be obtained are listed later in
this section.)
Note
MySQL Cluster NDB 6.1, 6.2, and 6.3 were formerly known as “MySQL Cluster Carrier Grade Edition”. Beginning with MySQL Cluster NDB 6.2.15 and MySQL Cluster NDB 6.3.14, this term is no longer applied to the MySQL Cluster software — which is now known simply as “MySQL Cluster” — but rather to a commercial licensing and support package. You can learn more about available options for commercial licensing of MySQL Cluster from MySQL Cluster Features, on the MySQL web site.
This chapter contains information about MySQL Cluster in MySQL 5.1 mainline releases through MySQL 5.1.23, MySQL Cluster NDB 6.2 releases through 5.1.31-ndb-6.2.17, MySQL Cluster NDB 6.3 releases through 5.1.31-ndb-6.3.21, and MySQL Cluster NDB 6.4 releases through 5.1.31-ndb-6.4.1. Currently, the MySQL Cluster NDB 6.2 and MySQL Cluster NDB 6.3 release series are Generally Available (GA), and MySQL Cluster NDB 6.4 is in Beta Development phase.
This chapter also contains historical information about MySQL Cluster NDB 6.1, although this release series is no longer in active development, and should not be used in new deployments. Users of MySQL Cluster NDB 6.1 should upgrade to a later MySQL Cluster NDB 6.x release series as soon as possible.
Platforms supported. MySQL Cluster is currently available and supported on a number of platforms, including Linux, Solaris, Mac OS X, HP-UX, and other Unix-style operating systems on a variety of hardware. Beginning with MySQL Cluster NDB 6.4, MySQL Cluster is also available on Microsoft Windows platforms. For exact levels of support available for on specific combinations of operating system versions, operating system distributions, and hardware platforms, please refer to the Cluster Supported Platforms list, maintained by the MySQL Support Team on the MySQL web site.
We are continuing to work to make MySQL Cluster available on all operating systems supported by MySQL and will update the information provided here as this work continues.
Availability. MySQL Cluster NDB 6.2 and MySQL Cluster 6.3 binary and source packages are available for supported platforms from https://dev.mysql.com/downloads/cluster.
Note
Binary releases and RPMs were not available for MySQL Cluster NDB 6.2 prior to MySQL Cluster NDB 6.2.15.
MySQL Cluster NDB 6.4 is currently available only as source. Source tarballs for the latest MySQL Cluster NDB 6.3 release can be obtained from ftp://ftp.mysql.com/pub/mysql/download/cluster_telco/.
MySQL Cluster release numbers.
Starting with MySQL Cluster NDB 6.1 and 6.2, MySQL Cluster follows
a somewhat different release pattern from the mainline MySQL 5.1
Cluster series of releases. In this Manual and other MySQL
documentation, we identify these and later MySQL Cluster releases
employing a version number that begins with “NDB”.
This version number is that of the
NDBCLUSTER storage engine used, and
not of the MySQL server version on which the MySQL Cluster release
is based.
Version strings used in MySQL Cluster NDB 6.x software. The version string displayed by MySQL Cluster NDB 6.x software uses this format:
mysql-mysql_server_version-ndb-ndbcluster_engine_version
mysql_server_version represents the
version of the MySQL Server on which the MySQL Cluster release is
based. For all MySQL Cluster NDB 6.x releases, this is
“5.1”.
ndbcluster_engine_version is the
version of the NDBCLUSTER storage
engine used by this release of the MySQL Cluster software. You can
see this format used in the mysql client, as
shown here:
shell>mysqlWelcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 2 Server version: 5.1.31-ndb-6.4.1 Source distribution Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql>SELECT VERSION()\G*************************** 1. row *************************** VERSION(): 5.1.31-ndb-6.4.1 1 row in set (0.00 sec)
This version string is also displayed in the output of the
SHOW command in the ndb_mgm
client:
ndb_mgm> SHOW
Connected to Management Server at: localhost:1186
Cluster Configuration
---------------------
[ndbd(NDB)] 2 node(s)
id=1 @10.0.10.6 (5.1.31-ndb-6.4.1, Nodegroup: 0, Master)
id=2 @10.0.10.8 (5.1.31-ndb-6.4.1, Nodegroup: 0)
[ndb_mgmd(MGM)] 1 node(s)
id=3 @10.0.10.2 (5.1.31-ndb-6.4.1)
[mysqld(API)] 2 node(s)
id=4 @10.0.10.10 (5.1.31-ndb-6.4.1)
id=5 (not connected, accepting connect from any host)
The version string identifies the mainline MySQL version from
which the MySQL Cluster release was branched and the version of
the NDBCLUSTER storage engine used.
For example, the full version string for MySQL Cluster NDB 6.1.15
(the first MySQL Cluster NDB 6.2 binary release) was
mysql-5.1.24-ndb-6.2.15. From this we can
determine the following:
Since the portion of the version string preceding “
-ndb-” is the base MySQL Server version, this means that MySQL Cluster NDB 6.2.15 derives from the MySQL 5.1.24, and contains all feature enhancements and bugfixes from MySQL 5.1 up to and including MySQL 5.1.24.Since the portion of the version string following “
-ndb-” represents the version number of theNDB(orNDBCLUSTER) storage engine, MySQL Cluster NDB 6.2.15 uses version 6.2.15 of theNDBCLUSTERstorage engine.
MySQL Cluster development source trees. MySQL Cluster development trees can also be accessed via https://code.launchpad.net/~mysql/:
MySQL Cluster NDB 6.1(OBSOLETE — no longer maintained)MySQL Cluster NDB 6.2(CURRENT)MySQL Cluster NDB 6.3(CURRENT)MySQL Cluster NDB 6.4(BETA)
The MySQL Cluster development sources maintained at https://code.launchpad.net/~mysql/ are licensed under the GPL. For information about obtaining MySQL sources using Bazaar and building them yourself, see Section 2.10.3, “Installing from the Development Source Tree”.
Currently, MySQL Cluster NDB 6.2 and MySQL Cluster NDB 6.3 binary releases are both Generally Available (GA). MySQL Cluster NDB 6.4 is Beta developement phase. MySQL Cluster NDB 6.1 is no longer in active development. For an overview of major features added in MySQL Cluster NDB 6.x, see Section 17.14, “MySQL Cluster Development Roadmap”.
This chapter represents a work in progress, and its contents are subject to revision as MySQL Cluster continues to evolve. Additional information regarding MySQL Cluster can be found on the MySQL AB Web site at https://www.mysql.com/products/cluster/.
Additional resources. More information may be found in the following places:
Answers to some commonly asked questions about Cluster may be found in the Section A.10, “MySQL 5.1 FAQ — MySQL Cluster”.
The MySQL Cluster mailing list: https://lists.mysql.com/cluster.
The MySQL Cluster Forum: https://forums.mysql.com/list.php?25.
Many MySQL Cluster users and some of the MySQL Cluster developers blog about their experiences with Cluster, and make feeds of these available through PlanetMySQL.
If you are new to MySQL Cluster, you may find our Developer Zone article How to set up a MySQL Cluster for two servers to be helpful.


User Comments
Add your own comment.