mcmd是MySQL集群管理器代理程序;调用此可执行文件启动MySQL集群管理器代理,您可以使用罗马数字客户端(见3.3节,“启动MySQL集群管理器客户端”,第四章,MySQL集群管理器客户端命令,以了解更多资料)。
您可以通过指定本节中讨论的一个或多个选项,以多种不同的方式修改代理的行为。这些选项中的大多数可以在命令行上或在代理配置文件中指定(通常等/ mcmd.ini
).(一些例外包括——defaults-file
而且——引导
选项,如果使用,必须在命令行上指定,并且彼此互斥。)例如,您可以将代理的集群日志记录级别设置为警告
而不是默认消息
用以下两种方法之一:
包括
——进行日志级别=警告
调用时,在命令行上mcmd.请注意在命令行上指定代理配置选项时,选项的名称用两个前导破折号作为前缀(
--
).在代理配置文件中包含以下一行:
进行日志级别=警告
在配置文件中使用时,选项的名称不应以任何其他字符作为前缀。每个选项必须在单独的行中指定。可以通过插入前导哈希字符(
#
),像这样:#进行日志级别=警告
你也可以用这种方式注释掉一行的一部分;以下任何文本
#
字符被忽略,直到当前行结束。
下表包含启动时读取的代理选项的摘要mcmd.关于每个选项的更详细信息,例如允许的值范围,可以在表后面的列表中找到。
表3.1 MySQL Cluster Manager Agent (mcmd)选项汇总
选项名称 | 描述 | 介绍了 |
---|---|---|
——agent-uuid | 设置代理的UUID;仅当在同一主机上运行多个代理进程时需要 | |
——basedir | 要用作配置中相对路径前缀的目录 | |
——引导 | 在启动时引导默认集群 | |
——copy-port | 指定用于文件复制操作的端口 | 1.4.2 |
——守护进程 | 以守护模式运行。该选项仅适用于Linux和其他类unix平台 | |
——defaults-file | 要使用的配置文件 | |
——event-threads | 要使用的事件处理程序线程数 | |
——帮助 | 显示应用程序选项 | |
——帮助所有 | 显示所有选项(应用程序选项和管理器模块选项) | |
-协助经理 | 显示管理器模块选项 | |
——初始 | 在进行备份后擦除代理的配置存储区中的内容 | 1.4.7 |
——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
,然后开始。此选项仅在尚未创建集群时有效。 -
命令行格式 ——copy-port =港口
介绍了 1.4.2 类型 数字 默认值 0
允许您指定文件复制操作的端口。默认值为0。
-
命令行格式 ——守护进程
特定于平台的 Linux 运行mcmd作为守护神。
-
命令行格式 ——defaults-file = file_name
类型 文件名称 默认值 等/ mcmd.ini
设置要从中读取配置选项的文件。默认为
等/ mcmd.ini
.看到章节2.4,“MySQL集群管理器配置文件”,以获取更多资料。 -
命令行格式 ——event-threads = #
类型 数字 默认值 1
最小值 1
最大值 (系统依赖)
要使用的事件处理程序线程数。默认值是1,这对于大多数正常操作来说已经足够了。
——帮助
,-?
命令行格式 ——帮助
mcmd
帮助输出分为应用程序而且经理部分。与连用时mcmd,——帮助
导致应用程序要显示的选项,如下所示:$> 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集群管理器帮助选项:-h,——Help显示帮助选项——Help -all显示所有帮助选项——Help - Manager显示Manager -module的选项Manager -module——bootstrap在初始启动时在localhost上引导集群——copy- Port =
文件复制操作端口(默认值:0)——initial备份后擦除存储库文件——Manager -directory=<目录> mcmd配置信息的路径——Manager -password= mcmd用户帐户的密码(默认值:——manager-port= 联系mcmd的端口(默认值:1862)——manager-username= mcmd的用户名user-account(默认值:mcmd)——Xcom - Port = mcmds通信的Xcom端口(默认值:18620)-V,——version显示版本——defaults-file= 配置文件——verbose-shutdown在关闭时始终记录退出码——daemon以daemon-mode启动——basedir=<绝对路径>配置中前置相对路径的基本目录——PID -file= PID文件,以防我们以daemon启动——plugin-dir= 插件的路径——plugins= 加载插件——log-level= 记录级别的所有消息…——Log -file= 将所有消息记录在一个文件中——Log -use-syslog将所有消息记录到syslog——Log -backtrace-on-crash尝试在崩溃时调用调试器——keepalive尝试在mcmd崩溃时重新启动——max-open-files最大打开文件数(ulimit -n)——event-threads事件处理线程数(默认值:1) -
命令行格式 -协助经理
mcmd
帮助输出分为应用程序而且经理部分。与连用时-协助经理
,mcmd显示了经理选项,像这样:$> mcmd—help-manager使用:mcmd [OPTION…]- MySQL Cluster Manager Manager -module——bootstrap在初始启动时在localhost上启动集群——copy- Port =
文件拷贝操作端口(默认值:0)——initial备份后擦除存储库文件——Manager -directory=<目录> mcmd配置信息的路径——Manager -password= mcmd用户帐户的密码(默认值:super)——Manager - Port = 联系mcmd的端口(默认值:1862)——manager-username= mcmd用户名user-account(默认值:mcmd)——Xcom -port= mcmds通信的Xcom端口(默认值:18620) -
命令行格式 ——初始
介绍了 1.4.7 MySQL集群管理器1.4.7及以上版本:备份代理的配置存储区(
mcm_data /代表/
)备份代理
命令,然后在启动之前擦除配置存储的内容mcmd.然后从其他代理中恢复代理的配置。这在代理处于不一致状态且无法正确重新启动时非常有用。 -
命令行格式 ——keepalive
特定于平台的 Linux 使用此选项可使mcmd在崩溃时尝试重新启动。
-
命令行格式 ——log-backtrace-on-crash
尝试在崩溃时加载调试器。在生产中通常不使用。
-
命令行格式 ——日志文件=文件
类型 文件名称 默认值 mcmd.log
设置要写入日志的文件名。默认为
mcmd.log
在安装目录下。在Linux和其他类unix平台上,你可以使用相对路径;这是关于MySQL集群管理器安装目录,而不是箱子
或等
子目录。在Windows上,你必须使用绝对路径,不能包含任何空格;此外,必须替换任何反斜杠(\
)路径中带有正斜杠(/
). -
命令行格式 ——进行日志级别=水平
类型 枚举 默认值 消息
有效值 至关重要的
错误
警告
消息
信息
调试
设置
mcmd
日志级别。中列出了此选项的可能值及其描述表3.2,“MySQL集群管理器代理日志级别”严重程度递减。当将该选项设置为某个严重级别时,将记录该级别或更高级别的所有事件。消息
是默认的日志级别,是生产环境的推荐设置;在更严重的日志级别上运行会产生更少的消息,并且在发生问题时更难跟踪问题。表3.2 MySQL Cluster Manager Agent日志级别
严重程度 描述 至关重要的
应该立即纠正的情况,例如损坏的MySQL集群管理器数据存储库 错误
应该更正的条件,例如配置错误 警告
不会导致执行失败,但可能需要用户注意的条件 消息
站点的主要事件和命令执行的消息 信息
为用户提供一些执行细节的信息性消息 调试
提供对开发人员有用的执行细节的调试消息。如果长时间使用,会导致日志文件变大。 您还可以更改
mcmd
在运行时使用变化进行日志级别
命令使用罗马数字客户端。而设置的——进行日志级别
选项仅应用于mcmd代理使用选项(在命令行或配置文件中)变化进行日志级别
Client命令用于将日志级别应用于整个管理站点或特定主机。 -
命令行格式 ——log-use-syslog
将日志输出写入syslog。
-
命令行格式 ——管理器目录= dir
类型 目录名称 默认值 . . / mcm_data(relative to the installation directory of MySQL Cluster Manager)
设置代理存储库的位置,其中包含MySQL集群管理器数据文件和MySQL NDB集群配置和数据文件的集合。必须为合法的绝对路径。在Linux上,如果目录不存在,则创建该目录;在Windows上,如果目录不存在,则必须创建该目录。此外,在Windows上,路径不能包含任何空格或反斜杠(
\
)字符;反斜杠必须替换为正斜杠(/
).默认位置为
. . / mcm_data
(相对于MySQL Cluster Manager的安装目录)。如果更改了默认值,则应该使用MySQL集群管理器安装目录外部的标准位置,例如/var/opt/mcm
在Linux上。除了MySQL集群管理器控制下的所有集群的数据文件外,管理器目录还包含一个
代表
所在目录mcmd保存配置和元数据。类的位置之外,通常不需要与这些目录进行交互管理器目录
在代理配置文件(mcmd.ini
);参见例外,例如,第3.8节,“用其他代理的数据恢复MySQL集群管理器代理”而且第3.7节“备份和恢复MySQL集群管理器代理”. -
命令行格式 ——manager-port =港口
类型 数字 默认值 1862
指定MySQL集群管理器客户端连接使用的端口。任何有效的TC/IP端口号都可以使用。通常情况下,不需要修改默认值(1862)。
以前,这个选项可以选择一个主机名作为端口号,但在MySQL集群管理器1.1.1及以后版本中,主机名不再被接受。
该选项有以下两个用途:
属性的用户名罗马数字客户端连接到mcmd代理。如果未指定该选项,则默认值为
mcmd
使用。如果该选项指定了另一个值,则客户机必须使用——用户
当尝试连接到代理时,客户机选项。属性设置使用此用户名连接到代理的密码
——manager-password
选择。数据库使用的MySQL帐户的用户名mcmd代理访问SQL节点。如果未指定该选项,则默认值为
mcmd
使用。初始化SQL节点时,将使用mcmd代理使用选项设置的用户名和设置的密码在其上创建一个新的MySQL用户帐户
——manager-password
选择。此帐户创建时具有MySQL服务器上的所有权限,包括授予权限.换句话说,它就像您执行了一样被创建授予*上的所有特权。*……有授权选项
在mysql客户端。现有的MySQL根
帐户在这种情况下不更改,并默认测验
数据库保存。
该选项有以下两个用途:
控件的用户密码罗马数字客户端连接到mcmd用户名设置为
——manager-username
.如果未指定该选项,则默认值为超级
使用。如果该选项指定了另一个值,则客户机必须使用——密码
当尝试连接到代理时,客户机选项。数据库使用的MySQL帐户密码mcmd代理访问SQL节点。如果未指定该选项,则默认值为
超级
使用。初始化SQL节点时,将使用mcmd的用户名创建一个新的MySQL用户帐户
——manager-username
选项和此选项设置的密码。参见——manager-username
有关帐户的更多详细信息。
-
命令行格式 ——max-open-files = #
类型 数字 默认值 1
最小值 1
最大值 (系统依赖)
设置打开文件的最大数量(与ulimit - n).
-
命令行格式 ——pid文件= file_name
类型 文件名称 默认值 mcmd.pid
将名称和路径设置为进程ID (
.pid
)文件。不常用的:通常使用或不需要的Windows系统不支持此选项。 -
命令行格式 ——plugin-dir = dir_name
类型 目录名称 默认值 lib / mcmd
将目录设置为搜索插件。默认为
lib / mcmd
,在MySQL Cluster Manager安装目录下;通常情况下,没有必要改变这一点。 -
命令行格式 ——插件=列表
类型 目录名称 默认值 经理
指定启动时要加载的插件列表。要启用MySQL集群管理器,此列表必须包括
经理
(默认值)。请注意,我们目前没有测试MySQL集群管理器的任何值插件
除了经理
.因此,我们建议在生产设置中使用默认值。 -
命令行格式 ——verbose-shutdown
力
mcmd
无论什么原因关闭,都要记录退出代码。 ——版本
,- v
命令行格式 ——版本
显示版本信息并退出。根据MySQL集群管理器软件版本、操作平台和系统上使用的库版本的不同,输出可能会有所不同,但应该与这里所示的非常相似,输出的第一行包含MySQL集群管理器发布号(强调的文本):
$> mcmd——MySQL集群管理器1.4.8(64位)chassis: 0.8.5.15734304 glib2: 2.44.0 libevent: 2.1.11-stable——模块管理器:1.4.8
-
命令行格式 ——xcom-port =港口
类型 数字 默认值 18620
允许您指定XCOM端口。18620年的默认值。