A blazing fast TR-069 auto configuration server (ACS) built with Node.js, Redis, and MongoDB
npm install genieacs
|3||downloads in the last week|
|29||downloads in the last month|
|Version||0.9.7 last updated 25 days ago|
|Keywords||TR-069, CWMP, ACS|
|Dependencies||libxmljs, redis, hiredis, mongodb|
GenieACS is a blazing fast TR-069 auto configuration server (ACS) built with Node.js, Redis, and MongoDB. It's technology neutral and configurable to fit any service provider needs. This is the core back end component. Official front end GUI is available at https://github.com/zaidka/genieacs-gui.
- Massively concurrent: Can handle hundreds of thousands of connected devices on a single server even with low inform interval.
- Preset-based configuration: Define sets of configurations that devices will pick up and apply as needed based on given preconditions.
- Tagging: Use tags to group devices for more manageable presets.
- Searching: Query for devices on any parameter (supports all common operators including regular expressions).
- Parameter aliasing: Define aliases to unify parameter paths from different types of devices. Aliases behave like normal parameters (i.e. can be queried or modified).
- Extensive API: A simple yet rich HTTP-based API allows easy integration with other system.
npm install -g genieacs
You may need to modify the configuration files under "config" directory (in /lib/node_modules/genieacs/config) depending on your setup.
Alternatively, you can use git to get the latest development version (not recommended for production use):
cd /opt git clone https://github.com/zaidka/genieacs.git cd genieacs npm install npm run configure npm run compile
Finally, run the following in GNU Screen session or something similar:
This is the service that the CPEs will communicate with. It listens to port 7547 by default (see config/config.json). Configure the ACS URL of your devices accordingly.
This is the API module. It exposes the API on port 7557 by default. This is needed for the GUI front end to communicate with.
This is the file server from which the CPEs will download firmware images and other types of files.
You can use stream redirection to output to log files:
genieacs-acs >> /var/log/genieacs-acs.log 2>> /var/log/genieacs-acs-err.log genieacs-api >> /var/log/genieacs-api.log 2>> /var/log/genieacs-api-err.log genieacs-files >> /var/log/genieacs-files.log 2>> /var/log/genieacs-files-err.log
For further details about installation and configuration, refer to the wiki section.
You may now proceed with installing GenieACS GUI front end.
Documentation is still work in progress. Feel free to contact me if you require any assistance in installation, configuration, or using the APIs.
You may submit bug reports or feature requests here.
For commercial support options, please contact me.
Contributions are welcome. Fork this repo and open a pull request and wait for feedback. You can also contribute by enhancing the documentation in the wiki section.