====== SSG changelog and update ======
{{indexmenu_n>10}}

===== Update instructions  =====
<note important>As of version 12.0, DPI is only installed on CentOS 8.x and [[veos:installation|VEOS]]!</note>

If you have version of CentOS 6.x or CentOS 8.x installed, switch the repository once with the command:
<code bash>
sed -i -e '/^mirrorlist=http:\/\//d' -e 's/^# *baseurl=http:\/\/mirror.centos.org/baseurl=http:\/\/vault.centos.org/' /etc/yum.repos.d/CentOS-*.repo
</code>

Then run updates as usual:
<code bash>
yum update fastdpi
</code>

<note tip>If the error ''Module yaml error'' appears during the upgrade, you should upgrade the module ''dnf upgrade libmodulemd''.</note>

After updating, restart the DPI:
<code bash>service fastdpi restart</code>

and other dependent procoesses (PCRF/Radius), but only if they are actually used and their configuration is valid:
<code bash>
service fastpcrf restart
service fdpi_radius restart
</code>

You can update the operating system components **Do not update the kernel version and its dependent utilities!**\\
For CentOS 6.x:
<code bash>
yum --exclude=kernel*,util-linux-ng,libuuid,libblkid update
</code>

For CentOS 8.x:
<code bash>
yum update
</code>

**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:
<code bash>touch /etc/dpi/noprioadj</code>
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.

<note tip>Customers using BRAS functionality should note the changes when upgrading SSG to the new version.</note>

===== Updating SSG to Version 14.0 Shooting Stars =====

14.0 Shooting Stars ((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:
<code bash>
yum info fastdpi
</code>
 
Rollback to 13.3:
<code bash>
yum downgrade fastdpi-13.3-0 fastpcrf-13.3-0 dpiutils-13.3 fastradius-13.3
</code>

After updating or changing the version, a service restart is required:
<code bash>
service fastdpi restart
</code>

:!: If PCRF and/or Radius are used, they must also be restarted. For PCRF restart, the following order is preferred:
<code bash>
service fastdpi stop
service fastpcrf restart
service fastdpi start
</code>

:!: 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:
<code bash>
yum clean all
</code>

====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). [[dpi:dpi_brief:dpi_requirements|Description]]
  - [CLI] Added support for ''subs_id'' in commands: ''dhcp show'', ''dhcp reauth'', ''dhcp6 show'', ''dhcp6 reauth'', and ''dhcp disconnect''. [[dpi:bras_bng:cli:dhcp|Description]]
  - [DPI] New protocols added: AGORA_STREAMS(49314), AZAR_CALL(49315), WECHAT_CALL(49316), TEAMS_CALL(49317). [[dpi:dpi_options:protocols]]
  - [DPI] Improved support for LINE_CALL, VYKE_CALL protocols. [[dpi:dpi_options:protocols]]
  - [DPI] Fixed smartdrop behavior
  - [DPI] Added validation for complex protocols. [[dpi:dpi_options:protocols]]
  - [DPDK] Increased the maximum number of dispatchers to 32. [[dpi:dpi_components:platform:dpi_config|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'' and ''bind_ipv6_subnet''. If the Framed-IPv6-Prefix has a /128 mask, it is not checked against the ''bind_ipv6_subnet'' restriction. [[dpi:dpi_components:radius:radius_requirements#ipv6_support|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 includes ''tunnel-IP'' as part of the subscriber ID. For more details, see sections [[dpi:bras_bng:ip_pool:ipv4]] and [[dpi:bras_bng:ip_pool:ipv6]]
  - [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 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''.
  - [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<code>
    hal mempool props
    hal mempool stat</code>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  [[dpi:bras_bng:radius_integration:radius_auth_server_integration:radius_auth_response#acct-interim-interval|Subscriber authorization attributes]], [[dpi:bras_bng:bras_pppoe:bras_pppoe_radius:bras_pppoe_radius_acc]], [[dpi:bras_bng:bras_pppoe:bras_pppoe_radius:bras_pppoe_radius_rej]]
  - [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. [[dpi:opt_cgnat:сgnat_settings|Description]]
  - [PCRF] Added support for service 19 "DNS spoofing", profile required. [[dpi:dpi_options:dns_substitution|Description]]
  - [DPDK] Added ''dpdk_engine=6'' (''mqrx-bridge'') — number of RSS dispatchers per bridge. [[dpi:dpi_components:platform:dpi_config#dpdk_engine_6rss_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. [[dpi:dpi_components:platform:vlan_traffic_handling|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 SDR
    - ''vlan rule modify'' - modify existing rule in SDR
    - ''vlan rule delete'' - delete rule from SDR
    - ''vlan rule show'' - show all rules for the specified VLAN/QinQ
    - ''vlan rule dump'' - dump all rules in SDR
    - ''vlan rule purge vlan''/''qinq''/''all'' - clear SDR for VLAN/QinQ or both
    - ''vlan 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'' 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.
  - [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 <code>
'*.*' 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' </code>
  - [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.
  - [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 in ''fastdpi_stat.log''.
  - [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)
  - [DNS] Added support for substitution/blocking/dropping of DNS requests A, AAAA, MX, HTTPS. [[dpi:dpi_options:dns_substitution|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. [[dpi:dpi_options:opt_statistics:statistics_ipfix|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. [[dpi:dpi_options:dns_substitution|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.