IntenseWebs/LibreQoS
3
0
Fork 0
mirror of https://github.com/LibreQoE/LibreQoS.git synced 2024-11-29 11:23:49 -06:00
Code Issues Packages Projects Releases Wiki Activity
1cc6a5464e
LibreQoS/docs/TechnicalDocs/integrations.md
Robert Chacón 1cc6a5464e
Update integrations.md
2024-01-05 17:15:32 -07:00

2.9 KiB
Raw Blame History

Integrations

UISP Integration

First, set the relevant parameters for UISP (uispAuthToken, UISPbaseURL, etc.) in ispConfig.py.

To test the UISP Integration, use

python3 integrationUISP.py

On the first successful run, it will create a network.json and ShapedDevices.csv file. If a network.json file exists, it will not be overwritten. You can modify the network.json file to more accurately reflect bandwidth limits. ShapedDevices.csv will be overwritten every time the UISP integration is run. You have the option to run integrationUISP.py automatically on boot and every 10 minutes, which is recommended. This can be enabled by setting automaticImportUISP = True in ispConfig.py

Powercode Integration

First, set the relevant parameters for Sonar (powercode_api_key, powercode_api_url, etc.) in ispConfig.py.

To test the Powercode Integration, use

python3 integrationPowercode.py

On the first successful run, it will create a ShapedDevices.csv file. You can modify the network.json file manually to reflect Site/AP bandwidth limits. ShapedDevices.csv will be overwritten every time the Powercode integration is run. You have the option to run integrationPowercode.py automatically on boot and every 10 minutes, which is recommended. This can be enabled by setting automaticImportPowercode = True in ispConfig.py

Sonar Integration

First, set the relevant parameters for Sonar (sonar_api_key, sonar_api_url, etc.) in ispConfig.py.

To test the Sonar Integration, use

python3 integrationSonar.py

On the first successful run, it will create a ShapedDevices.csv file. If a network.json file exists, it will not be overwritten. You can modify the network.json file to more accurately reflect bandwidth limits. ShapedDevices.csv will be overwritten every time the Sonar integration is run. You have the option to run integrationSonar.py automatically on boot and every 10 minutes, which is recommended. This can be enabled by setting automaticImportSonar = True in ispConfig.py

Splynx Integration

First, set the relevant parameters for Splynx (splynx_api_key, splynx_api_secret, etc.) in ispConfig.py.

The Splynx Integration uses Basic authentication. For using this type of authentication, please make sure you enable Unsecure access in your Splynx API key settings. Also the Splynx API key should be granted access to the necessary permissions.

To test the Splynx Integration, use

python3 integrationSplynx.py

On the first successful run, it will create a ShapedDevices.csv file. You can manually create your network.json file to more accurately reflect bandwidth limits. ShapedDevices.csv will be overwritten every time the Splynx integration is run. You have the option to run integrationSplynx.py automatically on boot and every 10 minutes, which is recommended. This can be enabled by setting automaticImportSplynx = True in ispConfig.py