Uživatelský manuál. Online Data Manager

Uživatelský manuál

Online Data Manager Aplikace: Přenos, archivace a redukce dat naměřených online systémy HTTP server pro síťový přístup k datům

Vlastnosti:

Nezávislé měření (bez ztráty časové kontinuity), asynchronní přístup k databázi Podpora MSSQL, optimalizované přístupy pro databáze do 1GB Implementovaný HTTP server pro síťový přístup k datům Exporty dat při překročení kritické velikosti databáze

Ref: 01032007 OS

ADASH s.r.o., Ostrava, Česká republika, tel.: +420 596 232 670, fax: +420 596 232 671, email: [email protected] Další technické a kontaktní informace najdete na www.adash.net, www.adash.cz

© ADASH spol. s r.o.

DDS 2000

2 ADASH s.r.o., Ostrava, Česká republika, tel.: +420 596 232 670, fax: +420 596 232 671, email: [email protected] Další technické a kontaktní informace najdete na www.adash.net, www.adash.cz


DDS 2000

Obsah Obsah ......................................................................................................................................3 Online Data Manager..............................................................................................................4 Použitá terminologie ............................................................................................................4 Popis....................................................................................................................................4 Databázový zdroj ODM........................................................................................................4 Redukce dat, exporty...........................................................................................................5 Transientní děje ...................................................................................................................6 Limitace ...............................................................................................................................6 Základní funkce ...................................................................................................................7 Spuštění ..............................................................................................................................7 Popis uživatelského rozhraní...............................................................................................8 Popis krátkých zpráv............................................................................................................8 Řízení ukládání a vzorkování (skupiny TCG) ....................................................................10 Parametry příkazové řádky ODM ......................................................................................11 Spouštěcí soubory .............................................................................................................12 HTML výstup......................................................................................................................13 Autentikace ...........................................................................................................................14



DDS 2000

Online Data Manager

Použitá terminologie ODM DS Statická data Dynamická data Databáze Buňka, Datová buňka Status TCG

Online Data Manager Diagnostic System, aplikace DDS2000 charakteristické hodnoty (RMS, Peak-Peak, posuvy apod.) časové průběhy, řádová analýza, spektra databáze vedená na SQL serveru datový objekt obsahující všechny informace včetně hodnoty dané měřené veličiny uložený v databázi (viz dokumentace DS) ODM rozeznává tři stavy měřené statické veličiny: normální, varovný a kritický Time Control Group, skupiny měřených statických veličin, které mají společný interval ukládání a společné řídící statické veličiny (tj. veličiny, podle jejichž statusu se řídí, budou-li veličiny obsažené ve skupině ukládány či ne)

Popis Online Data Manager (ODM) je aplikace sloužící ke sběru a archivaci dat z vibrodiagnostických zařízení (např. A3600). Úkolem ODM je zajistit robustní zpracování a uložení naměřených aktuálních statických a dynamických dat do databáze SQL serveru. Ukládání může mít proměnnou periodu vzorkování závislou na aktuálním stavu měřených statických hodnot. ODM zajišťuje bezpečnost databáze implementací automatických exportů. ODM také pracuje jako část distribuované aplikace, tzn. poskytuje aktuální data prostřednictvím síťového protokolu TCP (HTTP). Další aplikace (např. Online Data Viewer) pak mohou v reálném čase prohlížet celý soubor statických veličin.

Databázový zdroj ODM ODM používá jako databázový zdroj SQL server (Microsoft SQL Server nebo MSDE), formát databáze je plně (binárně) shodný s formátem databáze aplikace DS. V případech, kdy je potřeba optimalizovat výkon, je možné databázi převést do optimalizovaného tvaru, kdy jsou záznamy dynamických dat ukládány do separátních databázových souborů pro jednotlivé datové buňky. Dynamická data jsou pak zpracovávána s maximálním využitím výkonu pracovní stanice.



DDS 2000

Redukce dat, exporty Nastavení redukce i exportu dat se provádí editací souboru DM_CONF.INI, který je umístěn v hlavním adresáři DataManageru. ODM také provádí inteligentní snižování objemu dat prostřednictvím redukce dat. Redukce jsou třípásmové (data bez redukce, krátkodobá redukce, dlouhodobá redukce). Statické redukce reagují podle konfigurace na relativní změny v hodnotách. V určitých časových intervalech zachovávají data. Redukce dynamických dat je prováděna tak, aby byl zachován určitý počet vzorků v daném časovém intervalu. Pokud nejsou nastaveny redukce silně, může dojít k přetečení databáze. Pro zajištění databáze co do velikosti implementuje ODM databázové exporty, funkci umožňující exportovat historickou část “online” databáze uložené na SQL serveru do souboru databáze Access. Tato historická data jsou pak z “online” databáze odstraněna, databáze dále neroste a udržuje se na relativně konstantní velikosti. Všechny databázové úlohy (ukládání dat, redukce, exporty) jsou odděleny od procesu měření separátním vláknem vykonávání (provádějí se asynchronně), tzn. že měření není ovlivněno ukládáním do databáze.

Popis parametrů v souboru DM_CONF.INI, názorná ukázka nastavení ; nastavení redukce statik [ReduceStatic] ; úroveň významné změny u dlouhodobých redukcí v procentech LongReducePercent=70 ; doba, během níž nemají být data dlouhodobě redukována (ve dnech) LongPreserveDays=1 ; minimální interval 2 hodnot, který má zůstat zachován po dlouhodobé redukci (hodiny) LongIntHours=1 ; úroveň významné změny pro krátkodobou redukci v procentech ShortReducePercent=40 ; doba, během níž nemají být data krátkodobě redukována (v hodinách) ShortPreserveHours=1 ; minimální interval 2 hodnot, který má zůstat zachován po krátkodobé redukci (v minutách) ShortIntMinutes=10 ; nastavení redukce dynamik (spekter a časových záznamů) [ReduceSpectra] ; doba, během níž nemají být data dlouhodobě redukována (ve dnech) LongPreserveDays=1 ; minimální interval 2 hodnot, který má zůstat zachován po dlouhodobé redukci (hodiny) LongIntHours=1 ; doba, během níž nemají být data krátkodobě redukována (v hodinách) ShortPreserveHours=1 ; minimální interval 2 hodnot, který má zůstat zachován po krátkodobé redukci (v minutách) ShortIntMinutes=1 ; nastavení redukce řadových analýz [ReduceOrder] ; doba, během níž nemají být data dlouhodobě redukována (ve dnech) LongPreserveDays=1 ; minimální interval 2 hodnot, který má zůstat zachován po dlouhodobé redukci (hodiny) LongIntHours=1 ; doba, během níž nemají být data krátkodobě redukována (v hodinách) ShortPreserveHours=1 ; minimální interval 2 hodnot, který má zůstat zachován po krátkodobé redukci (v minutách) ShortIntMinutes=10 5 ADASH s.r.o., Ostrava, Česká republika, tel.: +420 596 232 670, fax: +420 596 232 671, email: [email protected] Další technické a kontaktní informace najdete na www.adash.net, www.adash.cz


DDS 2000

; nastavení exportu databáze [OnlineCollaboration] ; export zapnut - 1/vypnut - 0 ExportEnable=1 ; velikost databáze v MB pro export ExportLimitSize=250 ; počet hodin zachovaných v původní databázi po exportu ExportPreserveHours=9 ; v kolik hodin se má spouštět export ExportRunAtHour=0 ; cesta pro export ExportPath=C:\program files\adash\dm\export Pokud není soubor DM_CONF.INI nalezen, zkouší ODM načíst nastavení redukcí a exportu z INI souboru DS (DDS2000), pokud je cesta k tomuto souboru definovaná v projektu (toto chování je podle původní verze chování ODM). V případě, že se nepodaří INI soubor DDS2000 najít, nebo neobsahuje nastavení redukcí a exportů, použijí se přednastavené hodnoty – to znamená vypnutí veškerých redukcí a zapnutí exportů s nastavením velikosti databáze 250 MB, exportem v 0 hodin a exportem do aktuálního adresáře. Poté se automaticky vytvoří nový konfigurační soubor. Pokud jsou v konfiguračním souboru DM_CONF.INI u redukcí všude použity 0, redukce se neprovádí. Pro kontrolu nastavených parametrů si lze prohlédnout logovací soubor, do něhož se po načtení projektu vypisuje použitá konfigurace. Pokud je překročen limit velikosti dat ve statické buňce (viz níže), data se nadále ukládají do buňky a jejich počet je omezen prakticky jen použitým SQL serverem (např. u MSDE 2000 SP3 přibližně 210000 hodnot, u MSDE 2000 SP4 testováno do 500000). Při exportu buňky, která je větší než limit, se buňka rozdělí na více buňek s velikostí danou limitem a jsou pojmenovány stejně, jen na konci názvu se připojí „_“ a číslo nové buňky. V původním stromu se nic nemění, změny se týkají jen nově vytvořené databáze. Přesto se nedoporučuje překračovat daný limit kvůli rychlosti databáze (byl povolen pouze kvůli tomu, aby se neztrácela data mezi exporty) a raději nastavit exporty častější.

Transientní děje Pro zachycení transientních dějů na statických hodnotách lze definovat tzv. TCG (Time Control Group = skupina řízení ukládání), což jsou skupiny statických hodnot a dynamických dat, které mají společnou periodu ukládání. Každá TCG může být spuštěna - hodnoty obsažené v TCG pak jsou ukládány do databáze. Pokud není TCG spuštěna, hodnoty se neukládají. Manuální TCG jsou spuštěny vždy. Některé typy TCG navíc mohou být spuštěny prostřednictvím tzv. řídících hodnot, což jsou statiky ovládající aktivitu TCG. Pokud např. dojde ke změně statusu řídící statiky, přejde přechodně daná TCG do spuštěného stavu. Veličiny obsažené v této TCG pak jsou ukládány do databáze po dobu změny statusu řídící statiky. Protože status statické hodnoty se řídí individuálně pro každou statickou veličinu nastavenými kritickými hodnotami, lze nastavit různé podmínky pro různé statické veličiny a skupiny ukládaných dat. Lze tak zachytit transientní a dynamické jevy jako rozběhy/doběhy apod.

Limitace ODM je bez limitů, ale DS má tyto limity: - Max. počet záznamů statických dat v jedné datové buňce: 128 000 6 ADASH s.r.o., Ostrava, Česká republika, tel.: +420 596 232 670, fax: +420 596 232 671, email: [email protected] Další technické a kontaktní informace najdete na www.adash.net, www.adash.cz


-

DDS 2000

Max. počet záznamů dynamických dat v jedné datové buňce: 16 300 Min. perioda čtení 250 ms

Základní funkce

Obr.1. Okno ODM

Spuštění Uživatel může při spuštění ODM specifikovat parametry příkazové řádky (viz níže) nebo spustit ODM bez parametrů. Po otevření okna ODM je běžný postup: 1) (nepovinné) výběr ODBC Datového zdroje, stisknout tlačítko Připojit ODBC Datový zdroj, 2) stisknout tlačítko Načíst projekt, vybrat soubor-projekt s příponou ”600,36P,MU”, 3) stisknout tlačítko Start pro spuštění měření a ukládání.



DDS 2000

Popis uživatelského rozhraní Menu •

•

Příkazy o Spustit načítání - spustí proces měření a ukládání do databáze; ekvivalentní stisku tlačítka Spustit Načítání. o Načíst projekt - načte projekt; ekvivalentní stisku tlačítka Načíst projekt. o Znovunačtení glob.parametrů - pokud uživatel změnil v souboru DM_CONF.INI globální nastavení, např. parametry redukce dat, lze tímto příkazem načíst nové hodnoty těchto parametrů bez přerušení měření. o Management přístupových práv - vyvolá konfigurační dialog autentikace uživatelů. Nástroje o Parametry spouštění - umožňuje vizuální konfiguraci parametrů spouštění aplikace; viz kapitola Spouštěcí soubory.

Položky okna Úroveň logování Do souboru

specifikuje filtr zobrazovaných zpráv do seznamu Zprávy. povolení/zakázání logování do souboru. Pokud je povoleno, vytváří se v aktuálním adresáři aplikace logovací soubory s příponou lg0 (aktuální), lg1 (záloha). Pokud soubor lg0 překročí max. velikost (pokud není definována, pak je standardně 2000kB), je přesunut do souboru lg1 a smazán. Velikost lze specifikovat z příkazové řádky. Maximální hodnota maximální velikosti logu je 20 000kB. Interval čtení z přístroje základní perioda čtení dat z přístrojů (udávaná v ms). ODBC Datové zdroje seznam nakonfigurovaných ODBC datových zdrojů, na které lze ODM připojit. Připojení ODBC je nepovinné, projekty obsahují k nim definované ODBC, na které se ODM při načtení projektu automaticky napojí. Připojit ODBC datový zdroj připojí ODM k vybranému ODBC datovému zdroji, naměřená data budou ukládána tam (pokud existují reference na datové buňky). Odpojit ODBC datový zdroj odpojí ODM od databázového připojení. Dále jsou hodnoty uchovávány jen pro online čtení dat a nejsou zapisovány do databáze. Načíst projekt ODM načte projekt databázového připojení měřených veličin. Tyto projekty jsou vytvářeny výhradně v aplikaci DS. Znovunačtení parametrů ODM znovu načte globální parametry z INI souboru DS (jen pokud byl otevřen projekt). Řízení ukládání a vzorkování otevře dialog konfigurace skupin TCG (viz níže). Minimalizovat a zamknout minimalizuje okno ODM; pokud je definována autentikace ODM, pak při pokusu o maximalizaci bude uživatel vyzván k zadání jména a hesla administrátora.

Popis krátkých zpráv V původních verzích ODM bylo mnoho zpráv vypisováno ve stručné podobě. V nové verzi (2.1.26) byly tyto zprávy změněny – se snahou o zachování co největší stručnosti, ale tak, aby měly zároveň co největší informační hodnotu. Všechny zprávy, které zobrazuje samotný ODM, jsou uvedeny DM: . 8 ADASH s.r.o., Ostrava, Česká republika, tel.: +420 596 232 670, fax: +420 596 232 671, email: [email protected] Další technické a kontaktní informace najdete na www.adash.net, www.adash.cz


DDS 2000

Popis krátkých zpráv: Transferred:xx (Sch:xI:ySig:z) STA:xx stored (Sch:xI:ySig:z) Not valid data:xx (Sch:xI:ySig:z)

byla načtena statická hodnota datové buňky č. xx, (v závorce je navíc informace o tom, odkud pocházejí data v této buňce) do databáze byla uložena statická hodnota datové buňky č. xx. (v závorce opět informace o tom, odkud pocházejí tato data) data datové buňky č. xx nebyla načtena, nemají status platných dat.

Určení zdroje dat: x u Sch: udává, ze které jednotky (číslo určuje pořadí jednotky v projektu) data pocházejí, y u I: udává, ze kterého modulu této jednotky data pocházejí a z u Sig: udává zdrojový signál. DYN:xx stored STA: CellID xx – REDuced DYN: CellId xx – REDuced

byla uložena dynamická data datové buňky č. xx, u A3600 informuje o načtení těchto dat příslušná zpráva komunikačního rozhraní. záznamy statické datové buňky č. xx byly zredukovány. Tato zpráva dále pokračuje informací o tom, zda proběhla krátkodobá či dlouhodobá redukce. záznamy dynamické datové buňky č. xx byly zredukovány.

Popis původních krátkých zpráv: st:xx byla přečtena statická hodnota datové buňky č. xx STO:xx byla přečtena a uložena do databáze statická hodnota datové buňky č. xx X nebo X:xx data (datové buňky č. xx) nebyla načtena, data mají hw status neplatných dat dyn byla přečtena dynamická data, korespondující datová buňka však není definována DYN:xx byla přečtena a uložena do databáze dynamická data datové buňky č. xx RED:xx záznamy datové buňky č. xx byly načteny, zredukovány a uloženy do databáze



DDS 2000

Řízení ukládání a vzorkování (skupiny TCG) Skupiny TCG představují mechanismus umožňující uživateli definovat rozdílné periody či okamžiky ukládání dat v závislosti na hodnotách specifických, uživatelem daných statických veličin.

Obr.2. Dialog konfigurace skupin TCG Po otevření dialogu skupin TCG může uživatel upravovat stávající skupiny, přidávat nové či je odebírat tlačítky Přidat, Odebrat, Upravit. Tlačítko Načíst znovu načte skupiny TCG z aktuálně otevřeného projektu, tlačítko Uložit uloží aktuální konfiguraci do projektu. Tlačítko Nastavit aktivní umožňuje uživateli povolit vybranou skupinu – nastavit ji do aktivního stavu. Pokud je skupina aktivní, bude se daná skupina po načtení dat z přístrojů testovat. Aktivní skupina se po opětovném stisku stane neaktivní a nebude se testovat. Obsažené veličiny Řídící veličiny

jsou ty veličiny, které budou ukládány podle definice TCG, pokud je tato aktivní. jsou statické hodnoty, podle kterých se může řídit stav skupiny TCG. Jejich aktuální stav je porovnáván s kritickými hodnotami definovanými v databázi. Pokud jsou splněny podmínky v definici skupiny TCG (např. změna statusu řídící veličiny) a TCG je nastavena jako aktivní, je skupina spuštěna, tzn. veličiny v ní obsažené jsou s definovanou periodou ukládány do databáze.



DDS 2000

Obr. 3.Definice skupiny TCG Existují tyto typy skupin: Normal – tato skupina není řízena veličinami a pokud je aktivní, hodnoty v ní obsažené se ukládají podle definovaného Intervalu ukládání skupiny. Critical Status Change – tato skupina je spuštěna pokud jedna z jejích řídících veličin změní svůj status – k ukládání pak dojde, pokud je skupina aktivní. Zachycuje okamžik mezi změnami statusu. Critical Any Change – tato skupina je spuštěna, pokud se jedna z jejích řídících veličin nachází v pásmu varovných či kritických hodnot - k ukládání pak dojde, pokud je skupina aktivní. Zachycuje celou historii hodnoty veličiny při překročení mezních hodnot. Status To High (resp. Status To Low) – tato skupina je spuštěna, pokud jedna z jejích řídících veličin změní svůj status z nižšího na vyšší (resp. z vyššího na nižší) – k ukládání pak dojde, pokud je skupina aktivní. Zachycuje okamžik změny statusu. Constant Difference – toto je speciální typ skupiny, určený pro sledování frekvenčních změn. Pokud má frekvenční datová buňka definovány limity relativní změny (absolutní hodnotu kroku) a je vybrána jako řídící i obsažená veličina, pak každá změna, větší než je definovaný krok, povede k ukládání. To umožňuje uživateli monitorovat změny frekvence v konstatních krocích. To je užitečné například při sledování rozběhů.

Parametry příkazové řádky ODM Uživatel může aplikaci ODM spustit s doplňujícími parametry příkazové řádky tak, že není potřeba další manuální zásah v uživatelském rozhraní. Parametry jsou: -ODBC:DSN specifikuje DSN (Data Source Name), jméno databázového zdroje, na který má být ODM připojen. Nepovinné, pokud je otevírán projekt (projekt již obsahuje definovaný ODBC zdroj) -PROJ:cesta načte soubor projektu z umístění cesta -RUN:Y pokud uvedeno, ODM po načtení projektu a připojení k ODBC zdroji spustí načítání z přístrojů -REFRESH:interval nastaví základní periodu čtení z přístrojů na interval (v milisekundách) -PORT:port TCP server aplikace ODM obsadí port port. Standardně je tato hodnota 11257. -LG:lgsize Povoluje logování do souborů s příponami lg0, lg1. lgsize specifikuje maximální velikost logovacího souboru v kilobytech. Pokud základní logovací soubor překročí tuto velikost, je zálohován do souboru s příponou lg1 a vymazán. Pokud už předtím existoval soubor lg1, pak je tímto přepsán. -LLEVEL:loglevel Nastaví při startu příslušnou úroveň logování. Možné hodnoty jsou: 0 Jen chyby 11 ADASH s.r.o., Ostrava, Česká republika, tel.: +420 596 232 670, fax: +420 596 232 671, email: [email protected] Další technické a kontaktní informace najdete na www.adash.net, www.adash.cz


DDS 2000

1 Chyby a hlášení 2 Všechna hlášení -WAT:watchdog.exe Po startu spustí aplikaci watchdog.exe, která kontroluje běh ODM. Pokud ODM neodpovídá, bude znovu spuštěn. -WPAU:pause interval mezi testy aktivity aplikace ODM -WTST:testtime doba, po kterou se aplikace ODM nemusí ozývat, než bude brána jako neaktivní a znova spuštěna -OPT:volby volby je hodnota určená bitovým součtem jednotlivých voleb. Ty jsou: 2 - ukonči při stejném projektu - ODM bude ukončen, pokud je spouštěn z příkazové řádky s projektem, se kterým už je jedna aplikace ODM spuštěna. Použijte, pokud máte v DM_CONF.INI více instancí ODM ke spuštění a chráníte ODM aplikací watchdog.

Spouštěcí soubory Uživatel může spustit max. 4 instance ODM (ODV, nebo jiné aplikace) pomocí spouštěcího souboru DM_CONF.INI (ODV.INI). Jedná se o textový INI soubor, který se čte při prvním spuštění dané aplikace. Po jeho načtení se spouštějí další definované aplikace. Soubor je v následujícím formátu: [Run_1] [Exe=Plná cesta k exe souboru] CmdLine=parametry příkazové řádky spouštěné aplikace Delay=1000 … [Run_4] [Exe=Plná cesta k exe souboru] CmdLine=parametry příkazové řádky spouštěné aplikace Delay=1000 Pokud není hodnota Exe zadána, bere se aplikace spuštěná jako první (ta, která přečetla startovací soubor), což nejčastěji bývá ODM. Jinak může být zadána jako celá cesta k jiné aplikaci, která se má spustit. Hodnota Delay udává zpoždění před spuštěním další aplikace v milisekundách. Pokud existuje pouze sekce [Run_1], bude spuštěna jen jedna instance (ta, která přečetla spouštěcí soubor) se specifikovanými parametry příkazové řádky Příkaz menu Nastavení / Parametry spouštění spustí grafickou konfiguraci spouštěcího souboru, která umožňuje komfortnější nastavení spouštěcích souborů. Položky konfiguračního dialogu jsou ekvivalentní položkám v spouštěcím souboru, výběr aplikace, pro kterou se provádí konfigurace, se provede výběrem z nabídky Číslo konfigurované aplikace, následně se nakonfigurují požadované parametry. Pokud je požadována konfigurace další aplikace, provede se pouze nový výběr z nabídky Číslo konfigurované aplikace. Nevyplněné parametry budou mít přednastavené hodnoty, pokud není vyplněna cesta k aplikaci (EXE aplikace), bude spuštěn ODM.



DDS 2000

Obr.4. Dialog konfigurace spouštění aplikace Příklad DM_CONF.INI spouští aplikace ODM ([Run_1]) a ODV ([Run_2]) [Run_1] CmdLine=-PROJ:c:\projects\plant.36C –REFRESH:10000 –RUN:Y [Run_2] Exe=c:\program files\adash\Online\ODV.exe CmdLine=-PROJ:c:\projects\plant.viw Spuštění s watchdogem: [Run_1] CmdLine=-PROJ:c:\projects\plant.36C –REFRESH:10000 –RUN:Y -WAT:watchdog.exe -WTST:30 -WPAU:60 -OPT:2

HTML výstup Součástí ODM je i HTTP server, který slouží k online zobrazení načítaných dat. Tento server jednak umožňuje prohlížení načítaných dat pomocí aplikace Online Data Viewer a jednak umožňuje jejich prohlížení také pomocí obyčejného prohlížeče webových stránek (např. Internet Explorer). Pokud si zobrazíme HTML dokument, který ODM generuje, zobrazí se nám v tabulkách aktuální naměřené hodnoty pro jednotlivé jednotky v projektu. Každá tabulka je nadepsána číslem jednotky v rámci projektu, případně jejím jménem (zadaným při vytváření projektu v aplikaci 3600setup). V každé tabulce jsou zobrazeny poslední načtené hodnoty a časy měření. V záhlaví dokumentu je navíc seznam všech jednotek, umožňující kliknutím na jméno jednotky rychlý přechod k příslušné tabulce. Na konci dokumentu pak je výpis posledních chybových hlášení / logů aplikace ODM.



DDS 2000

Autentikace ODM podporuje autentikaci uživatelů, tzn. přihlašování oprávněných uživatelů do aplikací. Podle úrovně uživatele pak každá aplikace povoluje či zakazuje určité akce. Definice jmen a hesel se děje v autentikačním dialogu. Skupiny autentikace jsou hierarchické, tzn. skupina v hierarchii práv ležící výše má minimálně stejná práva jako skupina ležící níže.


Uživatelský manuál. Online Data Manager

Recommend Documents