--version, -V

Отображает номер версии и связанную информацию о приложении, а затем завершается. Например:

$> mysqlrouter --version

MySQL Router v9.2.0 on Linux (64-bit) (GPL community edition)

--help, -?

Отображает справку и информационную информацию, а затем завершается.

Опция --help имеет дополнительное преимущество. Наряду с объяснением каждой опции, опция --help также отображает пути, используемые для поиска файла конфигурации, а также несколько стандартных путей. Следующий фрагмент вывода --help показывает пример с машины Ubuntu 16.04:

$> mysqlrouter --help

...

Start MySQL Router.

Configuration read from the following files in the given order (enclosed
in parentheses means not available for reading):
  (/etc/mysqlrouter/mysqlrouter.conf)
  /home/philip/.mysqlrouter.conf
Plugin Path:
  /usr/lib/x86_64-linux-gnu/mysqlrouter
Default Log Directory:
  /var/log/mysqlrouter
Default Persistent Data Directory:
  /var/lib/mysqlrouter
Default Runtime State Directory:
  /run/mysqlrouter

Usage: mysqlrouter [-V|--version] [-?|--help]
...

Раздел конфигурации показывает порядок путей, которые могут быть использованы для чтения файла конфигурации. В данном случае доступен только второй файл.

--bootstrap URI, -B URI

Основная опция для выполнения инициализации MySQL Router путём подключения к серверу метаданных InnoDB Cluster по предоставленному URI. MySQL Router настраивает себя на основе информации, полученной от сервера метаданных InnoDB Cluster. Если необходимо, запрашивается пароль. Если имя пользователя не указано в URI, используется имя пользователя по умолчанию «root». См. для получения информации об использовании пути для указания экземпляра сервера.

По умолчанию процесс инициализации выполняет системную настройку MySQL Router. Только один экземпляр MySQL Router может быть настроен для системной работы. Системный экземпляр MySQL Router имеет имя «system». Если требуются дополнительные экземпляры, используйте опцию --directory для создания автономных установок MySQL Router.

URI: экземпляр сервера из InnoDB Cluster для извлечения метаданных. Если предоставленный URI является экземпляром только для чтения, MySQL Router автоматически переподключается к экземпляру для чтения-записи в InnoDB Cluster, чтобы он мог зарегистрировать MySQL Router.

Если файл конфигурации уже существует при запуске MySQL Router с --bootstrap, существующие router_id в этом файле повторно используются, и происходит процесс перенастройки. Файл конфигурации генерируется заново, и учётная запись сервера метаданных MySQL Router пересоздаётся, хотя и с тем же именем.

Во время процесса перенастройки все изменения, внесённые в существующий файл конфигурации, отбрасываются. Чтобы настроить файл конфигурации и сохранить возможность автоматической перенастройки (инициализации), вы можете использовать опцию командной строки --extra-config для указания дополнительного файла конфигурации, который читается после основного файла конфигурации. Эти параметры конфигурации используются, поскольку этот дополнительный файл конфигурации загружается после основного файла конфигурации.

Процесс инициализации создаёт новую учётную запись пользователя MySQL с случайным паролем для использования этим конкретным экземпляром MySQL Router. Эта учётная запись используется MySQL Router при подключении к серверу метаданных и кластеру InnoDB для получения информации о его текущем состоянии. Для подробной информации об этом пользователе, включая то, как хранится его пароль и необходимые привилегии MySQL, см. документацию для MySQL user option.

Сгенерированный файл конфигурации называется mysqlrouter.conf, и его расположение зависит от типа настраиваемого экземпляра, системы и пакета. Для системных установок сгенерированный файл конфигурации добавляется в системный каталог конфигурации, например, в /etc или %PROGRAMDATA%\MySQL\MySQL Router\. Выполнение mysqlrouter --help отобразит это расположение.

Опция --user требуется, если выполняется инициализация с пользователем суперпользователя (uid=0). Хотя не рекомендуется, принудительное использование суперпользователя возможно, передав его имя в качестве аргумента, например, --user=root.

Минимальные привилегии GRANT, необходимые для выполнения --bootstrap:

GRANT CREATE USER ON *.* TO 'bootstrapuser'@'%' WITH GRANT OPTION;
GRANT SELECT, INSERT, UPDATE, DELETE, EXECUTE ON mysql_innodb_cluster_metadata.* TO 'bootstrapuser'@'%';
GRANT SELECT ON mysql.user TO 'bootstrapuser'@'%';
GRANT SELECT ON performance_schema.replication_group_members TO 'bootstrapuser'@'%';
GRANT SELECT ON performance_schema.replication_group_member_stats TO 'bootstrapuser'@'%';
GRANT SELECT ON performance_schema.global_variables TO 'bootstrapuser'@'%';

Использование --bootstrap добавляет значения по умолчанию в сгенерированный файл конфигурации MySQL Router, и некоторые из этих значений по умолчанию зависят от других условий. Ниже приведены некоторые условия, влияющие на сгенерированные значения по умолчанию, где значение по умолчанию определяется путём передачи --bootstrap без дополнительных аргументов.

--bootstrap-socket socket_name

Используется совместно с --bootstrap для инициализации с использованием локального сокета Unix вместо TCP/IP. Значение --bootstrap-socket заменяет часть «хост:порт» в определении --bootstrap на назначенное имя сокета для подключения к серверу метаданных MySQL с помощью сокетов Unix. Это экземпляр MySQL, который инициализируется, и этот экземпляр должен быть на той же машине, если используются сокеты. Для получения дополнительной информации о том, как работает инициализация, см. --bootstrap.

Эта опция отличается от опции командной строки --conf-use-sockets, которая устанавливает параметр конфигурации socket во время процесса инициализации.

Эта опция недоступна в Windows.

--core-file

Записать файл ядра, если mysqlrouter завершается аварийно. Имя и местоположение файла ядра зависят от системы. В Linux файл ядра с именем core.pid записывается в текущий рабочий каталог процесса. pid представляет собой идентификатор процесса серверного процесса. В macOS файл ядра с именем core.pid записывается в каталог /cores, если у процесса есть право com.apple.security.get-task-allow. В Solaris используйте команду coreadm для указания места записи файла ядра и его имени. В Windows файл минидампа с именем mysqlrouter.{pid}.dmp записывается в текущий рабочий каталог процесса.

--directory dir_path, -d dir_path

Указывает, что автономная установка MySQL Router будет создана в указанном каталоге вместо настройки системного экземпляра маршрутизатора. Это также позволяет создавать несколько экземпляров маршрутизатора в одной системе.

Автономная структура каталогов для Router:

$path/start.sh
$path/stop.sh
$path/mysqlrouter.pid
$path/mysqlrouter.conf
$path/mysqlrouter.key
$path/run
$path/run/keyring
$path/data
$path/log
$path/log/mysqlrouter.log

Если указан этот параметр, файл keyring хранится в каталоге состояния времени выполнения этого экземпляра, в run/ в указанном каталоге, а не в системном каталоге состояния времени выполнения.

Если также включен параметр --conf-use-sockets, то в этот каталог также добавляются созданные файлы сокетов.

--master-key-writer

Этот необязательный параметр загрузки принимает скрипт, который считывает главный ключ из STDIN. Он также использует переменную среды ROUTER_ID, установленную MySQL Router перед вызовом скрипта master-key-writer.

Параметры master-key-writer и master-key-reader должны использоваться вместе, и их использование означает, что параметр master_key_file не должен быть определен в mysqlrouter.conf, так как главный ключ не записывается в файл главного ключа mysqlrouter.key.

Он также записывается в созданный файл конфигурации MySQL Router как параметр master-key-writer [DEFAULT].

Пример содержимого bash-скрипта с именем writer.sh, используемого в нашем примере:

#!/bin/bash

KID_=$(keyctl padd user ${ROUTER_ID} @us <&0)

Пример использования:

$> mysqlrouter --bootstrap=127.0.0.1:3310 --master-key-reader=./reader.sh
  --master-key-writer=./writer.sh

Это также влияет на созданный mysqlrouter.conf, например:

[DEFAULT]
...
master-key-reader=reader.sh
master-key-writer=writer.sh

--master-key-reader

Этот необязательный параметр загрузки принимает скрипт, который записывает главный ключ в STDOUT. Он также использует переменную среды ROUTER_ID, установленную MySQL Router перед вызовом скрипта master-key-reader.

Параметры master-key-reader и master-key-writer должны использоваться вместе, и их использование означает, что параметр master_key_file не должен быть определен в mysqlrouter.conf, так как главный ключ не записывается в файл главного ключа mysqlrouter.key, а вместо этого используется значение, предоставленное скриптом этого параметра.

Он также записывается в созданный файл конфигурации MySQL Router как параметр master-key-reader [DEFAULT].

Пример содержимого bash-скрипта с именем reader.sh, используемого в нашем примере:

#!/bin/bash

KID_=$(keyctl search @us user ${ROUTER_ID} 2>/dev/null)
if [ ! -z $KID_ ]; then
  keyctl pipe $KID_
fi

Пример использования:

$> mysqlrouter --bootstrap=127.0.0.1:3310 --master-key-reader=./reader.sh
  # Or, multiple hosts--master-key-writer=./writer.sh

Это также влияет на созданный mysqlrouter.conf, например:

[DEFAULT]
...
master-key-reader=reader.sh
master-key-writer=writer.sh

--strict

Включает строгий режим, который, например, заставляет проверку проверки пользователя загрузки --account остановить процесс загрузки, а не только выводить предупреждение и продолжать, если предоставленный пользователь не проходит проверку.

--account

Параметр загрузки для указания пользователя MySQL, который будет использоваться, который либо повторно использует существующую учетную запись пользователя MySQL, либо создает ее; поведение контролируется связанным параметром --account-create.

С --account, использование отдает предпочтение простоте управления перед простотой развертывания, поскольку несколько маршрутизаторов могут использовать одну и ту же учетную запись, а имя пользователя и пароль определяются вручную, а не генерируются автоматически.

Установка этого параметра вызывает запрос пароля для этой учетной записи независимо от того, доступен ли пароль в keyring.

Загрузка без передачи --account не пересоздает существующую учетную запись сервера MySQL.

Использование этого параметра предполагает, что пользователь имеет достаточные права доступа для Router, поскольку процесс загрузки не пытается добавить недостающие права доступа к существующим учетным записям. Процесс загрузки проверяет разрешения и выводит информацию о неудачной проверке на консоль. Процесс загрузки продолжается, несмотря на эти неудачные проверки, если только не используется дополнительный параметр --strict. Пример необходимых разрешений:

GRANT USAGE ON *.* TO `theuser`@`%`
GRANT SELECT, EXECUTE ON `mysql_innodb_cluster_metadata`.* TO `theuser`@`%`
GRANT INSERT, UPDATE, DELETE ON `mysql_innodb_cluster_metadata`.`routers` TO `theuser`@`%`
GRANT INSERT, UPDATE, DELETE ON `mysql_innodb_cluster_metadata`.`v2_routers` TO `theuser`@`%`
GRANT SELECT ON `performance_schema`.`global_variables` TO `theuser`@`%`
GRANT SELECT ON `performance_schema`.`replication_group_member_stats` TO `theuser`@`%`
GRANT SELECT ON `performance_schema`.`replication_group_members` TO `theuser`@`%`

Пароль не принимается из командной строки. Например, передача "foo:bar" предполагает, что "foo:bar" является желаемым именем пользователя, а не пользователем foo с паролем bar.

--account-create

Укажите политику создания учетной записи, чтобы предотвратить случайную загрузку с неправильной учетной записью пользователя. Возможные значения:

Этот параметр требует, чтобы также использовался параметр --account, и чтобы --account-host не использовался.

--account-host

Шаблон хоста, используемый для учетных записей, созданных MySQL Router во время процесса загрузки. Это необязательно и по умолчанию равно '%'.

Передайте этот параметр несколько раз, чтобы определить несколько шаблонов, в этом случае созданные учетные записи MySQL используют один и тот же пароль.

Примеры:

# One host
$> mysqlrouter --bootstrap localhost:3310 --account-host host1

# Or, multiple hosts
$> mysqlrouter --bootstrap localhost:3310 --account-host host1 --account-host host2
  --account-host host3

--conf-use-sockets

Включает локальные сокеты Unix domain.

Этот параметр используется при загрузке, и его включение добавляет параметр socket в сгенерированный конфигурационный файл.

Имя сгенерированного файла сокета зависит от параметра protocol. При включенном классическом протоколе файл называется mysql.sock для соединений чтения-записи и mysqlro.sock для соединений только для чтения. При включенном протоколе X файл называется mysqlx.sock для соединений чтения-записи и mysqlxro.sock для соединений только для чтения.

Этот параметр недоступен в Windows.

--conf-use-gr-notifications

Включает параметр use_gr_notifications [metadata_cache] во время загрузки. При включении маршрутизатор асинхронно уведомляется о большинстве изменений кластера. См. use_gr_notifications для получения дополнительной информации. Кроме того, использование этого параметра устанавливает ttl=60 и auth_cache_refresh_interval=60.

--pid-file path

Устанавливает расположение файла PID. Это можно установить тремя различными способами (в порядке приоритета): этот параметр командной строки --pid-file, установка pid_file в конфигурационном файле маршрутизатора или определение переменной среды ROUTER_PID.

Если указан --bootstrap, то установка --pid-file приводит к сбою маршрутизатора. Это отличается от ROUTER_PID и параметра конфигурации pid_file, которые игнорируются, если указан --bootstrap.

Если --bootstrap не указан, то следующие причины приводят к сбою маршрутизатора: --pid-file уже существует, pid_file или ROUTER_PID установлены, но пусты, или если маршрутизатор не может записать файл PID.

--report-host

Дополнительно определяет имя хоста маршрутизатора, вместо того чтобы полагаться на автоматическое обнаружение для определения внешне видимого имени хоста, зарегистрированного в метаданных во время процесса загрузки.

Маршрутизатор не проверяет и не подтверждает доступность указанного имени хоста, но использует RFC 1123 для проверки имен хостов и RFC 2181 для проверки адресов.

Указанное имя хоста записывается в поле host_name таблицы mysql_innodb_cluster_metadata.hosts в хранилище метаданных кластера MySQL InnoDB.

--conf-skip-tcp

Пропускает конфигурацию TCP-порта для прослушивания входящих соединений. См. также --conf-use-sockets.

Этот параметр недоступен в Windows.

--conf-base-port port_num

Базовое (первое) значение, используемое для прослушивания TCP-портов путем установки bind_port для каждого маршрута, загруженного при загрузке.

Это значение используется для классического маршрута чтения-записи, и каждый дополнительный выделенный порт увеличивается на единицу. Порядок портов установлен как классический чтение-запись / только чтение, а затем x чтение-запись / только чтение.

Установка --conf-base-port в 0 изменяет значения по умолчанию bind_port на следующие значения по умолчанию: для классического протокола чтение-запись использует 6446, а только чтение — 6447, а для протокола X чтение-запись использует 64460, а только чтение — 64470.

Пример использования:

# Example without --conf-base-port
$> mysqlrouter --bootstrap root@localhost:3310
...
Classic MySQL protocol connections to cluster 'devCluster':
- Read/Write Connections: localhost:6446
- Read/Only Connections: localhost:6447

X protocol connections to cluster 'devCluster':
- Read/Write Connections: localhost:6448
- Read/Only Connections: localhost:6449

# Example demonstrating --conf-base-port set to 0
$> mysqlrouter --bootstrap root@localhost:3310 --conf-base-port 0
...
Classic MySQL protocol connections to cluster 'devCluster':
- Read/Write Connections: localhost:6446
- Read/Only Connections: localhost:6447

X protocol connections to cluster 'devCluster':
- Read/Write Connections: localhost:64460
- Read/Only Connections: localhost:64470

--conf-bind-address address

Изменяет значение bind_address, установленное --bootstrap в сгенерированном конфигурационном файле маршрутизатора. По умолчанию, загрузка устанавливает bind_address=0.0.0.0 для каждого маршрута, и этот параметр изменяет это значение.

--read-timeout num_seconds

Количество секунд, прежде чем операции чтения на сервере метаданных будут считаться истекшими по времени.

Это влияет на операции чтения как во время процесса загрузки, так и на обычные операции MySQL Router, устанавливая связанный параметр read_timeout в сгенерированном mysqlrouter.conf.

Этот параметр установлен в пространстве имен [DEFAULT].

--connect-timeout num_seconds

Количество секунд, прежде чем попытки соединения с сервером метаданных будут считаться истекшими по времени.

Это влияет на соединения как во время процесса загрузки, так и на обычные операции MySQL Router, устанавливая связанный параметр connect_timeout в сгенерированном mysqlrouter.conf.

Существует два варианта connect_timeout. Вариант сервера метаданных определяется в пространстве имен [DEFAULT], а вариант сервера MySQL — в пространстве имен [routing].

--user {user_name|user_id}, -u {user_name|user_id}

Запустить mysqlrouter от имени пользователя с именем user_name или числовым идентификатором пользователя user_id. “Пользователь” в этом контексте относится к учетной записи системного входа, а не к пользователю MySQL, указанному в таблицах предоставления прав. При загрузке все сгенерированные файлы принадлежат этому пользователю, и это также устанавливает связанный параметр user.

Эта системная user определена в конфигурационном файле в пространстве имен [DEFAULT]. Для получения дополнительной информации см. документацию по параметру user, который настраивает --user.

Параметр --user необходим, если выполняется загрузка от имени суперпользователя (uid=0). Хотя это не рекомендуется, принудительное использование суперпользователя возможно путем передачи его имени в качестве аргумента, например, --user=root.

Этот параметр недоступен в Windows.

--name router_name

При первоначальной инициализации задаёт символьное имя для автономного экземпляра маршрутизатора. Этот параметр необязателен и используется с --directory. При создании нескольких экземпляров имена должны быть уникальными.

--force-password-validation

По умолчанию MySQL Router пропускает механизм проверки пароля MySQL Server и вместо этого генерирует и использует СИЛЬНЫЙ пароль, основанный на стандартных настройках validate_password. Это связано с тем, что validate_password может быть настроен пользователем, а Router не может учесть необычные пользовательские настройки.

Этот параметр гарантирует, что проверка пароля (validate_password) не пропускается для сгенерированных паролей, и он отключён по умолчанию.

--password-retries num_retries

Указывает количество попыток, которые MySQL Router должен предпринять для генерации пароля при создании учётной записи с правилами проверки пароля. Значение по умолчанию равно 20. Допустимый диапазон — от 1 до 10000.

Наиболее вероятной причиной неудачи является настройка validate_password с необычными требованиями, например, минимальной длиной 50 символов. В этом случае, вероятно, установлен параметр --force-password-validation в значение true.

--force

Вынуждает переконфигурировать ранее настроенный экземпляр маршрутизатора на хосте.

--ssl-mode mode

Режим SSL-соединения для использования во время инициализации и в ходе нормальной работы при подключении к серверу метаданных. Аналогично параметру в клиенте mysql.

Во время инициализации все подключения к серверам метаданных, выполняемые маршрутизатором, будут использовать указанные параметры SSL. Если ssl_mode не указан в конфигурации, он будет по умолчанию установлен в PREFERRED. Во время нормальной работы после запуска маршрутизатора его плагин Metadata Cache будет читать и учитывать все настроенные параметры SSL.

При установке значения, отличного от значения по умолчанию (PREFERRED), в сгенерированном конфигурационном файле вставка производится в раздел [metadata_cache].

Доступные значения — DISABLED, PREFERRED, REQUIRED, VERIFY_CA и VERIFY_IDENTITY. PREFERRED — значение по умолчанию. Как и в клиенте mysql, это значение регистронезависимое.

Эквивалент в конфигурационном файле документирован отдельно по адресу ssl_mode.

--ssl-cert file_path

Имя пути к файлу сертификата открытого ключа SSL в формате PEM. Используется для аутентификации клиента на стороне клиента во время процесса инициализации. Это напрямую соответствует и использует функциональность параметра MySQL-клиента.

Как и --ssl-key, этот параметр используется только во время процесса инициализации, использующего учётную запись root. Это полезно, когда учётная запись root была создана с REQUIRE X509, и поэтому для входа в неё клиенту требуется пройти аутентификацию.

--ssl-key file_path

Имя пути к файлу закрытого ключа SSL в формате PEM. Используется для аутентификации клиента на стороне клиента во время процесса инициализации. Это напрямую соответствует и использует функциональность параметра MySQL-клиента.

Как и --ssl-cert, этот параметр используется только во время процесса инициализации, использующего учётную запись root. Это полезно, когда учётная запись root была создана с REQUIRE X509, и поэтому для входа в неё клиенту требуется пройти аутентификацию.

--ssl-cipher ciphers

Список шифров SSL, разделённых двоеточием (":"), для разрешения, если SSL включён.

--tls-version versions

Список TLS-версий, разделённых запятыми (","), для запроса, если SSL включён.

--ssl-ca file_path

Путь к файлу SSL CA для проверки сертификата сервера.

--ssl-capath dir_path

Путь к каталогу, содержащему файлы SSL CA для проверки сертификата сервера.

--ssl-crl file_path

Путь к файлу SSL CRL для использования при проверке сертификата сервера.

--ssl-crlpath dir_path

Путь к каталогу, содержащему файлы SSL CRL для использования при проверке сертификата сервера.

--client-ssl-mode mode

Режим SSL-соединения для использования во время загрузки и нормальной работы при подключении между MySQL Router и клиентом.

Во время загрузки все соединения с клиентами, устанавливаемые маршрутизатором, будут использовать указанные параметры SSL. Если client_ssl_mode не указан в конфигурации, по умолчанию используется PREFERRED.

Эквивалент файла конфигурации документируется отдельно по адресу client_ssl_mode.

--client-ssl-cert file_path

Имя файла сертификата открытого ключа SSL в формате PEM. Он используется для облегчения проверки подлинности на стороне клиента во время процесса загрузки.

Как и --client-ssl-key, этот параметр используется только во время загрузки, которая использует учетную запись root. Это полезно, когда учетная запись root была создана с REQUIRE X509, и поэтому для входа в систему как root требуется, чтобы клиент аутентифицировал себя.

client-ssl-curves

По умолчанию используется защищенный список кривых SSL. Отформатируйте эту строку как список имен кривых, разделенных двоеточием.

--client-ssl-key file_path

Имя файла закрытого ключа SSL в формате PEM. Он используется для облегчения проверки подлинности на стороне клиента во время процесса загрузки.

Как и --client-ssl-cert, этот параметр используется только во время процесса загрузки, который использует учетную запись root. Это полезно, когда учетная запись root была создана с REQUIRE X509, и поэтому для входа в систему как root требуется, чтобы клиент аутентифицировал себя.

--client-ssl-cipher ciphers

Список шифров SSL, разделенных двоеточием (":"), которые разрешено использовать, если SSL включен.

client-ssl-dh-params

Имя файла параметров DH. Если указано и не пусто, параметры DH из этого файла используются вместо внутренних параметров DH по умолчанию. Отформатируйте файл параметров DH в формате PEM.

--client-ssl-ca file_path

Путь к файлу SSL CA для проверки сертификата сервера.

--client-ssl-capath dir_path

Путь к каталогу, содержащему файлы SSL CA для проверки сертификата сервера.

--client-ssl-crl file_path

Путь к файлу SSL CRL, который используется при проверке сертификата сервера.

--client-ssl-crlpath dir_path

Путь к каталогу, содержащему файлы SSL CRL, которые используются при проверке сертификата сервера.

--server-ssl-mode mode

Режим SSL-соединения для использования во время загрузки и нормальной работы при подключении между MySQL Router и сервером.

Во время загрузки все соединения с серверами, устанавливаемые маршрутизатором, будут использовать указанные параметры SSL. Если server_ssl_mode не указан в конфигурации, по умолчанию используется PREFERRED.

Эквивалент файла конфигурации документируется отдельно по адресу server_ssl_mode.

--server-ssl-cipher ciphers

Список шифров SSL, разделенных двоеточием (":"), которые разрешено использовать, если SSL включен.

--server-ssl-ca file_path

Путь к файлу SSL CA для проверки сертификата сервера.

--server-ssl-capath dir_path

Путь к каталогу, содержащему файлы SSL CA для проверки сертификата сервера.

--server-ssl-crl file_path

Путь к файлу SSL CRL, который используется при проверке сертификата сервера.

--server-ssl-crlpath dir_path

Путь к каталогу, содержащему файлы SSL CRL, которые используются при проверке сертификата сервера.

server-ssl-curves

По умолчанию используется защищенный список кривых SSL. Отформатируйте эту строку как список имен кривых, разделенных двоеточием.

--server-ssl-verify string

Проверка сертификатов SSL, представленных сервером роутеру

--config file_path, -c file_path

Используется для указания пути и имени файла конфигурации. Используйте этот параметр, если вы хотите использовать файл конфигурации, расположенный в папке, отличной от стандартных.

При использовании с --bootstrap, и если файл конфигурации уже существует, копия текущего файла сохраняется с расширением .bak, если содержимое сгенерированного файла конфигурации отличается от исходного. Существующие файлы .bak перезаписываются.

--extra-config file_path, -a file_path

Используется для указания дополнительного файла конфигурации. Используйте этот параметр, если вы хотите разделить файл конфигурации на две части для тестирования, нескольких экземпляров приложения, работающих на одном компьютере и т. д.

Этот файл конфигурации читается после основного файла конфигурации. Если возникают конфликты (параметр задан в нескольких файлах конфигурации), используется значение из файла, загруженного последним.

--install-service

Установка Router в качестве службы Windows, которая автоматически запускается при запуске Windows. Имя службы по умолчанию — MySQLRouter.

Этот процесс установки не проверяет файлы конфигурации, переданные через --config.

Этот параметр доступен только в Windows.

--install-service-manual

Установка MySQL Router в качестве службы Windows, которую можно запускать вручную. Имя службы по умолчанию — MySQLRouter.

Этот параметр доступен только в Windows.

--remove-service

Удаление службы Router в Windows; имя службы по умолчанию MySQLRouter.

Этот параметр доступен только в Windows.

--service

Запуск Router в качестве службы Windows. Это закрытый параметр, используемый только службой Windows при запуске Router в качестве службы.

Этот параметр доступен только в Windows.

--update-credentials-section

Этот параметр доступен только в Windows и относится к хранилищу паролей.

--conf-target-cluster

Устанавливает метаданные target_cluster MySQL Router. Принимает одну из следующих строк:

См. также --config-target-cluster-by-name, который устанавливает target_cluster конкретное статическое имя кластера.

--disable-rest

По умолчанию, данные конфигурации для веб-службы REST API MySQL Router добавляются в сгенерированный mysqlrouter.conf файл во время загрузки; этот параметр означает, что эти данные не добавляются. Это не отключает функциональность REST API, так как её можно настроить вручную (для включения) позже.

--https-port

Дополнительно можно определить port HTTP-сервера для REST API MySQL Router в секции [http_server] в сгенерированном mysqlrouter.conf файле во время загрузки. По умолчанию значение 8443. Проверка доступности порта не производится.