Documentation Home
MySQL 5.5 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 26.9Mb
PDF (A4) - 26.9Mb
PDF (RPM) - 25.3Mb
HTML Download (TGZ) - 6.3Mb
HTML Download (Zip) - 6.3Mb
HTML Download (RPM) - 5.3Mb
Man Pages (TGZ) - 158.7Kb
Man Pages (Zip) - 262.0Kb
Info (Gzip) - 2.6Mb
Info (Zip) - 2.6Mb
Excerpts from this Manual

MySQL 5.5 Reference Manual  /  ...  /  Options Common to NDB Cluster Programs — Options Common to NDB Cluster Programs

18.4.27 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 as well as 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 18.299 Command-line options common to all MySQL NDB Cluster programs

Format Description Added, Deprecated, or Removed

--character-sets-dir=dir_name

Directory where character sets are installed

All MySQL 5.5 based releases

--core-file

Write core on errors (defaults to TRUE in debug builds)

All MySQL 5.5 based releases

--debug=options

Enable output from debug calls. Can be used only for versions compiled with debugging enabled

All MySQL 5.5 based releases

--defaults-extra-file=filename

Read this file after global option files are read

All MySQL 5.5 based releases

--defaults-file=filename

Read default options from this file

All MySQL 5.5 based releases

--help,

--usage,

-?

Display help message and exit

All MySQL 5.5 based releases

--ndb-connectstring=connectstring,

--connect-string=connectstring,

-c

Set connection string for connecting to ndb_mgmd. Syntax: [nodeid=<id>;][host=]<hostname>[:<port>]. Overrides entries specified in NDB_CONNECTSTRING or my.cnf.

All MySQL 5.5 based releases

--ndb-mgmd-host=host[:port]

Set the host (and port, if desired) for connecting to management server

All MySQL 5.5 based releases

--ndb-nodeid=#

Set node id for this node

All MySQL 5.5 based releases

--ndb-optimized-node-selection

Select nodes for transactions in a more optimal way

All MySQL 5.5 based releases

--no-defaults

Do not read default options from any option file other than login file

All MySQL 5.5 based releases

--print-defaults

Print the program argument list and exit

All MySQL 5.5 based releases

--version,

-V

Output version information and exit

All MySQL 5.5 based releases


For options specific to individual NDB Cluster programs, see Section 18.4, “NDB Cluster Programs”.

See Section 18.3.3.8.1, “MySQL Server Options for NDB Cluster”, for mysqld options relating to NDB Cluster.

  • --character-sets-dir=name

    Property Value
    Command-Line Format --character-sets-dir=dir_name
    Type directory name
    Default Value

    Tells the program where to find character set information.

  • --core-file

    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.

  • --debug[=options]

    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.

  • --defaults-file=filename

    Property Value
    Command-Line Format --defaults-file=filename
    Type string
    Default Value [none]

    Read default options from this file.

  • --help, --usage, -?

    Property Value
    Command-Line Format

    --help

    --usage

    Prints a short list with descriptions of the available command options.

  • --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 18.3.3.3, “NDB Cluster Connection Strings”.

  • --ndb-mgmd-host=host[:port]

    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.

  • --ndb-nodeid=#

    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 18.1.6.2, “Limits and Differences of NDB Cluster from Standard MySQL Limits”, for more information.

  • --no-defaults

    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.

  • --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.

  • --print-defaults

    Property Value
    Command-Line Format --print-defaults
    Type boolean
    Default Value TRUE

    Print the program argument list and exit.

  • --version, -V

    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 18.5.5, “Performing a Rolling Restart of an NDB Cluster”), for more information.


User Comments
Sign Up Login You must be logged in to post a comment.