### syncLMS-Multi-MikroTik-PPPoE zgodność z v1.0.2
### INFO


  Nazwa:              SyncLMS-Multi-MikroTik-PPPoE
  Wersja:             1.0.2
  Data wydania:       21-01-2021r.
  Autor:              Sebastian Szurgot (seszu@kazuko.pl)
  Strona autora:      https://kazuko.pl
  Strona projektu:    https://kazuko.pl/page/syncLMS-Multi-MikroTik-PPPoE
  Język skryptu:      Perl
  System Operacyjny:  Był testowany na: Debian 8, 9 lub 10 (nie oznacza, że na innych systemach nie będzie działał skrypt)
  Mikrotik RouterOS:  Był testowany na: 6.46.7 oraz 6.47.4 (nie oznacza, że na innych wersjach nie będzie działał skrypt)
  LMS:                wersja LMSDB: od 2017051201 do 2020121400 (w przypadku innych wersji proszę o kontakt)
  Opis:               Skrypt ma za zadanie dodawanie, edycje oraz usuwanie wpisów na wielu Mikrotik`ach w ppp > secret na podstawie LMS`a (LAN Management System).


## Funkcje:
- możliwość ustawienia więcej niż jednego MikroTik`a do synchronizacji
- dodawanie, edycje oraz usuwanie wpisów w ppp > secret na podstawie LMS`a (LAN Management System)
- dodawanie danych klienta do komentarza na Mikrotiku
- synchronizacja co minutę lub na żądanie
- połączenie po przez API lub API z SSL (połączenie SSL jest testowe, czasem może wystąpić błąd)
- proste logi synchronizacji
- wysyłanie logów na maila
- wielowątkowe uruchomienie skryptu
- możliwość włączenia dodawania adresu IP do listy pppoe-DynamicLMS w ip > firewall > address-list adresów, które także będą w ppp > secret
- możliwość określenia sieci IP, które będą brane pod uwagę 
- możliwość ustawienia własnej nazwy profilu PPP lub ustawienia jako ID lub NAZWA sieci (z LMSa) adresu IP komputera



## Skrypt aktywuje synchronizacje, jeśli:
 - jest dodany argument --force lub -f
 - zmieni się w komputerze: 
   - IP
   - MAC
   - sprawdzanie MAC
   - nazwa
   - hasło 
   - adres/położenie
   - status (podłączony/odłączony)
   - zmieni się klient do którego jest przypisany komputer
 - zostanie usunięty komputer
 - zmieni się w kliencie: 
   - imie
   - nazwisko lub nazwa firmy
   - adres
   - miejscowość
   - stan klienta na podłączony lub na inny niż podłączony
 - zmieni się w zobowiązaniu: 
   - taryfa
   - zaznaczony/odznaczony komputer
 - zostanie usunięte zobowiązanie
 - zobowiązanie ulegnie przeterminowaniu
 - typ taryfy ulegnie zmianie



## Komputer/wpis zostanie dodany jeśli:
 - komputer:
   - będzie przypisany do klienta
   - status będzie ustawiony na podłączony
   - będzie przypisany do zobowiązania
 - stan klienta będzie ustawiony na podłączony
 - zobowiązanie będzie aktywne
 - typ taryfy będzie ustawiony na 1, czyli internet


Ze względu, że w Mikrotiku można przypisać tylko jeden adres MAC do adresu IP to będzie brany pod uwagę pierwszy dodany adres MAC w LMS-ie.