3.1mcmdMySQL集群管理器代理

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

    命令行格式 ——agent-uuid = uuid
    类型 字符串
    默认值 (在内部设置)

    为该代理设置UUID。通常这个值是自动设置的,只有在运行多个时才需要指定mcmd同一主机上的进程。

  • ——basedir =dir_name

    命令行格式 ——basedir = dir_name
    类型 目录名称
    默认值

    在配置中使用路径作为相对路径的前缀的目录。

  • ——引导

    命令行格式 ——引导

    使用默认配置值启动代理,创建一个名为mycluster,然后开始。此选项仅在尚未创建集群时有效。

  • ——copy-port

    命令行格式 ——copy-port =港口
    介绍了 1.4.2
    类型 数字
    默认值 0

    允许您指定文件复制操作的端口。默认值为0。

  • ——守护进程

    命令行格式 ——守护进程
    特定于平台的 Linux

    运行mcmd作为守护神。

  • ——defaults-file =文件名

    命令行格式 ——defaults-file = file_name
    类型 文件名称
    默认值 等/ mcmd.ini

    设置要从中读取配置选项的文件。默认为等/ mcmd.ini.看到章节2.4,“MySQL集群管理器配置文件”,以获取更多资料。

  • ——event-threads =

    命令行格式 ——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

    命令行格式 ——keepalive
    特定于平台的 Linux

    使用此选项可使mcmd在崩溃时尝试重新启动。

  • ——log-backtrace-on-crash

    命令行格式 ——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

    命令行格式 ——log-use-syslog

    将日志输出写入syslog。

  • ——管理器目录=dir_name

    命令行格式 ——管理器目录= 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 =

    命令行格式 ——manager-port =港口
    类型 数字
    默认值 1862

    指定MySQL集群管理器客户端连接使用的端口。任何有效的TC/IP端口号都可以使用。通常情况下,不需要修改默认值(1862)。

    以前,这个选项可以选择一个主机名作为端口号,但在MySQL集群管理器1.1.1及以后版本中,主机名不再被接受。

  • ——manager-username =user_name

    该选项有以下两个用途:

    • 属性的用户名罗马数字客户端连接到mcmd代理。如果未指定该选项,则默认值为mcmd使用。如果该选项指定了另一个值,则客户机必须使用——用户当尝试连接到代理时,客户机选项。

      属性设置使用此用户名连接到代理的密码——manager-password选择。

    • 数据库使用的MySQL帐户的用户名mcmd代理访问SQL节点。如果未指定该选项,则默认值为mcmd使用。

      初始化SQL节点时,将使用mcmd代理使用选项设置的用户名和设置的密码在其上创建一个新的MySQL用户帐户——manager-password选择。此帐户创建时具有MySQL服务器上的所有权限,包括授予权限.换句话说,它就像您执行了一样被创建授予*上的所有特权。*……有授权选项mysql客户端。现有的MySQL帐户在这种情况下不更改,并默认测验数据库保存。

  • ——manager-password =密码

    该选项有以下两个用途:

    • 控件的用户密码罗马数字客户端连接到mcmd用户名设置为——manager-username.如果未指定该选项,则默认值为超级使用。如果该选项指定了另一个值,则客户机必须使用——密码当尝试连接到代理时,客户机选项。

    • 数据库使用的MySQL帐户密码mcmd代理访问SQL节点。如果未指定该选项,则默认值为超级使用。

      初始化SQL节点时,将使用mcmd的用户名创建一个新的MySQL用户帐户——manager-username选项和此选项设置的密码。参见——manager-username有关帐户的更多详细信息。

  • ——max-open-files =

    命令行格式 ——max-open-files = #
    类型 数字
    默认值 1
    最小值 1
    最大值 (系统依赖)

    设置打开文件的最大数量(与ulimit - n).

  • ——pid文件=文件

    命令行格式 ——pid文件= file_name
    类型 文件名称
    默认值 mcmd.pid

    将名称和路径设置为进程ID (.pid)文件。不常用的:通常使用或不需要的Windows系统不支持此选项。

  • ——plugin-dir

    命令行格式 ——plugin-dir = dir_name
    类型 目录名称
    默认值 lib / mcmd

    将目录设置为搜索插件。默认为lib / mcmd,在MySQL Cluster Manager安装目录下;通常情况下,没有必要改变这一点。

  • ——插件

    命令行格式 ——插件=列表
    类型 目录名称
    默认值 经理

    指定启动时要加载的插件列表。要启用MySQL集群管理器,此列表必须包括经理(默认值)。请注意,我们目前没有测试MySQL集群管理器的任何值插件除了经理.因此,我们建议在生产设置中使用默认值。

  • ——verbose-shutdown

    命令行格式 ——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

    命令行格式 ——xcom-port =港口
    类型 数字
    默认值 18620

    允许您指定XCOM端口。18620年的默认值。