Планировщик заданий cron

Статья содержит описание настройки и перечень заданий, которые запускает планировщик cron в BILLmanager.

Планировщик cron — программа, запускающая задания с указанной периодичностью.

Чтобы перейти к управлению заданиями, в правом верхнем углу нажмите имя администратора → Вернуться в root → перейдите в раздел Настройки → Планировщик. Раздел Планировщик содержит задания для root пользователя, которые находятся в /var/spool/cron/root или /usr/spool/cron/.

В этом разделе вы можете:

Создать новые задания;
Изменить существующие;
Включить или Выключить задания;
Удалить задания.

Настройка заданий

Чтобы добавить новое задание, нажмите Создать задание:

Адрес e-mail — указывается в настройках после того, как задание создано;
Дата и время сервера — отображает текущие дату и время на сервере;
Команда — укажите команду, которую планировщик будет запускать по расписанию. См. раздел Описание заданий;
Пример команды
```
/usr/local/mgr5/sbin/mgrctl -m billmgr currencyrate.upload upload=on sok=ok plid=153/50
```
Описание — укажите описание задания;
Включено — при активной опции задание будет включено после создания;
Расписание. Задания будут выполнены по времени сервера.
- Базовый режим — упрощённый вариант настройки расписания. Выберите периодичность выполнения задания и укажите время начала его выполнения;
- Экспертный режим — расширенный вариант настройки расписания. Укажите периодичность выполнения задания вручную. См. раздел Описание заданий.
Не отправлять отчет по e-mail — активируйте опцию, чтобы результаты выполнения команды не отправлялись на почтовый адрес.

Настройка планировщика

Чтобы настроить планировщик, выберите задание → кнопка Настройки:

Адрес e-mail — укажите адрес почтового ящика для получения отчётов о выполнении заданий;
Путь — укажите путь до исполняемых файлов в формате /bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin. Пути разделяются двоеточием.

Описание заданий

Задание cron состоит из шести полей, разделяемых пробелами или табуляторами. Поля указываются в порядке: minute(s) hour(s) day(s) month(s) weekday(s) command(s).

Время выполнения может быть указано как:

число;
список чисел, разделённых запятыми;
диапазон чисел, разделённых дефисом;
символ * — любое целое число;
символ / — шаг значений диапазона.

Поле	Диапазон значений	Описание
minute	0-59	минута запуска
hour	0-23	час запуска
day	1-31	число (день) запуска
month	1-12	месяц запуска
weekday	0-6	день недели запуска (воскресенье = 0, понедельник = 1, вторник = 2 и т.д.)
command		Последовательность команд для выполнения. Это могут быть команды или исполняемые файлы

Примеры записи времени:

23 0-23/2 * * * — в 00:23, 2:23, 4:23 ..., каждый день;
* 5 4-10 0-3 * — в 5:00 на 4,5,6,7,8,9,10 дни января, февраля, марта и апреля.

command — это команда, выполняемая интерпретатором. Считается до конца строки и может содержать пробелы. В качестве команды укажите путь до исполняемого файла и используйте команду в соответствии с форматом, который поддерживается указанным файлом. Например:

<путь до исполняемого файла> -m billmgr <параметры команды> — обращение к платформе;
<путь до исполняемого файла> --command <параметры команды> — обращение к дополнительным модулям BILLmanager.

Для составления параметров команды вы можете воспользоваться статьями из раздела BILLmanager API.

Пример команды

/usr/local/mgr5/sbin/mgrctl -m billmgr currencyrate.upload upload=on sok=ok plid=153/50

Пример задания

## BILLmanager autoprolong notification
30 */12 * * * /usr/local/mgr5/sbin/billmaintain --command autoprolong_disabled_for_items >/dev/null 2>&1

Перечень заданий

Список заданий cron может отличаться в зависимости от версии и настроек платформы и установленных модулей.

Чтобы посмотреть список заданий cron для пользователя root выполните команду:

crontab -u root -l

Уведомления

Задание Cron	Значение
## BILLmanager update expiredate notification 0 1 * * * /usr/local/mgr5/sbin/billmaintain --command warnupdateexpiredate >/dev/null 2>&1	Проверка необходимости отправки писем по услугам со скорым истечением срока действия
## BILLmanager send periodic notifications 0 3 * * * /usr/local/mgr5/sbin/billmaintain --command send_notification >/dev/null 2>&1	Отправка финансовых уведомлений
## BILLmanager set ntsms messages * * * * * /usr/local/mgr5/notify/ntsms --command process >/dev/null 2>&1	Автоматическая отправка СМС-уведомлений. В этот список попадают пользователи, у которых: есть проверенный номер телефона; включены уведомления через СМС; соблюдается условие отправки уведомления.

Задание Cron

Значение

## BILLmanager update expiredate notification

0 1 * * * /usr/local/mgr5/sbin/billmaintain --command warnupdateexpiredate >/dev/null 2>&1

Проверка необходимости отправки писем по услугам со скорым истечением срока действия

## BILLmanager send periodic notifications

0 3 * * * /usr/local/mgr5/sbin/billmaintain --command send_notification >/dev/null 2>&1

Отправка финансовых уведомлений

## BILLmanager set ntsms messages

* * * * * /usr/local/mgr5/notify/ntsms --command process >/dev/null 2>&1

Автоматическая отправка СМС-уведомлений.

В этот список попадают пользователи, у которых:

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

Финансы и оплата

Задание Cron	Значение
## BILLmanager low money notification 0 1 * * * /usr/local/mgr5/sbin/billmaintain --command warnmoney >/dev/null 2>&1	Отправка уведомлений и пополнение баланса (если настроен автоплатёж)
## BILLmanager generate postpaid payments 25 2 1 * * /usr/local/mgr5/sbin/billmaintain --command payment_generate_postpaid >/dev/null 2>&1	Автоматическое выставление счетов всем клиентам, у которых на начало месяца есть неоплаченные расходы
## BILLmanager check modules balance info 0 6,18 * * * /usr/local/mgr5/sbin/mgrctl -m billmgr crontask action=processing.checkbalance >/dev/null 2>&1	Проверка баланса обработчиков. Подробнее см. в статье Баланс обработчика услуг документации BILLmanager
## BILLmanager clean_stalled_stored_methods 0 2,14 * * * /usr/local/mgr5/sbin/billmaintain --command clean_stalled_stored_methods >/dev/null 2>&1	Очистка списка зависших сохранённых методов оплаты
root@aqua-rosolite-cloned ~# crontab -l \| grep close_acco 15 2 * * * /usr/local/mgr5/sbin/billmaintain --command close_accounts >/dev/null 2>&1	Автозакрытие счетов

Услуги

Задание Cron	Значение
## BILLmanager autosuspend unpaid items 2 * * * * /usr/local/mgr5/sbin/billmaintain --command autosuspend >/dev/null 2>&1	Автоматическая остановка услуг
## BILLmanager daily billing 15 0 * * */usr/local/mgr5/sbin/billmaintain --command billdaily >/dev/null 2>&1	Ежедневный сбор информации об открытых услугах. Задание на продление услуг: через сохранённый способ оплаты, или с баланса лицевого счёта. Подробнее см. в статье Платежный цикл (Billing Cycle) документации BILLmanager
## BILLmanager process certificate subscription 30 0 * * * /usr/local/mgr5/sbin/billmaintain --command process_certificate_external_subscription >/dev/null 2>&1	Проверка необходимости продления сертификата на стороне обработчика
## BILLmanager sync items data with providers 40 /3 * * /usr/local/mgr5/sbin/billmaintain --command syncitem >/dev/null 2>&1	Синхронизация данных домена. Подробнее см. в статье Синхронизация данных доменов документации BILLmanager
## BILLmanager process abuse tasks 20 * * * * /usr/local/mgr5/sbin/billmaintain --command abuse_task >/dev/null 2>&1	Поиск нарушений политики использования услуг со статусом "Открыто" и сроком устранения меньше текущей даты на сервере. Подробнее см. в статье Список нарушений документации BILLmanager

Статистика

Задание Cron	Значение
## BILLmanager collect licence 6 usage stat 5 18 * * * /usr/local/mgr5/sbin/mgrctl -m billmgr collect_usageinfo sok=ok >/dev/null 2>&1	Сбор статистики по работе платформы
## BILLmanager export to Google Analytics /10 * * * /usr/local/mgr5/sbin/mgrctl -m billmgr google.analytics.export	Экспорт информации в Google Analytics. Подробнее см. в статье Интеграция с Google Analytics документации BILLmanager
## BILLmanager select tickets 0 1 * * * /usr/local/mgr5/sbin/billmaintain --command selecttickets	Автоматическое заполнение выборки модуля Контроль качества

Задание Cron

Значение

## BILLmanager collect licence 6 usage stat

5 18 * * * /usr/local/mgr5/sbin/mgrctl -m billmgr collect_usageinfo sok=ok >/dev/null 2>&1

Сбор статистики по работе платформы

## BILLmanager export to Google Analytics

*/10 * * * * /usr/local/mgr5/sbin/mgrctl -m billmgr google.analytics.export

Экспорт информации в Google Analytics. Подробнее см. в статье Интеграция с Google Analytics документации BILLmanager

## BILLmanager select tickets

0 1 * * * /usr/local/mgr5/sbin/billmaintain --command selecttickets

Автоматическое заполнение выборки модуля Контроль качества

Перепродажа

Задание Cron	Значение
## BILLmanager sync items processing info 30 /4 * * /usr/local/mgr5/sbin/mgrctl -m billmgr processing.syncserver.cron >/dev/null 2>&1	Синхронизация значений параметров из сторонней панели управления. Подробнее см. в статье Значения параметра документации BILLmanager
## BILLmanager sync processing module configurations 54 * * * * /usr/local/mgr5/sbin/mgrctl -m billmgr processing.getconfig >/dev/null 2>&1	Обновление информации о доступных шаблонах ОС. Подробнее см. в статье ОС доступные для заказа в VMmanager 6 документации BILLmanager

Задание Cron

Значение

## BILLmanager sync items processing info

30 */4 * * * /usr/local/mgr5/sbin/mgrctl -m billmgr processing.syncserver.cron >/dev/null 2>&1

Синхронизация значений параметров из сторонней панели управления. Подробнее см. в статье Значения параметра документации BILLmanager

## BILLmanager sync processing module configurations

54 * * * * /usr/local/mgr5/sbin/mgrctl -m billmgr processing.getconfig >/dev/null 2>&1

Обновление информации о доступных шаблонах ОС. Подробнее см. в статье ОС доступные для заказа в VMmanager 6 документации BILLmanager

Маркетинг

Задание Cron	Значение
## BILLmanager process affiliate 10 3 1 * * /usr/local/mgr5/sbin/billmaintain --command affiliatemonthly >/dev/null 2>&1	Начисление вознаграждения за реферальную программу. Подробнее см. в статье Как работает реферальная программа документации BILLmanager
## BILLmanager send notification 0 3 * * */usr/local/mgr5/sbin/billmaintain --command send_notification >/dev/null 2>&1	Отправка рассылок на сервере. Подробнее см. в статье Рассылки клиентам документации BILLmanager

Задание Cron

Значение

## BILLmanager process affiliate

10 3 1 * * /usr/local/mgr5/sbin/billmaintain --command affiliatemonthly >/dev/null 2>&1

Начисление вознаграждения за реферальную программу. Подробнее см. в статье Как работает реферальная программа документации BILLmanager

## BILLmanager send notification

0 3 * * */usr/local/mgr5/sbin/billmaintain --command send_notification >/dev/null 2>&1

Отправка рассылок на сервере. Подробнее см. в статье Рассылки клиентам документации BILLmanager

Обращения

Задание Cron	Значение
## BILLmanager archive tickets 0 12 * * * /usr/local/mgr5/sbin/billmaintain --command archive_ticket >/dev/null 2>&1	Отправка обращений в архив

Задание Cron

Значение

## BILLmanager archive tickets

0 12 * * * /usr/local/mgr5/sbin/billmaintain --command archive_ticket >/dev/null 2>&1

Отправка обращений в архив