Konfigurace iFIS klienta: Porovnání verzí

Z BBM Dokumentace iFIS
Skočit na navigaciSkočit na vyhledávání
Jpom (diskuse | příspěvky)
Bez shrnutí editace
Jpom (diskuse | příspěvky)
Bez shrnutí editace
 
(Není zobrazeno 6 mezilehlých verzí od stejného uživatele.)
Řádek 1: Řádek 1:
Momentálně se nastavení provádí v textovém souboru formátu JSON na aplikačním serveru WLS. Záměrně se používá JSON parser, který umožňuje komentovat data a nevyžaduje striktní JSON syntaxi. Na konfiguraci se dá nahlížet web prohlížečem, změna se provede editací konfiguračního souboru na serveru a pomocí prohlížeče se provede test a načtení do paměti serveru. Přístup vyžaduje ''admin ''oprávnění na WLS.
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:


Příklady URL pro:
*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.
<br/>Přístup vyžaduje ''admin'' oprávnění na WLS server a URL konfigurační stránky je:<br/><pre>https://&lt;server&gt;:7142/ConfigManagementService</pre>


*Zobrazení<br/><pre>https://&lt;server&gt;:7142/ConfigService/ManageConfigServlet</pre>
<br/>[[File:CliConf console.png|RTENOTITLE]]


*Test<br/><pre>https://&lt;server&gt;:7142/ConfigService/ManageConfigServlet?operation=test</pre>
<br/>Některé funkce se dají ve web prohlížeči spustit přímo zadáním URL. Příklady URL pro:
 
*Načtení<br/><pre>https://&lt;server&gt;:7142/ConfigService/ManageConfigServlet?operation=reload</pre>


*Zobrazení<br/><pre>https://&lt;server&gt;:7142/ConfigManagementService/ManageConfigServlet?operation=show</pre>


*Načtení do paměti<br/><pre>https://&lt;server&gt;:7142/ConfigManagementService/ManageConfigServlet?operation=reload</pre>




Řádek 33: Řádek 39:
= Konfigurační soubor a jeho struktura =
= 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ů:
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:&lt;ID databáze&gt;" - označení připojované databáze
*"sid:&lt;ID databáze&gt;" - označení připojované databáze
*"ip:&lt;IP subnet|IP range|IP adresa&gt;" - IP adresa klienta
*"ip:&lt;IP subnet|IP range|IP adresa&gt;" - IP adresa klienta
*"mac:&lt;MAC adresa&gt;" - MAC adresa klienta
*"mac:&lt;MAC adresa&gt;" - MAC adresa klienta
*"env:&lt;hodnota&gt;" - dle hodnoty prom. IFIS_DESKTOP_ID
*"env:&lt;hodnota&gt;" - hodnota proměnné IFIS_DESKTOP_ID v prostředí operačního systému na PC


Hodnoty nastavení modulu jsou umístěné vždy na dané úrovni:
Hodnoty nastavení modulu jsou navázané k příslušné úrovni identifikace:


*"config:&lt;název sekce konfigurace&gt;" - konfigurace pro daný modul
*"config:&lt;název sekce konfigurace&gt;" - konfigurace pro daný modul
Řádek 46: Řádek 52:
**"&lt;název parametru&gt;": "&lt;hodnota parametru&gt;"
**"&lt;název parametru&gt;": "&lt;hodnota parametru&gt;"


{{Tip|Jednoslovné názvy parametrů nemusí být v uvozovkách.<br/>
<br/>{{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.<br/>
Komentáře se zapisují:
Komentáře se zapisují:
  //text do konce řádku
  //text do konce řádku
Řádek 55: Řádek 61:
To musí být zohledněno při návrhu hierarchické struktury.}}
To musí být zohledněno při návrhu hierarchické struktury.}}


Příklad jak vypadá JSON konfigurační soubor.
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.


[[File:CliConf json.png|749x961px|CliConf json.png]]
[[File:CliConf json.png|749x961px|CliConf json.png]]


= Podrobný popis parametrů =
= Podrobný popis parametrů =


Názvy označení jednotlivých modulů, jejich parametrů a povolených hodnot budou součástí následující dokumentace [[Konfigurace_iFIS_klienta_-_parametry|Konfigurace iFIS klienta - parametry]].
Názvy označení jednotlivých modulů, jejich parametrů a povolených hodnot jsou součástí následující dokumentace [[Konfigurace_iFIS_klienta_-_parametry|Konfigurace iFIS klienta - parametry]].
[[Category:Koncové PC]]

Aktuální verze z 20. 1. 2017, 11:06

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.