====== BRAS PPPoE CLI ======
{{indexmenu_n>3}}

Команды управления PPPoE-сессиями BRAS

Это команда к fastdpi, так что в аргументе -r утилиты следует задавать адрес fastdpi.

==== pppoe show all ====
Вывод всех PPPoE-сессий
<code>
fdpi_cli -r <address> pppoe show all
# Синоним команды:
fdpi_cli -r <address> pppoe show sessions
</code>

==== pppoe show session ====
Вывод конкретной PPPoE-сессии по указанному ключу
<code>
fdpi_cli -r <address> pppoe show session [ip=X | mac=X | login=X]
</code>
Ключ указывается одним из параметров:
  * ''ip'' - IPv4- или IPv6-адрес абонента
  * ''mac'' - MAC-адрес абонента
  * ''login'' - логин абонента
Примеры вызова:
<code>
fdpi_cli -r 192.168.0.1 pppoe show session ip=10.56.79.7
fdpi_cli -r 192.168.0.1 pppoe show session ip=2001:89:7896:5::
fdpi_cli -r 192.168.0.1 pppoe show session mac=00:1b:21:bc:a3:0c
fdpi_cli -r 192.168.0.1 pppoe show session login=piter_smith
</code>

==== pppoe show stat ====
Вывод внутренней статистики по PPPoE-сессиям
<code>
fdpi_cli -r <address> pppoe show stat
</code>

==== pppoe term ====
Завершение сессии. 
<code>
fdpi_cli -r <address> pppoe term [hard] [ip=X | mac=X | login=X]
</code>
Команда ''pppoe term'' - мягкий ресет: посылает LCP Termination Request абоненту и ждет ответа Term Ack. Если абонент не отвечает, посылается повторный Term Req. Если абонент не отвечает, после исчерпания всех попыток (задается fastdpi.conf-параметром ''bras_ppp_max_terminate'') сессия безусловно разрывается.

Команда ''pppoe term hard'' шлет PPPoE PADT пакет абоненту и разрывает сессию, не требуя подтверждения.

Абонент задается одним из параметров:
  * ''mac=XX:XX:XX:XX:XX:XX'' - MAC-адрес абонента;
  * ''ip=X.X.X.X'' - IP-адрес абонента (IPv4 или IPv6);
  * ''login=xxx'' - логин абонента;

Следует отметить, что первичным уникальным ключом PPP-сессии является MAC-адрес. Все остальные ключи вторичные и не уникальные, то есть в принципе при завершении сессии по IP или по логину возможно завершение нескольких сессий.

Примеры:
<code>
fdpi_cli -r 127.0.0.1 pppoe term mac=01:02:03:60:70:99
fdpi_cli -r 127.0.0.1 pppoe term hard ip=10.0.0.50
</code>

==== pppoe renew pool ====
{{anchor:renew_pool}}
Принудительная отправка DHCP Renew для адресов, распределенных через [[dpi:bras_bng:ip_pool|пул]]
<code bash>
  # Общий формат команды
fdpi_cli -r 127.0.0.1 pppoe renew pool [ip=X | mac=X | login=X]
</code>

Абонент задается одним из параметров:
  * ''mac=XX:XX:XX:XX:XX:XX'' - MAC-адрес абонента;
  * ''ip=X.X.X.X'' - IP-адрес абонента (IPv4 или IPv6);
  * ''login=xxx'' - логин абонента;
Примеры:
<code bash>  
fdpi_cli -r 127.0.0.1 pppoe renew pool ip=10.56.79.7
fdpi_cli -r 127.0.0.1 pppoe renew pool ip=2001:89:7896:5/64
fdpi_cli -r 127.0.0.1 pppoe renew pool mac=00:1b:21:bc:a3:0c
fdpi_cli -r 127.0.0.1 pppoe renew pool login=piter_smith
</code>