SSG changelog and update

Update instructions

As of version 12.0, DPI is only installed on CentOS 8.x and VEOS!

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
If the error 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.

Customers using BRAS functionality should note the changes when upgrading SSG to the new version.

Updating SSG to Version 14.0 Shooting Stars

14.0 Shooting Stars 1) In memory of colleagues who made a huge contribution to the development of the company and its products and will forever remain in our memory

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. Description

[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, and dhcp 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 using the ipfix_reserved parameter. Description

[FastRadius] It is now possible to set both bind_ipv6_address and bind_ipv6_subnet. If the Framed-IPv6-Prefix has a /128 mask, it is not checked against the bind_ipv6_subnet restriction. Description

CLI command dev info now includes the name of the LAG that the port belongs to. Description

[PCRF][PPP][Framed-pool] Added: DHCP option Client-Id now includes tunnel-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. Description: ClickStream export Setup, Configuring Full NetFlow Export in IPFIX Format

[IPFIX DNS] New elements added to IPFIX DNS: 224 (ipTotalLength) and 43823:3206 (DNS transaction id). Description

[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 use subs_id as a key (subs prop show, l2tp show session, l2tp term, etc.) may now return multiple entries with the same l2subs_id. Description

[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 acct-interim-interval, PPPoE Radius Access-Request

[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). Description

[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] Added dpdk_engine=6 (mqrx-bridge) — number of RSS dispatchers per bridge. 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. Description

[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 and WECHAT_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 the auth_server parameter. If <pcrf_indxed> is not specified — defaults to 0.
Description

[IPFIX DNS] Added the ability to send DNS MX responses via IPFIX. Enabled by setting bit 3 (4) of the ajb_save_dns parameter. Description

[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. Description

[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 the VASExperts-Service-Type attribute. Description

[CLI] Added: stat flow ip6 command to display IPv6 flow statistics. Description

[CLI] Added: stat flow ip4 command to display IPv4 flow statistics. Analogous to the output in fastdpi_stat.log. Description

[IPFIX] Fixed ExportTime formation error in IPFIX Fullflow

[CLI] Added stat netflow command. Displays general statistics for Netflow/IPFIX (same as in fastdpi_stat.log under the "Statistics on NFLW_export" section). Description

[DNS] Added support for substitution/blocking/dropping of DNS requests A, AAAA, MX, HTTPS. Description

[CLI] Added stat firewall command. Description

[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. Description

[DPIUTILS] Updated checknat utility. Description

[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 monitor initial → connected), sending commands from the pending_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.