freeacs / freeacs-next

(WIP) A project to revitalize the FreeACS project

Free ACS

FreeACS is a somewhat complete TR-069 ACS available for free under the MIT License. You can download and install it, or contribute to the project!

Prerequisites

FreeACS requires Java 17 and MySQL. It has been tested to work on Java 17, 18 and 19 and latest version of MySQL (the latter with some minor quirk in the install script).

Discussion

• Discussion: https://github.com/freeacs/freeacs/discussions
• [Freeforums] (deprecated)

Build it

FreeACS is built with SBT on unix/linux systems:

$ ./mvnw test

Packaged to deployable zips with:

$ ./mvnw package

See the distribution modules target folder or the individual module target folders for deployable zip files.

Contributing

Please read CONTRIBUTING.md for instructions to set up your development environment to build FreeACS

Versioning

We use SemVer for versioning.

License

This project is licensed under the The MIT License.

Active project Members

• Jarl André Hübenthal (@jarlah)

See https://github.com/freeacs/freeacs/wiki/About for information.

freeacs-next's Issues

Re-implement auto generating new semirandom PeriodInformInterval

Re-Implement Kick functionality

Kick is inherently extremely simple. Either we do have connectionrequest params or we dont. If we do. Use them to kick device with a http request with basic header. Done. No fuzz

Re-Implement first and last connect timestamp

I need to always update/insert LastConnectTimestamp and insert FirstConnectTimestamp if not exists.

What about Shell scripts, is it possible?

Find out what the heck is wrong with get parameter names trying to recreate existing params

Re-implement TR-069 Basic Provisioning

Following things must be implemented:

1. IN -> INr, including auto discovery of unit, authentication etc.
   DONE
2. IN -> INr -> EM -> [GPN -> GPNr ->] GPV -> GPVr -> SPV -> SPVr -> EM
   Partially done, tr069 controller will automatically answer EM with dummy GPV and onwards.
   Done:

• If Discover param is 1, or if discovery mode is true, or if deviceParameters.length == 0 (meaning only system params)
  • GPN: Ask CPE for parameter names in <Keyroot>.ManagementServer. (or be explicit)
  • GPNr: Store all parameters in unit type that does not already exist
• GPV/GPVr: Ask CPE for all values to parameters with Read Always flag
• SPV/SPVr: Ask CPE to set new values for parameters that has different values in ACS (for initial provisioning this is obviously none). Always set new semi random PII.