Konfigurace iFIS klienta

Z BBM Dokumentace iFIS
Skočit na navigaciSkočit na vyhledávání

Nastavení lze provádět v konfiguračním textovém souboru formátu JSON přímo na aplikačním serveru WLS nebo jej lze provádět pomocí speciální webové stránky, která poskytuje několik funkcí pro manipulaci s konfiguračními soubory. Jedná se o následující funkce:

  • Download konfiguračních souborů z aplikačního serveru na lokální PC.
  • Zašifrování textu prostředky aplikačního serveru, používá se hlavně pro bezpečné uložení hesel v konfiguračním souboru.
  • Test JSON syntaxe lokálního konfiguračního souboru.
  • Upload konfiguračního souboru z lokálního PC na aplikační server. Pozn.: Soubor se pouze zkontroluje a uloží na aplikační server. Nezavede se do paměti serveru a není tak k dispozici klientům.
  • Reload konfigurace do paměti serveru.
  • Zobrazení konfigurace uložené v paměti serveru.


Přístup vyžaduje admin oprávnění na WLS server a URL konfigurační stránky je:

https://<server>:7142/ConfigManagementService


RTENOTITLE


Některé funkce se dají ve web prohlížeči spustit přímo zadáním URL. Příklady URL pro:

  • Zobrazení
    https://<server>:7142/ConfigManagementService/ManageConfigServlet?operation=show
  • Načtení do paměti
    https://<server>:7142/ConfigManagementService/ManageConfigServlet?operation=reload


Ukázka zobrazení nastavení ve webovém prohlížeči.

RTENOTITLE


Způsob získávání konfigurace

Klient získá svou konfiguraci následovně:

  1. serveru pošle své identifikační údaje
  2. server rekurzivně projde hierarchii nastavení
  3. postupně sestaví množinu vyhovujících nastavení
    • postupuje od obecných hodnot (od kořene)
    • upřesňuje/přepisuje hodnotami specifickými (k listům)


CliConf schema.png

Konfigurační soubor a jeho struktura

Vlastní JSON soubor představuje hierarchický objekt. Jednotlivé úrovně jsou uspořádány podle požadovaného způsobu vyhodnocování identifikačních údajů z klientské stanice:

  • "sid:<ID databáze>" - označení připojované databáze
  • "ip:<IP subnet|IP range|IP adresa>" - IP adresa klienta
  • "mac:<MAC adresa>" - MAC adresa klienta
  • "env:<hodnota>" - hodnota proměnné IFIS_DESKTOP_ID v prostředí operačního systému na PC

Hodnoty nastavení modulu jsou navázané k příslušné úrovni identifikace:

  • "config:<název sekce konfigurace>" - konfigurace pro daný modul
  • následují parametry pro daný modul
    • "<název parametru>": "<hodnota parametru>"


Tip Tip
Záměrně se používá JSON parser, který umožňuje okomentovat data a nevyžaduje striktní JSON syntaxi. Jednoslovné názvy parametrů nemusí být v uvozovkách.

Komentáře se zapisují:

//text do konce řádku

nebo

/* text uvnitř */


Varování Varování
Pozor, na konkrétní dané úrovni hierarchie nemusí být vyhodnocovány identifikačních údaje v pořadí, jak byly zadány v definičním souboru.

To musí být zohledněno při návrhu hierarchické struktury.


Příklad jak vypadá JSON konfigurační soubor, zvýrazněné oblasti nastavení naznačují, jakým způsobem se skládá nastavení diagnostiky klienta pro klienta na IP adrese 172.29.0.27.

CliConf json.png

Podrobný popis parametrů

Názvy označení jednotlivých modulů, jejich parametrů a povolených hodnot jsou součástí následující dokumentace Konfigurace iFIS klienta - parametry.