Администрирование BRAS

Утилита fdpi_cli позволяет просматривать содержимое внутренних структур fastDPI и fastPCRF и управлять ими.

Утилита находится в режиме бета. Некоторые команды выводят очень много данных, до десятков тысяч записей. Не рекомендуется вызывать такие команды в ЧНН

Вызов утилиты:

fdpi_cli [-r <адрес>] [<опции>] <команда> <адрес> - адрес fastDPI или fastPCRF сервера в формате ip%dev[:port] например, 10.20.30.40%eth1, 127.0.0.1%lo. Порты по умолчанию: fastdpi=29000, fastpcrf=29002 По умолчанию используется адрес 127.0.0.1 <опции>: -h, --help - выводится справка по утилите -t N - тайм-аут ожидания ответа от сервера, секунд; по умолчанию - 5 секунд -v - уровень детализации вывода (verbose output): -v, -vv, -vvv, -vvvv --json - вывод ответов в формате JSON --strict - использовать strict JSON (quoted field name). Актуально только для --json <команда> - команда fdpi_cli Вывод краткой справки по всем командам fdpi_cli: fdpi_cli help Вывод детальной справки по конкретной команде: fdpi_cli help <команда>

Уровень детализации предназначен для отладочных целей fdpi_cli и не влияет на вывод результата самой команды.

Особенности формата вывода в JSON описаны здесь.

По умолчанию CLI предполагает, что fastDPI и fastPCRF находятся на том же сервере, откуда производится вызов CLI, то есть если аргумент -r не задан, предполагается -r 127.0.0.1. Если fastDPI или fastPCRF находятся на удаленной машине, требуется обязательно указывать аргумент -r - адреса fastDPI или fastPCRF-сервера. Рекомендуем сделать алиасы (alias) для fdpi_cli для каждого из возможных адресов; например, алиас для CLI fastPCRF-сервера 10.20.30.40: alias fpcrf_cli="fdpi_cli -r 10.20.30.40"
Security: СКАТ принимает CLI-команды от любого источника. В целях безопасности советуем ограничить доступ к управляющим TCP-портам 29000 (fastDPI) и 29002 (fastPCRF) только доверенным клиентам средствами linux firewall (iptables)
Начиная со СКАТ 10, справку по CLI-команде можно вывести так: # справка по конкретной команде fdpi_cli pppoe show session ?? # список команд с заданным префиксом fdpi_cli pppoe show ??

Группы команд fdpi_cli:

DHCP - команды просмотра и управления внутренней БД DHCP fastDPI BRAS

DHCPv6 - команды просмотра и управления внутренней БД DHCPv6 fastDPI BRAS

PPPoE - команды просмотра и управления внутренней БД PPPoE-сессий fastDPI BRAS

GTP - команды просмотра и управления внутренней БД GTP-сессий

абоненты - команды управления абонентами

accounting - команды просмотра и управления внутренней БД аккаунтинга fastPCRF

PCRF - команды управления fastPCRF

vlan translation - команды управления трансляцией VLAN