AppServerProp.exe

Defaultně dodávaný exe soubor. Jedná se o nástroj AppServer Properties určený pro sledování a případnou administraci spojení klientů s aplikačním serverem. Tento nástroj je určen především servisním konzultantům a správcům systému. Běžný uživatel tento nástroj ke své práci nebude potřebovat.

Pomocí tohoto nástroje lze např.:

  • Prohlížet seznam aktuálních spojení na aplikační server a informace o čerpaných licencích.
  • Zrušit spojení - pomocí lokálního menu na pravém tlačítku myši nebo pomocí tlačítka Zrušit je možno každé spojení násilím rozpojit. To pomůže tehdy, pokud by na serveru "visela" spojení, ke kterým už dlouho neexistují klienti (k této situaci by sice docházet běžně nemělo, nicméně může se stát).
  • Prohlížet logy ukládané do paměti aplikačního serveru
  • Spouštět zátěžové testy.

Záložka Monitor - informace o časech posledního spuštění aplikačního serveru a informace o stanici.

Záložka Klienti - informace o názvech stanic, z nichž bylo spojení provedeno, čase vytvoření spojení, o poslední aktivitě apod.

Záložka Licence - informace o čerpání licencí, především špiček v čerpání licencí.

Záložka Vizualizace dat - zobrazuje logy Vizualizace dat a Vizualizaci dat zde lze restartovat.

Záložka Zatížení - zobrazí výsledky napočtené po spuštění funkce Generování zatížení.

Záložka Měření - zobrazí výsledky napočtené po spuštění funkce Měření aplikačního serveru

Nástroj se využívá zejména v síťových instalacích. V nesíťové instalaci je možné jej spustit, ale je dostupná pouze část funkcionality, která má při provozu bez aplikačního serveru význam (například zátěžové testy).

Jelikož se jedná o jeden z nástrojů, které při neznalém použití mohou mít destruktivní následky nebo u nichž není žádoucí, aby s nimi pracoval běžný uživatel, je možno provedení některých jeho funkcí chránit bezpečnostním heslem.

Kontroluje se funkce Generování zatížení a funkce Zrušit.

Po vyvolání akce chráněné heslem program nejdříve zkontroluje, zda pro danou instalaci již bylo bezpečnostní heslo zadáno. Heslo je pro všechny chráněné nástroje společné. Pokud heslo dosud v dané instalaci nebylo zadáno v rámci spuštění některého z chráněných nástrojů či jeho chráněné funkce, program na tuto skutečnost upozorní a nabídne možnost jej zadat.

Zadání hesla není povinné, ale v každém případě jej doporučujeme využívat. Můžete tak předejít nežádoucím manipulacím např. ze strany neznalé osoby, které mohou pro váš systém mít i značně destruktivní následky.

Pokud bezpečnostní heslo pro spouštění nástrojů bylo v rámci spuštění některého z chráněných nástrojů v dané instalaci již zadáno, zobrazí se přihlašovací dialog do nástrojů, v němž se uživatel musí přihlásit zadáním bezpečnostního hesla. Po stisku OK se ověřuje jeho správnost. Nebylo-li heslo zadáno správně, program umožní uživateli opětovné zadání jména a hesla (např. pro případ překlepu). Pokud ani opakovaně není heslo zadáno správně, program danou akci neprovede (totéž po vyvolání Storna z přihlašovacího dialogu). Bylo-li přihlášení úspěšné, program pokračuje dál v příslušné akci.

Údaje jsou uspořádány do subzáložek:

Záložka Monitor

První stránka, která se zobrazí po spuštění nástroje. Jedná se o jednoduchý monitoring časů od posledního spuštění aplikačního serveru. Dále se zobrazuje informace o stanici, portu, IP adrese a informací pro telemetrii.

Příklad zobrazení informací o čase posledního spuštění

Záložka Klienti

Na záložce Klienti jsou informace o názvech stanic, z nichž bylo spojení provedeno, čase vytvoření spojení, informace o poslední aktivitě apod.

Příklad zobrazení o spojeních. Čerpané licence modulů daným uživatelem v rámci daného spojení jsou viditelné na subzáložce Moduly, viz dále.

Význam položek je zřejmý z jejich názvu, blíže se zmíníme pouze o následujících položkách:

Název Popis
Stav

Stav spojení. Stav může nabývat následujících hodnot:

  • Aktivní - označuje vytvořené vlákno, tj. takové, které může buď provádět nějaký požadavek od klienta nebo čekat na požadavek.
  • Odpojuje se - označuje vlákno, kterému se nastavil příznak, aby se odpojilo (např. funkcí Zrušit). Vlákno jako takové se musí samo ukončit. Když se ukončí, zmizí ze seznamu. To může trvat různě dlouho v závislosti na tom, co dělá nebo pokud nezamrzlo.
  • Neaktivní - označuje vlákno, které není aktivní, tj. které neprovádí žádný požadavek od klienta a více než 10 sekund tzv. netiklo ve smyčce. Neboli vlákno, které zamrzlo v nějaké jiné části kódu, než ve zpracování požadavku od klienta. Teoreticky takový stav může nastat i pokud je server přetížený a nestíhá vláknům přidělovat čas procesoru v rámci 10ti sekund. Každopádně pokud by takový stav na spojení trval delší dobu, jedná se o vnitřní problém aplikačního serveru a bylo by vhodné nasaditlogování [Log.ExceptionHook]

Jednotlivé stavy jsou odlišeny různým podbarvením řádků.
Uživatelské jméno

Uživatelské jméno přihlášeného uživatele. Obsah položky Přihlašovací jméno z agendy Uživatelé.
Název spojení

Název spojení definovaný při vytváření databáze. Viz obsah položky Název spojení v nástroji DBAdmin.
Poslední aktivita

Poslední aktivita ukazuje čas, kdy naposled začal server pro konkrétního klienta "něco dělat". Pozor, tato činnost vyžadovaná klientem nemusí nutně souviset s fyzickou činností uživatele přihlášeného do systému ABRA. Čili nezaměňujte ji za poslední aktivitu uživatele pracujícího z daného spuštěného klienta systému ABRA. Sleduje se aktivita mezi klientem (ne uživatelem, ale spuštěnou instancí IS FLORES) a serverem. Může se jednat i o nějakou automatickou činnost probíhající v pravidelných intervalech na pozadí. Takovou činností může být nějaké pravidelné dotazování vyvolané např. nějakou úlohou ze skriptování udělanou na míru v dané instalaci apod.

Takovou činností bylo ve v. 9.02 např. i pravidelné dotazování klienta na existenci případných vzkazů pro přihlášeného uživatele.

V praxi se ukázalo jako vhodné eliminovat toto automatické dotazování na aplikační server (zjišťování zpráv) od jiné aktivity klienta. (Aby správci systému mohli tento nástroj např. využít pro násilné odpojení uživatelů, kteří již dlouho žádnou činnost neprovedli a blokují zbytečně licence (ráno se přihlásili a pak např. bez odhlášení odešli)). Proto je tato činnost od v. 9.03 řešena jiným způsobem a do sledování času poslední aktivity klienta se nezapočítává.

Do měření času poslední aktivity klienta se dále nezahrnují zprávy LifeNotification (dotazy aplikačního serveru na životnost klienta, na které klient odpovídá). Pokud by klient odpadl (klient přestal reagovat, "vytuhl"), tak je spojení po nějaké době automaticky ukončeno (defaultně 6 minut, jinak dle nastavení parametru KeepAliveTime v nexus.cfg). Pokud klient odpovídá a zasílá dotazy na aplikační server, tak se jedná o aktivní činnost klienta.
Poslední aktivita uživatele

Sloupec zobrazuje čas posledního dotazu na AppServer, který vykonal přímo uživatel (nebo uživatelem aplikované nastavení - např. automatické aktualizace).
Program

Identifikace spuštěného programu (.exe) a cesta k němu. Tj. např. flores.exe, AppServerProp.exe, AutoSercer.exe apod.
PID programu PID procesu, který je přidělen prostředky Windows.
Cesta k programu Kompletní cesta k aplikaci IS FLORES.
Název počítače Název počítače, kde je spuštěn systém IS FLORES.
Jméno

Jméno uživatele (v operačním systému) přihlášeného k aplikačnímu serveru. Uživatel, který spustil samotný AppServerProp je též v seznamu spojení jako jeden z uživatelů přihlášených k App Serveru.

Jaký program má uživatel spuštěn, je vidět dále v položkách Program a Cesta k programu.
TCP počet volání Položky zobrazují přijaté/odeslané bajty ze síťové komunikace počítané serverem a počet požadavků TCP na jednotlivých spojeních.
TCP přijato (B)
TCP odesláno (B)
DB handle

Databázový handle uživatele - co handle, to jedno spojení do databáze. Pomocí "handlu" lze spojení v databázi identifikovat.

Např. u IS FLORES pro Firebird je handle MON$ATTACHMENT_ID v tabulce MON$ATTACHMENTS, u IS FLORES pro Oracle je handle je AUDSID.
Thread ID

Identifikace vlákna (threadu). Tyto položky se zobrazují pouze v subzáložce Spojení na aplikační server.
Thread ID Hex

Seznam podporuje řazení a to pomocí kliknutí na hlavičku sloupce. Dále lze zatržením nastavit automatické občerstvování. Občerstvit lze i ručně (viz funkce lokálního menu).

Pod editovatelným seznamem adresátů je k dispozici lišta navigátoru:

Navigátor v této záložce

Navigátor v této záložce obsahuje tlačítka:

  • Pro pohyb kurzoru po řádcích (na začátek, předchozí řádek, další řádek, na konec) editovatelného seznamu
  • Zrušit - Funkce ukončí spojení z aktuálního řádku (na němž stojí kurzor). Funkce je chráněna heslem. Heslo je vyžadováno jen při prvním zavření spojení, opakované vyvolání funkce již heslo nevyžaduje.
  • Aktualizovat - Pro provedení aktualizace zobrazeného seznamu.

    Aktualizaci je možno vyvolat i volbou z menu.

Dále obsahuje subzáložky:

Podobně jako záložka Klienti zobrazuje informace o jednotlivých spojeních, které vytvoří klient do aplikačního serveru. Kromě již popsaných informací na záložce Klienti tato subzáložka obsahuje i další sloupečky, jejichž význam si popíšeme.

Podpůrné - Pokud je u tohoto spojení sloupec Podpůrné zatržen znamená to, že bylo vytvořeno podpůrné spojení. Takové může vygenerovat asynchronní funkce pro zobrazení hodnot na panelu definovatelných údajů, více viz kapitola Technická specifikace panelu definovatelných údajů

Stav - stav byl popsán na záložce Klienti, nicméně zde se vyskytuje stav Statistická data. Řádek s takovým stavem je čistě systémový a slouží k zobrazení informací o již ukončených podpůrných a případně dalších spojení.

Ve spodním okně seznam licencovaných modulů, jejichž licence čerpá aktuální uživatel (na němž stojí kurzor). Samotný spuštěný AppServerProp samozřejmě žádnou licenci na některý z modulů nečerpá. Dále viz Čerpání licencí jádra.

Pozor, pokud je uživatel přihlášen v IS FLORES jako uživatel A a otevře agendu jako uživatel B (viz otevření agendy v novém okně jako jiný uživatel), je v přehledu uživatelů zobrazeno, že tuto licenci čerpá uživatel A - ten, co je do IS FLORES přihlášen primárně.

Možnost sledovat u jednotlivých modulů, který uživatel čerpá licenci vybraného modulu, viz též agenda Správa licencí v IS FLORES. Dále viz též Možnosti sledování čerpání licencí.

Možnost sledovat čerpané licencované moduly jednotlivými uživateli může být užitečná např., pokud došlo k vyčerpání licencí na nějaký modul a potřebujeme zjistit, kdo licence na konkrétní modul obsadil a koho oslovit, aby modul opustil.

Zobrazuje logy uložené v paměti na aplikačním serveru. Pokud je logování zapnuto (pomocí parametrů v sekci [Logs]) a pokud je nastaveno logování do paměti. Zda logovat do souboru nebo do paměti (příp. obojí) a kolik posledních zápisů do logu uchovávat, lze nastavit pomocí parametrů Target a MemoryMaxLogCount. Více viz kap. Logování běhu aplikace.

Záložka Licence

Na záložce Licence jsou zobrazeny monitorované informace o stavu čerpání licencí především z pohledu sledování špiček v čerpání licencí jednotlivých licencovaných celků.

V horní části této agendy je k dispozici seznam prvků, které nesou informaci o stavu vaší licence

Název Popis
Obchodní jméno majitele licence

Význam jednotlivých položek viz stejnojmenné položky v agendě Správce licencí.

Jediný rozdíl je v položce Aktivováno, kterou v AppServerProp není možné získat, tudíž je zde zobrazován text Údaj je zde nedostupný.

 
Aktivováno
Verze
Počet aktivních stanic
Počet firem

Dále obsahuje subzáložky:

Obsažené subzáložky: Licencované moduly a vlastnosti Licencovamé doplňky

Subzáložka Licencované moduly a vlastnosti

Subzáložka obsahuje stejné informace jako stejnojmenná subzáložka Licencované moduly a vlastnosti v agendě Správce licencí. Tj. obsahuje dva seznamy:

Licencované moduly a vlastnosti

Název Popis
Modul/Vlastnost

Význam jednotlivých položek viz stejnojmenné položky v subzáložce Licencované moduly a vlastnosti v agendě Správce licencí.

Hodnota
Platnost do
Špička
Naposledy začala
Celkově trvala
Nedostupnost

K hodnotám zobrazeným v této záložce: Tyto hodnoty se "cachují" na aplikačním serveru, odkud si je nástroj AppServerProp stáhne. Nejsou perzistentní. Z toho také plyne, že zobrazené údaje jsou relevantní k času posledního startu aplikačního serveru.

Po změně licence, tj. po nahrání nového lic. klíče do IS FLORES, je potřeba AppServerPro restartovat, aby se zaktualizovaly položky Platnost do a jiné parametry zde zobrazené. (Důvodem je to, že nové údaje z nové licence vidí jen tato "nově aktivovaná IS FLORES" (protože jen ta "nově aktivovaná IS FLORES má aktualizovaného lic. managera), nevidí je ani AppServerProp, ani jiná spuštěná instance systému IS FLORES.)

Dále viz též Možnosti sledování čerpání licencí

Uživatelé čerpající licenci modulu

Význam jednotlivých položek viz stejnojmenné položky v subzáložce Licencované moduly a vlastnosti, seznam Uživatelů čerpajících licenci modulu v agendě Správce licencí.

Subzáložka Licencované doplňky

Subzáložka obsahuje stejné informace jako stejnojmenná subzáložka Licencované doplňky v agendě Správce licencí.

Název Popis
Doplněk

Význam jednotlivých položek viz stejnojmenné položky v záložce Licencované doplňky v agendě Správce licencí.

 
Hodnota
Platnost do

Záložka Zatížení

Záložka zobrazí výsledky napočtené po spuštění funkce Generování zatížení.

Příklad vzhledu záložky Zatížení

V horní části je menu, pomocí něhož lze vybrat spojení (je-li definováno jen jedno, vybere se automticky, jinak se zobrazí dialog na výběr spojení), úlohu nastartovat, stopnout a vyčistit výsledky.

V levé části v sekci Úlohy jsou jednotlivé typy funkcí, které jsou k dispozici.

Ve spodní části v sekci Parametry lze měnit parametry pro úlohu, na níž stojí kurzor.

V pravé části se zobrazují napočtené výsledky.

 

Záložka Měření

Podobně jako záložka Zatížení zobrazuje data z měření napočtené po spuštění funkce Měření aplikačního serveru. Měření obsahuje i stejné testy, avšak je přesnější.

Příklad vzhledu záložky Měření

V horní části je menu, pomocí něhož lze vybrat spojení (je-li definováno jen jedno, vybere se automticky, jinak se zobrazí dialog na výběr spojení), úlohu nastartovat, stopnout a vyčistit výsledky.

V levé části v sekci Úlohy jsou jednotlivé typy funkcí, které jsou k dispozici.

Ve spodní části v sekci Parametry lze měnit parametry pro úlohu, na níž stojí kurzor.

V pravé části se zobrazují napočtené výsledky.

  • volba Soubor - funkce pro ukončení nástroje
  • volba Zobrazení - podvolby pro aktualizaci
    • Aktualizovat - funkce pro ruční vyvolání aktualizace zobrazených údajů.
    • Rychlost aktualizace - nastavení konfigurace intervalu aktualizování. Refresh je automatický (jej pozastavit) a pouze na záložkách, kde má smysl (Spojení a Licence).

  • popis volby Funkce viz dále Funkce k tomuto nástroji

Název Doplňující popis:
Generování zatížení

Funkce pro generování umělé zátěže aplikačního serveru včetně vyhodnocování výsledků.

Zatím jsou k dispozici následující typy úloh (v případě potřeby mohou být postupně doplňovány další):

  • Echo - (chová se jako TCP echo), měří přenos sítě (network)
  • DiscoverPrimes - (vyhledává prvočísla), měří CPU
  • SQL - měří DB vrstvu
  • Load DB - měří dobu nahrání Business objektu. Úloha pracuje tak, že se jí předá persist CLSID (výchozí hodnota je adresář) a zátěž používá operaci Load. Úloha, než se rozeběhne, načte seznam ID z tabulky a následně načítá jeden řádek za druhým.

Kliknutím na sloupec lze úlohy řadit.

Po spuštění funkce se zobrazí záložka Zatížení, kde lze spouštět jednotlivé testovací úlohy, měnit jim parametry a kontrolovat výsledky měření.
Název Doplňující popis:
Měření aplikačního serveru

Funkce pro generování umělé zátěže aplikačního serveru včetně vyhodnocování výsledků. Jedná se o přesnější měření než funkce Generování zátěže.

Jednotlivé typy úloh jsou však shodné s touto funkcí, proto zde již nejsou samostatně popsány.

Nástroj podporuje také spouštění s parametry příkazové řádky. Syntaxe je následující:

AppserverProp [ password <heslo> ] [ connection <spojení na databázi> ] <příkaz> [ argumenty ]

Podporované parametry
Název Popis Příklady použití
help Zobrazí dialogové okno s přehledem podporovaných parametrů příkazové řádky. 
AppServerProp help
perf

Spustí některou z funkcí ze skupiny Generování zatížení (ve vizuálním režimu, tj. stejným způsobem, jako kdyby byla funkce vyvolána ručně z menu). Dostupné funkce:

  • Echo <NumberOfBytes>
  • Prime <Min> [<Max>]
  • SQL <SQL command> | <SQL file>
  • BOLoad <PersistCLSID> 

AppServerProp password pass123 connection Demo perf echo 1200

 

AppServerProp password pass123 connection Demo perf prime 5 100

 

AppServerProp password pass123 connection Demo perf boload {5B0190E1-BCCA-11D1-950D-0000E8D78F59}

 

AppServerProp password pass123 connection Demo perf sql "select count(*) from firms"

 

AppServerProp password pass123 connection Demo perf sql C:\test.sql
export

Vyexportuje strukturované údaje o připojených klientech s počtem přenesených bytů do JSON souboru. Položky , které můžou mít víc hodnot se exportují ve formě JSON pole textů (usernames, connections, atd.). Časy se exportují podle ISO 8601 v UTC časovém pásmu.

Nebude-li součástí příkazu zadána cesta, kam se má soubor vyexportovat, export se provede přímo do adresáře s IS FLORES. 

AppServerProp password pass123 connection Demo -export="Cesta a název souboru pod kterým bude export uložen, např C:\Exporty\Export"