Администрирование 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