miner:referens:systemdokumentation [Orbiq wiki]

Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan.
====== Miner: systemdokumentation ======

==== Förord ====

Syftet med denna guide är att gå igenom miners egenskap och funktionalitet steg för steg. Med denna guide så skall ni kunna konfigurera enheter från början till slut

Miner är en enhet som gör det möjligt att samla information från de olika datoriserade systemen i en fastighet. Med hjälp av miner så kan man antingen välja att ta ut all information som finns i systemet, eller välja ut exakta datapunkter. Beroende på ändamål och verksamhet. Miner är kompatibel med ett flertal olika fabrikat och kommunikationsprotokoll. För att nämna några protokoll och fabrikat som finns tillgängliga, se denna sida.







 


===== HEM =====
 {{:miner:intro:hem.png?600|}}

Här får vi två olika typer, ett som är benämnt som “Anslutningar” och ett som är benämnt som “Jobb”.

“Anslutningar” visar vilka olika fabrikat som som man har en anslutning mot.

“Jobb” visar dem jobben som “minas”, det vill säga hämtar information om datapunkter som finns i systemet. 





===== SKAPA ANSLUTNINGAR =====
 
{{:miner:intro:unnamed_1_.png?600|}}


I denna vy så kommer anslutningarna mot de system som man skapat att läggas till. Detta kommer då vara en samlingslista för samtliga “Anslutningar” 


För att skapa en anslutning så väljer man “SKAPA NY” 

{{:miner:intro:skapa_ny.png?600|}}

Nästkommande sida så väljer man vilken typ av datakälla (fabrikat eller kommunikationsprotokoll)  som man skall skapa en anslutning till.

{{:miner:intro:skapa_ny_datakaella.png?600|}}

I rullistan som visas så finns alla kompatibla fabrikat och kommunikationsprotokoll.
I detta exempel så har vi valt att använda “Larmia” 

{{:miner:intro:ny_datakaella.png?600|}}

Nu får vi följande kategorier som man  skall fylla i.//** Alla rader med * är obligatoriska.
**//

   * Namn -  Valfritt namn på fabrikat / protokoll 

  * Adress - IP-adress för datakällan så att en anslutning kan upprättas. 

  - Port - kommunikationskanal som används av program och tjänster i ett nätverk. I vissa särskilda fall kan andra portar användas än dem som är benämnda nedan 
  - Port 80 – HTTP (webb)
  - Port 443 – HTTPS (säker webbtrafik)
  - Port 22 – SSH
  - Port 53 – DNS
  - Port 3389 – RDP (fjärrskrivbord)


  * Användarnamn  - Användarnamn till fabrikat för att hämta metadata eller utföra överskrivningar via API 

  * Lösenord - Lösenord till nämnd tjänst som ovan. 

  * Upprepa lösenord - Upprepning av lösenord.

  * Beskrivning - Valfri beskrivning som exempelvis användningsområde för fabrikatet/kommunikationsprotokollet. 



Vill man sedan visualisera datapunkter genom larmer eller utläsning av metadata som exempelvis temperaturer så kan man bland annat göra det via vår egna tjänst.  Orbiq. 

Då väljer man  “SKAPA NY”. Sedan väljer man Orbiq i “Typ av datakällan" i rullistan.


{{:miner:intro:orbiq_data_kaella.png?600|}}



Profil - Här kan man välja mella “Orbiq data export” eller “ComputableExplorer”. “Orbiq data export skickar data till Orbiq och gör det möjligt att använda så kallade orbiq attributer. 
“ComputableExplorer” detta alternativ gör det möjligt att beräkna exempelvis temperatur som sedan kan skickas till en annan databas. 

  
  * Namn - Välj valfritt namn på Orbiq instansen

  * Adress -   IP-adress för Orbiq instansen så anslutning kan upprätta

  * Port - Port 80 (detta gäller för Orbiq) 

  * Användarnamn - Användarnamnet för Orbiq instansen

  * Lösenord - Lösenord för Orbiq instansen  

  * Upprepa lösenordet - upprepa lösenordet för Orbiq instansen 

  * Beskrivning - Valfri beskrivning av Orbiq instansen 


Efter att man har fyllt på den obligatoriska informationen så kan man trycka på spara.

 
{{:miner:intro:spara_datakaella.png?600|}}

Beroende på typ av “ANSLUTNING” så kommer jobbet antingen användas som input eller output. När det är parad med ett miner jobb.

===== SKAPA ETT JOBB =====


 Efter man har skapat anslutningar så kan man då påbörja att skapa “JOBB”
“JOBB” är det som kommer i slutändan att börja hämta metadatan från det fabrikat/kommunikationsprotokoll som man har skapat en anslutning till. 

För att skapa ett “JOBB” så börjar man med att trycka på “SKAPA NY”

{{:miner:intro:skapa_ett_jobb.png?600|}}


Efter man har tryckt på “SKAPA NY” så kommer man in på vyn “SKAPA ETT JOBB”. 
Här kommer man nu ha möjligheten precis som vid “ANSLUTNINGAR” att välja fabrikat/kommunikationsprotokoll. Här är det dock viktigt för att indatan skall börja hämtas att “JOBBET” är det samma “typ” som anslutningen”. Som exempelvis så kan man inte skapa en Elvaco “ANSLUTNING” och sedan ett Jobb som är Larmia med samma uppgifter. 

{{:miner:intro:skapa_ett_jobb_2.png?600|}}

Likväl som anslutningar finns det även här rader som är markerade med specialteckent *, är dessa obligatoriska. 

 
  * Namn - Valfritt namn på fabrikat/kommunikationsprotokoll

  * Beskrivning - Valfri beskrivning som exempelvis användningsområde för fabrikatet/kommunikationsprotokollet. 

  * Jobbtyp - I jobbtyp så finns det tre olika kategorier att välja mellan, Datahämningsjobb, Beräkningsjobb och Graphjobb. 

  * Datahämtningsjobb - hämtar data från en input och laddar upp till en output. 

  * Beräkningsjobb - hämtar data från Orbiq, bearbetar mätvärden utifrån ett script och laddar sedan upp till en output (Databas). 

  * Graphjobb - är jobb som bygger miners graf och laddar upp till en grafdatabas. 

  * Indata - I denna kategori så väljer man sedan utifrån "Anslutningar" som man skapade tidigare i vyn för “ANSLUTNINGAR”. Här finns det även ett alternativ “SKAPA NY” som man kan klicka om man inte redan har skapat en anslutning 

  * Välj en typ - Här kommer det visa utifrån vald “Indata” vilket fabrikat som berörs av detta jobb. 

  * Utdata - Utdata är tjänsten som skall ta emot datan från miner, exempelvis Orbiq. Man har också valmöjligheten att använda sig av flera olika typer av databaser för att hämta metadata. Efter Utdata valts så måste man trycka på lägg till.

  * Hämta historik - Ett alternativ om man vill hämta in historisk data från fabrikatet/kommunikationsprotokollet. Om hämta historisk är valt så kommer man att få ett alternativ på tidsintervall när miner skall börja hämta historisk data. 


{{:miner:intro:skapa_ett_jobb_3.png?600|}}




Efter man har tryckt på “NÄSTA så kommer man till vyn om “Konfigurera utdata”. 
Här kommer man få möjlighet att klassificera metadatan utifrån sina egna attribut om man har valt att ladda upp metadatan till en egen databas. OBS Detta gäller endast när man använder Orbiq som utdata 



{{:miner:intro:skapa_ett_jobb_4.png?600|}}




  * Attribut att överföra - Detta är attributer som kan tillämpas från den databas som man har valt som “utdata” 
 
  * Mapping av attribut - Här kan man använda nyckelord om man exempelvis vill att någon datapunkt skall benämna någon information annorlunda, som att “Byggnad” skall hetta “Building istället. 

  * Attribut att lägga till - Här kan man lägga till attributer som man tycker saknas, som ett exempel “Utrustning” för temperaturgivare. Att det är just en GT31 som mäter utomhustemperaturen. 



Om man använder Orbiq som källa för “Utdata” så behöver man inte nödvändigtvis att definiera några av attributerna nedan. Då Orbiq redan har en lista med specifika attributer. Detta kommer att belysas lite längre fram. 





Det sista vyn som man kommer in på är “LÄGG TILL PUNKTER” 


{{:miner:intro:skapa_ett_jobb_5.png?600|}}


  * Minas redan av en miner - Här har man alternativ att visa dem punkterna som “Minas” redan, d.v.s. Miner läser ut metadatan för dessa punkter. Man kan vilja att man bara visar punkter som inte “Minas” redan. Till sist har man alternativet visa allt, då visa datapunkter som är minas och dem som inte gör det. 

  * Sök efter datapunkt - Här har man möjlighet att söka efter en specifik datapunkt som man vill komma åt. 
  * Datapunkter - I denna lista visas alla datapunkterna som har hämtas in från det givna fabrikatet/kommunikationsprotokollet. All metadata som kan hämtas in kommer att finnas tillgänglig. Man kan sedan här välja vilka punkter som man vill börja hämta information ifrån, det vill säga börja “Mina”

  * Exportera CSV - Här kan man ta ut en CSV-fil som kommer att innefatta alla datapunkter som blivit inlästa till minern. Detta kan vara värdefullt i fall man skall göra en storskalig ändring, då kan man använda sig och skriva informationen direkt i CSV, man kommer sedan ha möjlighet att importera den till givna jobbet. 



I denna vy så markerar man de punkterna som man vill börja "mina", det vill säga börja hämta data ifrån och ladda upp till sin databas. När man markerat vilka punkter som man vill använda så tryck på knappen “NÄSTA” 

{{:miner:intro:skapa_ett_jobb_5.png?600|}}


I nästa vy så kommer man att få bekräfta att det är de datapunkterna man vill använda, genom att klarmarkera dem. Efter de klarmarkeras så kommer miner att börja samla in datan. 

{{:miner:intro:skapa_ett_jobb_6.png?600|}}

I denna vy så ser man hur många datapunkter som finns tillgängliga att klarmarkera. 
Som exempelvis (0 av 2 har klarmarkerats). När man sedan har valt att klarmarkera en punkt så ändras vyn ytterligare. 

{{:miner:intro:skapa_ett_jobb_7.png?600|}}

I den nya vyn som skapas efter man har klarmarkerat datapunkten eller datapunkterna, så ser man tre olika 3 olika valbara alternativ 

VÄXLA KLARMARKERING - Väljer man detta alternativ så innebär det att man klarmarkerar datapunkten och i samband med det så blir den grön

{{:miner:intro:skapa_ett_jobb_8.png?600|}}

Man kan även trycka igen på “VÄXLA KLARMARKERING” för att avmarkera punkten. Då går den tillbaka till sitt vita ursprung  för att visa att den inte längre är klarmarkerad. 

  * TA BORT  - Detta alternativ är användbart om man har tagit in en punkt som man inte har nytta av eller behov att läsa in.

  * LÄS IN - Men denna funktion så får man möjlighet att  läsa in värdet från datapunkten direkt, för att få en förhandsvisning på värdet, som exempelvis temperatur eller vattenflöde. 



Det finns också rubriker för datapunkten som ger information.


{{:miner:intro:skapa_ett_jobb_9.png?600|}}



  * Datapunkt - Här visas namnet som har blivit inläst från datapunkten 

  * Mått - Här belyse mätvärdet för datapunkten (MV) 

  * Avlästa värden - under denna rubrik så visas information värden från datapunkten 

  * Minas av miner - Om datapunktens information hämtas av miner. 


Om man sedan skulle trycka på en av datapunkterna, så kommer man till vyn “Redigera datapunkt” I denna vy så får man möjlighet att definiera attributer utifrån information som finns i datapunkten samt ändra beteckning om så önskas från datapunkten. Huvudrubriken för dessa är Attribut. 


{{:miner:intro:skapa_ett_jobb_10.png?600|}}


  * Beteckning - Här har man möjlighet att skriva om en beteckning från en datapunkt om man så önskar (Som standard så är denna beteckning samma som källbeteckning). Dessa rader är också markerad med *.Det vill säga att de är obligatoriska. 

  * Källbeteckning - detta är informationen som läses in från datapunkten och som sedan kommer att användas som namn/beteckning 

  * Typ - Minern skiljer mellan några olika typer av metadata (Type) som kan anges som datapunkter. Dessa typer skiljs åt med hjälp av egna prefixer, det vill säga med hjälp av olika tecken som anges för benämning. De olika tecken som är #, @, och !. 
 
 * #Kommentar  = Intern anteckning/kommentar i minern. Överför ej till någon annan databas
  
 * @ Dynamisk = metadata som vid förändring endast lagras/uppdateras med kommande värden. Lämplig exempelvis för att ange statusförändring.
 
 * !Konstant - metadata som uppdaterar historiska värden i Orbiq.  

  * Designation - Benämning för datapunktens metadata 

  * Värde - Vad är värdet för datapunktens metadata.


Man har även möjlighet att lägga till “ATTRIBUT” om man så vill där man kan använda egenskaperna som är beskrivna ovan. Förutom det som är redan är förklarat, så kan man även här “HÄMTA VÄRDE” , “VÄXLA KLARMARKERING” och “SPARA”.

Efter det att man har tryckt på “SPARA” så kan datapunkten att börja “minas” av Miner. 



==== Lindinspect ====


 



Att skapa ett jobb för Lindinspect skiljer sig lite från övriga system. Det är en skillnad hur jobbet hämtar information från datapunkten. Men man kommer att få alternativ hur information skall benämnas.

{{:miner:intro:lindinspect.png?600|}}


Man har tre stycken alternativ. “Ignorera”, “Datapunkt” och “Tagg” 

  * Punkt i osorterad listaIgnorera - Menas med att datapunkten inte kommer att läsas in 

  * Datapunkt - Detta betyder att själva attributen kommer att läsas in med sina egenskaper som en datapunkt 

  * Tagg - Denna kommer enbart att läsas in som attribut. 




===== REDIGERA JOBB =====
 
 


Efter att ett jobb har blivit skapat så kommer listan som tidigare var tom visa det skapade jobbet. 

{{:miner:intro:redigera_jobb.png?600|}}

Här kommer vi att få information gällande jobbet. 

  * NAMN - Det namn som valts för jobbet 

  * SENAST KÖRNING - När jobbet senast hämtade data (detta går tillbaka till tidsintervallen som man valde när man skapade jobbet) 

  * TYP - Vilken typ av fabrikat/kommunikationsprotokoll som jobbet innefattar

  * STATUS - Denna funktion visar Aktiv när miner läser data och inaktiv när miner inte läser data. 

  * PÅ /AV - Om jobbet körs eller inte 
    Genom att köra jobbet så kan man trycka direkt på “spela-knappen” direkt i vyn.

{{:miner:intro:redigera_jobb_1.png?600|}}

När jobbet har börjat köra så kommer data att börja hämtas. 

Om klickar på jobbet, så kommer man in i jobbets vy 

{{:miner:intro:redigera_jobb_2.png?600|}}


Som huvudrubrik så kommer namnet för Jobbet att så högst upp och inom parentes som kommer det förklaras om jobbet kör eller inte.

Här kommer vi få ytterligare rubriker med information gällande följande.

{{:miner:intro:redigera_jobb_3.png?600|}}


  * Källbeteckning  - Källbeteckning för datapunkt 

  * Beteckning - Beteckning för datapunkt 

  * Senast avläsning - Senaste gången metadata hämtas från datapunkten 

  * Senast sparat - senaste gången som vi har sparat till utdatan. 


Det finns olika funktioner som man får till sig efter man har skapat ett jobb och sedan går in på det. Har har vi också alternativet “KÖR JOBB” 

{{:miner:intro:redigera_jobb_4.png?600|}}
 

Det finns också möjlighet att “EXPORTERA CSV” då får man ut dem datapunkterna som blivit tillagda i jobbet  




I CSV-filen som man får ut så ser man våra egna kolumnrubriker som är skapade av miner .

{{:miner:intro:redigera_jobb_5.png?600|}}

Dem kolumnerna som skapas är följande 

  * UUID - Unik programmatisk ID som skapas i miner för datapunkter i ett minerjobb. Om jobbet raderas och skapas igen, får samma punkt i källsystemet ett nytt UUID. 

  * io_label - Datapunktens beteckning i källsystemet. Denna information kan ändras i minern via import/export i CSV, men för enklare spårbarhet rekommenderas det inte att ändra io_label 

  * poll_interval_sec - Ange hur ofta datapunkten ska läsas av från källsystemet. Ange tiden i Sekunder. Om det inte finns något värde för “cov” sparas data vid varje avläsning. Annars sker en kontroll om data ska sparas eller ej. 

  * cov - Står för “Change Of Value” och används för att ange att data endast ska sparas om det sker en förändring av värdet. Ange graden av förändring och använd punkten “.” istället för “,” för angivande av decimaltal. Exempelvis “0.1” betyder att värdet sparas om det har skett en förändring mellan avläsning på minst 0.1. 

  * minimal_save_interval - Används tillsammans med “cov” och är en rekommenderad inställning för att säkerställa att det alltid sparas data, även om det inte har skett någon förändring på lång tid. Exempelvis för driftindikering där det kan vara samma värde under många timmar, kan det vara lämpligt att kombinera “cov” med “minimal_save_interval”. Anges i sekunder och ska vara ett värde som är större än “poll_interval_sec” kombinationen [poll_interval_sec, cov, minimal_save_interval]=[60, 1, 1800] betyder “läs värdet varje minut, spara om det har ändrat med 1 eller mer, men spara alltid ett värde. 

  * orbiq_label - Datapunktens beteckning i Orbiq

  * data_access - Förklara datapunktensrättighet, r = read och rw = read/write. rw är alltså en punkt som man kan skicka information till som skall exempelvis skrivas över. 

  * config_status - är datapunkten klarmarkerad i minern så har det “config_status” = Done. Är datapunkten däremot inte klarmarkerad i jobbet så är config_status = NotDone. 

  * ProvisioningStatus - “ProvisioningStatus är till för att förmedla datapunkter upp till utdata som exempelvis proptechOS. Får vi förbindelse med grafen, med nämnd datapunkt så kommer “ProvisioningStatus” = Done om inte kommer den stå i “NotDone” 

Alla de attributer som har nämnts ovan är standardiserade inom miner. Så oavsett vilket jobb som man hämtar ifrån så kommer alla som nämnts finnas med. 


Trycker man på namnet “ÅTGÄRDER” så kommer man få ytterligare valmöjligheter 
för att kunna redigera jobbet. 

{{:miner:intro:redigera_jobb_6.png?600|}}


Nu kommer man få tre olika alternativ som man kan använda sig av.

{{:miner:intro:redigera_jobb_7.png?600|}}

  * IMPORTERA DATAPUNKTER FRÅN CSV - Här har man nu en möjlighet att importera datapunkter direkt från en CSV-fil som man tidigare har tagit ut från jobbet 

  * SKAPA NYA DATAPUNKTER MED EXPLORER - Med denna funktion så kan man lägga till nya datapunkter direkt i Minern. Man kommer då in i miner som tidigare när man först skapade jobbet, där får man lika som tidigare välja de datapunkterna som man vill lägga till. 

  * IMPORTERA ÖVERSKRIVNINGSREGLER FRÅN CSV - Här har man möjlighet att skicka information till en datapunkt. Exempelvis till ett värmesystem där man vill överstyra parallelförskjutningar via ett annan typ av datorisatsystem. Detta kan då göras direkt i en CSV-fil som man sedan kan ladda upp till miner. En viktig notering är att man kan skapa överskrivningsreglerna direkt via miner från om med version 1.14.2. 
(Länk till tillvägagångssätt https://iquest.se/wiki/miner/intro/hantering-av-oeverskrivningar) 









Genom att trycka på “inställningar” så får man upp följande vy 

{{:miner:intro:redigera_jobb_8.png?600|}}

Här får man möjlighet att redigera jobb och uppdatera senaste poller-värdet (se senaste gången information hämtades). 
Man kan också ladda ner loggar och konfiguration hur jobbet är utfört. Man får också information om jobbets UUID, Datakälla, Typ, Status, Senaste körningen, till sist om jobbet körs eller inte på/av. 

{{:miner:intro:redigera_jobb_9.png?600|}}

Trycker man på REDIGERA JOBB så får man upp följande ruta 

{{:miner:intro:redigera_jobb_10.png?600|}}

Här får man upp följande rubriker. 

  * Namn - Jobbets namn

  * Beskrivning - Om det finns en beskrivning för jobbet så kommer det belysas här. 
  * Datakälla - Vilken datakälla som jobbet tillhör 

  * Typ - Vilken typ (Fabrikat/kommunikationsprotokoll) 

  * Uppladdningsanslutning - Alternativ för om man skulle vilja lägga till ytterligare en utedatabas för upphämtning av information 


Man har också möjlighet att konfigurera anslutningen i efterhand 


   
 {{:miner:intro:redigera_jobb_11.png?600|}}




Man får också möjlighet att lägga till attributer till det befintliga jobbet. 



{{:miner:intro:redigera_jobb_12.png?600|}}









Om vi går tillbaka och väljer att trycka på datapunkten, så kommer till en vy som är specifik för just den datapunkten, //**OBS! Innan man kan göra en redigering av datapunkter så måste jobbet stoppas**//

{{:miner:intro:redigera_jobb_13.png?600|}}



I denna vy så ser vi vad datapunkten innehåller från beteckning till attributer. 
Som vi har sett tidigare så har vi dessa beteckningar även här 

{{:miner:intro:redigera_jobb_14.png?600|}}

  * Beteckning - namn 

  * Källbeteckning - information av teckning, 

  * UUID - Unik programmatisk ID som skapas i miner för datapunkter i ett minerjobbd

  * Attribut - Attributer som jobbet/datapunken innehåller 

  * Överskrivningsregler - Här visas det om en överskrivningen har blivit tillagd i datapunkten. 


Man har även möjlighet att ta bort punkten, redigera och växla klarmarkeringen. 


{{:miner:intro:redigera_jobb_15.png?600|}}


Väljer man att gå in på “REDIGERA” så kommer man till vyn “Redigera datapunkt” 

{{:miner:intro:redigera_jobb_16.png?600|}}


Detta har blivit påtalat tidigare i kapitlet för “Skapa Jobb”, så det är samma vy som tidigare. Man har här möjlighet att definiera attributer utifrån information som finns i datapunkten samt ändra beteckning om så önskas från datapunkten. Huvudrubriken för dessa är Attribut. Om något bör läggas till eller ändras. 



Sista kategorien är ÖVERSKRIVNINGSREGLER

Här får man möjlighet precis som nämnts tidigare med CSV:n, möjlighet att överskriva värden utifrån ett annat datoriserat system. 


{{:miner:intro:redigera_jobb_17.png?600|}}


Gå in på den aktuella datapunkten som du vill skriva över och aktivera redigeringsläget. Om det inte går att aktivera redigeringsläget, kan det bero på att jobbet håller på att köras. Se till att stoppa jobbet först och försök därefter igen.

Bläddra ned till avsnittet under inställning av attribut. Du ser rubriken ”Överskrivningsregler”, klicka på ”Lägg till” [1].


 Fyll i de olika fälten för ”Prioritet”, ”Värde”, ”Min-värde”, ”Max-värde” och ”Varaktighet”. Om du för pekaren till höger i respektive fält, ser du en symbol för  förstoringsglas [2]. Om du klickar på denna symbol, dyker ett sökfält upp och du kan då söka dig fram till de Jobb som finns i Minern. Skriv del av namnet på jobbet i sökrutan, eller bläddra dig fram till jobbet och klicka på jobbets namn.
 Då laddas listan med alla datapunkter som ingår i jobbet. Sök eller bläddra dig fram till aktuell datapunkt och klicka på den.
Du får då upp en lista, där du kan välja bland värdet för datapunkten (value), eller någon av de attribut som är tillgängliga för datapunkten [3].

Om du vill ta bort någon överskrivningsregel, klickar du på knappen ”Ta bort” till höger om den aktuella raden.

 När du är klar med inställningen av dina regler, är det bara att spara datapunkten.

Glöm inte att starta jobbet igen, om du har fått stoppa ett pågående jobb för att kunna påbörja dina redigeringar.




===== ADMIN =====
 


Sista kategorin som finns i Miner är inställningar för “ADMIN” 
I denna vy så kan man ställa in behörigheter för autentisering i samband med inloggningar. Även funktioner så som uppladdning till andra typer av utdatabaser finns tillgängliga. Man får även möjlighet att hantera larmfunktioner 

 
{{:miner:intro:admin_1.png?600|}}

Den första sektionen som finns i “inställningar för Miner” är “konfiguration av Miner” 

{{:miner:intro:admin_2.png?600|}}

Här visas följande 

  * Universal Unique ID (UUID)  - Unikt ID för Miner

  * Namn - Namn för Miner

  * Miner URL-  Konfigurera webbservern och gör den kompatibel med autentisering för inloggningar



Nästkommande sektion är “Inloggningsinställningar”. Här har man möjlighet att använda sig av olika typer av inloggningsmetoder. 

{{:miner:intro:admin_3.png?600|}}

Den första metoden är en så kallad Single Sign On (SSO) av typen CAS (central authentication system). 

{{:miner:intro:admin_4.png?600|}}

  * CAS URL - URL till var SSO installationen finns. 

  * CAS roll-attribut - Vilken grupp i CAS som kan använda SSO

  * CAS-roller - Vilken användare som kan använda SSO 




Andra metoden är “Grundläggande autentisering” till skillnad från en centraliserad inloggning så är detta endast ett lösenordsskydd för att komma in på domänen för Miner

{{:miner:intro:admin_5.png?600|}}

Här får man ett val att skapa “Användarnamn” och ett “Lösenord” som man vill använda sig av för att komma åt Miner. 

Det tredje alternativet som går att använda i kombination med dem övriga är “Tillåt lokala anslutningar” 

{{:miner:intro:admin_6.png?600|}}

Det som menas med detta är att om man befinner sig i samma nätverk som Miner så har man rättighet att ansluta sig till den. Denna kan som sagt fungerar i kombination med de övriga alternativ som finns att tillgå. Kan också användas fristående. 


Det fjärde alternativet är att man inte använder sig av autentiseringar över huvud taget. **//Det är dock något som vi inte  rekommenderar.//**








Man har även som nämnts tidigare möjlighet att ställa in larmutskick under “Utskicksinställningar” 


{{:miner:intro:admin_7.png?600|}}


Detta är då möjligt att skicka larmer till en utdatabas, i detta fall så är det Orbiq som används. 

Watchdog Stalled -  Den kollar om jobben har fastnat, den skickar iväg ett ping meddelande och förväntas sig ett svar tillbaka, får den inget svar som kommer den att larma för det 

Watchdog tid aktiverat - skickar ping under ett tidsintervall. 

Orbiq Settings

{{:miner:intro:admin_8.png?600|}}

Denna ruta kommer att bli obsolet. 





Det sista kategorien är “Grafinställningar” 

Miner publicerar sin egen information och av datapunkterna som Miner har läst in.

{{:miner:intro:admin_9.png?600|}}


Detta gör det sedan möjligt att ladda upp information till en grafdatabas. 
En grafdatabas fungerar genom att lagra och hantera data som noder, kanter och egenskaper, vilket gör den särskilt bra för information som handlar om relationer.

Integrationer till grafdatabaser av typen RDF-stores (även kallade triple-stores) kan ske på olika sätt:

Miner kan publicera metadata om pågående dataintegrationsjobb till en grafdatabas.

Miner kan ställa frågor till en grafdatabas med hjälp av SPARQL och använda resultatet för att berika data från andra källor.

Miner kan publicera information från delade webbkalendrar till en grafdatabas för att skapa underlag till smarta tidkanaler.

För att nämna några exempel. 









 
 ===== Orbiqs Standardiserade lista över komponentkvalifierare =====
 

Här nedan följer benämningar för datapunkters komponeter om man använder Orbiq som utdatabas. 


 === Mätvärde ===
 
  * MV = Mätvärde

 === Inställningsvärden ===
 

  * BV = Börvärde

  * MIN = Börvärde min

  * MAX = Börvärde max

  * BVF = Börvärde förskjutning

  * GVL = Gränsvärde låg

  * GVH = Gränsvärde hög

  * STAG = Börvärde, startgräns

  * STOG = Börvärde, stoppgräns

  * STOT = Börvärde, stoppfördröjning

  * STAD = Börvärde, direktstart

  * TFD = Tillslagsfördröjning

  * FFD = Frånslagsfördröjning

 === Börvärdeskurva ===
 

X1 = Börvärde kurva, X1

... t.o.m.

X9 = Börvärde kurva, X9

Y1 = Börvärde kurva, Y1

... t.o.m.

Y9 = Börvärde kurva, Y9

 === Regulator ===

  * CP = P-konstant

  * CI = I-tid

  * CD = D-tid

  * S = Samplingstid

  * FT = Filtrering

  * DZ = Dödzon


=== Beräknat värde ===
  * BB = Beräknat börvärde

  * MB = Beräknat mätvärde

  * MVM = Medelvärde

  * VGRAD = Verkningsgrad

  * SFP = Beräknat SFP-tal

=== Indikeringar ===

  * DI = Indikering, Till

  * IF = Indikering, Från

  * IH = Indikering, HAND

  * IO = Indikering, Öppen

  * IS = Indikering, Stängd

  * ITL = Indikering, Lågfart

  * ITH = Indikering, Högfart

=== Drifttid ===

  * DT = Drifttid

  * DTA = Drifttid återställ

=== Styrning ===

  * MAN = Man/Auto

  * MM = Manöverutgång

  * SA = Styrsignal manuell

  * SS = Styrsignal digital

=== Larm ===

  * AL = Avvikelselarm

  * ALG = Avvikelselarm, gränsvärde

  * ALT = Avvikelselarm, fördröjning

  * FSLA = Frysskyddslarm

  * FFSTOG = Gränsvärde, frysskydd

  * HL = Höglarm

  * HLG = Höglarm, gränsvärde

  * HLT = Höglarm, fördröjning

  * LG = Givarfel

  * LD = Driftfel

  * LL = Låglarm

  * LLG = Låglarm, gränsvärde

  * LLT = Låglarm, fördröjning

  * LA = Larm övriga

  * LAT = Larm övriga, fördröjning

  * VGRAD-LL = Låg verkningsgrad, VVX

  * VGRAD-LLG = Gränsvärde, låglarm VVX

  * VGRAD-LLT = Gränsvärde, fördröjning låglarm VVX

=== Tid ===

  * TK = Tidkanal

  * KAL = Kalender


=== Energi- och volymmätning ===

  * E = Energi

  * P = Effekt

  * V = Volym

  * Q = Flöde

  * FAB = Fabrikat

  * VER = Version

  * TYP = Typ

  * ID = Mätar id

=== Frekvensomriktare ===

  * LC = Kommunikationsfel

  * R = Styrsignal

  * FMAX = Max frekvens

  * FMIN = Min frekvens

  * I = Ström

  * IT = Driftindikering

  * L = Summalarm

  * MA = Handkörning aktiv via lokal panel i RC


=== Datum och tid ===

  * YYMM = År månad, läs

  * YYMMW = År månad, skriv

  * DDHH = Dag timme, läs

  * DDHHW = Dag timme, skriv

  * MMSS = Minut sekund, läs

  * MMSSW = Minut sekund, skriv

  * DAYW = Veckodag, skriv

  * TRIGG = Skriv trigger



=====  Exempel på exporterad CSV-fil från miner (Larmia) =====
 

{{:miner:intro:exempel_larmia.png|}}


Det som detta exempel visar är en exporterad fil från en miner som kör ett Larmia jobb. Via denna CSV så kan man som tidigare nämnts lägga till datapunkter som ännu inte läses in. Genom att importera denna fil efter man har pausat det aktuella jobbet kan man då importera punkterna som blivit konfigurerade i CSV-filen.