# RELEASE NOTES: #

## v1.5.1 -- May 2023 ##

* Tutorials:
  * All basic-based tutorials are now only in HTTP/2 mode and with NRF
    - All non-NRF basic deployments have been obsoleted
* Update the helm charts and helm chart tutorial
* Testing:
  * Load tester for 5000 PDU sessions
* Common features/fixes for all Network Functions:
  * Code Refactoring for:
    * Logging mechanism (runtime log level selection)
    * Installation / build scripts
    * Continuous Integration scripts
  * Published images on Docker-Hub is using now Ubuntu-20 as base image
    * We will soon obsolete the build system for Ubuntu18.04
* `AMF` changes:
  * Fix Service Request handling (Service Type: Signalling)
  * Fix N2 handover
  * Support usage of SUPI-type IMSI
  * Fix mapping between RAN UE NGAP ID and UE context
  * Fix SBI port for UDM in case of FQDN resolution
  * Fix TMSI handling
  * Fix PDU Session Ressource Release Response message
  * Fix issue for decoding MSIN with an odd number of digits
  * Fix usage of lower-case for DNN value (case insensitive)
  * Fix: NSSF port number was not read from config file
  * Code Refactoring for:
    * NAS layer
    * Registration Complete Message
    * UE context refactor
* `NRF` changes:
  * Tentative fix for a failed assertion of Boost signal
  * HTTP2 fix for json response data formatting
* `PCF` changes:
  * Add HTTP/2 support
* `SMF` changes:
  * Fix N1N2 Content message
  * Remove ranInfo field in n2infocontainer
  * Fix encoding NAS header
  * Resolved QoS Flow info missing in N2 Handover Preparation
  * Fix SUPI format: Use IMSI as SUPI
  * Fix: Send PDU Session Reject when PDU session fails before SMF procedure is started
  * Fix HTTP header
  * Fixing config parameter read
  * Fix for IE Redirect Information
  * Fix: Associate node id based on node id type
  * Use N3 ip address from NF profile if provided
  * Fix: UL TEID for multiple created PDR
  * Fix for encode/decode of create QER IE
  * Support for DL PDR in session establishment
  * Use NWI from config file when no UPF profile is associated
  * Fix HTTP/2 issue with PCF
* `UDM` changes:
  * HTTP2 Fix: Removed duplicate request handler
* `UDR` changes:
  * Fix PLMN ID for SessionManagementSubscriptionData (HTTP2)
  * logging: Add UE ID in the log
  * Retry NF Register if registration failed

## v1.5.0 -- January 2023 ##

* New tutorials:
  - UL CL with policies --> `docs/DEPLOY_SA5G_ULCL.md`
  - Testing with `OMEC-gnbsim` --> `docs/DEPLOY_SA5G_WITH_OMEC_GNBSIM.md`
  - SD-Fabric usage
* Update the helm charts and helm chart tutorial
* Switched tutorials to latest `mysql` version (`8.0`)
* Fixes in slicing tutorial to use latest OAI RAN images
* Common features/fixes for all Network Functions:
  - Proper exit on SIGTERM
  - jinja2-based configuration file
  - Ubuntu22 and cgroup2 support (even on `SPGWU-TINY`)
  - Giving some time for FQDN resolution
  - Release mode does not use libasan anymore
  - Health-checks are natively in the distributed images
* `AMF` changes:
  - Minimal fix for Decoding RegistrationRequest from COTS UE
  - Fix small issue for NGAP lib
  - NGAP IES code refactoring
  - Fix PDU session release
  - Refactor NGAP message callback
  - Fix nake ptr
  - Fix UL NAS transport
  - Fix typo for Rejected NSSAI
  - PDU session release supported
  - Update SST type (int instead of string) in conf file
  - Events exposure: location report with empty supi fixed
  - small fix for event exposure loss of connectivity
  - Minor fix for encoding no SD in PduSessionResourceSetupRequest
  - Fix SST/SD on cots ue
  - Docker images improvements
* `AUSF` changes:
  - Docker images improvements
* `NEF` changes:
  - Docker images improvements
* `NRF` changes:
  - Enhance UPF profile in NRF and fix bug in SBI when body is too long
  - Added Status change notification
  - Docker images improvements
* `NSSF` changes:
  - Docker images improvements
* `PCF` changes:
  - Initial release
  - NRF registration
  - Add Npcf_SMPolicyControl API Create, Update, Delete and Get procedures
  - Add file based policy provisioning
  - Add policy decision feature based on SUPI, DNN, Slice and default policy
* `SMF` changes:
  - Feature improvements:
    * PDU SESS EST + Qos Monitoring events exposure
    * PFCP: removing dependency to folly
    * Add IEs to support UE Rel 16
    * Added and integrated UPF graph instead of PFCP associations list
      * Supported scenarios:
        - I-UPF / A-UPF N9
        - UL CL
    * Implement Npcf_SMPolicyControl API client
    * Changing the configuration file to jinja2-based approach
      * At least one slice (slice #0) shall be completely defined
  - Fixes:
    * Fix openapi cause
    * Fix small issue for Mime parser for normal message
    * Fix Volume Threshold IE to PFCP Create URR IE
    * Fix mcc mnc 00 udr
    * Fix issues to work with Release-16 COTS UE
    * Fix issue when there's no valid reply from UPF for PDU session release
    * Fix Protocol identifier Selected Bearer Control Mode
    * Fix issue for Static UE IP Addr
    * Fix URR ID in IE Create URR (post UPF graph implementation)
    * Fix issue for Full DNN (APN Operator Identifier)
* `SPGWU-TINY` changes:
  - Docker images improvements
  - Ubuntu22 full support
* `UDM` changes:
  - Docker images improvements
* `UDR` changes:
  - Improve MySQL connection handling
  - Fix issue with DNNs including special characters
  - SessionManagementSubscriptionData POST API
  - Fix session management subscription data
  - Docker image improvements
* `UPF-VPP` changes:
  - Ubuntu22.04 support
  - SNSSAI fix
  - Support UL CL UPF deployment
  - Support I-UPF / A-UPF N9 UPF deployment
  - GTP payload length fix
  - Major Configuration update

## v1.4.0 -- July 2022 ##

* All official images produced by CI are pushed to `oaisoftwarealliance` Docker-Hub Team account
* New tutorial:
  - My5gRAN Tester --> `docs/DEPLOY_SA5G_WITH_My5g-RANTester.md`
* Update the helm charts and helm chart tutorial
* Reduce image size for all network functions
* New wiki page to know more about variable which can be configured for each network function
* Fix HTTP/2 support for all network functions `docker-compose/docker-compose-basic-nrf-httpv2.yaml`
* `AMF` Changes:
  - Fix SCTP NG Shutdown issue
  - Fix 100% CPU consumption issue
  - Fix RAN UE ID display
  - Fix issue for TMSI and GUTI value
  - Fix for handling S-NSSAI 
  - Remove OPC value from AMF configuration
  - Support for Ubuntu 20.04 bare-metal installation
* `AUSF` Changes:
  - Remove unused packages
  - HTTP/2 support for SBI interface
  - NRF Registration and heartbeat exchange
* `NRF` Changes:
  - Remove unused packages
  - Add NF profile handling for PCF
  - HTTP/2 support for SBI interface
* `NSSF` Changes:
  - Network slice selection for UE registration 
  - NS-AVAIBALITY API support to CREATE new slice
  - Fix bare-metal setup configuration management
  - HTTP/2 support for SBI interface
* `SMF` Changes:
  - Fix for handling S-NSSAI 
  - Add support for IMS
  - HTTP/2 support for SBI interface
  - Add usage report feature
  - Flexiable MTU
  - Support for Ubuntu 20.04 bare-metal installation
* `UDM` Changes:
  - Fix HTTP/2 support
  - NRF Registration and heartbeat exchange
* `UDR` Changes:
  - Fix sync failure issue
  - Fix issue to support Slice Selection Subscription Data retrieval
  - NRF Registration and heartbeat exchange
* `SPGWU-TINY` Changes:
  - Fix for handling S-NSSAI 
  - Add support for multiple slices via config file
  - Allowed reusing GTPv1-U socket
  - Fix GTPU offset sequence number
  - Fix configurable number of DL threads for data path
* `UPF-VPP` Changes:
  - Standalone support validated for traffic steering and redirection
  - Added instructions for bare-metal installation
  - Support for Ubuntu 20.04 bare-metal/docker installation
* `NEF` It is ongoing so far it is not functional

## v1.3.0 -- January 2022 ##

* Incorporation of new public network functions:
  - NSSF
* New tutorials:
  - Slicing --> `docs/DEPLOY_SA5G_SLICING.md`
  - Static UE IP address to emulate private network --> `docs/DEPLOY_SA5G_BASIC_STATIC_UE_IP.md`
* `AMF` Changes:
  - Periodic Registration Update
  - Support for Event Exposure (Registration State Report)
  - Implicit Deregistration Timer
  - Mobile Reachable Timer
  - Mobility Registration Update
  - NRF Selection (via NSSF)
  - Fix for validation of SMF Info
  - Fix RAN UE NGAP Id
  - Fix SMF Selection SD
  - Fix NSSAI mismatch
  - Fix Service Request
  - Fix HTTP2
  - Fix MCC such as 001
  - Docker optimization
* `AUSF` Changes:
  - HTTP2 Support
  - Docker optimization
* `NRF` Changes:
  - NF profile update
  - Docker optimization
* `NSSF` Changes:
  - Initial Public Release
  - Docker Optimization
* `SMF` Changes:
  - Update NWI from NF profile
  - Update SMF profile
  - Added retry for PFCP association request
  - More flexible DNN/IP ranges when deploying container
  - Fix retrieving the list of NWI
  - Fix entreprise IE decoding
  - Fix issue for UPF selection
  - Fix for IE Measurement Period
  - Docker optimization
* `UDM` Changes:
  - Experimental support for Event Exposure
  - Added HTTP2 support
  - Fix static addr allocation
  - Fix build issue
  - Docker build optimizations
* `UDR` Changes:
  - Added HTTP2 support
  - Fix build issue
  - Fix static addr allocation
  - Docker build optimizations
* `SPGWU-TINY` Changes:
  - Disable association request if NF registration is enabled
* `UPF-VPP` Changes:
  - Upgrade to UPG plugin stable/1.2
  - Build fixes
  - Deployment fixes (wait launch of NRF Client until VPP is getting ready)

## v1.2.1 -- October 2021 ##

* Incorporation of new public network functions:
  - UPF-VPP
* New tutorial with this new function
* `AMF` Changes:
  - Fix build issue
  - Tentative fix for ngKSI already in use
  - Initial implementation for Mobility registration update
* `AUSF` Changes:
  - Fix build issue
* `NRF` Changes:
  - Fix build issue
* `SMF` Changes:
  - Timers handling: T3591/T3952
  - Fix build issue
  - Fix UPF selection
* `UDM` Changes:
  - Fix build issue
* `UDR` Changes:
  - Fix build issue
* `SPGWU-TINY` Changes:
  - Fix build issue
  - Fix GTPU DL encapsulation: 8 extraneous bytes
* `UPF-VPP` Changes:
  - Initial Public Release
  - Full support for Ubuntu18 and RHEL7
  - CI Build support
  - Tutorial validated

## v1.2.0 -- September 2021 ##

* Incorporation of new public network functions:
  - AUSF
  - UDM
  - UDR
* New tutorials with these new functions
* CI improvements
* `AMF` Changes:
  - AUSF connection
  - Support PDU Session Resource Modify procedure
  - Support HTTP2
  - Support AMF Event Exposure Services
  - Fix NIA0, NEA2
  - Fix potential AMF crash with UE/NGAP/NAS context
  - Fix N2 Handover
  - Fix Paging procedures
* `AUSF` Changes:
  - Initial public release
  - NRF registration
    - with FQDN DNS resolution
  - Full support for Ubuntu18 and RHEL8
* `NRF` Changes:
  - Added AUSF, UDR, UDM profiles
  - Updated UPF profile
* `SMF` Changes:
  - Event Exposure implemented
  - UPF profile update
  - Support for URR query
  - Bug fixes
* `UDM` Changes:
  - Initial public release
  - NRF registration
    - with FQDN DNS resolution
  - Full support for Ubuntu18 and RHEL8
* `UDR` Changes:
  - Initial public release
  - NRF registration
    - with FQDN DNS resolution
  - Proper mySQL DB deployment management
  - Full support for Ubuntu18 and RHEL8
* `SPGWU-TINY` Changes:
  - Adding 5G features
    - HTTP2 support

## v1.1.0 -- July 2021 ##

* Improvements on Continuous Integration:
  - DsTester validation on Ubuntu18 docker deployment
  - DsTester validation on RHEL8 / OpenShift deployment
  - Some components (such as AMF/NRF) have bracket-testing at unit level
* A lot of tutorials have been added
* `AMF` Changes:
  - Session Release
  - NRF registration
    - with FQDN DNS resolution
  - Multiple PDU support
  - Bug fixes
  - Full support for Ubuntu18 and RHEL8
* `NRF` Changes:
  - FQDN DNS resolution
  - Bug fixes
  - Full support for Ubuntu18 and RHEL8
* `SMF` Changes:
  - PFCP Release 16 support
  - NRF registration
    - with FQDN DNS resolution
  - Support for multiple UPF instances
  - Dotted DNN support
  - Use (SST, SD) to get the subscription information
  - Bug fixes
  - Full support for Ubuntu18 and RHEL8
* `SPGWU-TINY` Changes:
  - Adding 5G features
    - NRF discovery and FQDN support

## v1.0.0 -- September 2020 ##

* Initial release