62 lines
2.0 KiB
Markdown
62 lines
2.0 KiB
Markdown
|
# femto-acs for femtocells
|
||
|
|
|
||
|
|
This is a *hack* to get ip.access nano3g femtocells configured without using a huge tr069/ACS server like (geniacs, ...).
|
||
|
|
This simplified version only reacts on *Inform* and tries to set values from the configuration file without checking the state of the femto cell.
|
||
|
|
It further does not create or delete objects if they don't exist. Neither does it check if the values in the ini file are valid. E.g. by getting both values and type from the device itself.
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
### debian
|
||
|
|
|
||
|
|
Ensure python3 with pipenv is installed
|
||
|
|
|
||
|
|
`apt-get install python3 pipenv`
|
||
|
|
|
||
|
|
```sh
|
||
|
|
pipenv install
|
||
|
|
```
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
### config/flask.cfg
|
||
|
|
|
||
|
|
Please change the `SECRET_KEY` by generating your own. The `SECRET_KEY` is used to sign cookies.
|
||
|
|
|
||
|
|
### config/femtocells.ini
|
||
|
|
|
||
|
|
The main configuration file for the femtocells. The *Common* section is used as default values which can be overriden by a specific
|
||
|
|
femtocell configuration.
|
||
|
|
To override values for a specific femtocell create a section with the serialnumber including leading zeros as shown for femtocell *0000123456*.
|
||
|
|
|
||
|
|
**IMPORTANT** ensure the **Device.ManagementServer.URL=http://10.0.11.184:7547/acs|xsd:string** matches this server including the /acs.
|
||
|
|
|
||
|
|
After changing values in the femtocells.ini the femto cell can be either rebooted or wait until the femto cell is informing us again (see periodic inform / tr069).
|
||
|
|
|
||
|
|
## Running
|
||
|
|
|
||
|
|
From within the repository call:
|
||
|
|
```
|
||
|
|
pipenv install
|
||
|
|
pipenv shell
|
||
|
|
gunicorn -k eventlet --keep-alive 600 --bind 0.0.0.0:7547 app:app
|
||
|
|
```
|
||
|
|
|
||
|
|
gunicorn is used to allow keep-alive connections.
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
|
||
|
|
### femto cell stops reacting on ACS data
|
||
|
|
|
||
|
|
Ensure the xml files contain an extra newline (ascii 0xa) on the end of the request.
|
||
|
|
|
||
|
|
## Bugs / Limitations
|
||
|
|
|
||
|
|
* It doesn't use any external database (mysql) or cache system (redis) to reduce the amount of external dependencies and simplify the setup.
|
||
|
|
|
||
|
|
## Thanks
|
||
|
|
|
||
|
|
Thanks to:
|
||
|
|
|
||
|
|
* [Thomas Steen 'tykling' Rasmussen](https://github.com/tykling/)
|
||
|
|
* [pentonet for their genieacs setup](https://github.com/Pentonet/pentonet-genieacs-package)
|