База знаний PMTA›Механизм§ 8.3.1

Откат версии MTA и настройка через API

Configuration API on downgrade

Невидимо, но не удалено

Что происходит с настройкой, заведённой через API, если откатить сам PowerMTA на более раннюю версию.

На версию без API (до 5.5) настройка игнорируется. Между версиями с API руководство даёт таблицу: с 6.0r1 и раньше на 5.5 — всё работает; с 6.0r2 и новее на 6.0r1 или 5.5 — API выключается, а настройка держится на ранее созданных файлах; с 6.0r3 и новее на 6.0r2 — API работает, но хешированные адреса игнорируются до обновления обратно.

Откат после неудачной операции API может сломать запуск: созданные файлы останутся неверными. Руководство советует перед откатом выполнить перечитывание.

Главная ловушка — откатиться сразу после сбоя API. Неудачная операция оставляет в /var/lib/pmta/config-api неверные файлы, и откаченный MTA с ними не запустится; перечитывание перед откатом переписывает их действующей настройкой.

Что делает Хаб. Не используется: API настройки Хаб не включает и версии MTA не откатывает.

Рекомендуемые значения

Что уцелеет при откате:

Откуда	Куда	Что будет
6.0r1 и раньше	5.5	всё работает
6.0r2 и новее	6.0r1, 5.5	API выключен, настройка из созданных файлов
6.0r3 и новее	6.0r2	API работает, хешированные адреса игнорируются

Таблица откатов и предупреждение про запуск — из руководства (§ 8.3.1). Разбор ловушки — наш.

Пример в конфигурации

# перед откатом MTA переписать файлы API действующей настройкой
pmta reload

Руководство называет перечитывание мерой предосторожности; уже сломанные файлы правят вручную.

жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.

Совместимость

PowerMTA 6.0

описана в руководстве этой версии · платформа: любая

С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.

⇄

Связанные записи

2 связи

Работают в паре

Обновление MTAПорядок действий, в котором механизм и применяется. inference

Где применяется

Настройка через API и файл не сходятсяСмежный механизм: они работают вместе. § 8.3.1

Как проверить на узле

До отката узнать версию и состояние файлов API:

pmta show version
ls -l /var/lib/pmta/config-api/

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

◇

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

3 статьи

◇Ключ активации — условие установки, а не шаг после неёБез ключа активации от поддержки SparkPost MTA не ставится и не работает, а уровень лицензии задаёт потолок исходящих соединений: на стандартной всё сверх 200 игнорируется.◇Ограничения облакаОблака ограничивают исходящую почту через порт 25, пока не попросишь снять лимит, а их диапазоны адресов почтовики встречают с подозрением.◇Как перевести план отправки в железоДве постоянные, по которым считается любой узел: около 2 КБ памяти на каждого получателя в очереди и место под спул, пропорциональное суммарному размеру писем.

В Хабе

Цена ошибки: опасно: последствия переживут откат
Сценарии: Подготовить узел к отправке