Demo
Demo
База знаний PMTA›Блок <domain>›Директива§ 3.3.10.103

disable-mx-rollup

<domain>

Исключить ли этого получателя из сведения очередей
в конфигурации это строкаdisable-mx-rollup falseвнутри блока <domain>
Оставить получателя со своей отдельной очередью

Отменяет сведение для одного получателя. При включении записи DNS этого домена не сверяются с ручным списком <mx-rollup-list> и не рассматриваются для автоматического сведения (auto-mx-rollup). Обе дороги закрываются одной строкой.

Домен остаётся со своей отдельной очередью: свой темп, свой потолок соединений, свой щадящий режим, своя строка в мониторе.

Строка нужна там, где сведение мешает. Обычный случай — важный получатель, стоящий за общим шлюзом хостера: сведение уравняет его с тысячами чужих доменов, а вам нужен отдельный контроль именно за ним.

Главная ловушка. Отдельная очередь не значит отдельный шлюз. Приёмник по-прежнему видит суммарную нагрузку от всех ваших очередей, которые к нему приходят, — вы лишь перестали её учитывать. Исключение домена из сведения без пересчёта его лимита обычно означает, что суммарный темп на шлюз вырос.
Что делает Хаб. Не пишет — и не пишет ни одного из сведений, которые эта строка отменяет. Пока конфигурация Хаба подоменная, строка не нужна: отменять нечего.
Рекомендуемые значения

Только точечно. Смысл строки — исключение из правила. Включённая в блоке со звёздочкой, она отменяет сведение целиком, и проще тогда не настраивать его вовсе.

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

Проверьте, что исключать есть что. Если ни ручной список, ни автоматическое сведение не настроены, строка не делает ничего.

Требование пересчитать лимит и предупреждение про звёздочку — наши. Из руководства здесь умолчание false и то, что строка закрывает обе дороги сразу: и сверку со списком, и автоматическое сведение.
Пример в конфигурации
# важный получатель за общим шлюзом — ведём отдельно
<domain client.example.com>
    disable-mx-rollup true    max-smtp-out 5
    max-msg-rate 200/h
</domain>
Лимиты рядом не для красоты: домен, выведенный из общей очереди, перестаёт делить её темп и получает свой — сверх того, что уже идёт на тот же шлюз.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается2 ошибки▶

Исключают домен и не трогают его лимиты

наш опыт

Чем чреватоДомен получает собственный темп в дополнение к тому, что уже идёт на тот же шлюз остальными очередями. Суммарная нагрузка на приёмника растёт ровно в тот момент, когда её хотели взять под контроль.
Как заметитьПосле исключения выросла доля временных отказов по всем доменам этого шлюза, не только по исключённому.
Как правильноЗадать исключённому домену лимит из общего бюджета на шлюз, а не поверх него.

Ставят её в блоке со звёздочкой

§ 3.3.10.103

Чем чреватоСведение отменяется для всех получателей сразу. Ручной список и автоматическая группировка остаются в конфигурации и выглядят работающими, хотя не действуют ни на кого.
Как заметитьОчередей с окончанием .rollup в списке нет вовсе, хотя список сведения задан.
Как правильноСтавить строку только в блоках конкретных получателей.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
disable-mx-rollup <boolean>
Значения
yes или no; true и false принимаются наравне с ними
Умолчание
false § 3.3.10.103
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<domain>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Значение сливается по блокам <domain> от общего к частному: побеждает наиболее подходящий блок, а не последний по файлу. Отменяет оба сведения независимо от того, где они заданы: ручной список — на уровне узла, auto-mx-rollup — тоже. Подхватывается по pmta reload.
⇄

Связанные директивы

2 связи

Конфликтует

auto-mx-rollupGlobalАвтоматическое сведение, которое эта строка отменяет для одного получателя. § 3.3.10.103

Чем можно заменить

queue-to<domain>Противоположное действие: та сводит домены в общую очередь по вашему указанию, эта выводит домен из любого сведения. § 3.3.10.103

Как проверить на узле
Результат виден по списку очередей: у исключённого домена очередь названа его собственным именем, а не именем сведённой:
pmta show settings client.example.com/vmta1 | grep -i disable-mx-rollup
pmta show queues | grep -i client.example.com
Если во второй команде домен виден в очереди с окончанием .rollup или .arollup, строка не подействовала. Хаб сведение не настраивает, поэтому у него все очереди подоменные и без этой строки.
◇

Что ещё почитать

3 статьи

◇Четыре типа значений, на которых написан весь конфигЛогическое, образец домена, регулярное выражение и промежуток времени — определены один раз в § 3.2 и дальше используются всеми директивами.◇Два обработчика входящих отчётов и что с ними делатьОтказы письмом и жалобы разбираются двумя одинаково устроенными блоками; у каждого свой список адресов и своя пара решений о судьбе письма.◇Как складывается политика для приёмникаНастройки собираются от самого общего образца к самому точному; порядок блоков в файле не значит ничего.

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Классификация отказов · Настроить темп под провайдера
Соседние настройки блока <domain>:reroute-to-virtual-mtabackoff-reroute-to-virtual-mtasmtp-hostsqueue-torouteВсе 135 директив блока →