AppServerProp.exe

Defaultne dodávaný exe súbor. Ide o nástroj AppServer Properties určený na sledovanie a prípadnú administráciu spojení klientov s aplikačným serverom. K dispozici jsou i informace o čerpání licencí. Viď tiež Aktivácia a licencovanie systému. Tento nástroj je určený predovšetkým servisným konzultantom servisnej siete výrobcu a správcom systému. Bežný užívateľ tento nástroj k svojej práci nebude potrebovať.

Pomocou tohto nástroja je možné napr.:

  • Prohlížet seznam aktuálních spojení na aplikační server a informace o čerpaných licencích.
  • Zrušiť spojenie - pomocou lokálneho menu na pravom tlačidle myši alebo pomocou tlačidla Zrušiť je možné každé spojenie násilne rozpojiť. To pomôže napr. vtedy, ak by na serveri "viseli" spojenia, ku ktorým už dlho neexistujú klienti (k takejto situácii by síce bežne dochádzať nemalo, no môže sa to stať).
  • Prehliadať logy ukladané do pamäte aplikačného servera
  • 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 Licencia - informace o čerpání licencí, především špiček v čerpání licencí.

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

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

Záložka Meranie - 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).

Keďže ide o jeden z nástrojov, ktoré pri neznalom použití môžu mať deštruktívne následky alebo pri ktorých nie je žiadúce, aby s nimi pracoval bežný užívateľ, je možné prevedenie niektorých jeho funkcií chrániť bezpečnostným heslom.

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

Po vyvolaní akcie chránenej heslom program najprv skontroluje, či pre danú inštaláciu už bolo bezpečnostné heslo zadané. Heslo je pre všetky chránené nástroje spoločné. Pokiaľ heslo zatiaľ v danej inštalácii nebolo zadané v rámci spustenia niektorého z chránených nástrojov či jeho chránenej funkcie, program na túto skutočnosť upozorní a ponúkne možnosť ho zadať.

Zadanie hesla nie je povinné, ale v každom prípade ho odporúčame využívať. Môžete tak predísť nežiaducim manipuláciám napr. zo strany neznalej osoby, ktoré môžu mať pre váš systém aj značne deštruktívne následky.

Pokiaľ bezpečnostné heslo na spúšťanie nástrojov bolo v rámci spustenia niektorého z chránených nástrojov v danej inštalácii už zadané, zobrazí sa prihlasovací dialóg do nástrojov, v ktorom sa užívateľ musí prihlásiť zadaním bezpečnostného hesla. Po stlačení OK sa overuje jeho správnosť. Ak nebolo heslo zadané správne, program užívateľovi umožní opätovné zadanie mena a hesla (napr. v prípade preklepu). Pokiaľ ani opakovane nie je heslo zadané správne, program danú akciu nevykoná (rovnako po vyvolaní Storna z prihlasovacieho dialógu). Ak bolo prihlásenie úspešné, program pokračuje ďalej v príslušnej akcii.

Údaje sú usporiadané do subzáložiek:

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í

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ázov Popis
Stav

Stav spojení. Stav môže nadobúdať nasledujúce hodnoty:

  • Aktívny - označuje vytvorené vlákno, tzn. také, ktoré môže buď vykonávať nejakú požiadavku od klienta alebo čakať na požiadavku.
  • Odpája sa - označuje vlákno, ktorému sa nastavil príznak, aby sa odpojilo (napr. funkciou Zrušiť). Vlákno ako také sa musí samo ukončiť. Keď sa ukončí, zmizne zo zoznamu. To môže trvať rôzne dlho v závislosti na tom, čo robí alebo pokiaľ 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. Teda vlákno, ktoré zamrzlo v nejakej inej časti kódu, ako v spracovaní požiadavky od klienta. Teoreticky taký stav môže nastať i pokiaľ je server preťažený a nestíha vláknam prideľovať čas procesoru v rámci 10tich sekúnd. Každopádne pokiaľ by taký stav na spojenie trval dlhšiu dobu, ide o vnútorný problém aplikačného servera a bolo by vhodné nasadiť logovanie [Log.ExceptionHook]

Jednotlivé stavy sú odlíšené rôznym podfarbením riadkov.
Užívateľské meno

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, kedy naposledy začal server pre konkrétneho klienta "niečo robiť". Pozor, táto činnosť vyžadovaná klientom nemusí nutne súvisieť s fyzickou činnosťou užívateľa prihláseného do systému ABRA. Nezamieňajte si ju preto prosím s poslednou aktivitou užívateľa pracujúceho z daného spusteného klienta systému ABRA. Sleduje sa aktivita medzi klientom (nie užívateľom, ale spustenou inštanciou ABRA Gen) a serverom. Môže tiež ísť o nejakú automatickú činnosť, ktorá prebieha v pravidelných intervaloch na pozadí. Takou činnosťou môže byť napr. nejaké pravidelné dopytovanie vyvolané napr. nejakou úlohou zo skriptovania vytvorenou na mieru v danej inštalácii a pod.

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 sa ukázalo ako vhodné eliminovať toto automatické dopytovanie na aplikačný server (zisťovanie správ) od inej aktivity klienta. (Aby správcovia systému mohli tento nástroj využiť napr. na násilné odpojenie užívateľov, ktorí už dlhšiu dobu žiadnu činnosť nevykázali a blokujú zbytočne licencie (ráno sa prihlásili a neskôr napr. bez odhlásenia odišli)). Preto je od v. 9.03 táto činnosť riešená iným spôsobom a do sledovania času poslednej aktivity klienta sa nezapočítava.

Do merania času poslednej aktivity klienta sa ďalej nezahŕňajú správy LifeNotification (dopyty aplikačného servera na životnosť klienta, na ktoré klient odpovedá). 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). Ak klient odpovedá a posiela požiadavky na aplikačný server, ide o aktívnu činnosť klienta.
Posledná aktivita užívateľa

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

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 volaní 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 odoslané (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 pre Firebird je handle MON$ATTACHMENT_ID v tabulce MON$ATTACHMENTS, u ABRA Gen pre 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

Zoznam podporuje radenie a to pomocou kliknutia na hlavičku stĺpca. Začiarknutím je možné nastaviť automatické občerstvovanie. Občerstviť je možné aj ručne (viď funkcie lokálneho menu).

Pod editovateľným zoznamom adresátov je k dispozícii lišta navigátora:

ZrušiťObčerstviť

Navigátor v tejto záložke

Navigátor v tejto záložke obsahuje tlačidlá:

  • Na pohyb kurzora po riadkoch (na začiatok, predchádzajúci riadok, ďalší riadok, na koniec) editovateľného zoznamu.
  • 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.

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

V spodnom okne zoznam licencovaných modulov, ktorých licencie čerpá aktuálny užívateľ (na ktorom stojí kurzor). Ďalej viď Licencované celky (licencované moduly a vlastnosti). Samotný spustený AppServerProp samozrejme žiadnu licenciu na niektorý z modulov nečerpá. Ďalej viď Čerpanie licencií jadra.

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žnosť sledovať pre jednotlivé moduly, ktorý užívateľ čerpá licenciu vybraného modulu, viď tiež agenda Správa licencií v ABRA Gen. Ďalej viď aj Možnosti sledovania čerpania licencií.

Možnosť sledovať čerpané licencované moduly jednotlivými užívateľmi môže byť užitočná napr. v prípade, že došlo k vyčerpaniu licencií na nejaký modul a potrebujeme zistiť, kto licencie na konkrétny modul obsadil a koho je potrebné osloviť, aby modul opustil.

Zobrazuje logy uložené v pamäti na aplikačnom serveri. Ak je logovanie zapnuté (pomocou parametrov v sekcii [Logs]) nexus.cfg) a ak je nastavené logovanie do pamäte. Či sa má logovať do súboru alebo do pamäte (príp. oboje) a koľko posledných zápisov do logu sa má uchovávať, je možné nastaviť pomocou parametrov Target a MemoryMaxLogCount. Viac viď kap. Logovanei chodu aplikácie.

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ázov Popis
Obchodné meno majiteľa licencie

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

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

 
Aktivované
Verzia
Počet aktívnych staníc
Počet firiem

Ďalej 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

Názov Popis
Modul/Vlastnosť

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

Hodnota
Platnosť do
Špička
Naposledy začala
Celkovo trvala
Nedostupnosť

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. Nie sú perzistentné. Z toho tiež plynie, že zobrazené údaje sú relevantné k času posledného štartu aplikačného servera.

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

Ďalej viď aj Možnosti sledovania čerpania licencií

Užívatelia čerpajúci licenciu 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ázov Popis
Doplnok

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

 
Hodnota
Platnosť do

Informace zobrazované v agendě Správa licencií 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 slouží k zobrazení logu Vizualizace dat. Dále jsou v horní části této záložky k dispozici následující funkce:

Názov Popis
Spustiť

Funkce pro spuštění Vizualizace dat (tj. spuštění Javy).
Zastavit

Funkce pro zastavení Vizualizace dat (tj. ukončení Javy).
Reštartovať 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. Pokiaľ heslo zatiaľ v danej inštalácii nebolo zadané v rámci spustenia niektorého z chránených nástrojov či jeho chránenej funkcie, program na túto skutočnosť upozorní a ponúkne možnosť ho zadať.

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.

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ázov Doplňujúci 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ázov Doplňujúci 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ázov Popis Príklady použitia
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 ABRA Gen. 

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