This is an old revision of the document!

*Bruksanvisning ved friskmelding og utesperring av parametre i Kvalobs*
(Dersom flere levels/sensorer for samme stasjon og parameter skal sperres ute, se framgamgsmåte nederst).
Dette utføres av én i Kvdrift. Vedkommende sender bekreftelsesmail til kvdrift og klimadata@feilmeldinger.

Utføres dersom kvdrift (og klimadata@feilmeldinger) får mail av typen 1) eller 2)
eller av andre grunner vet at én eller flere parametre på én eller flere stasjoner
viser uriktig(e) verdi(er) og må sperres ute, eller at utesperrede parametre skal friskmeldes.

1) “Friskmelding Stasjon <stasjon> <stnr>,
Parametre <parametre>
Grunn: <tekst>
Av <person>
, signaturnr <nr>”

f.eks. “Friskmelding Stasjon HAKADAL 4460,
Parametre 112
Grunn: Nullstilt. Stabil.
Av Svein Olav Sundal
, signaturnr 114”

eller

2) “Stasjon <stasjon> <stnr>,
Sperr ute parametergrupper: <parametergrupper>
Grunn: <tekst>.
Av <person>
, signaturnr <nr>”

f.eks.
“Stasjon SLÅTTERØY 48330,
Sperr ute parametergrupper: Vindhastighet, Vindretning
Grunn: Feil på sensorer.
Av Yngve Øen
, signaturnr 103”

så skal 1) en eller flere parametre friskmeldes. (Framgår av meldingen)
eller 2) en eller flere parametre sperres ute. (Framgår av meldingen).

Prosedyre:
a) Direkte sletting eller innlegging i Kvalobsdatabasen
Logg inn på testserver (pr. 17/10-12 'kvalobs@dev-vm098') og utfør direkte innlegging eller sletting på denne
først for å sikre at dette går greit.
1) Ved friskmelding; direkte sletting av rad i Kvalobs-databasen:
Eksempel: Parameter 112 skal friskmeldes:
“delete from checks where stationid=15270 and qcx='QC1-0-112'“

2) Ved utesperring; direkte innlegging av rad i checks.
f.eks. 'insert into checks values (60240,'QC1-0-112','QC1-0','1','push6flag','obs;SA;;','* * * * *','2012-10-15 11:00');

Logg så inn på Kvalobs; 'ssh -X kvalobs@kvalobs' og utfør de samme sql-statements der.
OBS. OBS! Vær 100% sikker på at delete- eller insert-statement(ene)
er riktig slik at unødig sletting eller feil innlegging unngås.

b)Oppdatering av “utesperrings-fila” insert_qc1_0.sql
1) Uansett må man fra kvalobs@kvalobs1: (under /metno/kvalobs) skrive 'emacs insert_qc1_0.sql&' og oppdatere
denne filen i emacs (evt. annet editeringsverktøy).
Dersom friskmelding: Fjern raden(e) med spesifisert stationid og qcx. (Altså de som samsvarer med delete-statement(ene))
Eks. friskmelde parametre 106 (RR_1) på stasjon 36200:
-fjern raden: 'insert into checks values (36200,'QC1-0-106','QC1-0','1','push6flag','obs;RR_1;;','* * * * *','2010-12-01 11:00:00');'

2) Dersom utesperring: Legg til rad med spesifisert stationid og qcx. (Altså det eller de aktuelle insert-sql-statement(s))
F.eks. legg til raden 'insert into checks values (60240,'QC1-0-112','QC1-0','1','push6flag','obs;SA;;','* * * * *','2012-10-15
11:00');' i fila, og helst der det er naturlig dvs. etter stigende stationid nedover, slik at den er lett å finne igjen.
Tidspunktet for “insert”- raden(e) er ideelt sett når sensoren begynte å svikte. Vanlig praksis er at man
setter tidspunktet til den første reelle timen etter at man har mottatt mail om utesperring.

c) Lagre filen. N.B. Vanlig praksis er at man ALLTID oppdaterer fila “insert_qc1_0.sql” fra kvalobs1 for så
å kopiere denne til kvalobs2. Dette for å unngå to forskjellige versjoner på disse instansene.

d) Kopiere fila til 'kvalobs2' og testserver (pr. 17/10-12 'dev-vm098')
Skriv 'scp insert_qc1_0.sql kvalobs@kvalobs2:' fra kvalobs1
Skriv deretter 'scp insert_qc1_0.sql kvalobs@dev-vm098:' enten fra kvalobs2 eller kvalobs1.

Kvalobs1 og Kvalobs2 oppdateres hver normal arbeidsdag kl. 11.20 norsk tid, mens dev-vm098 oppdateres hver natt.

Merk: for å finne ut hvilke parametre man skal sperre ute:
f.eks. ved “Sperr ute parametergrupper: Vindhastighet, Vindretning” må man se i obs_pgm for stasjonen hvilke
vindparametre den observerer, alternativt kikke i datautlistingen i KRO http://kro hvilke vindparametre som kommer der.
Da skal alle de aktuelle parametre sperres ute.
For f.eks. “Sperr ute parametergrupper: Temperatur” sperrer man typisk ute TA, TAN, TAX.
For f.eks. “Sperr ute parametergrupper: Vindhastighet, Vindretning” er det typisk FF, DD, FX_1, FG_1, FG_010, DX_1 som må sperres ute.

Dersom flere levels/sensorer for samme stasjon og parameter skal sperres ute:
Samme framgangsmåte som beskrevet over, man må bare lage hver sin unike qcx og checksignature for hver ulik level/sensor som sperres ute.
Man må i parameterleddet i checksignature følge denne syntaksen: parameternavn&level&sensor&typeID (beskrevet her:
https://kvalobs.wiki.met.no/doku.php?id=kvalobs:veiledning_for_koding_av_perl-skript_og_innlegging_av_sjekkenes_metadata),
hvor i praksis kun parameternavn brukes (se eksemplene over) dersom vi snakker default level og sensor (som regel level 0, sensor 0).
Merk: Dersom det kun eksisterer étt par av unik sensor/level som skal sperres ute, så holder det med én rad i qcx,
og altså én utesperringsrad, der man i praksis ikke trenger å spesifisere level/sensor vha. nevnte &-tegn-syntaks
(selv om level og/eller sensor er forskjellig fra 0). Dette fordi det i praksis bare er én kombinasjon å sperre ute, og da blir denne tatt.

Eksempler:
Stationid 60240, paramid 112 (SA), level 0, sensor 1 samt level 0, sensor 0 skal sperres ute:
Level 0, sensor 0: Syntaks for checksignature blir da: obs;SA&&0&;; og 'QC1-0-112 for qcx
Tilsvarende for level 0, sensor 1:
obs;SA&&1&;; og 'QC1-0-112_1' i qcx (hvorav '_1' er med for å markere sensor 1). Det foreslås da å bruke f.eks. '_l1' for å markere level 1.

Stationid 17050, paramid 227 (TJM), level 0, sensor 0 samt level 20, sensor 0, og level 50, sensor 0 skal utesperres:
Level 0, sensor 0: Syntaks for checksignature blir da: obs;TJM;; og 'QC1-0-227 for qcx (legg merke til at vi ikke her trenger å skrive
obs;TJM&0&&;; fordi level 0 her blir tatt som default.
Tilsvarende for level 20, sensor 0:
obs;TJM&20&&;; og 'QC1-0-112_l20' i qcx (hvorav '_l20' er med for å markere level 20).
level 50, sensor 0:
obs;TJM&50&&;; og 'QC1-0-112_l50' i qcx (hvorav '_l50' er med for å markere level 50).

Uansett: Sjekk ALLTID (ved neste termin med data som kommer inn) at utesperringen fungerer for alle ønskede levels og sensorer!!