===4.3.19. lms-teryt===

Skrypt służący do importu i aktualizacji danych bazy TERYT. Zawiera również możliwość pobrania plików bazy z Internetu, a także procedurę przypisywania identyfikatorów TERYT do istniejących komputerów, które mają zdefiniowany adres ale nie mają przypisanego TERYTu. 

Skrypt zawiera następujące opcje uruchomieniowe, które można łączyć:

-f, --fetch

Włącza procedurę pobierania (i rozpakowania) plików bazy TERYT z Internetu. Wymagane jest umożliwienie połączenia HTTP z serwerem określonych w opcji 'url' oraz zainstalowanie programu unzip.

-l, --list=<lista>

Zawęża działanie opcji importu/aktualizacji do określonych województw. Podobnie jak w opcji konfiguracyjnej 'state_list' podajemy tutaj numeryczne identyfikatory oddzielone przecinkami. Ze względu na duży rozmiar całej bazy, wskazane jest ograniczenie się tylko do wybranych województw. Identyfikatory można znaleźć w pliku TERC.xml. 
  2 - dolnośląskie
  4 - kujawsko-pomorskie
  6 - lubelskie
  8 - lubuskie
  10 - łódzkie
  12 - małopolskie
  14 - mazowieckie
  16 - opolskie
  18 - podkarpackie
  20 - podlaskie
  22 - pomorskie
  24 - śląskie
  26 - świętokrzyskie
  28 - warmińsko-mazurskie
  30 - wielkopolskie
  32 - zachodniopomorskie
  
-u, --update

Import danych do bazy LMSa. Jeśli baza była już wcześniej importowana, nastąpi aktualizacja bazy.

-m, --merge

Przypisanie identyfikatorów TERYT dla komputerów/urządzeń, które nie zostały jaszcze przypisane, ale posiadają wpisany adres lokalizacji. Algorytm jest dość prosty i nie ma pewności, że wszystkie adresy zostaną rozpoznane.

Konfigurację tego skryptu zawiera sekcja [teryt] w pliku lms.ini: 

  * url
Adres strony pobierania plików bazy TERYT. Domyślnie zawiera poniższy link.
Przykład: url = http://www.stat.gov.pl/broker/access/prefile/listPreFiles.jspa

  * dir
Katalog w którym, są przechowywane rozpakowane pliki (xml) bazy TERYT. W tym katalogu zostaną też zapisane pobrane pliki. Domyślnie: katalog uruchomienia skryptu.
Przykład: dir = /var/lib/teryt

  * unzip_binary
Lokalizacja programu unzip. Domyślnie: /usr/bin/unzip.
Przykład: unzip_binary = /sbin/unzip

  * state_list
Lista identyfikatorów województw, oddzielonych przecinkami, które będą brane pod uwagę podczas importu. W celu minimalizacji rozmiaru bazy danych i czasu działania skryptu najlepiej ograniczyć się do wybranych województw.
Przykład: state_list = 2

-o, --only-unique-city-matches

Uaktualnia lokalizację TERYT tylko wtedy, gdy nazwa miasta z lokalizacji jest unikalną miejscowością w bazie danych TERYT.