Skip to content

Releases: uw-ictd/colte

Release 0.15.*

29 Jul 23:12
Compare
Choose a tag to compare

This release marks a major upgrade to CoLTE and will require user
action to upgrade existing systems.

  1. 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.
  2. 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 command colte-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.
  3. 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

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

28 Jan 05:08
Compare
Choose a tag to compare

This release adds support for new core features in Open5Gs, as well as addressing many small maintenance issues.

open5gs rebase

27 Mar 17:50
d1ca5ed
Compare
Choose a tag to compare

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

16 Oct 20:57
Compare
Choose a tag to compare

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

26 Sep 23:58
Compare
Choose a tag to compare

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

25 Sep 17:48
Compare
Choose a tag to compare

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.