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
1ae0a2d568
LibreQoS/v1.2
History
Robert Chacón f661d8ba74
Implement bug fix https://github.com/rchac/LibreQoS/pull/137
2022-10-21 07:56:51 -06:00
..
xdp-cpumap-tc@12ea5973ba Update xdp-cpumap-tc 2022-09-30 04:29:38 -06:00
graphBandwidth.py Prevent "by Tin" graphs from exceeding 100% 2022-09-26 07:59:11 -06:00
graphLatency.py add v1.2 alpha content 2022-09-05 07:54:46 -06:00
influxDBdashboardTemplate.json Update influxDBdashboardTemplate.json 2022-09-25 23:18:29 -06:00
integrationUISP.py Implement bug fix https://github.com/rchac/LibreQoS/pull/137 2022-10-21 07:56:51 -06:00
ispConfig.example.py XDP enabled by default, remove usingXDP boolean 2022-09-30 04:54:20 -06:00
LibreQoS.py Fix prefix handling in v1.2 2022-10-19 14:44:47 -06:00
lqTools.py add +x permission for lqTools.py (improvement) 2022-09-19 15:02:25 +02:00
mikrotikDHCPRouterList.csv Update mikrotikDHCPRouterList.csv 2022-09-19 04:16:57 +05:00
mikrotikFindIPv6.py Add Api port parameter 2022-09-16 19:08:22 +05:00
network.example.json Create network.example.json 2022-09-13 08:03:19 -06:00
README.md Update README.md 2022-09-30 04:46:15 -06:00
scheduled.py Fix https://github.com/rchac/LibreQoS/issues/87 2022-09-12 10:44:48 -06:00
ShapedDevices.example.csv Make Mbps explicit 2022-10-20 15:14:24 -06:00

README.md

v1.2 (IPv4 + IPv6) (Stable)

LibreQoS

Installation Guide

Features

  • Support for multiple devices per subscriber circuit. This allows for multiple IPv4s to be filtered into the same queue, without necessarily being in the same subnet.

  • Support for multiple IPv4s or IPv6s per device

  • Reduced reload time by 80%. Actual packet loss is <25ms on reload of queues.

  • Command line arguments --debug, --verbose, --clearrules and --validate.

  • lqTools.py - change-circuit-bandwidth, change-circuit-bandwidth-using-ip, show-active-plan-from-ip, tc-statistics-from-ip

  • Validation of ShapedDevices.csv and network.json during load. If either fails validation, LibreQoS pulls from the last known good configuration (lastGoodConfig.csv and lastGoodConfig.json).

ShapedDevices.csv

Shaper.csv is now ShapedDevices.csv

New minimums apply to upload and download parameters:

  • Download minimum must be 1Mbps or more
  • Upload minimum must be 1Mbps or more
  • Download maximum must be 2Mbps or more
  • Upload maximum must be 2Mbps or more

ShapedDevices.csv now has a field for Circuit ID. If the listed Circuit ID is the same between two or more devices, those devices will all be placed into the same queue. If a Circuit ID is not provided for a device, it gets its own circuit. Circuit Name is optional, but recommended. The client's service loction address might be good to use as the Circuit Name.

IPv6 Support

Full, XDP accelerated made possible by @thebracket

UISP Integration

This integration fully maps out your entire UISP network. Add UISP info under "Optional UISP integration" in ispConfig.py

To use:

  1. Delete network.json and, if you have it, integrationUISPbandwidths.csv
  2. run python3 integrationUISP.py

It will create a network.json with approximated bandwidths for APs based on UISP's reported capacities, and fixed bandwidth of 1000/1000 for sites. You can modify integrationUISPbandwidths.csv to correct bandwidth rates. It will load integrationUISPbandwidths.csv on each run and use those listed bandwidths to create network.json. It will always overwrite ShapedDevices.csv on each run by pulling devices from UISP.

UISP Integration - IPv6 Support

This will match IPv4 MAC addresses in the DHCP server leases of your mikrotik to DHCPv6 bindings, and include those IPv6 addresses with their respective devices.

To enable:

  • Edit mikrotikDHCPRouterList.csv to list of your mikrotik DHCPv6 servers
  • Set findIPv6usingMikrotik in ispConfig.py to True