CLI для управления абонентами [Документация VAS Experts]

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
dpi:bras_bng:cli:subs [2023/08/24 09:07] – ↷ Страница перемещена из dpi:dpi_options:cli:subs в dpi:bras_bng:cli:subs elena.krasnobryzhdpi:bras_bng:cli:subs [2026/03/23 09:07] (текущий) – [subs prop set] elena.krasnobryzh
Строка 1: Строка 1:
 ====== CLI для управления абонентами ====== ====== CLI для управления абонентами ======
-{{indexmenu_n>40}}+{{indexmenu_n>5}}
  
 Команды управления абонентами Команды управления абонентами
Строка 6: Строка 6:
 ===== subs auth ===== ===== subs auth =====
 {{anchor:subs_auth}} {{anchor:subs_auth}}
-Команды управления статусом авторизации абонентов.+Команды управления статусом авторизации абонентов.\\
 Абонент указывается своим IP-адресом. Можно задать один IP-адрес или группу адресов в виде CIDR или в виде диапазона IP-адресов: Абонент указывается своим IP-адресом. Можно задать один IP-адрес или группу адресов в виде CIDR или в виде диапазона IP-адресов:
 <code bash> <code bash>
Строка 67: Строка 67:
 ''params'' - какие параметры устанавливаются: ''params'' - какие параметры устанавливаются:
   * ''state=unk|auth|noauth'' - статус авторизации: неизвестен (''unk''), авторизован (''auth''), неавторизован (''noauth''). Статус "неизвестен" аналогичен команде ''subs auth clear'', статус авторизации "неавторизован" - это аналог получения ''Access-Reject'' от Радиуса, "авторизован" - аналог ''Access-Accept''   * ''state=unk|auth|noauth'' - статус авторизации: неизвестен (''unk''), авторизован (''auth''), неавторизован (''noauth''). Статус "неизвестен" аналогичен команде ''subs auth clear'', статус авторизации "неавторизован" - это аналог получения ''Access-Reject'' от Радиуса, "авторизован" - аналог ''Access-Accept''
-  * ''expired=<time>'' - время действия авторизации. ''<time>'' может быть указано относительно текущего времени (число секунд) или как абсолютное время в будущем в формате ''YYYY-MM-DDTHH:MM:DD''. Указкние ''expired=0'' равносильно очистке времени действия, что приведет к отпраке запроса L3-авторизации по приходе пакета от абонента.+  * ''expired=<time>'' - время действия авторизации. ''<time>'' может быть указано относительно текущего времени (число секунд) или как абсолютное время в будущем в формате ''YYYY-MM-DDTHH:MM:DD''. Указание ''expired=0'' равносильно очистке времени действия, что приведет к отправке запроса L3-авторизации по приходе пакета от абонента.
  
 Примеры: Примеры:
Строка 143: Строка 143:
  
 Существующие ограничения: команда может не работать в режиме мультикластера без агрегации. Существующие ограничения: команда может не работать в режиме мультикластера без агрегации.
 +
 +==== subs ping inet ====
 +Проверка доступности интернета.\\
 +Пакет проходит через весь стек функций и услуг, полисинг и тд, только после этого уходит в интернет. Таким образом можно определить, на чьей стороне проблема: на аплинке в интернете, между абонентами BRAS, либо на BRAS.
 +
 +Подсказка: ''fdpi_cli ping inet ?''
  
 ===== subs prop ===== ===== subs prop =====
Строка 148: Строка 154:
  
 ==== subs prop show ==== ==== subs prop show ====
-Просмотр L2-свойств абонента для заданного IPv4 или IPv6-адреса+Просмотр L2-свойств абонента для заданного IPv4 или IPv6-адреса, MAC или subs_id
 <code> <code>
-subs prop show IP+subs prop show <IP>
  
 Примеры: Примеры:
Строка 157: Строка 163:
 </code> </code>
  
 +<code>
 +subs prop show mac=<MAC>
 +
 +Пример:
 +subs prop show mac=02:42:89:33:7b:3e
 +</code>
 +
 +<code>
 +subs prop show subs_id=<MAC>
 +
 +Пример: 
 +subs prop show subs_id=00:1b:21:bc:a3:0c
 +</code>
 +
 +Подсказка:
 +<code>
 +fdpi_cli help subs prop show 
 +</code>
 ==== subs prop set ==== ==== subs prop set ====
-Модификация L2-свойств абонента, добавление нового абонента с указанными L2-свойствами, удаление некоторых L2-свойств.+Модификация L2-свойств абонента, добавление нового абонента с указанными L2-свойствами, удаление некоторых L2-свойств.\\ 
 + 
 +В команде доступен флаг запрета L3-авторизации для конкретного абонента ''[[dpi:bras_bng:bras_l2_vlan:bras_l2_vlan_dhcp:bras_l2_vlan_dhcp_proxy:bras_l2_vlan_dhcp_proxy_l3auth#запрет_l3-авторизации_для_абонента|disable_l3_auth]]''. Управление выполняется через CLI с использованием параметра: 
 +  * ''disable_l3_auth=1'' — запретить L3-авторизацию; 
 +  * ''disable_l3_auth=0'' — разрешить L3-авторизацию (значение по умолчанию). 
 Полный синтаксис см. Полный синтаксис см.
 <code> <code>
Строка 165: Строка 194:
  
 ==== subs prop del ==== ==== subs prop del ====
-Удаление всех L2-свойств указанного абонента.+Удаление всех L2-свойств указанного абонента.\\
 Примеры: Примеры:
 <code> <code>
Строка 171: Строка 200:
 subs prop del 2001:67:abcd::67/64 subs prop del 2001:67:abcd::67/64
 </code> </code>
-Эта команда фактичяески удаляет IP-адрес из внутренней БД. Для удаления конкретного свойства абонента используйте ''subs prop set''.+Эта команда фактически удаляет IP-адрес из внутренней БД. Для удаления конкретного свойства абонента используйте ''subs prop set''. 
 + 
 +=====subs traffic stat===== 
 +Вывод биллинговой статистики и статистики по rating group для указанного абонента, если они подключены 
 + 
 +=====subs bind show===== 
 +Просмотр списка IP-адресов, привязанных к логину.\\ 
 +Режимы работы: 
 +  * ''memory'' (по умолчанию) — выводит привязку IP к логину так, как в данный момент задано в fastDPI. 
 +  * ''udr'' — выводит привязку IP к логину из UDR. 
 +Вывод этих двух режимов может отличаться: не все связки IP←→логин сохраняются в UDR; например, для Framed-Route подсетей привязка к логину создается только в памяти, сами framed-route подсети хранятся в UDR в отдельной таблице, см. группу CLI-команд ''[[dpi:bras_bng:cli:framed_route|cli framed route ?]]'' 
 + 
 +Пример: 
 +<code>subs bind show <login> [memory|udr]</code> 
 + 
 +=====subs db stat===== 
 +Вывод статистики по БД L2 BRAS.\\ 
 + 
 +=====dev info===== 
 +Отображает информацию по девайсам. 
 +<code bash> fdpi_cli dev info</code> 
 +Основные характеристики: 
 +  - Идентификатор и описание устройства 
 +  - MAC-адрес и LAG 
 +  - PCI-шина 
 +  - Драйвер и firmware 
 +  - Текущий MTU 
 +Возможности устройства: 
 +  - Количество очередей (прием/передача) 
 +  - Лимиты MTU 
 +  - Размеры буферов 
 +  - Максимальное количество очередей 
 +  - Лимиты дескрипторов 
 +  - Поддерживаемые скорости 
 +Флаги и возможности оффлоада: 
 +  - Флаги устройства 
 +  - Возможности RX оффлоада (чексуммы, VLAN, RSS и др.) 
 +  - Возможности TX оффлоада (чексуммы, TSO, VLAN и др.) 
 +  - Возможности оффлоада для очередей 
 +  - Поддержка RSS для разных типов трафика 
 +Конфигурации по умолчанию: 
 +  - Настройки RX/TX конфигураций 
 +  - Лимиты дескрипторов 
 +  - Настройки портов 
 +Дополнительно: 
 +  - Количество xstat счетчиков