Documentation Home
MySQL Cluster Manager 1.4 User Manual
Related Documentation Download this Manual

4.8.1 The import cluster Command

import cluster [--dryrun|-y] [--remove-angel] cluster_name

This command imports a MySQL NDB Cluster created independently of MySQL Cluster Manager into a cluster named cluster_name that has been created in MySQL Cluster Manager. You are strongly advised to create cluster_name using the create cluster command's --import option; see that command's description for more information about the --import option and its effects.

import cluster requires a single argument, the name of the cluster created using MySQL Cluster Manager (cluster_name) into which you wish to import a MySQL NDB Cluster created externally into MySQL Cluster Manager and bring it under MySQL Cluster Manager control. The cluster named in the command must already exist in MySQL Cluster Manager.

import cluster also supports a --dryrun option. When this option is used, only the checks required for importation are performed against the existing cluster. This makes it possible to test a given configuration without actually placing any cluster processes under MCM control. -y is supported as a short form of this option.

For MySQL Cluster Manager 1.4.7 and later, import cluster supports a --remove-angel option. When this option is used, any running angel processes for the data nodes of the cluster to be imported are stopped by mcmd prior to the actual import, which is a necessary step for a cluster import unless the angel processes have already been stopped manually. When this option is used together with the --dryrun option, no removals of angel processes will actually be performed, but the checks for angel processes (which occur when the --dryrun option is used alone) will be skipped. It is recommended that you use the two options separately: perform the checks with the --dryrun option only, and once the only errors observed are with the angel processes, run import cluster again with the --remove-angel option only to complete the import.

For more information about importing clusters into MySQL Cluster Manager, including examples, see Section 3.5, “Importing MySQL NDB Clusters into MySQL Cluster Manager”.