Service Management [Документация VAS Experts]

This is an old revision of the document!


3 Management of policing and services

Subscribers' management is handled by fdpi_ctrl utility.

We recommend using Named profiles which simplify the services and policies management.

Command syntax

General command format:

fdpi_ctrl command { --service service_identifier | --policing policing_description_file} [IP_list] [LOGIN_list]

Here 'command' is:

load : load data
del  : remove. You have to specify 'program_identifier' for '--service'. No need to specify for policing
list : show the information on the specified 'IP_list' or all the information if the argument is 'all'

service_identifier - is one of these values or their comma separated list:

1 - bonus program
2 - advertising
3 - block advertisements
4 - black list
5 - white list
6 - notifications
7 - caching
8 - DDos protection passed
9 - collect netflow statistics for billing
10 - DDOS protection service
11 - CGNAT
12 - subscriber traffic recording in PCAP
13 - mini-Firewall
14 - traffic diversion
50 - member of a marketing campaign

IP_list - is a sequence or one of the following options:

--file     - a file containing IP list
--ip       - a single IP
--ip_range - inclusive IP range
--cidr     - CIDR (inclusive) CIDR~ (exclusive)

You can exclude reserved addresses from the CIDR range (by classless convention, these are gateway and broadcast addresses) by adding the “~” symbol to the range definition at the end of the cidr definition, for example –cidr 5.200.43.0/24~

LOGIN_list - is a sequence or one subscriber's name value in format:

--login USER1
--login "FIRST_NAME LAST_NAME" is the option to indicate login with special symbols screening

IP list or LOGIN can be specified as:

192.168.0.1             a single IP
192.168.0.1-192.168.0.5 inclusive IP range
192.168.0.0/30          CIDR
"USER1"                 specify LOGIN in quotes
'USER2'                 specify LOGIN in single quotes

Lines starting from '#' is as a comment.

One can specify 'all' instead of IP/LOGIN list in commands list, del, clear. It means to apply the command to all subscribers.

Examples

To get the policing application list:

fdpi_ctrl list all --policing

To get the list of subscribers with active service 1:

fdpi_ctrl list all --service 1

To get the information for specified IP:

fdpi_ctrl list --policing  --ip 192.168.0.1
fdpi_ctrl list --service 1 --ip 192.168.0.1

To activate service 1:

fdpi_ctrl load --service 1 --ip 192.168.0.1
or
fdpi_ctrl load --service 1 --login USER1

To activate policing:

fdpi_ctrl load --policing tbf.cfg --ip 192.168.0.1

To disable service 1:

fdpi_ctrl del --service 1 --ip 192.168.0.1

One can specify several options '–file', '–ip', '–ip_range', '–cidr' when specifying IP list:

fdpi_ctrl list --service 1 --ip 192.168.0.1 --ip 192.168.0.2 --file fip_1.txt --ip_range 192.168.0.3-192.168.0.6 --login USER1

This action would be applied to all elements that do not cause any errors.

There is no undo for changes that were already implemented is made on errors.

Detailed description on policing and services' management one can find in chapters devoted to the respective options.