====== Управление полисингом (тарифным планом). Именованные профили полисинга ======
{{indexmenu_n>3}}
Создание, изменение и удаление профилей полисинга осуществляется с помощью утилиты ''fdpi_ctrl''. 

Профили полисинга делятся на два типа:
  * **Анонимные (без имени) профили** — полисинг не создается заранее, параметры услуги задаются в момент подключения услуги абоненту в json-формате или файлом с разметкой полисинга
  * **Именованные профили** — полисинг создается до подключения абоненту, хранится во внутренней базе DPI — [[dpi:dpi_components:platform:dpi_admin:admin_db|]]

**Именованные профили** по сравнению с анонимными профилями имеют следующие преимущества:
  - Упрощает администрирование абонентов
  - Позволяет находить абонентов с требуемым профилем по имени профиля
  - Позволяет изменить профиль всем абонентам с заданным профилем просто изменив параметры профиля
  - Позволяет контролировать ограничение на количество уникальных профилей (максимум 65535)

**Анонимные (без имени) профили** в свою очередь имеют следующие преимущества:
  - Не нужно заниматься менеджментом профиля (создавать его и удалять), профиль освобождается вместе с удалением абонента или профиля у абонента
  - Не нужно придумывать имя профиля

===== Синтаксис команд =====
Общий формат команд:
<code bash>fdpi_ctrl команда --policing файл_описания_полисинга [список_IP] [список_LOGIN]</code>

Расшифровка параметров команды:
^ Параметр                     ^ Описание, возможные значения и формат                                                                                                                                                                                                                                                                                              ^ Примечание                                                                                                                                                                                                                                   ^
| ''команда''                  | Значения:\\ 1. ''load'' — загрузить данные\\ 2. ''del'' — удалить. Для ''--service'' нужно задать ''идентификатор_услуги''\\ 3. ''list'' — показать информацию по заданному списку ''список_IP'' или всю информацию, если задан аргумент ''all''.                                                                                  | В командах ''list'', ''del'' вместо списка IP/LOGIN можно задавать ''all'', что значит применить команду для всех.                                                                                                                           |
| ''файл_описания_полисинга''  | Файл в формате ''cfg'', формат: ''tbf.cfg''                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                              |
| ''список_IP''                | Значения:\\ 1. ''--file'' — файл со списком IP\\ 2. ''--ip'' — одиночный IP, формат: ''192.168.0.1''\\ 3. ''--ip_range'' — интервал IP (включает границы), формат: ''192.168.0.1-192.168.0.5''\\ 4. ''--cidr'' — IP с портом, формат: ''192.168.0.0/30, 5.200.43.0/24~'' (вариант указания CIDR с исключенными крайними адресами)  | Из диапазона CIDR можно исключить крайние адреса (по соглашению о бесклассовой адресации — это адреса шлюза и широковещательный), добавив в определение диапазона символ ''~'' в конце определения CIDR, например ''--cidr 5.200.43.0/24~''  |
| ''список_LOGIN''             | Значения:\\ 1. ''--file'' — файл со списком логинов\\ 2. ''--login'' — одиночный логин, формат: USER1, "FIRST_NAME LAST_NAME" (вариант указания логина с экранированием спецсимволов)                                                                                                                                              | "USER1" — вариант задания login в двойных кавычках\\ 'USER2' — вариант задания login в одинарных кавычках                                                                                                                                    |
<note>Строка, начинающаяся с символа ''#'' — это комментарий.</note>

====== Создание, подключение и отключение полисинга ======
Создание именованного профиля полисинга и подключение его на абонента:
<code bash>
fdpi_ctrl load profile --policing ./rate_10Mbps.cfg --profile.name rate_10Mbps
fdpi_ctrl load --policing --profile.name rate_10Mbps --ip 192.168.0.1
fdpi_ctrl load --policing --profile.name rate_10Mbps --login test
</code>

<note important>[[dpi:dpi_components:platform:subscriber_management:subsman_res|]]</note>

Подключение анонимного профиля полисинга через файл с разметкой полисинга:
<code bash>fdpi_ctrl load --policing rate_10Mbps.cfg --ip 192.168.0.1 
fdpi_ctrl load --policing rate_10Mbps.cfg --login test</code>

Отключение полисинга для конкретного абонента:
<code bash>fdpi_ctrl del --policing --ip 192.168.0.1
fdpi_ctrl del --policing --login test
</code>

====== Команды управления полисингом ======
Получить список всех созданных и примененных полисингов: 
<code bash>fdpi_ctrl list all --policing</code>

Получить список всех абонентов по имени полисинга:
<code bash>
fdpi_ctrl list all --policing --profile.name rate_10Mbps
</code>

Получить информацию по конкретному абоненту: 
<code bash>fdpi_ctrl list --policing  --ip 192.168.0.1
fdpi_ctrl list --policing  --login test
</code>

Удаление именованного профиля (при удалении профиля в нем не должно содержаться абонентов)
<code bash>
fdpi_ctrl del profile --policing --profile.name rate_10Mbps
</code>

Просмотр настроек полисинга (тарифного плана) по имени:
<code bash>
fdpi_ctrl list profile --policing --profile.name rate_10Mbps
</code>

Изменение настроек полисинга с дневного (10Mbps) на ночной режим (20Mbps). Новые настройки сразу применятся ко всем абонентам с заданным полисингом:
<code bash>
fdpi_ctrl load profile --policing ./rate_20Mbps_night.cfg --profile.name rate_10Mbps
</code>