v1.3.0

What's Changed

deploy-free5gc.sh

• Add support to free5GC v3.4.3 and v3.4.4 stable versions
• Add support to deploy TNGF
• Add extra safeguard to check the compatibility between free5GC and GTP5G module while deploying
• Add extra safeguard to warn that it isn't possible to run N3IWF and TNGF at the same time with the configuration provided by this tool

deploy-n3iwue.sh

• Update N3IWUE nightly commit to latest

deploy-tngfue.sh

• First public release

install-go.sh

• Update Go version to 1.21.8
• Remove unneeded commands according to the official install instructions

Future directions

This section was moved to the issues page

Full Changelog: v1.2.3...v1.3.0

v1.2.3

What's Changed

deploy-free5gc.sh

• Update free5GC nightly commit hash to be able to use the latest fixes related to N3IWUE signaling reported on free5gc/free5gc#584
• Update control variables' names to a pattern that puts the name the related component in the suffix
• Add the parameter -n3iwf-nightly to control which version of N3IWF will be cloned (stable or nightly)
• Update the clone command used to install free5GC stable to silence 'You are in detached HEAD state' warnings

deploy-UERANSIM.sh

• Update UERANSIM nightly commit to use the version with the EAP-AKA-PRIME fix

deploy-n3iwue.sh

• Add 3 parameters to control which version of N3IWUE will be installed
• Now at least one parameter is required, similar to the behavior of deploy-UERANSIM.sh (e.g. to choose which branch to install)
• Update hostname control variable to new suffix naming pattern

deploy-both-UEs.sh

• Update parameters used to deploy N3IWUE due to the changes made on deploy-n3iwue.sh

Future directions

• Make ATSSS prototype's source code first public release
• Improvements on the IP address setup on all scripts may be made, so it gets easier to setup them as currently they must be manually typed (still is on hold, not a priority right now)

Full Changelog: v1.2.2...v1.2.3

v1.2.2

What's Changed

deploy-free5gc.sh

• Add a parameter to control the execution of the iptables-related flow
• Delete sleep timers to speed up deployment
• Update 5GC deployment to enhance the DB installation process
• Add support to Ubuntu 22.04 (please, read this FAQ)
• Update free5GC and GTP-U to latest stable versions
• Add safeguards to kill the script if the control variables FREE5GC_VERSION or GTP5G_VERSION fail to be set
• Add more informative messages to the GTP-U setup section

deploy-UERANSIM.sh

• Update UERANSIM configuration flow to avoid errors when running multiple times

deploy-n3iwue.sh

• Add the ability of cloning both v1.0.0 or v1.0.1 of N3IWUE via parameter configuration

deploy-both-UEs.sh

• Deploys the latest stable (v1.0.1) version of N3IWUE by default when setting up both UEs

change-kernel-version.sh

• First public release (please, see this FAQ)

Future directions

• Improve the ATSSS prototype's source code and make it ready for public release
• Improvements on the IP address setup on all scripts may be made, so it gets easier to setup them as currently they must be manually typed (still is on hold, not a priority right now)

Full Changelog: v1.2.1...v1.2.2

v1.2.1

What's Changed

deploy-free5gc.sh

• Add a safeguard to verify the input parameters and avoid errors or typos
• Update GTP module version to latest stable

deploy-UERANSIM.sh & deploy-n3iwue.sh

• Add a parameter to skip updating the machine host name

deploy-both-UEs.sh

• First public release

Future directions

• Work on a prototype for making a PoC regarding one of the ATSSS-based techniques (another branch will be created for that)
• Improvements on the IP address setup on all scripts may be made, so it gets easier to setup them as currently they must be manually typed (on hold, not a priority right now)

Full Changelog: v1.2.0...v1.2.1

v1.2.0

What's Changed

deploy-free5gc.sh

• Warn the user before deleting/cleaning the iptables rules
• Update the N3IWF configuration automatically during deploy (if parameter -n3iwf is issued)
• Configure the Nwu and IPSec IPs automatically
• Update N3IWUE address range if conflicting with other IPs from 5GC host machine

deploy-UERANSIM.sh

• No changes since previous release

deploy-n3iwue.sh

• First public release
• Configure Nwu and IPSec IPs and resolves IP conflict, if any, automatically

Future directions

• A script to automatically deploy both UE (through UERANSIM) and N3IWUE on the same machine automatically
• Work on a prototype for making a PoC regarding one of the ATSSS-based techniques (another branch will be created for that)
• Improvements on the IP address setup on all scripts may be made, so it gets easier to setup them as currently they must be manually typed

Full Changelog: v1.1.0...v1.2.0

v1.1.0

What's Changed

deploy-free5gc.sh

• Script behavior changed (cloning and installing the stable branch is the default now)
• Now the usage of parameters is fully supported to control the different execution flows

deploy-UERANSIM.sh

• Add support to use parameters to control the different execution flows
• Add the possibility of working with the stable version or two nightly versions (that support free5GC v3.3.0 and below or v3.4.0 and above)

Future directions

• I'm currently working on automating the N3IWUE setup
• I'll try to improve the scripts on the IP address parts so it gets easier to setup them
• I'll try to improve the execution of the N3IWF configuration (e.g. Setup NWu interface IP, etc)

Full Changelog: v1.0.0...v1.1.0

v1.0.0

What's Changed

• First public stable release

Note: The UERANSIM script (deploy-UERANSIM.sh) is being revised in the next version to incorporate parameter support and achieve a similar behavior as deploy-free5gc.sh. For now, please, adjust the command on line 26 according to your setup.

Full Changelog: https://github.com/oliveiraleo/free5gc-auto-deploy/commits/v1.0.0