SSG changelog and update
Update instructions
If you have version of CentOS 6.x or CentOS 8.x installed, switch the repository once with the command:
sed -i -e '/^mirrorlist=http:\/\//d' -e 's/^# *baseurl=http:\/\/mirror.centos.org/baseurl=http:\/\/vault.centos.org/' /etc/yum.repos.d/CentOS-*.repo
Then run updates as usual:
yum update fastdpi
Module yaml error
appears during the upgrade, you should upgrade the module dnf upgrade libmodulemd
.
After updating, restart the DPI:
service fastdpi restart
and other dependent procoesses (PCRF/Radius), but only if they are actually used and their configuration is valid:
service fastpcrf restart service fdpi_radius restart
You can update the operating system components Do not update the kernel version and its dependent utilities!
For CentOS 6.x:
yum --exclude=kernel*,util-linux-ng,libuuid,libblkid update
For CentOS 8.x:
yum update
Note for users running the DPI in a virtual environment, using old CPU (release of 2009) and AMD CPU:
Run the following command before the update:
touch /etc/dpi/noprioadj
and it causes the DPI process to be launched with normal priority (not the realtime), thus significantly reducing the consumption of CPU system (sys) resourses, but slightly increasing the latency on the platform.
Updating SSG to Version 14.0 Shooting Stars
14.0 Shooting Stars 1)
You can check the currently installed version with the command:
yum info fastdpi
Rollback to 13.3:
yum downgrade fastdpi-13.3-0 fastpcrf-13.3-0 dpiutils-13.3 fastradius-13.3
After updating or changing the version, a service restart is required:
service fastdpi restart
If PCRF and/or Radius are used, they must also be restarted. For PCRF restart, the following order is preferred:
service fastdpi stop service fastpcrf restart service fastdpi start
Do not perform Linux kernel updates. In new kernel versions, binary compatibility with Kernel ABI may be broken, and the network driver may not load after the update. If you have already performed the update, temporarily configure the GRUB bootloader to boot the previous kernel version: in the
/etc/grub.conf
file, set the parameter default=1
.
If during the update a message appears that the update was not found or there are dependency issues, before updating, execute the command:
yum clean all
Changes in version 14.0
- [BRAS] Support for L2TP termination
- [DPI] Migration to DPDK 24.11, support for new NICs (Intel E830 200G, Intel E610, Napatech SmartNIC). Description
- [CLI] Added support for
subs_id
in commands:dhcp show
,dhcp reauth
,dhcp6 show
,dhcp6 reauth
, anddhcp disconnect
. Description - [DPI] New protocols added: AGORA_STREAMS(49314), AZAR_CALL(49315), WECHAT_CALL(49316), TEAMS_CALL(49317). List of protocols
- [DPI] Improved support for LINE_CALL, VYKE_CALL protocols. List of protocols
- [DPI] Fixed smartdrop behavior
- [DPI] Added validation for complex protocols. List of protocols
- [DPDK] Increased the maximum number of dispatchers to 32. Description
- [IPFIX/Netflow] Added the ability to change IPFIX/Netflow parameters without restarting fastDPI. A new config parameter
ipfix_reserved
has been added to reserve memory for enabling/changing IPFIX/Netflow parameters. If IPFIX/Netflow parameters are set in the configuration file, memory reservation for IPFIX/Netflow is automatically enabled and parameters/new exporter types can be changed without restarting fastDPI. - [FastRadius] It is now possible to set both
bind_ipv6_address
andbind_ipv6_subnet
. If the Framed-IPv6-Prefix has a /128 mask, it is not checked against thebind_ipv6_subnet
restriction. Description - CLI command
dev info
now includes the name of the LAG that the port belongs to - [PCRF][PPP][Framed-pool] Added: DHCP option
Client-Id
now includestunnel-IP
as part of the subscriber ID. For more details, see sections IPv4 Pools Support and IPv6 pools support - [IPFIX] Message aggregation added for IPFIX streams: FullFlow/DNS/META/NAT
- [IPFIX] Added parameter
ipfix_mtu_limit
to restrict maximum message size for IPFIX UDP packets - [IPFIX DNS] New elements added to IPFIX DNS: 224 (ipTotalLength) and 43823:3206 (DNS transaction id)
- [VRRP] Fixed proper handling of the
vrrp_enable
option change - [BRAS][PPP] PPP session key is now compound:
l2subs_id
+tunnel-IP
. For PPPoE sessions, tunnel IP = 0. CLI commands that usesubs_id
as a key (subs prop show
,l2tp show session
,l2tp term
, etc.) may now return multiple entries with the samel2subs_id
. - [DPI] Added cloud protocols with identifiers 55296..58367
- [IPFIX] Fixed IPFIX exporter reinitialization bugs
- [BRAS][subs_grooming] Fixed potential crash due to race condition during fastDPI shutdown
- [CLI] Added commands to display mempool properties and statistics
hal mempool props hal mempool stat
DPDK must be built with statistics collection enabled to display mempool stats
- [BRAS][DHCP] Fixed crash when parsing Framed-Pool Renew response if it contains no DHCP options
- [PCRF][Acct] Fixed: Interim-Update sending is now disabled when
Acct-Interim-Interval = 0
is explicitly set in the RADIUS response. For more details, see sections Subscriber authorization attributes, Access-Accept format for the PPPoE networks, Access-Reject format for PPPoE networks - [VASE_CLI] Created a unified CLI for managing DPI, BRAS, DHCP (KEA), ROUTER (BIRD) with support for authorization and command logging via TACACS (VEOS 8.x required)
- [SNMP] Created a module for monitoring system components via SNMP
- [DPI] Added DOQ 49318 protocol (DNS-over-QUIC)
- [Router] Announcing subscriber white addresses for 1:1 NAT individually and after authentication. Description
- [PCRF] Added support for service 19 "DNS spoofing", profile required. Description
- [DPDK] Removed dedicated mempools. The fastdpi.conf option
dpdk_emit_mempool_size
is deprecated and no longer used. - [VLAN-Rule] Moved vlan group data from UDR to SDR. Global rules for vlan drop/pass/hide/permit set by the previous CLI command
vlan group
were converted and moved from UDR to SDR, with removal from UDR. Description - Up to version 14, only one built-in database UDR (User Data Repository) is used, intended for permanent storage of data about services, policings, and other FastDPI settings.
Starting from Version 14, UDR is split into UDR and SDR. The split occurs automatically during version update.
SDR (System Data Repository) is intended for storing FastDPI settings not related to subscribers. It can be considered that SDR is an extension of fastdpi.conf. No special activation of SDR is required — the necessary .mdb files are created automatically when the corresponding mode is enabled in fastdpi.conf. - [VLAN] VLAN rules — added CLI commands:
vlan rule add
- add new rule to SDRvlan rule modify
- modify existing rule in SDRvlan rule delete
- delete rule from SDRvlan rule show
- show all rules for the specified VLAN/QinQvlan rule dump
- dump all rules in SDRvlan rule purge vlan
/qinq
/all
- clear SDR for VLAN/QinQ or bothvlan rule apply
- apply rules; by default, rules are applied 5 minutes after the last SDR modification
- [IPv6] Added direction detection in combined traffic (IN+OUT on one port) based on the local flag for IP addresses. Enabled via
combined_io_direction_mode
option - [BRAS] Fixed compatibility with the old format of service 18, where there were fewer protocols and both fields in the profile needed to be filled
- [DPI] Lowered detection priority for
telegram_tls
- [DPI] Improved detection of
WECHAT
andWECHAT_CALL
- [BRAS][Framed-Route] Fixed: possible crash when freeing memory
- [BRAS] Refactored PCRF connectivity: in the new implementation, all connections are equal; an error on any triggers reconnection of all connections and a switch to another PCRF. Added CLI commands:
pcrf connect show
— show current status and accumulated statistics for PCRF connections.- Force connection to the specified PCRF
pcrf connect switch [<pcrf_index>]
, where<pcrf_indxed>
is the index of the connection line in theauth_server
parameter. If<pcrf_indxed>
is not specified — defaults to 0.
- [IPFIX DNS] Added the ability to send DNS MX responses via IPFIX. Enabled by setting bit 3 (4) of the
ajb_save_dns
parameter - [DPI] Added FakeTLS protocol (49319) with validation
- [BRAS][DHCP] Changed: sliding window algorithm for rate limit
- [BRAS] Fixed: time comparison error when loading ip_prop from UDR
- [VLAN-Rule] Added support for 'any' instead of '*' when describing VLAN range
'*.*' is interpreted in bash command line as a file search mask, so now instead of '*', you can specify 'any' ('*' is still supported): 'any.any' - equivalent to '*.*' 'any' - equivalent to '*' '68.any' - equivalent to '68.any' 'any.78-90' - equivalent to '*.78-90'
- [DPI][LOG] Messages about insufficient SSL parsers are written to the slave log not for every event, but at a frequency of 1/50000.
- [DPI] Added protocols ZALO_CALL(49320) and VK_CALL(49321)
- [DPI] Fixed blocking in hard mode for SSL
- [Acct] Added attribute
VASExperts-Service-Type
. Radius acct start/interim/stop sends the authorization type in theVASExperts-Service-Type
attribute. - [CLI] Added:
stat flow ip6
command to display IPv6 flow statistics - [CLI] Added:
stat flow ip4
command to display IPv4 flow statistics. Analogous to the output infastdpi_stat.log
. - [IPFIX] Fixed ExportTime formation error in IPFIX Fullflow
- [CLI] Added
stat netflow
command. Displays general statistics for Netflow/IPFIX (same as infastdpi_stat.log
under the "Statistics on NFLW_export" section) - [DNS] Added support for substitution/blocking/dropping of DNS requests A, AAAA, MX, HTTPS. Description
- [CLI] Added
stat firewall
command - [DPI] Added BIGO_CDN protocol (49324)
- [DPI] Added UDP support for BIGOTV
- [PCRF][L2TP] Fixed: NAS attributes for L2TP during authorization
- [BRAS][L2TP] Fixed: data race when closing sessions
- [DPDK] Removed deprecated rx channels settings and related checks
- [IPFIX] Added configurable sending of drop octets/packets counters when generating IPFIX fullflow. Description
- [PCAP] Added capability to save traffic of a specified vlan using the
ajb_save_vlan
parameter - [DPIUTILS] Updated checknat utility
- [DPIUTILS] Updated dns2dic utility with domain blocking support. Description
- [BRAS][L2TP] Fixed: data race during tunnel creation
- [Router] Fixed: interception and diversion of IPv6 packets to tap interfaces. Link-local addresses were not diverted to tap, even if explicitly specified in the
router.subnet6
settings. - [BRAS][L2TP] Fixed: length field in L2TP header for data packets. According to RFC, the len field in L2TP header is optional for data packets. Some L2TP client implementations do not understand data packets with the len field in the L2TP header. This fix adjusts FastDPI's behavior: if data packets from the subscriber arrive without the len field, then SSG will also send data packets without this field. If data packets from the subscriber contain the len field, SSG will include it as well.
- [BRAS] Fixed: sending commands from the
pending_queue
. In some cases (e.g., during state transitions of the pcrf monitorinitial → connected
), sending commands from thepending_queue
was not triggered, which caused commands to "hang" in the queue indefinitely (until reconnection due to a socket error). - Fixed a recently introduced error (affecting betas 4.6 and 4.7) in the session lifecycle that leads to resource exhaustion over time; an operational update from these versions (or rollback) is recommended.
Was this information helpful?