MySQL Cluster Manager 8.0.31 用户手册  / 第 4 章使用 MySQL 集群管理器  /  3.3 启动MySQL Cluster Manager客户端

3.3 启动MySQL Cluster Manager客户端

本节介绍启动 MySQL Cluster Manager 客户端和连接到 MySQL Cluster Manager 代理。

MySQL Cluster Manager 1.4.8 包含一个命令行客户端 mcm，位于安装 bin目录中。可以使用下表中显示的任何一个选项调用 mcm ：

表 3.3 mcm 选项

长表 简写 描述
--help -? 显示mcm客户端选项
--version -V 显示 MySQL Cluster Manager 代理/客户端版本。
— -W 显示 MySQL Cluster Manager 代理/客户端版本，以及 mcm使用的mysql版本。
--address -a 连接到 mcmd时使用的主机和可选端口， 格式为；默认是。host[:port]127.0.0.1:1862
--mysql-help -I 显示mysql客户端的帮助（见下文）。

MySQL Cluster Manager 使用的客户端/服务器协议是平台无关的。 您可以在任何可用的平台上使用mcm客户端连接到任何 MySQL Cluster Manager 代理。这意味着，例如，您可以使用 Microsoft Windows 上的mcm客户端连接到在 Linux 主机上运行的 MySQL Cluster Manager 代理。

mcm实际上充当 mysql客户端的包装器，它包含在捆绑的 MySQL NDB Cluster 发行版中。不指定任何选项调用mcm等效于以下内容： 

$> mysql -umcmd -psuper -h 127.0.0.1 -P 1862 --prompt="mcm>"

（这些选项-u和-p值是硬编码的，无法更改。）这意味着您可以使用mysql客户端在mcm本身（甚至 mcmd）不可用的平台上运行 MySQL Cluster Manager 客户端会话。有关详细信息，请参阅使用mysql客户端连接到代理。

如果您在启动 MySQL Cluster Manager 客户端会话时遇到问题，因为客户端无法连接，请参阅 无法连接到 [本地] MySQL 服务器，了解可能发生这种情况的某些原因，以及一些可能的解决方案的建议。

要结束客户端会话，请使用exitor quit命令（缩写形式：） \q。这些命令都不需要分隔符或终止符。

有关详细信息，请参阅第 4 章，MySQL Cluster Manager 客户端命令。

使用mcm客户端连接到代理。  您可以通过调用mcm（或者，在 Windows 上， 调用mcm.exe） 来连接到 MySQL Cluster Manager 代理 。您可能还需要指定以下一个或多个命令行选项：

  • --host=hostname 或-h[ ]hostname

    此选项采用要连接的主机的名称或 IP 地址。默认是（在启动mcmlocalhost客户端会话时可能无法在所有平台上识别， 即使它适用于启动mysql客户端会话）。

    您应该记住，mcm客户端不执行主机名解析；任何名称解析信息都来自运行客户端的主机上的操作系统。因此，通常最好为此选项使用数字 IP 地址而不是主机名。

  • --port=portnumber 或-P[ ]portnumber

    此选项指定供客户端使用的 TCP/IP 端口。这必须与 MySQL Cluster Manager 代理使用的端口相同。如其他地方所述，如果在 MySQL Cluster Manager 代理配置文件（mcmd.ini）中未指定代理端口，则 MySQL Cluster Manager 代理默认使用的端口号为 1862，mcm也默认使用该端口号。

  • --user=username 或-u[ ]username

    该选项指定用于连接到代理的用户名。如果未指定该选项，则使用默认值 “ mcmd” 。要成功连接，该选项的值必须与您要连接的代理的 mcmd配置选项 指定的值匹配，默认情况下--manager-username也是 “ mcmd”。

  • --password[= password] 或 -p[ password]

    该选项指定用于连接到代理程序的密码。 如果未指定该选项，则使用默认值“ super” 。要成功连接，该选项的值必须与您要连接的代理的mcmd配置选项 指定的值匹配，默认情况下--manager-password也是 “ super”。

    如果您使用短选项形式 ( -p)， 则此选项和密码之间不得留有空格。如果您 在命令行中省略或 选项password后面的值 ， mcm客户端会提示您输入一个。 --password-p

    在命令行上指定密码应该被认为是不安全的。最好是在调用客户端时省略密码，然后在出现提示时提供密码，或者将密码放在启动脚本或配置文件中。

mcm接受额外的mysql 客户端选项，其中一些可能对 MySQL Cluster Manager 客户端会话有用。例如， 包含太多行而无法显示在单个屏幕中--pager选项可能会有所帮助get该 --prompt选项可用于提供独特的提示，以帮助避免多个客户端会话之间的混淆。但是，当前手册中未显示的选项尚未使用 mcm进行广泛测试，因此不能保证（甚至根本不能）正常工作。有关 所有mysql客户端选项的完整列表和描述，mysql 客户端选项。

笔记

Like the mysql client, mcm also supports \G as a statement terminator, which causes the output to be formatted vertically. This can be helpful when using a terminal whose width is restricted to some number of (typically 80) characters. See Chapter 4, MySQL Cluster Manager Client Commands, for examples.

Connecting to the agent using the mysql client.  如前所述，mcm实际上充当mysql客户端的包装器。事实上，来自任何 MySQL 发行版的 mysql客户端在连接到mcmd 时应该没有任何问题 。此外，由于 MySQL Cluster Manager 使用的客户端/服务器协议是平台无关的，因此您可以在 MySQL支持的任何平台上使用mysql客户端。（这意味着，例如，您可以使用 Microsoft Windows 上的 mysql客户端连接到在 Linux 主机上运行的 MySQL Cluster Manager 代理。）使用mysql连接到 MySQL Cluster Manager 代理客户端通过调用mysql并使用以下命令行选项指定主机名、端口号、用户名和密码来实现：

  • --host=hostname 或-h hostname

    此选项采用要连接的主机的名称或 IP 地址。默认值为localhost。与mcm客户端一样， mysql客户端不执行主机名解析，并且依赖于主机操作系统来完成此任务。因此，通常最好为此选项使用数字 IP 地址而不是主机名。

  • --port=portnumber 或-P portnumber

    This option specifies the TCP/IP port for the client to use. This must be the same port that is used by the MySQL Cluster Manager agent. Although the default number of the port used by the MySQL Cluster Manager agent is 1862 (which is also used by default by mcm), this default value is not known to the mysql client, which uses port 3306 (the default port for the MySQL server) if this option is not specified when mysql is invoked.

    Thus, you must use the --port or -P option to connect to the MySQL Cluster Manager agent using the mysql client, even if the agent process is using the MySQL Cluster Manager default port, and even if the agent process is running on the same host as the mysql client. Unless the correct agent port number is supplied to it on startup, mysql is unable to connect to the agent.

  • --user=username or -u username

    The option specifies the user name for connecting to the agent. By default, the mysql client tries to use the name of the current system user on Unix systems and “ODBC” on Windows, so you must supply this option and the username when trying to access the MySQL Cluster Manager agent with the mysql client; otherwise, mysql cannot connect to the agent.

    To connect successfully, the value of the option must match that specified by the mcmd configuration option --manager-username of the agent you are connecting to, which is “mcmd” by default.

  • --password[=password] or -p[password]

    The option specifies the password for connecting to the agent. If you do not include the --password or -p option when invoking mysql, it cannot connect to the agent. To connect successfully, the value of the option must match that specified by the mcmd configuration option --manager-password of the agent you are connecting to, which is “super” by default.

    If you use the short option form (-p), you must not leave a space between this option and the password. If you omit the password value following the --password or -p option on the command line, the mysql client prompts you for one.

    Specifying a password on the command line should be considered insecure. It is preferable that you either omit the password when invoking the client and then supply it when prompted, or put the password in a startup script or configuration file.

In addition, you can use the --prompt option to set the mysql client's prompt. This is recommended, since allowing the default prompt (mysql>) to be used could lead to confusion between a MySQL Cluster Manager client session and a MySQL client session.

Thus, you can connect to a MySQL Cluster Manager agent by invoking the mysql client on the same machine from the system shell in a manner similar to what is shown here. 

$> mysql -h127.0.0.1 -P1862 -umcmd -p --prompt='mcm> '

For convenience, on systems where mcm itself is not available, you might even want to put this invocation in a startup script. On a Linux or similar system, this script might be named mcm-client.sh, with contents similar to what is shown here: 

#!/bin/sh
/usr/local/mysql/bin/mysql -h127.0.0.1 -P1862 -umcmd -p --prompt='mcm> '

In this case, you could then start up a MySQL Cluster Manager client session using something like this in the system shell: 

$> ./mcm-client

On Windows, you can create a batch file with a name such as mcm-client.bat containing something like this: 

C:\mysql\bin\mysql.exe -umcmd -psuper -h localhost -P 1862 --prompt="mcm> "

(Adjust the path to the mysql.exe client executable as necessary to match its location on your system.)

如果将此文件保存到方便的位置，例如 Windows 桌面，只需双击桌面上（或 Windows 资源管理器中）的相应文件图标即可启动 MySQL Cluster Manager 客户端会话；客户端会话在新的 cmd.exe (DOS) 窗口中打开。