Releases: uw-ictd/colte
Release 0.15.*
This release marks a major upgrade to CoLTE and will require user
action to upgrade existing systems.
-
To better stabilize the relationship between CoLTE and Haulage,
this release splits the data tables between each program and allows
each program to own their respective tables.- As part of this migration CoLTE now supports full migrations and
schema updates via the knex framework. The latest migrations are
applied on startup, allowing future upgrades to change the
database schema without requiring user intervention.
- As part of this migration CoLTE now supports full migrations and
-
The primary backing database has been shifted from mysql/mariadb to
postgresql. As the behavior of mysql (shipped with ubuntu) subtly
diverges from that of mariadb (shipped with debian & fedora), it
becomes harder to debug and support end-users in the field. Postgresql
is fully open source and consistently available across distributions,
making it ideal for our purposes.- Existing mariadb/mysql deployments will need to manually migrate
their data from mysql to postgres. An upgrade tool is provided
and installed as part of the package release. You can see how to
use it with the commandcolte-pg-upgrade --help
. This tool
does not delete data from the mysql database, and system
administrators will need to manually remove this unused data if
desired.
- Existing mariadb/mysql deployments will need to manually migrate
-
Miscellaneous bug fixes
-
Fixed a packaging bug where the wrong environment file may be
included -
Return subscribers in a consistent order in the admin view
-
-
Meta
-
Applied consistent machine-checkable style to the codebase via
prettier (for web-centric languages like js, HTML, hbs, yml,
etc) and black (for python). -
Added additional CI jobs to check style and run github code
quality analysis. -
Added new high-level documentation intended for end-users at
https://docs.colte.network
-
Support for Open5Gs 4G/5G Hybrid Core
This release adds support for new core features in Open5Gs, as well as addressing many small maintenance issues.
open5gs rebase
This is a major release! In addition to stabilizing some code and fixing several bugs, we also re-based the EPC from OAI to open5gs. No guaranteed backwards compatibility here, unfortunately, but stability and system sanity has been dramatically improved. Overall, we are very happy with this release and think you will be as well.
Warning: if you have existing users, they will persist in the CoLTE/haulage database but you will have to manually add them to open5gs. We provide a tool in /etc/colte/colte_open5gsdb that lets you add/remove users, this should help.
Integration and Bug-fixes
This release closes about seven grab-bag issues that were holdovers from the initial debian packages release. The issues include HSS key-dumping, SPGW service file not starting, colteconf failing in certain use-cases, and a few other hiccups that, while minor, made the codebase far less accessible to newcomers.
Major rearch/improvement of debian packages
This is a good release! I broke down the debian packages into some sub-packages with dependences and now have everything working right. Key notes:
apt-get colte
is the best starting point for people that want full functionality. It is just a metapackage that installs colte-epc
and colte-webservices
.
colte-epc
is a metapackage that installs colte-{hss, mme, spgw}
(the three EPC components) as well as colte-conf
, described below.
colte-webservices
is a metapackage that installs colte-webgui
(our GUI for clients of the network) and configures it to work with BIND (for DNS) and nginx (for Web proxying). You can access the webgui directly at http://localhost:7999
or via nginx at http://network.colte
.
colte-conf
is our configuration utility. Many different components depend on it. It is idempotent and powered by Ansible. You can run colteconf prompt
to set all options manually, or just edit the values in /usr/local/etc/colte/config.yml
and then run colteconf update
.
Stable Debian Packages Release
Finally integrated apt-get packages for Ubuntu 18.04 and Debian 9! This is a relatively minimal release in that it supports the OAI EPC (HSS/MME/SPGW), colteconf
utility for dynamic (re)configuration, and the colte-webgui
Node application.