| |
| en:dpi:dpi_components:platform:subscriber_management:policing_mng:start [2024/09/17 07:44] – created elena.krasnobryzh | en:dpi:dpi_components:platform:subscriber_management:policing_mng:start [Unknown date] (current) – removed - external edit (Unknown date) 127.0.0.1 |
|---|
| ====== Policing Management ====== | |
| {{indexmenu_n>3}} | |
| Subscriber management is performed using the utility ''fdpi_ctrl''. | |
| <note important>We recommend using [[en:dpi:dpi_components:platform:subscriber_management:subsman_profiles:start]], which simplifies policing management.</note> | |
| |
| ===== Command Syntax ===== | |
| The general format of commands: | |
| <code bash>fdpi_ctrl command --policing policing_description_file [IP_list] [LOGIN_list]</code> | |
| |
| Explanation of command parameters: | |
| ^ Parameter ^ Description, possible values, and format ^ Note ^ | |
| | ''command'' | Values:\\ 1. ''load'' — load data\\ 2. ''del'' — delete. For ''--service'', you need to specify the ''service_identifier''\\ 3. ''list'' — display information for the specified ''IP_list'' or all information if the ''all'' argument is provided. | In ''list'' and ''del'' commands, instead of an IP/LOGIN list, you can specify ''all'', meaning the command will apply to all. | | |
| | ''policing_description_file''| A file in ''cfg'' format, e.g., ''tbf.cfg'' | | | |
| | ''IP_list'' | Values:\\ 1. ''--file'' — file with a list of IPs\\ 2. ''--ip'' — single IP, format: ''192.168.0.1''\\ 3. ''--ip_range'' — IP range (inclusive), format: ''192.168.0.1-192.168.0.5''\\ 4. ''--cidr'' — IP with port, format: ''192.168.0.0/30, 5.200.43.0/24~'' (CIDR format with excluded boundary addresses) | Boundary addresses can be excluded from a CIDR range (following the classless addressing agreement — gateway and broadcast addresses) by adding the ''~'' symbol at the end of the CIDR definition, e.g., ''--cidr 5.200.43.0/24~''. | | |
| | ''LOGIN_list'' | Values:\\ 1. ''--file'' — file with a list of logins\\ 2. ''--login'' — single login, format: USER1, "FIRST_NAME LAST_NAME" (alternative for specifying a login with escaped special characters) | "USER1" — option for specifying login in double quotes\\ 'USER2' — option for specifying login in single quotes | | |
| <note>A line starting with ''#'' is a comment.</note> | |
| |
| ===== Examples ===== | |
| - Enable policing policy using a policing description file: <code bash>fdpi_ctrl load --policing tbf.cfg --ip 192.168.0.1</code> | |
| - Get a list of applied policing: <code bash>fdpi_ctrl list all --policing</code> | |
| - Get information for a specific IP: <code bash>fdpi_ctrl list --policing --ip 192.168.0.1</code> | |
| - Enable policing policy using a named profile: <code bash>fdpi_ctrl load --policing --profile.name tariff_10 --login kv_111</code> | |
