====== Администрирование BRAS ======
{{indexmenu_n>10}}


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

Вызов утилиты:
<code bash>
   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 <команда>
</code>
Уровень детализации предназначен для отладочных целей fdpi_cli и не влияет на вывод результата самой команды.

Особенности формата вывода в JSON описаны [[dpi:bras_bng:cli:json|здесь]].

<note tip>По умолчанию 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"''</note>

<note warning>Security: СКАТ принимает CLI-команды от любого источника. В целях безопасности советуем ограничить доступ к управляющим TCP-портам 29000 (fastDPI) и 29002 (fastPCRF) только доверенным клиентам средствами linux firewall (iptables)</note>

<note tip>Начиная со СКАТ 10, справку по CLI-команде можно вывести так:
<code bash>
    # справка по конкретной команде
fdpi_cli pppoe show session ??
    # список команд с заданным префиксом
fdpi_cli pppoe show ??
</code>
</note>


Группы команд fdpi_cli:
  - [[dpi:bras_bng:cli:dhcp|DHCP]] - команды просмотра и управления внутренней БД DHCP fastDPI BRAS
  - [[dpi:bras_bng:cli:dhcpv6|DHCPv6]] - команды просмотра и управления внутренней БД DHCPv6 fastDPI BRAS
  - [[dpi:bras_bng:cli:pppoe|PPPoE]] - команды просмотра и управления внутренней БД PPPoE-сессий fastDPI BRAS
  - [[dpi:bras_bng:cli:gtp|GTP]] - команды просмотра и управления внутренней БД [[dpi:dpi_components:platform:dpi_mobile_spec|GTP-сессий]]
  - [[dpi:bras_bng:cli:subs|абоненты]] - команды управления абонентами
  - [[dpi:bras_bng:cli:acct|accounting]] - команды просмотра и управления внутренней БД аккаунтинга fastPCRF
  - [[dpi:bras_bng:cli:pcrfctl|PCRF]] - команды управления fastPCRF
  - [[dpi:dpi_components:platform:dpi_vlan_recode#cli-команды|vlan translation]] - команды управления [[dpi:dpi_components:platform:dpi_vlan_recode|трансляцией VLAN]]