Это старая версия документа!
Консольные команды
Консольные команды нужны для выполнения некоторых действий из командной строки или написания собственных скриптов для некоторых действий.
Вызов консольных команд в версии 2.х, 3.х :
Запуск из косноли
Общий принцип всех команд одинаков: для начала нужно зайти в директорию "админки".
Для Linux систем:
cd /var/www/mikbill/admin
Для FreeBSD систем:
cd /usr/local/www/mikbill/admin
далее выполняем:
php ./index.php "команда" "параметр"
Параметр по необходимости, если их несколько то разделителем является пробел
Периодический запуск через cron
# raw раздел
По умолчанию можно настроить запуск консольных команд каждые:
- 5 минут (mikbill_5min.sh)
- час (mikbill_hour.sh)
- день (mikbill_block.sh; mikbill_day.sh)
- 1 раз в начале месяца (mikbill_mth.sh)
- 1 раз в середине месяца (mikbill_halfmonth.sh)
- 1 раз в конце месяц (mikbill_lastday.sh)
Запуск осуществляется по записям в cron.
Список скриптов включенных по умолчанию в CRON
Скрипты можно найти в директории: /var/mikbill/prod/scripts
Если добавили свой скрипт в выше указанные директории, то НЕ забудьте поставить права на исполнение скрипта
Доступные команды
Абонплата
Команда | Описание |
---|---|
pay_day | снимает ежедневную абонплату |
pay_day2 | снимает 'ежедневную абонплату' пропорционально количеству дней месяца |
pay_day_monthly | снимает 'месячную абонплату' по указанной дате в учетке абонента |
pay_mth | снимает месячную абонплату |
pay_mth_ost | снимает остаточную абонплату за месяц (тип абонплаты - 'каждый месяц обязан потратить') |
block_dolgniki | блокировать локальную сеть должникам |
block_dolgniki_inet | блокировать интернет должникам |
unlim_block | выполняет блокировку Интернета абонентам, у которых нахватает денег на абон.плату (только для ежедневных абон.плат и плавающей даты) |
unlim_block_month | выполняет блокировку Интернета абонентам, у которых нахватает денег на абон.плату (только для ежемесячных абон.плат, кроме плавающей даты) |
unlim_block_month_type2 | выполняет блокировку Интернета абонентам с балансом < 0 (только для ежемесячных абон.плат, кроме плавающей даты) |
do_freeze_abonplata | снимает ежедневную абонплату заморозки, если таковая существует |
pay_real | снимает 'ежедневную абонплату' за использование услуги Real-ip, если таковая существует |
pay_credit | оплата услуги % по кредиту |
Абоненты
Команда | Описание |
---|---|
otkl_neplat | перенос в группу 'отключенные' по истечению количества дней |
del_otkl | перенос в группу 'удаленные' из 'отключенных' по истечению количества дней |
do_disable_locked_users | перенос в группу 'отключенные' по прошествии N дней с момента блокировки Интернета по недостатку средств (регулируется 'системными опциями'). Не переносятся в отключённые абоненты с "вечным лимитом" и те, у которых с момента регистрации не прошло N дней |
do_disable_users_contract_state | переводит в группу 'отключённые' базовых пользователей, у которых статус контракта 'приостановлен' |
do_remove_users_contract_state | переводит в группу 'удалённые' базовых пользователей, у которых статус контракта 'закрыт' |
update_date_of_contract_by_regdate | вносит абонентам без 'даты заключения договора' дату заключения, которая соответствует дате регистрации абонента в системе биллинга |
do_create_ticket_nopays | создаёт тикеты на абонентов, которых отключило от Интернета N дней назад |
do_create_ticket_offline | создаёт тикеты на абонентов, которые не выходили в онлайн N дней |
do_create_ticket_freezed | создаёт тикеты на абонентов, которые заморожены более N дней |
prepare_mobile_and_sms_phones | убирает из "мобильный номер" и "смс номер" всех абонентов все символы, кроме цифр |
changetarifuser | изменяет шейпер у абонента после смены тарифа, 3 параметра: UID, старый GID , новый GID |
proceed_users_pending_changes | Выполнить все отложенные изменения абонентов, которые готовы к активации |
Сессии
Команда | Описание |
---|---|
rad_online | запускает 'сборщик мусора', который находит и закрывает, 'зависшие' сессии абонентов, если вдруг возник какой либо сбой на NAS |
clear_online | очистит список текущего онлайна |
userkick | Выполняет выкидывание абонента по UID . Пример: userkick 1234, где 1234 - uid абонента |
kick_unknown | Выкинуть неизвестных |
kick_usersblock | Выкинуть заблокированных |
kick_usersotkl | Выкинуть отключенных |
kick_usersdel | Выкинуть удаленных |
kick_usersotkl_usersdel | Выкинуть удаленных и отключенных |
kick_usersfreeze | Выкинуть замороженных |
kick_no_money | Выкинуть должников |
kick_tarif_tos_day | Выкинуть всех кто на учетном тарифе, ежедневно |
kick_tarif_tos_week | Выкинуть всех кто на учетном тарифе, еженедельно |
kick_tarif_tos_month | Выкинуть всех кто на учетном тарифе, ежемесячно |
kick_tarif_tos_dynamic | Выкинуть всех кто на учетном тарифе, плавающая дата |
IP адреса
Команда | Описание |
---|---|
pool_online | запускает 'сборщик мусора IP', который утилизирует IP из IP-Pool, в случае, если они уже перестали использоваться, но остались еще выданными |
clear_pool_online | Вернуть все IP в свои пулы ip_pool |
clear_pool_ip_online | Убирает из пулов IP адреса, которые на данный момент "онлайн" |
pool_recreate_all | Пересоздает IP адреса во всех пулах (у которых указаны шлюз и маска) |
remove_used_framed_IP_from_framed_pool | Из пула (справочника) реальников удаляет те IP, которые уже выданы абонентам |
sectorsync | выполняет синхронизацию IP в пулах сегментов, т.е. убирает из свободных те, что уже выданы абонентам и т.д. Удобно восстановить целостность после ручной правки базы или же на этапах внедрения. Результатом работы команды будет упорядочивание IP в пулах сегментов, удаление используемых абонентами IP, а также исключение из пула адресов, указанных в параметре Range, ваших сегментов. Если у вас были проблемы с пересортировкой IP в сегментах, когда в пуле одного сегмента присутствовали IP другого, команда исправит эту и другие проблемы с IP в сегментах |
framedsync | Синхронизирует framed_ip с local_ip согласно VPN базе |
clear_real_ip | автозабор внешних IP у абонентов в удаленных и отключенных |
Услуги
Команда | Описание |
---|---|
do_freeze | 'заморозка' пользователей по расписанию |
do_unfreeze | 'разморозка' пользователей по расписанию |
unfreezeuser | 'разморозка' пользователя по UID - передается параметр UID |
credit_null | выполняет полное обнуление кредитов по заданному числу |
tarif_change | выполняет изменения тарифа с нового месяца |
do_usluga_block | выполняет блокировку всех услуг, в соответствии с датой окончания услуги |
do_turbo_block | выполняет проверку и своевременную блокировку услуги 'турбо' |
Платежи
Команда | Описание |
---|---|
do_api_terminal_payments | проводит все платежи Pay API |
getPrivatTodayPayments | Вносит в биллинг все новые платежи за сегодняшний день из выписки ПриватБанк |
getPrivatPreviousPayments | Вносит в биллинг все новые платежи за прошлые дни из выписки ПриватБанк, количество дней регулируется в системных опциях |
discard_thousandths_of_users_balance | решение 'проблемы' '-0.00': отбрасывает все знаки после сотых в балансе базовых пользователей, т.е. '0.001' = 0 и '-0.001' = 0. При использовании этой команды может не сойтись оборотно-сальдовая ведомость и прочие отчёты, т.к. погрешность будет увеличена |
MBP (Мониторинг)
Команда | Описание |
---|---|
mbp_ping_bras | Собирает информация о пинге к NAS серверам |
mbp_ping_devices | Собирает информация о пинге к устройствам |
mbp_graph_cpu | Добавляет информацию о текущей нагрузке процессора в график |
mbp_graph_ram | Добавляет информацию о состоянии памяти сервера в график |
Utility
Команда | Описание |
---|---|
migratenodeny | выполняет миграцию абонентов |
dhcp_gen | формирует конфигурацию для демона dhcpd |
user_mrtg_gen | генерирует конфигурационный файл для мониторинга нагрузки online абонентов |
shaper_init | аналогично действию 'обновить шейперы' |
do_voip_calls | выполняет об звонку должников на базе Asterisk |
white_list | формирует 'Белый список', аналогично действию 'обновить белый список' |
sql_fix | устраняет большинства проблем в БД: не существующие связи и прочие артефакты, которые могли возникнуть до времени введения контроля над действиями сотрудников |
sql_clear | уменьшает объём базы данных путём очистки низкоприоритетной информации |
sql_check | выполнить диагностику и ремонт базы данных MikbiLL |
do_interval | Изменяет скорость абонентам в онлайне (скорость берется из настроек интервала день/ночь. Для NAS типа accelv2, ciscoasr, asr9000, junmxv2 будет использоваться CoA, для остальных PoD |
clear_dhcp_log | выполняет очистку лога DHCP в Mysql |
fiscalization_upd | обновляет старые переменные фискализации из системных опций |
shaper_generate_vasexperts | Создать индивидуальные шейпера абонентов для vasexperts |
Документы
Команда | Описание |
---|---|
generateinvoices | Генерирует invoice за текущий месяц |
generateinvoiceslastmonth | Генерирует invoice за прошлый месяц |
generateinvoicesnextmonth | Генерирует invoice за следующий месяц |
send_sms_invoices | Отправить счета по СМС |
send_email_invoices | Отправить счета по email |
send_post_invoices | Сохранить счета в файлы (для распечатки) |
Отчеты
Команда | Описание |
---|---|
generate_trial_balance_report | Сгенерировать оборотно-сальдовую ведомость за текущий месяц. Указать период можно передав в первом параметре месяц а во втором год. Пример: php index.php generate_trial_balance_report 01 2021 |
generate_trial_balance_report_city | Сгенерировать оборотно-сальдовую ведомость по нас. пунктам за текущий месяц. Указать период можно передав в первом параметре месяц а во втором год. Пример: php index.php generate_trial_balance_report_city 01 2021 |
generate_trial_balance_report_subprovider | Сгенерировать оборотно-сальдовую ведомость по субпровайдерам за текущий месяц. Указать период можно передав в первом параметре месяц а во втором год. Пример: php index.php generate_trial_balance_report_subprovider 01 2021 |
generate_trial_balance_report_tarif | Сгенерировать оборотно-сальдовую ведомость по тарифам за текущий месяц. Указать период можно передав в первом параметре месяц а во втором год. Пример: php index.php generate_trial_balance_report_tarif 01 2021 |
Подписки
На данный момент реализовано для IPTVPortal и OmegaTV
Команда | Описание |
---|---|
iptv_user_sync | Выполняет синхронизацию подписок указанного абонента с мидлварой. Пример iptv_user_sync 7 |
iptv_sub_sync | Выполняет синхронизацию абонентов указанной подписки с мидлварой. Пример iptv_sub_sync 101 |