Консольные команды [Документация ACP MikBiLL]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Консольные команды ======

Консольные команды нужны для выполнения некоторых действий из командной строки или написания собственных скриптов для некоторых действий.

Вызов консольных команд в версии 2.х, 3.х :

{{gallery> old:billing:console_commands_2x.png?nolink& }}

===== Запуск из косноли =====

Общий принцип всех команд одинаков: для начала нужно зайти в директорию "админки".

Для Linux систем:
<sxh language width classes>cd /var/www/mikbill/admin</sxh>
Для FreeBSD систем:
<sxh language width classes>cd /usr/local/www/mikbill/admin</sxh> 

далее выполняем:
<sxh language width classes>php ./index.php "команда" "параметр"</sxh>

<WRAP center round tip 40%>
Параметр по необходимости, если их несколько то разделителем является пробел
</WRAP>


===== Периодический запуск через 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.  

[[billing:scripts?&#c%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B_%D0%B2%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D0%BF%D0%BE_%D1%83%D0%BC%D0%BE%D0%BB%D1%87%D0%B0%D0%BD%D0%B8%D1%8E_%D0%B2_cron|Список скриптов включенных по умолчанию в CRON]]

[[billing:scripts?&#%D0%B4%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B|Дополнительные скрипты]]

<WRAP center round info 40%>
Скрипты можно найти в директории: \\
Linux: /var/www/mikbill/admin/sys/scripts \\   
BSD:   /usr/local/www/mikbill/admin/sys/scripts \\
</WRAP>


<WRAP center round tip 40%>
Если добавили свой скрипт в выше указанные директории, то НЕ забудьте поставить права на исполнение скрипта
</WRAP>





===== Доступные команды =====
==== Абонплата ====
^  Команда      ^  Описание  ^
|pay_day|снимает ежедневную абонплату |
|pay_day2|снимает 'ежедневную абонплату' пропорционально количеству дней месяца |
|pay_day_monthly|снимает 'месячную абонплату' по указанной дате в учетке абонента |
|pay_mth|снимает месячную абонплату |
|pay_mth_ost|снимает остаточную абонплату за месяц (тип абонплаты - 'каждый месяц обязан потратить') |
|block_dolgniki|блокировать локальную сеть должникам |
|block_dolgniki_inet|блокировать интернет должникам |
|unlim_block|выполняет блокировку Интернета абонентам, у которых нахватает денег на абон.плату (только для ежедневных абон.плат и плавающей даты)|
|unlim_block_month|выполняет блокировку Интернета абонентам, у которых нахватает денег на абон.плату (только для ежемесячных абон.плат, кроме плавающей даты)|
|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_blocked|создаёт тикеты на обзвон абонентов, которых отключило от Интернета 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 |
|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|проводит все платежи [[billing:configuration:payment_api|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|аналогично [[billing:preferences:management:actions|действию]] 'обновить шейперы'|
|do_voip_calls|выполняет об звонку должников на базе Asterisk|
|white_list|формирует '[[billing:preferences:security:whitelist|Белый список]]', аналогично [[billing:preferences:management:actions|действию]] 'обновить белый список'|
|sql_fix|устраняет большинства проблем в БД: не существующие связи и прочие артефакты, которые могли возникнуть до времени введения контроля над действиями сотрудников|
|sql_clear|уменьшает объём базы данных путём очистки низкоприоритетной информации|
|sql_check|выполнить диагностику и ремонт базы данных MikbiLL|
|do_interval | Изменяет скорость абонентам в онлайне (скорость берется из настроек интервала день/ночь. Для NAS типа accelv2, ciscoasr, asr9000, junmxv2 будет использоваться CoA, для остальных PoD |
|clear_dhcp_log|выполняет очистку лога DHCP в Mysql|
|fiscalization_upd|обновляет старые переменные фискализации из системных опций|