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