logging_folder

路径MySQL路由器日志文件目录。日志文件命名mysqlrouter.log,生成或追加到如果这个文件已经存在。

设置logging_folder到一个空值将消息发送到控制台(stdout)。

一个将日志发送到的例子/var/log/mysqlrouter / mysqlrouter.log:

(默认)logging_folder = /var/log/mysqlrouter

当——目录使用引导选项生成的配置文件集目录/日志/美元。

plugin_folder

路径MySQL路由器插件。这个文件夹必须匹配MySQL路由器安装目录。你应该设置这个如果你有一个自定义安装的插件不标准的安装位置。

默认值:/usr/local/lib/mysqlrouter

runtime_folder

MySQL路由器运行时文件路径。

默认值:/运行/ mysqlrouter

master-key-writer

脚本,该脚本从STDIN中读取主密钥。设置使用——master-key-writer命令行启动选项。

master-key-reader

脚本返回主密钥发送到STDOUT。设置使用——master-key-reader命令行启动选项。

config_folder

路径MySQL路由器配置文件。

默认值:/usr/local/etc/mysqlrouter

汇

水槽(s)(不同的测井方法)定义的日志级别被送到。

支持下沉值:consolelog,filelog,事件日志(在Windows上)syslog(在基于unix的系统)。使用逗号分隔列表来定义多个值。

默认值:filelog如果logging_folder选择不空”(默认)”部分,否则consolelog。

例如,配置日志记录器使用文件,控制台和事件日志中的每个配置使用调试日志级别(日志)部分:

(logger)水平=调试下沉= consolelog,事件日志,filelog

keyring_path

指向keyring文件的位置。

一个系统范围的引导不添加这个选项生成的配置文件,并假定keyring文件位于整个系统的运行时状态目录。如果——目录也用,那么运行时状态下的keyring文件存储目录的实例,在吗运行/在指定的目录中。

使用系统默认的路径,如果没有定义这个选项。

使用示例:

keyring_path = / opt / myrouter /数据/密匙环master_key_path = / opt / myrouter / mysqlrouter.key

master_key_path

主密钥文件的位置。这个选项允许无人值守解密,否则它的位置是在启动时要求。

使用系统默认的路径,如果没有指定这个选项。

使用示例:

keyring_path = / opt / myrouter /数据/密匙环master_key_path = / opt / myrouter / mysqlrouter.key

用户(系统)

运行mysqlrouter作为用户的名字user_name或数字的用户IDuser_id。”用户”在这种情况下是指一个系统登录账户,不是一个MySQL用户授权表中列出。这也可以指定在运行时使用——用户命令行选项。

在Linux上,安装路由器官方DEB和RPM包创建一个本地系统用户和组名为“mysqlrouter”主机、路由器和MySQL运行默认为该用户。这个帐户没有shell访问及其主目录指向的目录默认配置文件存储。

这个选项的目的是运行MySQL路由器作为用户与限制系统的特权。如果系统上的用户不存在,或者如果作为根用户试图启动路由器,发出一个错误和路由器退出。

MySQL路由器可以引导和执行在任何操作系统用户,不需要特殊权限以外的读和写访问自己的文件。它访问的文件包括插件(读/执行),配置文件,日志,UNIX域套接字文件(如果启用),等等。

默认情况下,配置和日志文件写入一个系统范围的位置等/等和/var/log。此外,路由器可以引导自己的通过使用一个独立的目录——目录选择。例如:

壳> sudo mysqlrouter——引导localhost: 3310——目录/ /道路/ myrouter——用户史努比

在这个例子中,路由器创建/ /道路/ myrouter并添加所有生成的文件和目录,这是由系统用户只可写的史努比。此外,用户生成的配置文件中定义吗/ /道路/ myrouter / mysqlrouter.conf:

(默认)用户=史努比

bind_address

相关信息可选的bind_address选择:

使用示例:

bind_address = 127.0.0.1:7001

bind_port

可选地,您可以定义一个默认的端口bind_address使用bind_port。如果没有配置一个港口bind_address,然后bind_port需要和使用的。

通过使用可选设置这些值——conf-base-port引导选项。

以下三个例子都导致bind_address = 127.0.0.1:7001

路由:example_1 bind_port = 7001

[路由:example_2] bind_port = 7001 bind_address = 127.0.0.1

路由:example_3 bind_address = 127.0.0.1:7001

套接字

使用的套接字被启用套接字选项,该选项可以指定有或没有TCPbind_port和bind_address选项。一个例子:

(路由)套接字= / tmp / mysqlrouter。袜子目的地= a.example.com: 3306年,b.example.com: 3307

当启动MySQL路由器,路由器会拒绝运行如果套接字文件已经存在或不能写入。

相对路径是可以接受的和基于路由器的当前工作目录。

路由器可以同时听TCP套接字和Unix socket。例如,下面的(路由)配置示例中是有效的,配置路由器都侦听连接localhost: 1234和/ tmp / mysqlrouter.sock:

[路由:my_redirect] bind_address = localhost: 1234套接字= / tmp / mysqlrouter。袜子模式=读写目的地= localhost: 57121年,localhost: 57122年,localhost: 57123

协议

路由连接到目的地时插件使用的MySQL服务器,并可以设置为“经典”(默认),或“x”(x协议)。

使用示例:

[路由:basic_failover] bind_port = 7001 =读写目的地= 10.20.200.1:33060模式,10.20.200.2:33060 = x协议

的协议选择也会影响每个目的地的所使用的缺省端口。如果目的港不配置,那么“经典”的默认端口是3306(默认),33060年“x”(x协议)。

pid_file

集PID文件的位置。这个可以设置三种不同的方式(在优先顺序):——pid文件命令行选项,设置pid_file选择在路由器的配置文件,或者定义ROUTER_PID环境变量。

如果——引导是指定的,那么pid_file和ROUTER_PID定义将被忽略。这是不同于——pid文件命令行选项导致路由器失败。

如果——引导没有指定,那么以下导致路由器失败:- PID文件已经存在,pid_file或设置ROUTER_PID但空,或者如果路由器不能写PID文件。

connect_timeout

超时值MySQL路由器连接到目的地时使用的MySQL服务器。默认值是1秒。值不能是无限的,无效的值会导致一个配置错误。有效的范围是1到65536之间。你应该降低这个值。

例如,当使用读写模式,价值可以更高一点等待主变得可用。当使用只读模式二次连接,一个较低的价值更有意义,因为路由器中选择一个新的服务器连接路由。

使用示例:

(路由)connect_timeout = 1

connect_timeout

超时值MySQL所使用的路由器连接到MySQL服务器的元数据。默认值为30秒。

使用示例:

(默认)connect_timeout = 30

read_timeout

所使用的超时值MySQL路由器当阅读从MySQL元数据服务器。默认值为30秒。

使用示例:

(默认)read_timeout = 30

目的地

提供主机信息建立连接。它接受一个以逗号分隔的目的地址或元数据缓存集群链接到一个InnoDB。

例子使用与特定的主机(静态路由):

目的地= a.example.com, b.example.com, c.example.com

示例使用InnoDB集群元数据缓存:

目的地=元数据缓存:/ / mycluster /违约? =主要角色

的元数据缓存URI的选项是:

dynamic_state

这个选项跟踪和商店活跃MySQL InnoDB集群元数据服务器地址和加载它们是否重启路由器。这个功能被激活——引导和优先考虑弃用静态的bootstrap_server_addresses选择。

引导定义了dynamic_state选项mysqlrouter.conf以下文件(默认的)部分。的值是一个路径JSON文件命名state.json路由器已经引导时创建的。的state.json初始化使用InnoDB集群元数据服务器地址和组复制ID(由InnoDB返回group_replication_name集群);路由器运行时添加附加信息和更新。

例子mysqlrouter.conf条目:

(默认)dynamic_state = / opt / myrouter /数据/ state.json

例子state.json生成的——引导:

{"元数据缓存":{“group-replication-id”:“4 b9e817a - 0254 - 11 - e9 - 9 - cc0 - 080027 - bb5030”、“cluster-metadata-servers”: [“mysql: / / localhost: 3310”,“mysql: / / localhost: 3320”,“mysql: / / localhost: 3330]},“版本”:“1.0.0”}

的dynamic_state和弃用bootstrap_server_addresses不能同时设置选项。向后兼容性,如果bootstrap_server_addresses然后设置功能就像在以前的路由器版本和不使用这种动态配置功能。

这个选项是在MySQL路由器8.0.14补充道。

模式

弃用模式选项设置路由器的调度,和两个支持模式值:

另外,之前的目的地例子可以使用元数据缓存使用InnoDB的元数据集群的缓存动态配置主机信息。例如:。

[路由:ro_route] bind_port = 7002个目的地=元数据缓存:/ / myCluster /违约?=二级routing_strategy =循环作用

routing_strategy

路由策略定义了MySQL路由器选择连接到MySQL服务器。

可用的策略:

的角色违约和可用的组合:

max_connections

每一个路由可以限制线路或连接的数量。一个可能的用途是帮助防止拒绝服务(DOS)攻击。默认值为512,有效范围是1到65536之间。

这类似于MySQL服务器的max_connections服务器系统变量。

max_connections = 512

MySQL路由器8.0.22介绍功能,增加了并发连接限制从大约5000年到50000年间连接。最大的都取决于系统的调查(或linux_epoll)限制和可用的CPU核/线程的数量。参见(IO)后端和线程配置选项。

thread_stack_size

分配给每个线程的堆栈大小。以千字节,默认为64。

(默认)thread_stack_size = 128

net_buffer_length

设置net_buffer_lengthMySQL服务器选项。

max_connect_errors

默认值为100,有效范围是1 - 2 ^ 32(4294967295,一个unsigned int)。

这类似于MySQL服务器的max_connect_errors服务器系统变量。

这可能会导致轻微的性能损失,如果一个应用程序执行频繁的重新连接,因为MySQL路由器尝试发现如果connection-related错误存在。

一个成功的连接重置计数器(8.0.14)的错误。

每个路由都有自己的屏蔽主机列表。阻塞客户端接收MySQL服务器错误1129代码与一个稍微不同的错误信息:“从fail.example.com 1129:太多的连接错误”。为阻止客户路由器日志包含额外的信息,如:信息[…]1认证错误为fail.example.com (max 100)警告[…)阻塞客户端主机fail.example.com

max_connect_errors = 100

client_connect_timeout

这类似于MySQL服务器的connect_timeout服务器系统变量。

默认值是9,这是不到一个MySQL 5.7违约。2和31536000之间的有效范围。

client_connect_timeout = 9

auth_cache_refresh_interval

之间的时间(以秒为单位)auth-cache刷新尝试。默认为2。值必须小于auth_cache_ttl和ttl其他的路由器不会开始。

这个选项如果应用http_auth_backend部分的后端选项设置为metadata_cache;这是一个路由器REST API的功能。

auth_cache_ttl

时间(以秒为单位),直到变得无效如果不刷新缓存。默认值为1(无限)。的值必须大于auth_cache_refresh_interval其他的路由器不会开始。

这个选项如果应用http_auth_backend部分的后端选项设置为metadata_cache;这是一个路由器REST API的功能。

router_id

MySQL的路由器ID。

server_ssl_curves

默认为一个安全的SSL曲线列表。格式的字符串作为一个冒号分隔的列表曲线的名字。

server_ssl_cipher

默认为一个安全的SSL密码列表。这个字符串格式作为密码的冒号分隔的列表的名字。

server_ssl_verify

SSL验证设置为默认禁用。

server_ssl_mode

SSL模式设置为默认AS_CLIENT。

client_ssl_dh_params

如果指定的,而不是空的,这个文件的DH参数代替内部默认DH参数。DH参数文件格式在PEM格式。

client_ssl_curves

允许哪些曲线之间的客户端和MySQL路由器,默认为一个安全的SSL曲线列表。格式的字符串作为一个冒号分隔的列表曲线的名字。

client_ssl_cipher

客户端和MySQL路由器之间允许哪些密码,默认为一个安全的SSL密码列表。这个字符串格式作为密码的冒号分隔的列表的名字。

client_ssl_mode

控制如果从客户机连接到MySQL路由器必须加密。

ssl_mode

SSL模式连接到MySQL服务器的元数据。它默认为首选如果没有设置。

当设置为首选(默认),引导将警告当不使用SSL和连接到元数据服务器是未加密的。

可用值是残疾,优先考虑,要求,VERIFY_CA, VERIFY_IDENTITY。与mysql客户端,这个值是不区分大小写的。

还有一个运行时选择引导;看到——ssl-mode。

bootstrap_server_addresses

指向列表和元数据,可以连接到MySQL服务器。元数据被访问后,元数据缓存交换机到服务器出现在主ReplicaSet获取元数据。他们也被称为引导服务器。

不建议使用这个选项在MySQL中路由器8.0.14,不再产生的引导过程。相反,dynamic_state选择添加作为替换。

用户(MySQL)

生成的MySQL用户与权限访问MySQL服务器的元数据模式。这个用户的密码是自动生成并存储在一个加密的密匙环。默认情况下,这个密匙环的加密密钥存储在一个读保护主密钥存储文件,该文件是在配置文件中定义的。大多数情况下,该用户在引导和相关密码是自动生成的。相关的命令行选项——force-password-validation和——尝试输入密码。默认情况下,生成的密码通过validate_password力量雄厚。

密码是完全由路由器和永远不会暴露,并存储在一个本地密匙环系统使用操作系统的账户,MySQL路由器运行。可以使用它通过路由器连接到InnoDB集群和检索当前拓扑信息。路由器和元数据服务器之间的会话是默认使用SSL加密。

在生成的密匙环文件存储取决于引导配置。对于独立的安装(当——目录使用),它存储在运行/在独立的目录中。对于整个系统的安装,它是存储在系统运行时状态目录,路径是特定于平台的。有关更多信息,请参见master_key_path和keyring_path

这个用户分配(需要)以下特权:

路由器所需的特权帐户:在元数据服务器:选择mysql_innodb_cluster_metadata。*目标副本集:选择performance_schema。在performance_schema.replication_group_member_stats replication_group_members选择

生成的用户名遵循这一模式:mysql_router_[0 - 9]{1,6}_[0-9a-z] {12},在那里[0 - 9]{1,6}数字的路由器id和吗[0-9a-z] {12}是12个随机小写字母数字字符。如果已经出现在路由器id是重用mysqlrouter.conf和它的长度不能超过6位数。

metadata_cluster

InnoDB集群的名称。

use_gr_notifications

使组复制通知。当启用时,路由器是大多数集群变化的异步通知。它可以手动启用mysqlrouter.conf或启用使用——conf-use-gr-notifications在启动命令行选项。

当路由器收到下列通知从组复制,它刷新集群元数据:

组复制通知特性被启用时,将允许一个更高ttl值,因为元数据进行刷新ttl间隔成为一个额外的保护,而不是主要手段保持集群状态更新信息。当禁用,低ttl值(如0.5秒,默认)建议避免重新连接到实例的开销和查询元数据经常改变。

ttl

生存时间(以秒为单位)信息的元数据缓存。

接受一个整数或浮点值。0.001毫秒的粒度是有限的,相当于一个毫秒。精度截断所支持的范围;例如ttl = 0.0119被视为11毫秒。的值0意味着元数据缓存模块查询元数据一直在紧密循环。

只支持十进制分隔符”。”(一段时间)不管语言环境,和科学符号,如ttl = 1.6依照,支持。

浮点支持MySQL路由器8.0.12补充道。

目的地

直接控制台日志输出这个设备目的地;在[consolelog]部分。默认为/dev/stderr和一个空使用默认值。

可用值:/dev/stdout,/dev/stderr,/ dev / null;或反对和空在Windows上。

(默认)logging_folder = = / dev / null (consolelog)的目的地

文件名

日志输出重定向到一个特定的文件命名文件名驻留在logging_folder目录中。它必须被定义为一个文件名称和文件路径,并与[记录器]和[filelog]部分。

使用文件名与(logger)来定义默认值[filelog]部分,也改变路由器的日志文件mysqlrouter.log这个新值。

(默认)logging_folder = /道路/ /日志/文件名= router_error.log记录器

路由器不报告错误如果文件名设置下(logger)但没有使用基于文件的日志记录器。

使用文件名(filelog):

(默认)logging_folder = /道路/ /日志/ filelog:文件名= a_router_error。日志文件名= b_router_error.log filelog: b

如果文件名是空或没有设置(filelog)然后使用文件名(logger)下定义;和使用的默认日志文件(mysqlrouter.log如果文件名没有设置在(记录器)。

相关,指挥控制台输出/ dev / null:

(默认)logging_folder = = / dev / null (consolelog)的目的地

水平

使用日志记录器插件日志通知、错误和调试信息。可用的日志级别调试,请注意,信息(默认),警告,错误,系统,致命的。这些值是不区分大小写的。

的信息水平显示所有信息消息、警告和错误消息。的调试从路由器代码级别显示额外的诊断信息,包括成功的路线。系统包括消息如启动消息。

(logger) =调试水平

取决于输出行为logging_folder选择。设置logging_folder一个文件夹保存一个日志文件命名mysqlrouter.log该文件夹。设置logging_folder空值,或者没有设置,输出日志到控制台。它是确定的(默认)部分。

引导接受一个配置文件使用——配置并利用日志级别定义。

timestamp_precision

日志时间戳精度;可用的示例值定义为:

港口

TCP端口侦听HTTP请求;它默认为8881。

bind_address

IP地址绑定到HTTP港口;它默认为0.0.0.0。

static_folder

静态文件请求的基本目录;默认情况下它是空的。空值意味着没有提供静态文件。

require_realm

(http_auth_realm)实例的名称。

ssl

值1支持SSL, 0禁用它。TLS客户支持TLSv1.2或晚是必需的。这是定义在[http_server]部分。

ssl_cert

文件名称及其链认证证书的PEM格式;如果需要ssl = 1。这是定义在[http_server]部分。

ssl_key

在PEM格式文件名称的关键;如果需要ssl = 1。这是定义在[http_server]部分。

ssl_cipher

cipher-spec(参见openssl的密码列表)。密码默认为一个以逗号分隔的所有批准。未知密码默默地忽略。失败如果密码列表是空的,ssl = 1。这是定义在[http_server]部分。

ssl_dh_param

从这个文件读取DH参数在PEM格式。在默认情况下使用RFC 5114的dh-param如果ssl = 1。这是定义在[http_server]部分。

后端

后端处理异步IO操作。一般调查后端可以在所有平台上,而每个平台可以提供替代后端。

选择调查(所有平台)和linux_epoll (Linux)。默认为linux_epoll Linux上。

(io)后端= = 32 linux_epoll线程

路由器有三个“后端”选项,每个不同部分具有不同的含义。有“(io)后端(异步操作),(http_auth_realm)后端”(定义一个自定义名称后端关联到一个特定的领域),和“(http_auth_backend)后端”(类型的身份验证后端)。帮助避免混淆,这里有一个例子证明这三个:

线程

IO线程处理连接的数量。

默认值为0(使用所有可用的CPU核/线程),但也接受1到1024之间的数字。在运行时系统可能限制上限超出此值。

(io)后端= = 32 linux_epoll线程

后端

[http_auth_backend]部分的名称。

路由器有三个“后端”选项,每个不同部分具有不同的含义。有“(io)后端(异步操作),(http_auth_realm)后端”(定义一个自定义名称后端关联到一个特定的领域),和“(http_auth_backend)后端”(类型的身份验证后端)。

方法

HTTP身份验证方法;默认为基本。

的名字

领域提出了身份验证的用户的名称。

需要

要求用户通过身份验证后端验证;默认为有效用户,使这张支票。

后端

后端实现的名称;接受的值是“文件”(默认)或“metadata_cache”。

【http_auth_backend:名称】后台= metadata_cache metadata_cache auth_cache_refresh_interval = 2 auth_cache_ttl = 1

路由器有三个“后端”选项,每个不同部分具有不同的含义。有“(io)后端(异步操作),(http_auth_realm)后端”(定义一个自定义名称后端关联到一个特定的领域),和“(http_auth_backend)后端”(类型的身份验证后端)。

文件名

后端存储文件的名称,是相对的data_folder目录中。

cluster_type

AdminAPI对象的类型,路由器是引导,这是一个InnoDB ReplicaSet (rs)或InnoDB集群(gr)。

引导评估目标实例,并相应地设置这个选项在生成的配置文件。

这个选项被添加在MySQL中路由器8.0.19;相同版本InnoDB ReplicaSet支持补充道。