wsrep_provider_options

wsrep_provider_options

Следующие параметры могут быть установлены как часть переменной Galera wsrep_provider_options. Динамические параметры могут быть изменены во время работы сервера.

Параметры должны быть предоставлены в виде списка, разделенного точкой с запятой (;), на одной строке. Параметры, которые не установлены явно, устанавливаются в значение по умолчанию.

Обратите внимание, что до Galera 3 тег repl назывался replicator.

base_dir

• Описание: Указывает каталог данных

base_host

• Описание: Для внутреннего использования. Не следует устанавливать вручную.
• По умолчанию: 127.0.0.1 (обнаруженный сетевой адрес)

base_port

• Описание: Для внутреннего использования. Не следует устанавливать вручную.
• По умолчанию: 4567

cert.log_conflicts

• Описание: Подробности журнала ошибок сертификации.
• Динамический: Да
• По умолчанию: no

cert.optimistic_pa

• Описание: Управляет параллельным применением действий на реплике. Если установлен, разрешается полный диапазон параллелизации, определяемый алгоритмом сертификации. Если не установлен, окно параллельного применения не будет превышать того, что наблюдается на основном сервере, и применение начнется не раньше, чем после фиксации всех действий, которые он видел на основном сервере.
• Динамический: Да
• По умолчанию: yes

debug

• Описание: Включить отладку.
• Динамический: Да
• По умолчанию: no

evs.auto_evict

• Описание: Количество записей, которые узел допускает для данного узла с задержкой, прежде чем запустить протокол автоматического удаления. Запись добавляется в список задержек для каждого задержанного ответа от узла. Если установлено значение 0, по умолчанию, протокол автоматического удаления отключен для этого узла. Подробнее см. Автоматическое удаление.
• Динамический: Нет
• По умолчанию: 0

evs.causal_keepalive_period

• Описание: Используется только разработчиками и не обслуживается вручную.
• Динамический: Нет
• По умолчанию: evs.keepalive_period.

evs.debug_log_mask

• Описание: Управляет ведением журнала отладки EVS. Эффективно только когда wsrep_debug включен.
• Динамический: Да
• По умолчанию: 0x1

evs.delay_margin

• Описание: Время, на которое могут быть задержаны времена отклика, прежде чем этот узел добавит запись в список задержек. См. evs.auto_evict. Должно быть установлено значение большее, чем время задержки двусторонней связи между узлами.
• Динамический: Нет
• По умолчанию: PT1S

evs.delayed_keep_period

• Описание: Время, в течение которого этот узел требует, чтобы ранее отложенный узел оставался отзывчивым, прежде чем быть удаленным из списка задержек. См. evs.auto_evict.
• Динамический: Нет
• По умолчанию: PT30S

evs.evict

• Описание: При установке в UUID gcomm узла этот узел удаляется из кластера. При установке в пустую строку список удалений очищается на узле, где он установлен. См. evs.auto_evict.
• Динамический: Нет
• По умолчанию: Пустая строка

evs.inactive_check_period

• Описание: Частота проверок бездействия узла (поиск узлов с задержанными ответами), после чего узлы могут быть добавлены в список задержек, а затем удалены.
• Динамический: Нет
• По умолчанию: PT0.5S

evs.inactive_timeout

• Описание: Предельный срок, в течение которого узел может быть неактивен, прежде чем будет объявлен неработоспособным.
• Динамический: Нет
• По умолчанию: PT15S

evs.info_log_mask

• Описание: Управляет дополнительным ведением журнала информации EVS. Биты:
  • 0x1 – дополнительная информация об изменении представления
  • 0x2 – дополнительная информация об изменении состояния
  • 0x4 – статистика
  • 0x8 – профилирование (доступно только в сборках с включенным профилированием)
• Динамический: Нет
• По умолчанию: 0

evs.install_timeout

• Описание: Время ожидания ожидания подтверждений сообщений об установке. Заменяет evs.consensus_timeout.
• Динамический: Да
• По умолчанию: PT7.5S

evs.join_retrans_period

• Описание: Период времени, указывающий, как часто должна происходить повторная передача сообщений о присоединении EVS при формировании членства в кластере.
• Динамический: Да
• По умолчанию: PT1S

evs.keepalive_period

• Описание: Как часто следует передавать сигналы keepalive, когда нет другого трафика.
• Динамический: Да
• По умолчанию: PT1S

evs.max_install_timeouts

• Описание: Количество раундов установки членства, которые необходимо предпринять перед истечением времени ожидания. Общее количество раундов будет равно этому значению плюс два.
• Динамический: Нет
• По умолчанию: 3

evs.send_window

• Описание: Максимальное количество пакетов, которые могут быть реплицированы одновременно. Должно быть больше, чем evs.user_send_window, который применяется только к пакетам данных (рекомендуется удвоение). В сетях WAN может быть установлено значительно больше, чем значение по умолчанию, например 512.
• Динамический: Да
• По умолчанию: 4

evs.stats_report_period

• Описание: Период отчетности для статистики EVS.
• Динамический: Нет
• По умолчанию: PT1M

evs.suspect_timeout

• Описание: Узел будет считаться неработоспособным после этого периода бездействия. Если все узлы согласны, узел удаляется из кластера до достижения evs.inactive_timeout.
• Динамический: Нет
• По умолчанию: PT5S

evs.use_aggregate

• Описание: Если установлено значение true (по умолчанию), небольшие пакеты будут агрегироваться в один, где это возможно.
• Динамический: Нет
• По умолчанию: true

evs.user_send_window

• Описание: Максимальное количество пакетов данных, которые могут быть реплицированы одновременно. Должно быть меньше, чем evs.send_window (рекомендуется половина). В сетях WAN может быть установлено значительно больше, чем значение по умолчанию, например 512.
• Динамический: Да
• По умолчанию: 2

evs.version

• Описание: Версия протокола EVS. По умолчанию 0 для обратной совместимости. Некоторые функции EVS (например, автоматическое удаление) требуют более новых версий.
• Динамический: Нет
• По умолчанию: 0

evs.view_forget_timeout

• Описание: Время, после которого прошлые представления будут удалены из истории представлений.
• Динамический: Нет
• По умолчанию: P1D

gcache.dir

• Описание: Каталог, в котором размещаются файлы GCache.
• Динамический: Нет
• По умолчанию: Рабочий каталог

gcache.keep_pages_size

• Описание: Общий размер страниц хранилища страниц для кэширования. Одна страница всегда присутствует, если включено только хранилище страниц.
• Динамический: Нет
• По умолчанию: 0

gcache.mem_size

• Описание: Максимальный размер хранилища malloc() для настроек, имеющих свободный объем оперативной памяти.
• Динамический: Нет
• По умолчанию: 0

gcache.name

• Описание: Имя файла буфера кольцевого хранилища gcache. По умолчанию расположен в рабочей директории, изменение расположения или раздела может уменьшить ввод-вывод на диск.
• Динамическое: Нет
• Значение по умолчанию: ./galera.cache ---

gcache.page_size

• Описание: Размер страниц файлов хранения страниц. Они имеют префикс gcache.page. Может быть установлен так же, как это позволяет диск.
• Динамическое: Нет
• Значение по умолчанию: 128M

gcache.recover

• Описание: Происходит ли восстановление gcache при запуске узла. Если возможно восстановить gcache, узел может предоставить IST другим присоединяющимся узлам, что помогает при перезапуске всего кластера.
• Динамическое: Нет
• Значение по умолчанию: no
• Введено: MariaDB 10.1.20, MariaDB Galera 10.0.29, MariaDB Galera 5.5.54

gcache.size

• Описание: Размер буфера кольцевого хранилища Gcache (пространство, используемое узлом для кэширования наборов записей), предварительно выделено при запуске.
• Динамическое: Нет
• Значение по умолчанию: 128M

gcomm.thread_prio

• Описание: Политика и приоритет потока Gcomm (в формате policy:priority. Приоритет - целое число, а политика может быть одной из:
  • fifo: Планирование по принципу «первым пришёл — первым обслужен». Всегда прерывает другие потоки, пакетные или потоки ожидания, и может быть прерван только другими потоками fifo более высокого приоритета или заблокирован запросом ввода-вывода.
  • rr: Планирование по круговому циклу. Всегда прерывает другие потоки, пакетные или потоки ожидания. Работает определённое время, после чего поток останавливается и перемещается в конец списка, заменяясь другим потоком с круговым планированием того же приоритета. В противном случае работает до прерывания другими потоками rr более высокого приоритета или блокировки запросом ввода-вывода.
  • other: Стандартное планирование в Linux. Потоки работают до прерывания потоком более высокого приоритета или более высокой очередностью планирования, или блокировки запросом ввода-вывода.
• Динамическое: Нет
• Значение по умолчанию: Пустая строка

gcs.fc_debug

• Описание: Если установлено значение больше нуля (по умолчанию), статистические данные отладки о контроле потока SST будут публиковаться каждый раз после указанного числа наборов записей.
• Динамическое: Нет
• Значение по умолчанию: 0

gcs.fc_factor

• Описание: Доля ниже gcs.fc_limit, при падении очереди приёма ниже которой возобновляется репликация.
• Динамическое: Да
• Значение по умолчанию: 1.0

gcs.fc_limit

• Описание: Если очередь приёма превышает это количество наборов записей, репликация приостанавливается. Может значительно увеличиваться в схемах мастер-раб. Репликация возобновится в соответствии с настройкой gcs.fc_factor.
• Динамическое: Да
• Значение по умолчанию: 16

gcs.fc_master_slave

• Описание: Предполагать, что в кластере имеется только один мастер. Устарело с Galera 4.10 (MariaDB 10.8.1, MariaDB 10.7.2, MariaDB 10.6.6, MariaDB 10.5.14, MariaDB 10.4.22) - см. gcs.fc_single_primary
• Динамическое: Нет
• Значение по умолчанию: no

gcs.fc_single_primary

• Описание: Определяет, есть ли более одного источника репликации. По мере роста количества узлов в кластере, вычисляемый gcs.fc_limit становится больше. В то же время, количество записей с узлов увеличивается. При установке этого параметра в НЕТ (множественный первичный), параметр gcs.fc_limit динамически изменяется, чтобы дать больший запас каждому узлу, чтобы отставать немного дальше при применении записей. Параметр gcs.fc_limit изменяется на квадратный корень от размера кластера, то есть в кластере из четырёх узлов он в два раза выше, чем базовое значение. Это делается для компенсации увеличения шума скорости репликации.
• Динамическое: Нет
• Значение по умолчанию: no

gcs.max_packet_size

• Описание: Максимальный размер пакета, после которого наборы записей фрагментируются.
• Динамическое: Нет
• Значение по умолчанию: 64500

gcs.max_throttle

• Описание: Насколько мы можем ограничить скорость репликации во время передачи состояния (чтобы избежать исчерпания памяти). Установите его в 0,0, если приемлемо приостановление репликации ради завершения передачи состояния.
• Динамическое: Нет
• Значение по умолчанию: 0.25

gcs.recv_q_hard_limit

• Описание: Максимальный размер очереди приёма. Если превышен, сервер прерывается. Рекомендуемый размер — половина доступной оперативной памяти плюс своп.
• Динамическое: Нет
• Значение по умолчанию: LLONG_MAX

gcs.recv_q_soft_limit

• Описание: Доля gcs.recv_q_hard_limit, после которой скорость репликации ограничивается. Скорость ограничения линейно увеличивается от нуля (обычная, изменяющаяся скорость репликации) до и ниже csrecv_q_soft_limit до единицы (полное ограничение) при gcs.recv_q_hard_limit
• Динамическое: Нет
• Значение по умолчанию: 0.25

gcs.sync_donor

• Описание: Должен ли остальной кластер оставаться синхронизированным с донором. Если установлено YES (NO по умолчанию), если донор заблокирован передачей состояния, весь кластер также блокируется.
• Динамическое: Нет
• Значение по умолчанию: no

gmcast.listen_addr

• Описание: Адрес, на котором Galera слушает подключения от других узлов. Может использоваться для переопределения порта прослушивания по умолчанию, который получен из адреса подключения.
• Динамическое: Нет
• Значение по умолчанию: tcp://0.0.0.0:4567

gmcast.mcast_addr

• Описание: По умолчанию не установлено, но если установлено, для репликации будет использоваться UDP-мультивещание. Должно быть идентичным на всех узлах.Например, gmcast.mcast_addr=239.192.0.11
• Динамическое: Нет
• Значение по умолчанию: Нет

gmcast.mcast_ttl

• Описание: Значение TTL (времени жизни пакета) для мультивещания.
• Динамическое: Нет
• Значение по умолчанию: 1

gmcast.peer_timeout

• Описание: Таймаут подключения для инициирования передачи сообщений.
• Динамическое: Нет
• Значение по умолчанию: PT3S

gmcast.segment

• Описание: Определяет сегмент, к которому принадлежит узел. По умолчанию все узлы находятся в одном сегменте (0). Обычно все узлы одного дата-центра помещаются в один сегмент. Трафик протокола Galera перенаправляется только на один узел в каждом сегменте, а затем передаётся другим узлам в том же сегменте, что экономит сетевой трафик между дата-центрами за счёт некоторого увеличения задержки. Передачи состояния также, предпочтительно, но не исключительно, берутся из одного сегмента. Если узлов нет в одном сегменте, передача состояния будет взята с узла в другом сегменте.
• Динамическое: Нет
• Значение по умолчанию: 0
• Диапазон: 0 до 255

gmcast.time_wait

• Описание: Время ожидания, прежде чем разрешить подключение узла, который был объявлен вне стабильного просмотра.
• Динамическое: Нет
• Значение по умолчанию: PT5S

gmcast.version

• Описание: Устаревший параметр. Версия Gmcast.
• Динамическое: Нет
• Значение по умолчанию: 0

ist.recv_addr

• Описание: Адрес для прослушивания передачи состояния наращивания.
• Динамическое: Нет
• Значение по умолчанию: <адрес>:<порт+1> из wsrep_node_address

ist.recv_bind

• Описание:
• Динамический: Нет
• По умолчанию: Пустая строка
• Введён в: MariaDB 10.1.17, MariaDB Galera 10.0.27, MariaDB Galera 5.5.51

pc.announce_timeout

• Описание: Период времени, в течение которого объявления о присоединении к кластеру отправляются каждые 1/2 секунды.
• Динамический: Нет
• По умолчанию: PT3S

pc.checksum

• Описание: Для отладки, по умолчанию false (true в более ранних версиях), указывает, следует ли проверять контрольную сумму реплицированных сообщений на уровне PC. Можно безопасно отключить.
• Динамический: Нет
• По умолчанию: false

pc.ignore_quorum

• Описание: Следует ли игнорировать вычисления кворума, например, когда мастер отделяется от нескольких подчиненных узлов, он будет продолжать работать, если установлено true (false is default). Однако используйте с осторожностью, поскольку в конфигурациях мастер-подчиненный, подчиненные узлы не будут автоматически подключаться к мастеру, если это установлено.
• Динамический: Да
• По умолчанию: false

pc.ignore_sb

• Описание: Разрешить обработку обновлений даже в случае раскола мозга (когда узел отключен от оставшихся узлов). Безопасно в конфигурациях мастер-подчиненный, но может привести к несогласованности данных в конфигурациях с несколькими мастерами.
• Динамический: Да
• По умолчанию: false

pc.linger

• Описание: Время, в течение которого протокол PC ожидает завершения EVS.
• Динамический: Нет
• По умолчанию: PT20S

pc.npvo

• Описание: Если установлено true (false по умолчанию), при наличии конфликтов с первичным компонентом, наиболее новый компонент переопределяет более старый.
• Динамический: Нет
• По умолчанию: false

pc.recovery

• Описание: Если установлено true (по умолчанию), состояние первичного компонента сохраняется на диске, и в случае полного сбоя кластера (например, при отключении электропитания), возможна автоматическая восстановление. Последующие плавные полные перезапуски кластера потребуют явного инициализации нового первичного компонента.
• Динамический: Нет
• По умолчанию: true

pc.version

• Описание: Устаревший параметр. Версия протокола PC.
• Динамический: Нет
• По умолчанию: 0

pc.wait_prim

• Описание: Если установлено true, по умолчанию, узел будет ожидать первичный компонент в течение периода времени, указанного параметром pc.wait_prim_timeout. Используется для запуска непервичных компонентов и их преобразования в первичные с помощью pc.bootstrap.
• Динамический: Нет
• По умолчанию: true

pc.wait_prim_timeout

• Описание: Время ожидания первичного компонента. См. pc.wait_prim.
• Динамический: Нет
• По умолчанию: PT30S

pc.weight

• Описание: Вес узла, используемый для расчёта кворума. См. статью Codership Взвешенный кворум.
• Динамический: Да
• По умолчанию: 1

protonet.backend

• Описание: Устаревший параметр. Используемый транспортный бэкенд. В настоящее время поддерживается только ASIO.
• Динамический: Нет
• По умолчанию: asio

protonet.version

• Описание: Устаревший параметр. Версия Protonet.
• Динамический: Нет
• По умолчанию: 0

repl.causal_read_timeout

• Описание: Срок ожидания для каузальных чтений.
• Динамический: Да
• По умолчанию: PT30S

repl.commit_order

• Описание: Разрешено ли выполнение фиксации в несоблюдении порядка, и при каких условиях. По умолчанию не разрешено, но его настройка может улучшить параллельную производительность.
  • 0 BYPASS: Мониторинг порядка фиксации не выполняется (полезно для измерения штрафа за производительность).
  • 1 OOOC: Разрешена фиксация вне порядка для всех транзакций.
  • 2 LOCAL_OOOC: Разрешена фиксация вне порядка только для локальных транзакций.
  • 3 NO_OOOC: Фиксация вне порядка не разрешена вообще.
• Динамический: Нет
• По умолчанию: 3

repl.key_format

• Описание: Формат репликации ключа. Может быть одним из следующих:
  • FLAT8 - более короткий ключ с большей вероятностью ложных срабатываний при сопоставлении
  • FLAT16 - более длинный ключ с меньшей вероятностью ложных срабатываний при сопоставлении
  • FLAT8A - более короткий ключ с большей вероятностью ложных срабатываний при сопоставлении, включает аннотации для отладки
  • FLAT16A - более длинный ключ с меньшей вероятностью ложных срабатываний при сопоставлении, включает аннотации для отладки
• Динамический: Да
• По умолчанию: FLAT8

repl.max_ws_size

• Описание:
• Динамический:
• По умолчанию: 2147483647

repl.proto_max

• Описание:
• Динамический:
• По умолчанию: 9

socket.checksum

• Описание: Метод, используемый для генерации контрольной суммы. Примечание: Если в кластере используются как Galera 25.2.x, так и 25.3.x, MariaDB с Galera 25.3.x необходимо запускать с wsrep_provider_options='socket.checksum=1' для обеспечения обратной совместимости с Galera v2. Провайдеры wsrep Galera, отличные от 25.3.x или 25.2.x, не поддерживаются.
• Динамический: Нет
• По умолчанию: 2

socket.dynamic

• Описание: Разрешить как шифрованные, так и нешифрованные соединения между узлами. Обычно это должно быть установлено в false (по умолчанию). При установке в true шифрованные соединения всё ещё будут предпочтительны, но будут переключаться на нешифрованные, когда шифрование невозможно, например, если оно ещё не включено на всех узлах. Необходимо установить true на всех узлах, если требуется включить или отключить шифрование с помощью поэтапного перезапуска. Поскольку это не может быть изменено во время работы, для включения или отключения шифрования может потребоваться три перезапуска каждого узла: один для включения socket.dynamic на каждом узле, один для изменения самих настроек шифрования на каждом узле и окончательный цикл для изменения socket.dynamic обратно на false.
• Динамический: Нет
• По умолчанию: false
• Введён в: MariaDB 10.4.19, MariaDB 10.5.10, MariaDB 10.6.0

socket.recv_buf_size

• Описание: Размер в байтах буфера приёма, используемого на сетевых сокетах между узлами, передаваемый ядру через параметр сокета SO_RCVBUF.
• Динамический: Нет
• По умолчанию:
  • >= MariaDB 10.3.23, MariaDB 10.2.32, MariaDB 10.1.45: Авто
  • < MariaDB 10.3.22: MariaDB 10.2.31, MariaDB 10.1.44: 212992

socket.send_buf_size

• Описание: Размер в байтах буфера отправки, используемого на сетевых сокетах между узлами, передаваемый ядру через параметр сокета SO_SNDBUF.
• Динамический: Нет
• По умолчанию: Авто
• Введён в: MariaDB 10.3.23, MariaDB 10.2.32, MariaDB 10.1.45

socket.ssl

• Описание: Явно включает использование TLS у поставщиком wsrep.
• Динамическое: Нет
• По умолчанию: NO

socket.ssl_ca

• Описание: Путь к файлу сертификата центра сертификации (CA). Неявное включение параметра socket.ssl.
• Динамическое: Нет

socket.ssl_cert

• Описание: Путь к файлу сертификата TLS. Неявное включение параметра socket.ssl.
• Динамическое: Нет

socket.ssl_cipher

• Описание: Использовать шифр TLS. Неявное включение параметра socket.ssl. С версии MariaDB 10.2.18 по умолчанию используется значение системной переменной ssl_cipher.
• Динамическое: Нет
• По умолчанию: значение по умолчанию системы, до MariaDB 10.2.18 по умолчанию AES128-SHA.

socket.ssl_compression

• Описание: Сжатие для TLS-соединений. Неявное включение параметра socket.ssl.
• Динамическое: Нет

socket.ssl_key

• Описание: Путь к файлу ключа TLS. Неявное включение параметра socket.ssl.
• Динамическое: Нет

socket.ssl_password_file

• Описание: Путь к файлу пароля для использования в TLS-соединениях. Неявное включение параметра socket.ssl.
• Динамическое: Нет

См. также

• Документация параметров Galera от Codership