EcoNAT Documentation

Команды CLI для мониторинга и управления BRAS EcoNAT Documentation / Команды CLI для мониторинга и управления BRAS

Для подсистемы EcoSGE BRAS предусмотрен ряд команд, которые позволяют выводить краткую и подробную информацию об обслуживаемых IP-адресах и контрактах, применяемых политиках и сервисах, а также производить сброс абонентских сессий и очистку веток конфигурации BRAS. В таблице ниже дано краткое описание всех предусмотренных команд. Подробное описание команд следует после таблицы.

Команда	Действие
clear brascontract <id>	Закрытие сессии абонента с указанным номером персонального контракта или всех сессий абонентов с указанным номером общего контракта.
clear brasinfo { <IP-адрес> \| all }	Удаление информации об абонентских сессиях из таблицы BRAS. Аргументами команды могут быть IP-адрес или ключевое слово all. При указании IP-адреса соответствующая абонентская сессия будет закрыта.
droppolicies	Очистка ветки конфигурации system.bras.policies
dropradius	Очистка ветки конфигурации system.bras.radius
dropservices	Очистка ветки конфигурации system.bras.services
show brascontract <id>	Вывод информации о контракте и связанных с ним абонентах
show brascontracts	Вывод списка активных контрактов, т. е. тех, в которых есть хотя бы одна открытая абонентская сессия
show brasinfo { <IP-адрес_1>[-<IP-адрес_2>] \| <имя_политики> \| all }	Вывод подробной или краткой информации об абонентских сессиях. Аргументами команды могут быть IP-адрес, диапазон IP-адресов, имя политики или ключевое слово all.
show brasinfo summary	Вывод информации о созданных политиках и состоянии базы данных BRAS
show brasstate	Вывод информации о состоянии BRAS

Команды просмотра

show brascontract <id>

Данная команда выводит информацию о контракте и связанных с ним абонентах: тип контракта (Shared/Not Shared, т. е. общий или персональный), IP-адрес абонента, статус авторизации, продолжительность сессии и статистика принятых и отправленных байтов и пакетов. Если в контракте есть абоненты IPv6, использующие делегированные префиксы, то эти префиксы будут включены в вывод команды, если соответствующие атрибуты Delegated-IPv6-Prefix были получены от RADIUS-сервера. Для общего контракта также выводится сводная статистика байтов и пакетов по всем абонентам данного контракта. Ниже дан пример выводимой информации для общего контракта.

EcoSGE:# show brascontract shared1
Shared       192.168.55.6    Authorized   2m30s    Bytes rx/tx: 7832582/115571751; Packets rx/tx: 45613/119596
Shared       192.168.55.7    Authorized   1m45s    Bytes rx/tx: 7951843/99673922; Packets rx/tx: 47917/199925
Shared       192.168.55.5    Authorized   3m20s    Bytes rx/tx: 7595493/95415626; Packets rx/tx: 49795/92433
Shared       3001::2         Authorized   1m15s    Bytes rx/tx: 0/0; Packets rx/tx: 0/0
Shared       3001::1         Authorized   1m50s    Bytes rx/tx: 0/0; Packets rx/tx: 0/0

Delegated IPv6 Prefixes:
3001:db8:1101::/48
3400:ca00:3000:240::/60

============================ Shared Configuration ============================
Current service: "servicesh2" (Enabled)
Configured data rate upstream                                        1022 Kb/s
Configured data rate downstream                                      1022 Kb/s
Policer byte drop upstream/downstream                           0/6083734
Policer packet drop upstream/downstream                            0/4019
Bytes downstream                                                 23379918
Bytes upstream                                                  328286141
Packets downstream                                                 133335
Packets upstream                                                   315275

show brascontracts

Данная команда выводит список активных контрактов (персональных и общих), то есть тех контрактов, в которых имеется хотя бы одна открытая абонентская сессия.

EcoSGE:# show brascontracts
sh1
sh2
pers1
pers2

show brasinfo { <IP-адрес_1>[-<IP-адрес_2>] | <имя_политики> | all }

Данная команда, в зависимости от аргумента, выводит подробную или краткую информацию об абонентских сессиях. Аргументами команды могут быть IP-адрес, диапазон IP-адресов, имя политики или ключевое слово all.

При отправке команды с ключевым словом all выводится краткая информация обо всех абонентских сессиях. Пример вывода:

EcoSGE:# show brasinfo all
Bras info for addresses 0.0.0.0-255.255.255.255:
10.210.1.0      Authorized   1m30s  Bytes rx/tx: 0/60; Packets rx/tx: 0/1
10.210.1.234    Authorized   3m20s  Bytes rx/tx: 0/60; Packets rx/tx: 0/1
10.210.1.89     Authorized   4m15s  Bytes rx/tx: 17464/0; Packets rx/tx: 118/0
…

При указании IP-адреса выводится подробная информация о сессии и применённых сервисах для данного абонента. Пример вывода:

EcoSGE:# show brasinfo 1.2.3.4
Bras info for address 1.2.3.4:
================================================================================
Subscriber 1.2.3.4
Contract qq0
Origin RADIUS
Mac 11:11:11:11:11:11
Main TTL 12
Policy policyd
================================================================================
Status                                                              Authorized
Accounting status                                                   Start
Configured data rate upstream total                                 unlim Kb/s
Configured data rate downstream total                               unlim Kb/s
Policer byte drop upstream/downstream total                     0/3185938
Policer packet drop upstream/downstream total                      0/2105
Bytes upstream total                                               471087
Bytes downstream total                                           17246003
Packets upstream total                                               6605
Packets downstream total                                            11436
Session uptime                                                        158 s
Session timeout expires in                                          10961 s
Idle timeout expires in                                             28728 s
Interim interval expires in                                             0 s
--------------------------------------------------------------------------------
Shared service: "servicesh2" (Enabled)
Configured data rate upstream                                        4999 Kb/s
Configured data rate downstream                                      4999 Kb/s
Policer byte drop upstream/downstream                           0/6083734
Policer packet drop upstream/downstream                            0/4019
Bytes upstream                                                     839948
Bytes downstream                                                 25460597
Packets upstream                                                    11657
Packets downstream                                                  16880
--------------------------------------------------------------------------------
1. "servicea" (Enabled)
Configured data rate upstream                                       unlim Kb/s
Configured data rate downstream                                     unlim Kb/s
Policer byte drop upstream/downstream                                 0/0
Policer packet drop upstream/downstream                               0/0
Bytes upstream                                                     471087
Bytes downstream                                                 14060065
Packets upstream                                                     6605
Packets downstream                                                   9331

Если для указанного IP-адреса нет сессий, то будет выведено следующее сообщение:

EcoSGE:# show brasinfo 10.210.0.212
Bras info for address 10.210.0.212: not found

При указании диапазона, включающего в себя не более миллиона IP-адресов, выводится подробная информация об абонентских сессиях для указанных адресов (как для команды show brasinfo <IP-адрес>). Если указанный диапазон содержит более миллиона адресов IP-адресов, то выводится краткая информация об абонентских сессиях (как для команды show brasinfo all).

Вывод информации для большого количества IP-адресов может занять некоторое время. Выполнение команды можно прервать нажатием [Backspace] или [Ctrl+C].

В таблице ниже приведено описание данных, выводимых командой show brasinfo <IP-адрес>.

Поле	Описание
Status	Статус абонента
Accounting status
Configured data rate upstream total	Установленные для абонента ограничения пропускной способности исходящего канала (кбит/с)
Configured data rate downstream total	Установленные для абонента ограничения пропускной способности входящего канала (кбит/с)
Policer byte drop upstream/downstream total	Количество отброшенных исходящих/входящих байтов, которые не удалось обработать при установленных ограничениях скорости передачи
Policer packet drop upstream/downstream total	Количество отброшенных исходящих/входящих пакетов, которые не удалось обработать при установленных ограничениях скорости передачи
Bytes downstream total	Общее количество принятых байтов
Bytes upstream total	Общее количество отправленных байтов
Packets downstream total	Общее количество принятых пакетов
Packets upstream total	Общее количество отправленных пакетов
Session uptime	Продолжительность сессии в секундах
Session timeout expires in	Время (в секундах), оставшееся до автоматического завершения сессии. По истечении данного времени сессия удаляется и создаётся новая
Idle timeout expires in	Время (в секундах), оставшееся до автоматического завершения сессии по причине неактивности
Interim interval expires in	Время (в секундах), оставшееся до завершения интервала аккаунтинга
Информация о сервисах
Enabled/Disabled	Состояние сервиса: включен/выключен
Configured data rate upstream	Установленные сервисом ограничения ограничения пропускной способности исходящего канала (кбит/с)
Configured data rate downstream	Установленные сервисом ограничения ограничения пропускной способности входящего канала (кбит/с)
Policer byte drop upstream/downstream	Количество отброшенных исходящих/входящих байтов, которые не удалось обработать в данном сервисе при установленных ограничениях скорости передачи
Policer packet drop upstream/downstream	Количество отброшенных исходящих/входящих пакетов, которые не удалось обработать в данном сервисе при установленных ограничениях скорости передачи
Bytes downstream	Количество байтов, полученных абонентом
Bytes upstream	Количество байтов, отправленных абонентом
Packets downstream	Количество пакетов, полученных абонентом
Packets upstream	Количество пакетов, отправленных абонентом

Пример вывода show brasinfo для групповой статической политики (static_shared):

EcoSGE:# show brasinfo policy1
Bras info for policy policy1:
================================================================================
Subscriber policy1
Contract Undefined
Mac 00:00:00:00:00:00
Policy policy1
================================================================================
Status                                                              Authorized
Accounting status                                                   Alive
Configured data rate upstream total                                 unlim Kb/s
Configured data rate downstream total                               unlim Kb/s
Policer byte drop upstream/downstream total                      0/102952
Policer packet drop upstream/downstream total                        0/68
Bytes upstream total                                                26508
Bytes downstream total                                             699468
Packets upstream total                                                394
Packets downstream total                                              462
Session timeout expires in                                          86393 s
Idle timeout expires in                                             28800 s
Interim interval expires in                                            53 s
--------------------------------------------------------------------------------
Common service: "serviceTotal" (Enabled)
Configured data rate upstream                                        4999 Kb/s
Configured data rate downstream                                      4999 Kb/s
Policer byte drop upstream/downstream                                 0/0
Policer packet drop upstream/downstream                               0/0
Bytes upstream                                                      26508
Bytes downstream                                                   699468
Packets upstream                                                      394
Packets downstream                                                    462
--------------------------------------------------------------------------------
1. "service1" (Enabled)
Configured data rate upstream                                         999 Kb/s
Configured data rate downstream                                       999 Kb/s
Policer byte drop upstream/downstream                            0/102952
Policer packet drop upstream/downstream                              0/68
Bytes upstream                                                      26508
Bytes downstream                                                   596516
Packets upstream                                                      394
Packets downstream                                                    394
--------------------------------------------------------------------------------
2. "service2" (Enabled)
Configured data rate upstream                                        1999 Kb/s
Configured data rate downstream                                      1999 Kb/s
Policer byte drop upstream/downstream                                 0/0
Policer packet drop upstream/downstream                               0/0
Bytes upstream                                                          0
Bytes downstream                                                        0
Packets upstream                                                        0
Packets downstream                                                      0

show brasinfo summary

Данная команда выводит информацию о созданных политиках BRAS, количестве абонентов, к которым применены эти политики, статусе авторизации абонентов, а также информацию о состоянии базы данных BRAS. Пример вывода:

EcoSGE:system# show brasinfo summary
=======================================================
 brasinfo summary
=======================================================
 Policy                                    Subscribers
-------------------------------------------------------
 policya                                             3
 policyb                                             3

-------------------------------------------------------
 Status sum for policies
-------------------------------------------------------
 Authorization                                       0
 Authorized                                          4
 Rejected                                            0
 Error                                               2
 Deleting                                            0

-------------------------------------------------------
 Total                                               6
=======================================================

Shared contract stats:

Database queue                 used/total: 0 / 524288 (0.0%)
Database strings               used/total: 0 / 1572864 (0.0%)
Database contract data         used/total: 0 / 524288 (0.0%)
Database ip entries            used/fair/total: 0 / 104857 / 2621440 (0.0%)
Database used contract: 0 / used connection: 0 / total: 1048576 (0.0%)

show brasstate

Данная команда предназначена для просмотра состояния BRAS. Пример вывода:

EcoSGE:# show brasstate
Default access: BLOCK
State         : ENABLED

Вывод команды содержит два поля:

Default access – действие по умолчанию (BLOCK или PASS),

State – состояние BRAS (включен/выключен).

Сразу после загрузки BRAS работает в режиме пропускания всего трафика, чтобы выполнялось обслуживание абонентов в то время, пока ещё не загружена информация из системы биллинга (default access – pass). После загрузки базы BRAS переключается в основной режим работы, когда запрещён трафик от тех абонентов, которые в биллинге не разрешены явно (default access – block).

Команды закрытия сессий

clear brascontract <id>

Данная команда закрывает сессию абонента с указанным номером персонального контракта или все сессии абонентов с указанным номером общего контракта. При выполнении команды выводятся IP-адреса абонентов, чьи сессии были закрыты. Этим абонентам потребуется повторная авторизация через RADIUS-сервер. Пример вывода:

EcoSGE:# clear brascontract sh1
Process...
66.77.88.99
1.2.3.4
5.6.7.8
Done

clear brasinfo { <IP-адрес> | all }

Данная команда предназначена для удаления информации об абонентских сессиях из таблицы BRAS. Аргументами команды могут быть IP-адрес или ключевое слово all. При указании IP-адреса соответствующая абонентская сессия будет закрыта. Примеры выполнения команды:

EcoSGE:# clear brasinfo 10.210.30.4
Success
EcoSGE:# clear brasinfo all
Bras table purged

Если настроен аккаунтинг, то при выполнении команды clear brasinfo <IP-адрес> сначала на RADIUS-сервер отправляется запрос Accounting Stop, чтобы закрыть сессию, и только потом сессия удаляется из таблицы BRAS. При выполнении clear brasinfo all происходит только удаление записей о сессиях из таблицы BRAS.

Команды очистки веток конфигурации BRAS

Для очистки веток конфигурации BRAS предусмотрены следующие команды:

droppolicies – очистка ветки конфигурации system.bras.policies
dropradius – очистка ветки конфигурации system.bras.radius
dropservices – очистка ветки конфигурации system.bras.services

После выполнения любой из трёх вышеуказанных команд необходимо отправить команду apply, чтобы изменения конфигурации вступили в силу.