AppServerProp.exe

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.

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.

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. nebylo 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é nasadit logová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í ABRA Gen) 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ř. abragen.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 ABRA Gen.
Název počítače	Název počítače, kde je spuštěn systém ABRA Gen.
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 ABRA Gen pro Firebird je handle MON$ATTACHMENT_ID v tabulce MON$ATTACHMENTS, u ABRA Gen 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:

ZrušitObčerstvit

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.
• Občerstvit - Pro provedení občerstvení zobrazeného seznamu.

  Občerstvení je možno vyvolat i volbou z menu.

Dále obsahuje subzáložky:

Subzáložka Spojení na aplikační server

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í.

Subzáložka Moduly

Ve spodním okně seznam licencovaných modulů, jejichž licence čerpá aktuální uživatel (na němž stojí kurzor). Dále viz Licencované celky (licencované moduly a vlastnosti). 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 ABRA Gen 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 ABRA Gen 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 ABRA Gen. 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.

Subzáložka Logy

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áva 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:

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
• Uživatelé čerpající licenci modulu

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 ABRA Gen, 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á ABRA Gen" (protože jen ta "nově aktivovaná ABRA Gen má aktualizovaného lic. managera), nevidí je ani AppServerProp, ani jiná spuštěná instance systému ABRA Gen.)

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

Informace zobrazované v agendě Správa licencí na záložce Licence Vizualizace dat není možné v AppServerProp získat, proto tato záložka není v AppServerProp obsažena.

Záložka Vizualizace dat

Záložka Vizualizace dat slouží k zobrazení logu Vizualizace dat. Dále jsou v horní části této záložky k dispozici následující funkce:

Název	Popis
Spustit	Funkce pro spuštění Vizualizace dat (tj. spuštění Javy).
Zastavit	Funkce pro zastavení Vizualizace dat (tj. ukončení Javy).
Restartovat	Funkce pro restart Vizualizace dat (tj. restart Javy).

Funkce Spustit, Zastavit a Restartovat je možné chránit heslem. Toto heslo je společné i pro všechny chráněné nástroje (DBAdmin.exe, StorExpl.exe atp.), takže pokud již bylo někde zadáno, platí i pro tyto funkce. 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.

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 - obsahuje funkce pro ukončení nástroje
• volba Zobrazení - obsahuje funkce pro občerstvování seznamu:
  • Občerstvit - vyvolá jednorázové občerstvení zobrazených údajů.
  • Rychlost občerstvení - nastaví interval občerstvování. Obsah záložek, kde má občerstvování smysl (Spojení a Licence) se mohou periodicky občerstvovat v nastaveném intervalu, případně je možné občerstvování pozastavit.

• volba Funkce obsahuje následující položky:

  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ěří propustnost sítě. Parametrem je počet posílaných bajtů. DiscoverPrimes - hledání prvočísel, měří výkon CPU. Parametry jsou spodní a volitelně horní hranice intervalu celých čísel, ve kterých se prvočísla hledají. SQL - měří výkonnost databázové vrstvy. Parametrem je SQL příkaz. BO Load - měří dobu nahrání Business objektu. Úloze generující zátěž se předá jako parametr persistentní CLSID (výchozí hodnotou je persistentní CLSID adresáře firem). Úloha následně načte seznam ID z tabulky a operací Load 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í. Všechny funkce je možné alternativně spouštět také z příkazové řádky, viz popis parametru perf v následující sekci.

  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 ]

AppServerProp help

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

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