Документация BILLmanager 6
Документация — ваш лучший друг?
Поделитесь мнением и пройдите небольшой опрос
Пройти опрос

Планировщик заданий 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).

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

  • число;
  • список чисел, разделённых запятыми;
  • диапазон чисел, разделённых дефисом;
  • символ * — любое целое число;
  • символ / — шаг значений диапазона.
ПолеДиапазон значенийОписание
minute0-59минута запуска
hour0-23час запуска
day1-31число (день) запуска
month1-12месяц запуска
weekday0-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 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

Очистка списка зависших сохранённых методов оплаты

## BILLmanager process autopayments

1 0 * * * /usr/local/mgr5/sbin/billmaintain --command recurring >/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>&

Ежедневный сбор информации об открытых услугах. Подробнее см. в статье Платежный цикл (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 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 archive tickets

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

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