mcmd是MySQL集群管理器代理程序;调用此可执行文件启动MySQL集群管理器代理,您可以使用罗马数字客户端(见第3.3节“启动MySQL集群管理器客户端”,第四章,MySQL集群管理器客户端命令,以获取更多资料)。
您可以通过指定本节中讨论的一个或多个选项,以多种不同的方式修改代理的行为。大多数选项都可以在命令行或代理配置文件中指定(通常等/ mcmd.ini
).(一些例外包括——defaults-file
而且——引导
选项,如果使用,必须在命令行上指定,并且它们彼此互斥。)例如,可以将代理的集群日志记录级别设置为警告
而不是默认值消息
用以下两种方式之一:
包括
——进行日志级别=警告
调用时在命令行上mcmd.请注意在命令行上指定代理配置选项时,选项的名称以两个前导破折号(
--
).在代理配置文件中包含以下行:
进行日志级别=警告
在配置文件中使用时,选项的名称不应该以任何其他字符作为前缀。每个选项必须在单独的行中指定。您可以通过插入一个前导散列字符(
#
),像这样:#进行日志级别=警告
你也可以用这种方式注释掉一行的一部分;后面的任何文本
#
字符被忽略,直到当前行结束。
下表包含在启动时读取的代理选项的摘要mcmd.关于这些选项的更详细信息,如允许的值范围,可以在下表的列表中找到。
表3.1 MySQL集群管理器代理(mcmd)选项摘要
选项名称 | 描述 |
---|---|
——agent-uuid | 设置代理的UUID;仅当在同一主机上运行多个代理进程时需要 |
——basedir | 要在配置中用作相对路径前缀的目录 |
——引导 | 启动时引导默认集群 |
——守护进程 | 以守护进程模式运行。该选项仅适用于Linux和其他类unix平台 |
——defaults-file | 要使用的配置文件 |
——event-threads | 要使用的事件处理程序线程数 |
——帮助 | 显示应用程序选项 |
——帮助所有 | 显示所有选项(应用程序选项和管理器模块选项) |
-协助经理 | 显示管理器模块选项 |
——keepalive | 尝试在崩溃的情况下重新启动mcmd。该选项仅适用于Linux和其他类unix平台 |
——log-backtrace-on-crash | 尝试在崩溃的情况下加载调试器 |
——日志文件 | 要写入日志的文件的名称 |
——进行日志级别 | 设置mcmd日志级别 |
——log-use-syslog | 日志来syslog |
——管理器目录 | 存储管理器数据的目录 |
——manager-password | mcmd用户帐号的密码 |
——manager-port | 客户端连接到管理器时使用的端口 |
——manager-username | mcmd用户帐号的用户名 |
——max-open-files | 打开文件的最大数量(ulimit -n) |
——pid文件 | 指定PID文件(当作为守护进程运行时使用) |
——plugin-dir | 查找插件的目录 |
——插件 | 要加载的插件列表以逗号分隔;必须包括“经理” |
——verbose-shutdown | 关闭时,始终记录退出代码 |
——版本 | 显示管理器版本 |
——xcom-port | 指定XCOM端口 |
MySQL集群管理器代理(mcmd
)选项的描述
下面的列表包含了可供使用的每个启动选项的描述mcmd,包括允许值和默认值。标记为布尔值的选项只需要指定以便生效;您不应该尝试为这些设置一个值。
-
命令行格式 ——agent-uuid = uuid
类型 字符串 默认值 (在内部设置)
为这个代理设置一个UUID。通常这个值是自动设置的,只有在运行多个时才需要指定mcmd进程。
-
命令行格式 ——basedir = dir_name
类型 目录名称 默认值 .
在配置中使用路径作为相对路径前缀的目录。
-
命令行格式 ——引导
使用默认配置值启动代理,创建一个名为
mycluster
,然后开始。此选项仅在尚未创建集群的情况下有效。选项互斥——defaults-file
选择。当前,任何存储在默认集群中的数据
mycluster
在集群重新启动之间不保留。 -
命令行格式 ——守护进程
特定于平台的 Linux 运行mcmd作为一个守护进程。
-
命令行格式 ——defaults-file = file_name
类型 文件名称 默认值 等/ mcmd.ini
设置从中读取配置选项的文件。默认值是
等/ mcmd.ini
.看到第2.4节“MySQL集群管理器配置文件”,以查询更多资料。 -
命令行格式 ——event-threads = #
类型 数字 默认值 1
最小值 1
最大值 (系统依赖)
要使用的事件处理程序线程数。默认值是1,这对于大多数正常操作已经足够了。
——帮助
,-?
命令行格式 ——帮助
mcmd
帮助输出分为应用程序而且经理部分。一起使用时mcmd,——帮助
导致应用程序要显示的选项,如下所示:shell> mcmd——help用法:mcmd [OPTION…]MySQL集群管理器帮助选项:-?,——帮助Show help options --help-all Show all help options --help-manager Show options for the manager-module Application Options: -V, --version Show version --defaults-file=
configuration file --verbose-shutdown Always log the exit code when shutting down --daemon Start in daemon-mode --basedir= Base directory to prepend to relative paths in the config --pid-file= PID file in case we are started as daemon --plugin-dir= Path to the plugins --plugins= Plugins to load --log-level= Log all messages of level ... or higher --log-file= Log all messages in a file --log-use-syslog Log all messages to syslog --log-backtrace-on-crash Try to invoke debugger on crash --keepalive Try to restart mcmd if it crashed --max-open-files Maximum number of open files (ulimit -n) --event-threads Number of event-handling threads (default: 1) -
命令行格式 ——帮助所有
mcmd
帮助输出分为应用程序而且经理部分。一起使用时——帮助所有
,mcmd显示两个应用程序和经理选项,如下:> mcmd——help-all用法:mcmd [OPTION…]MySQL集群管理器帮助选项:-?,——帮助Show help options --help-all Show all help options --help-manager Show options for the manager-module manager-module --manager-port=
Port to manage the cluster (default: 1862) --xcom-port= Xcom port (default: 18620) --manager-username= Username to manage the cluster (default: mcmd) --manager-password= Password for the manager user-account (default: super) --bootstrap Bootstrap a default cluster on initial startup --manager-directory= Path to managers config information Application Options: -V, --version Show version --defaults-file= configuration file --verbose-shutdown Always log the exit code when shutting down --daemon Start in daemon-mode --basedir= Base directory to prepend to relative paths in the config --pid-file= PID file in case we are started as daemon --plugin-dir= Path to the plugins --plugins= Plugins to load --log-level= Log all messages of level ... or higher --log-file= Log all messages in a file --log-use-syslog Log all messages to syslog --log-backtrace-on-crash Try to invoke debugger on crash --keepalive Try to restart mcmd if it crashed --max-open-files Maximum number of open files (ulimit -n) --event-threads Number of event-handling threads (default: 1) -
命令行格式 -协助经理
mcmd
帮助输出分为应用程序而且经理部分。一起使用时-协助经理
,mcmd显示了经理选项,如下:shell> mcmd——help-manager用法:mcmd [OPTION…]- MySQL Cluster Manager Manager -module——Manager - Port =
管理集群的端口(默认值:1862)——Xcom - Port = Xcom端口(默认值:18620)——Manager -username= 管理集群的用户名(默认值:mcmd)——Manager -password= 管理器的密码user-account(默认值:super)——bootstrap初始启动时引导默认集群——Manager -directory= 管理器配置信息的路径 -
命令行格式 ——keepalive
特定于平台的 Linux 使用此选项可使mcmd在发生崩溃时尝试重新启动。
-
命令行格式 ——log-backtrace-on-crash
在发生崩溃时尝试加载调试器。在生产中通常不使用。
-
命令行格式 ——日志文件=文件
类型 文件名称 默认值 mcmd.log
设置要写入日志的文件名。默认值是
mcmd.log
在安装目录下。在Linux和其他类unix平台上,可以使用相对路径;这是与MySQL集群管理器安装目录相关的,而不是箱子
或等
子目录。在Windows上,您必须使用绝对路径,并且它不能包含任何空格;此外,必须替换任何反斜杠(\
)路径中的正斜杠字符(/
). -
命令行格式 ——进行日志级别=水平
类型 枚举 默认值 消息
有效值 至关重要的
错误
警告
消息
信息
调试
设置
mcmd
日志严重性级别。中列出了此选项的可能值及其描述表3.2“MySQL集群管理器代理日志级别”严重程度递减。当将该选项设置为某个严重级别时,将记录该级别或更高级别的所有事件。消息
是默认的日志级别,是生产环境的推荐设置;在更严格的日志级别上运行会产生更少的消息,并使发生问题时更难跟踪问题。表3.2 MySQL集群管理器代理日志级别
水平的严重程度 描述 至关重要的
应该立即纠正的情况,如MySQL集群管理器数据存储库损坏 错误
应该纠正的条件,例如配置错误 警告
执行不会失败,但可能需要用户注意的条件 消息
关于站点的主要事件和来自命令执行的消息 信息
为用户提供一些执行细节的信息性消息 调试
提供对开发人员有用的执行细节的调试消息。如果长时间使用,会导致日志文件过大。 您也可以更改
mcmd
日志级别在运行时使用变化进行日志级别
命令罗马数字客户端。而设置的——进行日志级别
选项仅应用于mcmd代理使用选项(在命令行或配置文件中)变化进行日志级别
客户端命令可用于将日志级别应用到整个管理站点或特定主机。 -
命令行格式 ——log-use-syslog
将日志输出写入syslog。
-
命令行格式 ——管理器目录= dir
类型 目录名称 默认值 . . / mcm_data(relative to the installation directory of MySQL Cluster Manager)
设置代理存储库的位置,其中包含MySQL Cluster Manager数据文件和MySQL Cluster配置和数据文件的集合。必须是有效的绝对路径。在Linux上,如果目录不存在,则创建该目录;在Windows系统中,如果该目录不存在,则必须创建该目录。此外,在Windows上,路径可能不包含任何空格或反斜杠(
\
)字符;反斜杠必须替换为正斜杠(/
).默认位置为
. . / mcm_data
(相对于MySQL Cluster Manager的安装目录)。如果更改默认值,则应该使用MySQL集群管理器安装目录外部的标准位置,例如/var/opt/mcm
在Linux上。除了MySQL Cluster Manager数据文件之外,
管理器目录
还包含一个代表
MySQL集群管理器控制下的每个MySQL集群的MySQL集群数据文件都保存在这个目录中。的位置之外,通常不需要与这些目录进行交互管理器目录
在代理配置文件(mcmd.ini
).但是,如果代理达到不一致的状态,则可以删除
代表
目录,在这种情况下,代理尝试从另一个代理恢复其存储库。在这种情况下,还必须删除repchksum
文件和high_water_mark
文件从管理器目录
.否则,代理读取这些文件并引发错误,因为now为空代表
目录中。 -
命令行格式 ——manager-password =密码
类型 字符串 默认值 超级
设置用于管理器代理用户帐户的密码。默认值是
超级
.使用此选项和
manager-username
会创建一个MySQL用户帐户,使用这两个选项指定用户名和密码。此帐户具有MySQL服务器上的所有权限,包括授予权限.换句话说,它的创建就像您执行了一样授予*上的所有特权。*……使用GRANT选项
在mysql客户端。 -
命令行格式 ——manager-port =港口
类型 数字 默认值 localhost: 1862
指定MySQL集群管理器客户端连接所使用的端口。可以使用任何有效的TC/IP端口号。通常情况下,不需要更改默认值(1862)。
以前,这个选项可以在端口号之外选择一个主机名,但是在MySQL集群管理器1.1.1及以后版本中不再接受主机名。
-
命令行格式 ——manager-username =名字
类型 字符串 默认值 mcmd
设置MySQL集群管理器代理使用的MySQL帐户的用户名。默认值是
mcmd
.当与
manager-password
,该选项还会创建一个新的MySQL用户帐户,使用这两个选项指定用户名和密码。此帐户具有MySQL服务器上的所有权限,包括授予权限.换句话说,它的创建就像您执行了一样授予*上的所有特权。*……使用GRANT选项
在mysql客户端。现有的MySQL根
帐户在这种情况下不会改变,而默认测验
数据库保存。 -
命令行格式 ——max-open-files = #
类型 数字 默认值 1
最小值 1
最大值 (系统依赖)
设置打开文件的最大数量(如ulimit - n).
-
命令行格式 ——pid文件= file_name
类型 文件名称 默认值 mcmd.pid
将名称和路径设置为进程ID (
.pid
)文件。不正常使用或不需要的Windows系统不支持此选项。 -
命令行格式 ——plugin-dir = dir_name
类型 目录名称 默认值 lib / mcmd
将目录设置为搜索插件。默认值是
lib / mcmd
,在MySQL集群管理器安装目录;通常不需要改变这一点。 -
命令行格式 ——插件=列表
类型 目录名称 默认值 经理
指定启动时要加载的插件列表。要启用MySQL集群管理器,该列表必须包括
经理
(默认值)。请注意,我们目前不测试MySQL集群管理器的任何值插件
除了经理
.因此,我们建议在生产设置中使用默认值。 -
命令行格式 ——verbose-shutdown
力
mcmd
无论什么原因,在关机时记录退出代码。 ——版本
,- v
命令行格式 ——版本
显示版本信息并退出。根据MySQL集群管理器软件版本、操作平台和系统上使用的库版本的不同,输出可能会有所不同,但应该非常类似于这里所示的,第一行输出包含MySQL集群管理器版本号(强调的文本):
壳> mcmd - vMySQL集群管理器1.3.6底盘:mysql-proxy 0.8.3 glib2: 2.16.6 libevent: 1.4.13-stable——模块管理器:1.3.6
-
命令行格式 ——xcom-port =港口
类型 数字 默认值 18620
允许您指定XCOM端口。18620年的默认值。