Rechercher dans le manuel MySQL
22.4.31 Options Common to NDB Cluster Programs — Options Common to NDB Cluster Programs
All NDB Cluster programs accept the options described in this section, with the following exceptions:
Users of earlier NDB Cluster versions should note that some of
these options have been changed to make them consistent with
one another, and also with mysqld. You can
use the --help
option with any NDB Cluster
program—with the exception of
ndb_print_backup_file,
ndb_print_schema_file, and
ndb_print_sys_file—to view a list of
the options which the program supports.
The options in the following table are common to all NDB Cluster executables (except those noted previously in this section).
Table 22.360 Command-line options common to all MySQL NDB Cluster programs
Format | Description | Added, Deprecated, or Removed |
---|---|---|
Directory where character sets are installed | All NDB 8.0 releases |
|
Set the number of times to retry a connection before giving up | All NDB 8.0 releases |
|
Time to wait between attempts to contact a management server, in seconds | All NDB 8.0 releases |
|
Write core on errors (defaults to TRUE in debug builds) | All NDB 8.0 releases |
|
Enable output from debug calls. Can be used only for versions compiled with debugging enabled | All NDB 8.0 releases |
|
Read this file after global option files are read | All NDB 8.0 releases |
|
Read default options from this file | All NDB 8.0 releases |
|
Also read groups with names ending in this suffix | All NDB 8.0 releases |
|
Display help message and exit | All NDB 8.0 releases |
|
Read this path from the login file | All NDB 8.0 releases |
|
|
Set connection string for connecting to ndb_mgmd. Syntax: [nodeid=<id>;][host=]<hostname>[:<port>]. Overrides entries specified in NDB_CONNECTSTRING or my.cnf. | All NDB 8.0 releases |
Set the host (and port, if desired) for connecting to management server | All NDB 8.0 releases |
|
Set node id for this node | All NDB 8.0 releases |
|
Select nodes for transactions in a more optimal way | All NDB 8.0 releases |
|
Do not read default options from any option file other than login file | All NDB 8.0 releases |
|
Print the program argument list and exit | All NDB 8.0 releases |
|
Output version information and exit | All NDB 8.0 releases |
For options specific to individual NDB Cluster programs, see Section 22.4, “NDB Cluster Programs”.
See Section 22.3.3.9.1, “MySQL Server Options for NDB Cluster”, for mysqld options relating to NDB Cluster.
-
Property Value Command-Line Format --character-sets-dir=dir_name
Type Directory name Default Value Tells the program where to find character set information.
-
Property Value Command-Line Format --connect-retries=#
Type Numeric Default Value 12
Minimum Value 0
Maximum Value 4294967295
This option specifies the number of times following the first attempt to retry a connection before giving up (the client always tries the connection at least once). The length of time to wait per attempt is set using
--connect-retry-delay
.NoteWhen used with ndb_mgm, this option has 3 as its default. See Section 22.4.5, “ndb_mgm — The NDB Cluster Management Client”, for more information.
-
Property Value Command-Line Format --connect-retry-delay=#
Type Numeric Default Value 5
Minimum Value 1
Minimum Value 0
Maximum Value 4294967295
This option specifies the length of time to wait per attempt a connection before giving up. The number of times to try connecting is set by
--connect-retries
. -
Property Value Command-Line Format --core-file
Type Boolean Default Value FALSE
Write a core file if the program dies. The name and location of the core file are system-dependent. (For NDB Cluster programs nodes running on Linux, the default location is the program's working directory—for a data node, this is the node's
DataDir
.) For some systems, there may be restrictions or limitations. For example, it might be necessary to execute ulimit -c unlimited before starting the server. Consult your system documentation for detailed information.If NDB Cluster was built using the
--debug
option for configure, then--core-file
is enabled by default. For regular builds,--core-file
is disabled by default. -
Property Value Command-Line Format --debug=options
Type String Default Value d:t:O,/tmp/ndb_restore.trace
This option can be used only for versions compiled with debugging enabled. It is used to enable output from debug calls in the same manner as for the mysqld process.
--defaults-extra-file
=filename
Property Value Command-Line Format --defaults-extra-file=filename
Type String Default Value [none]
Read this file after global option files are read.
For additional information about this and other option-file options, see Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”.
-
Property Value Command-Line Format --defaults-file=filename
Type String Default Value [none]
Read default options from this file.
For additional information about this and other option-file options, see Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”.
-
Property Value Command-Line Format --defaults-group-suffix
Type String Default Value [none]
Also read groups with names ending in this suffix.
For additional information about this and other option-file options, see Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”.
-
Property Value Command-Line Format --help
--usage
Prints a short list with descriptions of the available command options.
-
Property Value Command-Line Format --login-path=path
Type String Default Value [none]
Read this path from the login file.
For additional information about this and other option-file options, see Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”.
--ndb-connectstring=
,connection_string
--connect-string=
,connection_string
-c
connection_string
Property Value Command-Line Format --ndb-connectstring=connectstring
--connect-string=connectstring
Type String Default Value localhost:1186
This option takes an NDB Cluster connection string that specifies the management server for the application to connect to, as shown here:
shell> ndbd --ndb-connectstring="nodeid=2;host=ndb_mgmd.mysql.com:1186"
For more information, see Section 22.3.3.3, “NDB Cluster Connection Strings”.
-
Property Value Command-Line Format --ndb-mgmd-host=host[:port]
Type String Default Value localhost:1186
Can be used to set the host and port number of a single management server for the program to connect to. If the program requires node IDs or references to multiple management servers (or both) in its connection information, use the
--ndb-connectstring
option instead. -
Property Value Command-Line Format --ndb-nodeid=#
Type Numeric Default Value 0
Sets this node's NDB Cluster node ID. The range of permitted values depends on the node's type (data, management, or API) and the NDB Cluster software version. See Section 22.1.7.2, “Limits and Differences of NDB Cluster from Standard MySQL Limits”, for more information.
-
Property Value Command-Line Format --no-defaults
Type Boolean Default Value TRUE
Do not read default options from any option file other than login file.
For additional information about this and other option-file options, see Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”.
--ndb-optimized-node-selection
Property Value Command-Line Format --ndb-optimized-node-selection
Type Boolean Default Value TRUE
Optimize selection of nodes for transactions. Enabled by default.
-
Property Value Command-Line Format --print-defaults
Type Boolean Default Value TRUE
Print the program argument list and exit.
For additional information about this and other option-file options, see Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”.
-
Property Value Command-Line Format --version
Prints the NDB Cluster version number of the executable. The version number is relevant because not all versions can be used together, and the NDB Cluster startup process verifies that the versions of the binaries being used can co-exist in the same cluster. This is also important when performing an online (rolling) software upgrade or downgrade of NDB Cluster.
See Section 22.5.5, “Performing a Rolling Restart of an NDB Cluster”), for more information.
Document created the 26/06/2006, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/mysql-rf-mysql-cluster-program-options-common.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.