28.1. IPSH overview

28.1. IPSH overview
	Chapter 28. IPSH - IP Shaping

The IPSH (IP Shaping) resource is used within the Abilis CPX to reduce the priority of traffic recognised as existing between two 'machines', in order to give higher priority to the work of humans.

IPSH analyzes all IPs in the local network (up to maxip). It extracts the TOPIPs that send and receive the most data. For each IP in the TOPIP it first checks that the throughput is higher than the configured threshold value, otherwise it ignores it. For these IPs considered valid for IPSH the variance is calculated.

Hosts with traffic above the TRAFFIC-IN/OUT threshold and at the same time variance below the threshold are considered as performing M2M traffic.

For these hosts IPSH will add shift jumps (up to MAX-SHIFT-JUMPS) for packets in the output queue, in order to give higher priority for interactive traffic. The algorithm acts on the ‘output queues’, specifically for packets going to the Internet on an SDWAN/WAN port of the Abilis, and for packets coming from the Internet on the LAN resource where the managed hosts are located. If the output queue is free, no other interactive traffic, then shift jumps will have no effect, so even M2M traffic will be transmitted without any delay.

IPs that are objects of IPSH are displayed in the new gui interface.

28.1.1. IPSH resource parameters

Use the following command to display the parameters of the resource. By typing d p ipsh ? command it's possible to display the meaning of all the parameters.

[17:50:56] ABILIS_CPX:d p ipsh

RES:IpSh ----------------------------------------------------------------------
Run    DESCR:IP_Shaping_service
       LOG:NO        ALERT:NO    ACT:YES
       maxip:200                 PERIOD:60                  TOPIP:5
       WHITE-LIST:IPshWhiteList
       MAX-SHIFT-JUMPS:5         SHIFT-STEP:15
       TRAFFIC-IN-THR:0          TRAFFIC-OUT-THR:0          VARIANCE-THR:50

The meaning:

DESCR

Resource description. Max 79 chars. Spaces require double quotes (E.g. "str1 str2").

LOG

State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes, see ref. manual).

ALERT

Send an alert on state changes [NO, 1..255].

ACT

Operation activation [NO, YES].

maxip

Maximum number of IP addresses analyzed per each IP resource [100..1000].

PERIOD

Period of time window for TOP IP analysis. Values are averaged over this sliding window [5..120 sec].

TOPIP

Highest number of TOP-IP host subject to traffic shaping [5..20].

WHITE-LIST

IP hosts of the LAN which bypass the IP shaping control.

	Note
	Read Only.

MAX-SHIFT-JUMPS

Max amount of jumps over the regular service-pace [5..20].

SHIFT-STEP

Amount of seconds with variance below (or above) the threshold required to step the SHIFT-JUMP up (or down) of one unit [1...30].

TRAFFIC-IN-THR

Level of incoming throughput from LAN under which TOP-IPs are not managed, because they produce negligible traffic [0..1000000 KBit/sec].

TRAFFIC-OUT-THR

Level of outgoing throughput to LAN under which TOP-IPs are not managed, because they produce negligible traffic [0..1000000 KBit/sec].

VARIANCE-THR

Variance threshold: above or equal threshold the traffic is interactive, below it is stream [0..100].

The following command allows the administrator to change the configuration of the resource:

s p ipsh parameter:value...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init ipsh; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. with warm start command).


Chapter 28. IPSH - IP Shaping		28.2. IPSH diagnostics and statistics