Quant Metering. Driftsdokumentasjon P Dok.nr. Dato Versjon

Transkript

1 Quant Metering Driftsdokumentasjon No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by any means without the prior written permission of the publisher Side 1 av 28

2 Forkortning og uttrykk Ord Forklaring Side 2 av 28

3 Innholdsfortegnelse: Forkortning og uttrykk Innledning Formål med dokumentet Målgruppe Systemoversikt Kommunikasjonsflyt Programavhengigheter Oversikt over installert programvare Oracle Microsoft Internet Information Server (IIS) Microsoft FTP server Quant Metering komponenter Komponenter som er installert på WEB server Komponenter som er installert på kommunikasjonsserver Komponenter som er installert på databaseserver Oppsett av systemet Oppsett av kommunikasjonslinjer (modem/gprs) Commserver PCU PT750 Caller Aidon DCS Plural DCS Databasetilkoblinger (Oracle) Embriq Access System PCU PT750 Caller Commserver CommserverQA Aidon DCS Plural DCS Embriq Metering web FaultFix web Måleverdieksport Embriq Integration Services JobManager TaskManager Systemspesifikke parametre CommserverQA Drift av systemet Klokke på servere Antivirus Logging Side 3 av 28

4 5.4. Start/Stopp av Quant Metering Start Stopp Feilsøking i loggfiler Embriq Access System Commserver CommserverQA Aidon DCS Plural DCS Exportmanager AutoExport PT750 caller feilsøking i Konsollapplikasjoner PCU Backup, overvåking og oppdatering Backup Overvåking Oracle databasen Bytte passord på Databaseskjema EMBRIQ Oppdatering av operativsystem / Oracle database Sletting av loggfiler Sletting backup-filer generert av kommunikajsonsprogram Commserver PCU Rutiner for feilrapportering Release Notes Quant Metering 4.6.3d feilrettinger Forbedringer/Nye funksjoner Quant Metering Feilrettinger Forbedringer/Nye funksjoner Quant Metering c Feilrettinger Forbedringer/Nye funksjoner Side 4 av 28

5 1. Innledning 1.1. Formål med dokumentet Formålet med dokumentet er å hjelpe til med daglig drift og konfigurasjonsendringer i innsamlingssystemet. Dokumentet beskriver hvordan systemet er installert, hvor det er installert, hvor man kan finne konfigureringer og hvor man kan finne fram til hva som er årsaken til feil som måtte oppstå Målgruppe Målgruppen for dokumentet er IT-Drift. Selve bruken av systemet og hvordan man kan optimalisere innsamling er ikke beskrevet i dette dokumentet. Side 5 av 28

6 2. Systemoversikt Under følger en oversikt over hvordan Quant Metering systemet er bygget opp. Quant Metering bruker systemtid, det vil si at all automatisk overgang til sommer/vintertid må skrus av på serveren. Brukergrensesnitt Forretningslogikk WEB - Embriq Mtering / FaultyFix CommServerQA JobManager TaskManager Integrasjon JobPusher Embriq Access- System AutoExport Terminalkommunikasjon Embriq Integration Services PCU 400 PT750 Caller CommServer PluralDCS AidonDCS ExportManager Datalagring Oracle Figur 1 Systemoversikt Side 6 av 28

7 Quant Metering sentralsystem er en modulær tjenesteplattform som er bygd rundt seks systemdeler, brukergrensesnitt, forretningslogikk, terminalkommunikasjon, datalagring, integrasjon mot eksterne system og kvalitetssikring. En skisse over Quant Metering sentralsystem er vist ovenfor. En kort beskrivelse av komponentene de ulike systemdelene i Quant Metering sentralsystem består av : Brukergrensesnitt o Quant Metering EM Web er det web-baserte brukergrensesnittet for Quant Metering sentralsystem. o FaultyFix FaultyFix er et web-basert brukergrensesnitt for håndtering av måleverdier som har blitt avvist av plausibilitetskontrollen i terminalkommunikasjonstjenestene. Brukergrensesnittet støttes av weblesere som Microsoft Internet Explorer (IE), FireFox, Google Chrome og Opera. Forretningslogikk 1 o CommServerQA CommServerQA er en funksjon som overvåker og korrigerer konfigurering i feltutstyr, slik som kommunikasjonsnoder og terminaler. Dens hovedoppgave er å sørge for at konfigurasjonen som er i databasen gjenspeiles på PoliNoder og PoliTermer. o JobManager JobManager skal initiere periodiske oppgaver, slik som klokkesynkronisering av kommunikasjonsnoder, broadcast lastkontroll, tidsstyrte kommandoer og restinnsamling. o o TaskManager TaskManager er en funksjon som sporer utføring av kommandoer (ikke kommandoer som går via gammelt kommunikasjonsgrensesnitt - RSPML/Switch og PCU400). EmbriqAccessSystem (nødvendig for system med PN200 kommunikasjonskonsentratorer) Mellomvare plattform som håndterer kommandoer til kommunikasjonskonsentratorer, samt innsamling av målerverdier fra disse. PCU400 brukes som Front-End. Terminalkommunikasjon o CommServer Commserver styrer kommunikasjon og datainnsamling mot alle tilknyttede kommunikasjonskonsentratorer (PoliNoder) ved hjelp av kommunikasjonsprotokollen PC570. Commserver har ett antall parallelle linjer tilgjengelig for denne kommunikasjonen og kan kommunisere med PoliNoder via GSM-, GPRS- eller TCP/IP-linjer. Antallet linjer kan utøkes ved behov. o o PluralDCS PluralDCS styrer kommunikasjon og datainnsamling mot P2P-terminaler fra ulike leverandører, slik som Landis+Gyr og Aidon5413. AidonDCS AidonDCS styrer kommunikasjon og datainnsamling mot fra Aidon GPRS SM5410 P2P-terminaler. 1 Forretningslogikk er en betegnelse på de manipuleringene som utføres av et dataprogram når man henter ut informasjon til et bestemt formål, eller på et bestemt format. Side 7 av 28

8 o o PCU400 (nødvendig for system med PN200 kommunikasjonskonsentratorer) PCU400 styrer kommunikasjon og datainnsamling mot tilknyttede kommunikasjonskonsentratorer (PoliNoder) ved hjelp av kommunikasjonsprotokollen IEC PCU400 har ett antall parallelle GSM-linjer tilgjengelig for denne kommunikasjonen. Antallet linjer kan utøkes ved behov, men hver linje krever ett GSM-modem. Merk at PCU400 må kjøres som konsollprogram på server. PCU400 består i 4 forskjellige konsollprogrammer som alle må kjøre for at PCU400 skal fungere. - DCUSRV: Ruting program mellom X05 og X61 - X05: Behandler alle kommandoer, tolker svar fra PoliNoden og holder orden på hvilken PoliNode/PoliTerm som det skal kommuniseres med. - X61: Program som kommuniserer med PN200 på IEC protokollen. - Klokkeserver: Program som setter PC tiden i de andre tre programmene. PT750 Caller (nødvendig for system med PT750 P2P-terminaler) PT750 Caller styrer kommunikasjon og datainnsamling mot tilknyttede PT750 P2P-terminaler. PT750 Caller har ett antall parallelle GSM-linjer tilgjengelig for denne kommunikasjonen. Antallet linjer kan utøkes ved behov, men hver linje krever ett GSM-modem. Merk at PT750 Caller må kjøres som konsollprogram på server. Datalagring o ORACLE database En ORACLE database benyttes for lagring av all systemkonfigurering, innsamlede måleverdier, annen systeminformasjons slik som statistikker og innlest strukturdata. Integrasjon o AutoExport Tjeneste som eksporterer ut filer til MSCONS eller GS2 format. Eksporten kan gå både automatisk og manuelt. o o Integration services Tjeneste for å overføre måleverdier til overliggende system. Tjenesten kan også opprette og administrere målepunkt og terminaler via web service. Arbeidsordre/ tredjepart system kan bruke denne tjenesten for å opprette og administrere terminaler og målere i EM. ExportManager Tjeneste for automatisk eksport av målerverdier direkte til målerverdidatabase. Side 8 av 28

9 2.1. Kommunikasjonsflyt Beskrivelse på hvordan de forskjellige komponentene kommuniserer med hverandre. Alle komponenter har kontakt med databasen (Oracle) unntatt PCU400. Det er default port, 1521, som brukes for all database trafikk. De komponentene som ikke er med i figuren kommuniserer ikke direkte med hverandre, kun med databasen. TCP EmbriqAccessSystem (Lytter på port 8000) TCP CommServerQA WS TCP TCP CommServer Aidon DCS PT750 Caller PCU400 JobPusher WEB Embriq Metering WS WS WS WS Plural DCS WS Embriq Integration Services ExportManager WS WS 3dje part Figur 2. Oversikt over hvordan de forskjellige komponentene kommuniserer med hverandre Figuren over viser hvordan de forskjellige komponentene kommuniserer med hverandre. Det er to forskjellige metoder som brukes XML over TCP/IP (TCP) og kommunikasjon gjennom Web Services (WS). For de komponentene som bruker TCP/IP står det hvilken port de forskjellige komponentene lytter på. Alle TCP porter som benyttes er konfigurerbare ved å endre oppsett konfigurasjonsfilene for de forskjellige komponentene. Side 9 av 28

10 2.2. Programavhengigheter Oversikt over hvilke programmer som er avhengige av hverandre for å fungere optimalt. Figuren tolkes slik at komponentene er avhengige av de som står over dem på listen. Database EmbriqAccessSystem AutoExport ExportManager CommServer Aidon DCS Plural DCS PCU400 PT750 WEB Embriq Metering / FaultyFix CommServerQA EmriqIntegrationServices Figur 3. Oversikt over programavhengighet Side 10 av 28

11 3. Oversikt over installert programvare 3.1. Oracle Quant Metering fungerer på Oracle versjon 10g og høyere Microsoft Internet Information Server (IIS) IIS og ASP.NET 4.0 må være installert på serveren for å kunne kjøre Quant Metering. Quant Metering krever fra og med versjon minimum WINDOWS 2008 SR Microsoft FTP server Microsoft sin FTP server eller en annen FTP server må installeres dersom man eksporterer måleverdier ut på filformater som GS2 eller MSCONS Quant Metering komponenter Quant Metering sentralsystem inneholder følgende komponenter som kan være installert på en eller flere servere Komponenter som er installert på WEB server Komponent : Program/Servicenavn : Mappeplassering : Brukergrensesnitt EM Web Web-applikasjon \web\embriqmetering FaultyFix Web-applikasjon \web\faultyfix Microsoft komponenter Internet Information Server (IIS) Standard plassering valgt av installasjonsprogram FTP server Standard plassering valgt av installasjonsprogram Dataeksport Automatisk eksport AutoExport Oracle komponenter Oracle Client 11g r2 32/64 bit 3djeparts programmer 7zip Textpad Komponenter som er installert på kommunikasjonsserver Komponent : Program/Servicenavn : Mappeplassering : Forretningslogikk QA (Quality assurance) EmbriqCommserverQA \EmbriqAccessSystem\CommserverQA \CommserverQA.exe JobManager Embriq Job Manager \EmbriqAccessSystem\EIS\ JobManager\JobManagerSrvc.exe TaskManager Embriq Task Manager \EmbriqAccessSystem\EIS\ Side 11 av 28

12 TaskManager\TaskManagerSrvc.exe EmbriqAccessSystem esolswitch30_xx 2 \EmbriqAccessSystem\Switch\ Switch.exe + SwitchSrvc.cfg esollogserver \EmbriqAccessSystem\Logserver\ Logsrvc.exe Terminalkommunikasjon Commserver Embriq AMS Commserver E \EmbriqAccessSystem\Commserver\ CommServerService.exe PluralDCS Embriq P2P Metering Services \EmbriqAccessSystem\EIS\ PluralDcs\PluralDcsService.exe AidonDCS Embriq DataCollection Service \EmbriqAccessSystem\AidonDcs\ AidonDcsService.exe PCU400 Konsollprogrammer o DCUSRV \Rcs400\Run\dcusrv.exe o X05 \Rcs400\Run\x05.exe o X61 \Rcs400\Run\x61.exe o Klokkeserver \Rcs400\Run\ClkSrv.exe PT750 Caller Konsollprogram \EmbriqAccessSystem\PT750Caller\750 Datainnhenting.cmd Integrasjon ExportManager Embriq ExportManager \EmbriqAccessSystem\EIS\ ExportManager.exe Integration service Embriq Integration Services \EmbriqAccessSystem\EIS\ IntegrationServices\intsrvc.exe Oracle komponenter Oracle Client 11g r2 32/64 bit 3djeparts programmer 7zip Textpad Visual Studio Redristributable enus/download/details.aspx?i package» d= Komponenter som er installert på databaseserver Komponent : Program/Servicenavn : Mappeplassering : Oracle komponenter Oracle Server 11g r2 64 bit 2 XX er forkortelse for kunde, f.eks AE for Agder Energi. Side 12 av 28

13 4. Oppsett av systemet 4.1. Oppsett av kommunikasjonslinjer (modem/gprs) Det finnes mulighet for å kommunisere via flere kommunikasjonsbærere i Embriq Metering. De mest brukte er dog Oppringt via GSM data, ISDN eller analoge modem TCP/IP (GPRS) Det finnes flere kommunikasjonsmoduler, men ingen av dem kan dele linjer. Brukes oppringt må det av den grunn dedikeres egne modem til hvert av programmene. Når det gjelder TCP/IP så er ikke dette støttet av alle kommunikasjonsprogrammene Commserver Alle kommunikasjonslinjer til commserver er definert i databasen i en tabell som heter «pn_com_lines». For å legge til, endre eller ta bort linjer kreves det databasekunnskap. For å legge til en ny linje INSERT INTO pn_com_lines (line, name, port, baudrate, linetype, lockport, modeminit, modemreboot, modemdialprefix, created) VALUES ((SELECT MAX(line) + 1 FROM pn_com_lines), 'GSM Modem COM 10', portnummer, baudrate, linjetype, 0, 'Modem init', 'Modem reboot', Modem oppringingsprefiks', SYSDATE); Verdier uthevet i rødt må erstattes med nye verdier. - Navn: Beskrivende navn på linjen, fritekst - Portnummer: COM port nummer eller TCP/IP port. For TCP/IP er standard portnummer Baudrate: Forteller hvilken hastighet modem skal kommunisere med. For linjetype 2 skal strengen være tom (NULL). For resten er den normalt Linjetype: Type linje. Det kan velges mellom følgende linjetyper: o 1 Oppringt (GSM) o 2 TCP/IP (GPRS) o 3 Direkte o 4 Multidrop direkte o 5 Analogt modem o 6 Multidrop modem - Modem Init : Modemkommando som brukes for å initialisere modemet. For linjetype 2, 3 og 4 skal strengen være tom (NULL). For GSM modem er den normalt ATE0 +CBST=71,0,1 - Modem reboot : Modemkommando som brukes for å reboote modem. For linjetype 2, 3 og 4 skal strengen være tom (NULL). For GSM modem er den normalt AT+CFUN=1,1 - Modem oppringingsprefiks : Kommando som brukes for å fortelle at modem skal ringe opp et telefonnummer. For linjetype 2, 3 og 4 skal strengen være tom (NULL). For de aller fleste modem er den normalt «ATD». Eksempel 1, Siemens GSM modem på COM port 10: INSERT INTO pn_com_lines (line, name, port, baudrate, linetype, lockport, modeminit, modemreboot, modemdialprefix, created) VALUES ((SELECT MAX(line) + 1 FROM pn_com_lines), 'GSM Modem COM 10', 10, 9600, 1, 0, 'ATE0 +CBST=71,0,1', 'AT+CFUN=1,1', 'ATD', SYSDATE); Side 13 av 28

14 Eksempel 2, TCP/IP (GPRS linje): INSERT INTO pn_com_lines (line, name, port, baudrate, linetype, lockport, modeminit, modemreboot, modemdialprefix, created) VALUES ((SELECT MAX(line) + 1 FROM pn_com_lines), 'TCP/IP Linje 10', 6001, NULL, 2, 0, NULL, NULL, NULL, SYSDATE); For å endre bruker man UPDATE kommandoen og linjenummeret på den linjen man skal endre. For å slette en linje bruker man DELETE kommandoen og linjenummeret.. Etter at SQL kommandoen er kjørt avslutter man med COMMIT og en restart av COMSERVER slik at den kan lese inn det nye linjeoppsettet PCU 400 Å sette opp nye, endre eller slette linjer i PCU400 er litt komplisert. Ta derfor kontakt med Embriq support for å få hjelp til dette PT750 Caller Linjene i PT750 Caller er definert i en tilhørende konfigurasjonsfil (XML fil). Filen heter normalt modemfiletransfere.xml og åpnes i en vanlig tekst eller XML editor. I seksjonen som heter RS232SETTINGS kan det være et eller flere modem definert. For å legge til et modem legges det en ny MODEM seksjon. Se eksempel under <MODEM> <COMPORT>COM27:</COMPORT> <BAUDRATE>9600</BAUDRATE> <PROTOCOL>AT E0 +CBST=71,0,1</PROTOCOL> <DIGITAL_MODEM>Y</DIGITAL_MODEM> </MODEM> Se hvordan de foregående modem er definert og legg til en ny seksjon med et annet COM port nummer og eventuelt en annen modeminit streng som ligger i PROTOCOL taggen. For å endre en linje så endres verdiene i de forskjellige taggene til slik de skal være. For å ta bort en linje(modem) slettes hele MODEM taggen. Etter at nødvendige endringer er gjort lagres filen og PT750 Caller programmet stoppes og startes på nytt igjen slik at det kan lese de nye innstillingene Aidon DCS Aidon DCS bruker modem for å «vekke opp» terminalen slik at de igjen tar kontakt på TCP/IP over GPRS. Modemene som skal brukes til dette må settes opp i konfigurasjonsfilen til programmet, dcs.config. I taggen GsmManager defineres de modemene som skal brukes. <GsmModem ComPort="COM3" BaudRate="9600" DataBits="8" Parity="none" IgnoreFa ult="true" Type="local" modeminit="ate0\q3+cbst=7,0,1"/> For å legge til et modem legges det inn en ny tilsvarende tag som vist over. Programmet må stoppes og startes igjen for at de nye innstillingene skal bli aktive. For å endre på linken endres aktuelle parameterverdier. Side 14 av 28

15 For å ta bort et modem slettes hele taggen (GsmModem). 4.. Plural DCS Linjene settes opp i filen PluralDcsConfig.XML i seksjonen LinePool. Alle TCP/IP linjer ligger i samletag, DynamicTcpLines. Her er det to parametere, der allow alltid står til «true» og maksimalt antall parallelle linjer over Tcp/IP (maxlines) brukes til å begrense kommunikasjons kapasiteten tilegnet denne driveren. <DynamicTcpIpLines allow="true" maxlines="50"/> Etter at ønskede parametere er endret må programmet/servicen stoppes og startes på nytt igjen Databasetilkoblinger (Oracle) De aller fleste programmene i Embriq Metering har kontakt med databasen. Tilkoblingsinformasjonen ligger i konfigurasjonsfilene til de forskjellige programmene. Det som legges inn for hvert enkelt program er brukernavn, passord og database SID Embriq Access System Det ligger databaseinformasjon i følgende filer: - \EmbriqAccessSystem\Switch\switch.cfg - \EmbriqAccessSystem\Switch\etc\datacollectadp.xml - \EmbriqAccessSystem\Switch\etc\configadapt.xml - \EmbriqAccessSystem\Switch\etc\rspml.xml - \EmbriqAccessSystem\Jobpusher\jobpusher.xml - \EmbriqAccessSystem\datacollect_activator_ver_2\datacollectsender.xml Databaseinformasjonen er enkel å lokalisere i alle filene PCU 400 PCU400 har ikke direkte kontakt med databasen. Alt går via Embriq Access System, PT750 Caller Det ligger databaseinformasjon i følgende filer: - \EmbriqAccessSystem\PT750Caller\PolicomPTControlModem.xml <DBUser>embriq_metering</DBUser> <DBPass>vin67h99</DBPass> <DBServ>embriq</DBServ> Commserver Det ligger databaseinformasjon i følgende fil: - \EmbriqAccessSystem\CommServer\CommServerConfig.xml <Database DataSource="embriq" User="embriq_metering" Password="vin67h99" /> - \EmbriqAccessSystem\CommserverQA\QAConfig.xml <Database DataSource="embriq" User="embriq_metering" Password="vin67h99" /> Side 15 av 28

16 CommserverQA Det ligger databaseinformasjon i følgende fil: - \EmbriqAccessSystem\CommServerQA\QAConfig.xml <Database DataSource="embriq" User="embriq_metering" Password="vin67h99" /> Aidon DCS Det ligger databaseinformasjon i følgende filer: - \EmbriqAccessSystem\AidonDCS\config\dcs.config <Database DataSource="embriq" User="embriq_metering" Password="vin67h99"/> Plural DCS Det ligger databaseinformasjon i følgende fil: - \EmbriqAccessSystem\EIS\PluralDcs\PluralDcsConfig.xml Databaseinformasjon kan ligge i flere tagger (DomainConfig) som ligger i Domain taggen. <Database source="embriq" user="embriq_metering" password="vin67h99"/> Merk at databaseinformasjonen kan ligge flere steder. Plural DCS er bygget opp for å kunne kommunisere med flere målertyper som har forskjellige protokoller. Under taggen Domain kan det være en eller flere DomainConfig som hver har eget databaseoppsett Embriq Metering web Databaseinformasjonen ligger i web.config filen for begge applikasjonene og ligger i seksjonen connectionstring - \EmbriqAccessSystem\WEB\EmbriqMetering\web.config <add name="datasource" connectionstring="data Source=embriq;Persist Security In fo=true;max Pool Size=100; User ID=embriq_metering;Password=vin67h99" providern ame="system.data.oracleclient"/> FaultFix web Databaseinformasjonen ligger i web.config filen for begge applikasjonene og ligger i seksjonen connectionstring - \EmbriqAccessSystem\WEB\FaultyFix\web.config <add name="datasource" connectionstring="data Source=embriq;Persist Security In fo=true;max Pool Size=400; User ID=embriq_metering;Password=vin67h99" providern ame="system.data.oracleclient"/> Måleverdieksport Det ligger databaseinformasjon i følgende filer: - \EmbriqAccessSystem\AutoExport\AutoExportSrvc.exe.config <add key="datasource" value="embriq"/> <add key="user" value="embriq_metering"/> <add key="password" value="vin67h99"/> Side 16 av 28

17 Embriq Integration Services Det ligger databaseinformasjon i følgende filer: - \EmbriqAccessSystem\EIS\IntSrvc.exe.config Informasjon ligger i følgende seksjoner: <setting name="dbsource" serializeas="string"> <value>embriq</value> </setting> <setting name="dbuser" serializeas="string"> <value>embriq_metering</value> </setting> <setting name="dbpassword" serializeas="string"> <value>vin67h99</value> </setting> JobManager - \EmbriqAccessSystem\EIS\JobManager\JobManagerSrvc.exe.config Databaseinformasjonen ligger i følgende tag: <add name="datasource" connectionstring="data Source=embriq;Persist Security Inf o=true;user ID=embriq_metering;Password=vin67h99" providername="oracle.dataacces s.client" /> TaskManager - \EmbriqAccessSystem\EIS\TaskManager\TaskManagerSrvc.exe.config Databaseinformasjonen ligger i følgende tag: <add name="datasource" connectionstring="data Source=embriq;Persist Security Info =True;User ID=embriq_metering;Password=vin67h99" providername="oracle.dataaccess. Client" /> 4.3. Systemspesifikke parametre CommserverQA Polinode parameter synkronisering VIKTIG! Denne funksjonen vil blant annet skrive ned GPRS konfigurasjon til alle PoliNoder i systemet. Les derfor teksten under nøye. Funksjonen aktiveres ved å sette følgende parameter i qaconfig.xml <Component filename="polinodeconfigcheck.dll" name="polinodeconfigcheck.polinodeconfigcheck">... <AllowSyncronizePolinodeParameters>true</AllowSyncronizePolinodeParameters>... </Component> Parameterfilen i alle PoliNoder i systemet vil synkroniseres mot data i filen: «PN_PARAM_CONFIG.xml». Denne filen skapes med «default» data dersom den ikke eksisterer når systemet startes, men systemet vil ikke starte før innholdet i fila er korrigert. Side 17 av 28

18 Eksempel konfigurasjon, PN_PARAM_CONFIG.xml: <?xml version="1.0" encoding="utf-8"?> <PolinodeParametersConfig xmlns:xsi=" xmlns:xsd=" <ValidMachineId>ddd5d804-e0ba a1e6b251fb68</ValidMachineId> <ConfigurationParameters> <GprsTcpEmbriqMetering_IP> </GprsTcpEmbriqMetering_IP> <GprsUdpEmbriqMetering_IP> </GprsUdpEmbriqMetering_IP> <GprsTcpEmbriqMetering_Port>10000</GprsTcpEmbriqMetering_Port> <GprsUdpEmbriqMetering_Port>19000</GprsUdpEmbriqMetering_Port> <GprsAPN>apn.xyz.no</GprsAPN> <GprsListenPort>11000</GprsListenPort> <GprsUsername>none</GprsUsername> <GprsPassword>none</GprsPassword> </ConfigurationParameters> </PolinodeParametersConfig> ValidMachineId (!) Dette er en sikkerhetsmekanisme som sikrer at konfigurasjonen i denne fila faktisk tilhører systemet. Den fungerer ved å bruke en unik maskin identifikator og sammenligne med verdien i dette elementet. Dersom det ikke er likt vil ikke denne komponenten starte, og en feilmelding skapes i loggen. Maskin identifikatoren kan hentes ved å starte et program som ligger sammen med CommserverQA.exe «GetMachineId.exe». Alternativt, kan det hentes via «regedit»: HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Cryptography\\MachineGuid ConfigurationParameters/* GprsTcpEmbriqMetering_IP IP adressen til innsamlingssystemet. GprsUdpEmbriqMetering_IP IP adressen til innsamlingssystemet GprsTcpEmbriqMetering_Port Porten innsamlingssystemet lytter etter TCP meldinger fra Polinode F.eks keepalive og alarm/hendelser. GprsUdpEmbriqMetering_Port Porten innsamlingssystemet lytter etter UDP meldinger fra Polinode Per i dag gjelder det kun Pt8xx timestander. GprsAPN APN Polinode skal koble seg opp mot. GprsListenPort Porten (TCP) Polinode lytter på etter oppkoblinger over GPRS GprsUserName Brukernavn mot APN GprsPassword Passord mot APN Synkroniseringen av disse innstillingene skjer normalt hver dag, som konfigurert i qaconfig.xml og kjører mot alle PoliNoder. Side 18 av 28

19 5. Drift av systemet 5.1. Klokke på servere Klokken på kommunikasjonsserver skal alltid gå i normaltid. Det må passes på at automatisk justering for sommer/vintertid er slått av. Når det gjelder webserver og databaseserver så kan de om ønskelig settes til automatisk å følge sommer/vintertid. Det anbefales også at serverklokkene automatisk justeres mot en atomklokke daglig. Dette kan gjørs ved å justere klokken mot kjente klokke-tjenester (NNTP servere) på internett Antivirus Antivirus som kjøres på databaseserver må ikke scanne databasefiler som ligger under databasekatalogen(e). Hvis dette gjøres kan det medføre låsing av databasefiler og i verste tilfelle medføre at databasen blir korrupt. Det vil også medføre at databasen går saktere Logging Logserveren logger til mappen som angitt i kapittel 3.4. Alle servicene har sin egen loggmappe. I loggfilen logges det en linje om gangen. Linjen har format på denne måten: INFO [Dec#2,CommandDecoder] MELDING [DATO] [KLOKKE] [LOGGNIVÅ] [TRÅD] MELDING Siste innkomne melding ligger alltid nederst i filen. Dette formatet gjelder for alle loggfilene Start/Stopp av Quant Metering Start De ulike Quant Metering-komponentene kan startes uavhengig av hverandre. Rekkefølgen nedenfor er likevel anbefalt. Starte Quant Metering komponentene: esollogserver esolswitch30_xxx esoldatacoll2_xxx EmbriqCommserverQA EmbriqIntegrationServices (avhengig av installasjon) Embriq Job Manager EmbriqJobPusher_XXX Embriq P2P Metering Services (avhengig av installasjon) Embriq Task Manager AutoExport XXX vil variere fra installasjon til installasjon. Normalt erstattes XXX med forkortelsen til nettselskapet. Side 19 av 28

20 Start av PCU400 På skrivebordet er det lagt opp snarveier for de programmene som skal startes. o Dobbeltklikk på «1. DCUSRV» snarveien. o Dobbeltklikk på «2. X61» snarveien. o Dobbeltklikk på «3. X05» snarveien. o I X05 vinduet kommer det opp en del tekst. Vent til teksten «Linepool activated» dukker opp o Dobbeltklikk på «4. Klokkeserver» snarveien. Start av PT750 Caller Dobbeltklikk på «5. PT750 Caller» snarveien Stopp Før stopp av systemet må alle operatører varsles slik at de ikke jobber med systemet når det stenges ned. Dersom de arbeider i systemet når det stenges kan arbeid gå tapt. Er det ikke IT-drift som tar ned systemet må de også varsles dersom de har overvåking av serverne. For å stoppe Quant Metering komponentene stoppes alle startede Embriq servicer som er listet opp i esollogserver stanes til slutt, utover dette er det ingen rekkefølge: Stopp av PCU400 og PT750 Caller Steng konsollvinduene. Det spiller ingen rolle i hvilken rekkefølge de stenges. Side 20 av 28

21 5.5. Feilsøking i loggfiler De aller fleste komponenter generer loggfiler over hva de gjør og hva som feiler eller har meldinger som vises i konsollvinduer. Den enkleste måten å finne feil er derfor å se gjennom disse filene for å se om de inneholder feilmeldinger Embriq Access System Alle meldinger som sendes gjennom Embriq Access System blir også skrevet til fil sammen med eventuelle feilmeldinger. Det lagres normalt 10l filer med begrenset størrelse som det hele tiden roteres på. Filene ligger i lagret i \EmbriqAccessSystem\Logs katalogen og heter mxtracex.log der X er nummeret på loggfilen. X varierer fra 1 til maksimum antall loggfiler. Det er ikke nødvendigvis den filen med høyest tall som er den nyeste, men den med det ferskeste datostempelet på filen. Dersom man vet når den eventuelle feilen oppstod så er de bare å søke seg fram til dette tidspunktet i aktuell fil. Alle linjene i filen begynner med et datostempel på formatet «YYYYMMDD HHmmSS». Normalt er det Oracle som er årsaken til at programmet stopper opp. Søk derfor etter ORA- meldinger i filene for å finne feilmeldinger som er generert på grunn av Oracle Commserver Commserver logger det meste som den foretar seg og lager en loggfil for hver dag. Fil for inneværende dag heter commserver.log og ligger i katalogen \EmbriqAccessSystem\Commserver\Logs. Oppbygging på loggfil: Tidsstempel Hendelsestype Kommunikasjonslinje Meldingstekst - Tidsstempel har format «YYYYMMDD HHmmSS». - Hendelsestype kan være enten DEBUG, INFO, WARN eller ERROR. - Kommunikasjonslinje forteller hvilken linje som brukes i kommunikasjonen. Linjene er definert i tabellen pn_comm_lines i databasen. Feil som oppstår ved kommunikasjonen mellom program og PoliNode/PoliTerm begynner alltid med teksten «ERROR» rett etter tidsstempelet. Er det problemer med kommunikasjonen mot en PoliNode/PoliTerm så kan man finne en plausibel forklaring på dette her. Uventede hendelser/feil medfører at programmet går inn i unntaksbehandling. Disse feilene finnes ved å søke etter ordet «Exception». Eventuelle Oracle tilkoblingsfeil, feilaktige data i databasen og problemer med kommunikasjonslinjer vil medføre i «Exceptions». I unntaket som logges til fil vil det også stå hva som er feil CommserverQA Commserver logger det meste som den foretar seg og lager en loggfil for hver dag. Fil for inneværende dag heter csqa.log og ligger i katalogen \EmbriqAccessSystem\CommserverQA\Logs. Filene er bygget opp på akkurat samme måte som for Commserver i Side 21 av 28

22 Aidon DCS Aidon DCS logger det meste som den foretar seg og lager en loggfil for hver dag. Fil for inneværende dag heter aidondcs.log og ligger i katalogen \EmbriqAccessSystem\AidonDCS\Logs. Filene er bygget opp på akkurat samme måte som for Commserver i Plural DCS Plural DCS logger det meste som den foretar seg og lager en loggfil for hver dag. Fil for inneværende dag heter pluraldcs.log og ligger i katalogen \EmbriqAccessSystem\PluralDCS\Logs. Filene er bygget opp på akkurat samme måte som for Commserver i Exportmanager Export logger det meste som den foretar seg og lager en loggfil for hver dag. Fil for inneværende dag heter embriqexportmanager.log og ligger i katalogen \EmbriqAccessSystem\Logs\ExportManager. Filene er bygget opp på akkurat samme måte som for Commserver i Alle verdier som sendes over til 3dje-part logges samt alle feil som oppstår AutoExport AutoExport programmet/servicen logger alle feil og hendelser i loggfilen autoexport.log som ligger i katalogen \EmbriqAccessSystem\Logs\Autoexport. I tillegg kommer noen hendelser i Event Viewer i Windows. Det er typisk Oracle feil/problem som er årsaken til at programmet/servicen feiler PT750 caller PT750 Caller logger det meste som den foretar seg og lager en loggfil for hver dag. Fil for inneværende dag heter embriqexportmanager.log og ligger i katalogen \EmbriqAccessSystem\Logs\PT750. Filene er bygget opp på akkurat samme måte som for Commserver i feilsøking i Konsollapplikasjoner PCU400 PCU400 genererer ikke noen loggfiler. Alt som hender vises i konsollvinduene som alltid må være åpne. Ting som kan gå galt her er at programmet X05 mister kontakt med Embriq Access System eller at programmene ikke kommer i gang ordentlig. For at PCU400 skal fungere må det være kontakt med alle modem som er satt opp i programmet. Er det ikke kontakt med alle modemer vil den nekte å ta kontakt med PoliNodene. Så snart alt er på plass vil det komme opp «Linepool activated» i X05 og programmet vil da respondere på kommandoer som mottas. Side 22 av 28

23 De fleste «feil» som oppstår her er at programmet ikke får kontakt med PoliNodene, at forbindelsen mellom programmet og PoliNodene er for dårlige eller at PoliTermene ikke svarer Backup, overvåking og oppdatering Backup Det oppfordres sterkt til full ukentlig backup av databasen og innstillingsfilene til Oracle, samt daglig inkrementell backup av databasen. Loggmappen og eksportmappene bør det tas backup av hver dag, og de bør beholdes for minst 1 uke for feilsøkingshensyn Overvåking Systemet bør overvåkes hvis det eksisterer programvare for dette. Dersom dette eksisterer bør følgende overvåkes: HDD plass Bør flagges ved 40% ledig plass og kritisk nivå når det er 13% ledig PageFile utnyttelsesgrad Minst 50% ledig Arkiver logger Overvåk og slett 4+ dager gamle logger Overvåking av Windows prosessene under som hører til Windows og som ikke er installert som default på Windows 2003/2008 o nmsrvc.exe, Del av Oracledatabasen som håndterer det webbaserte administrasjonsgrensesnittet o nmz.exe, Del av Oracledatabasen som skal kjøre o tnslsnr.exe, Del av Oracledatabasen som skal kjøre for å kunne initiere oppkoblinger mot databasen fra en annen plass o ORACLE.EXE, hovedkomponenten i Oracledatabasen, skal kjøre o inetinfo.exe, Del av Microsoft Windows Server Internet Information Services som håndterer feilsøking men også visse andre HTTP og FTP funksjoner o w3wp.exe, Del av Microsoft Windows Server Internet Information Services som blant annet håndterer applikasjons pool ene. Metering ligger som en egen applikasjonspool. o I tillegg må alle servicene nevnt i kapittel 3.4 Quant Metering komponenter også overvåkes Oracle databasen Kontroll av Oracle databasens feillogger og ytelseskontroll mot Metering skal sjekkes via Oracle Database Manager hver uke av Oracle DBA Bytte passord på Databaseskjema EMBRIQ For å bytte passord skal systemet stoppes som beskrevet i kapittel Etter dette kan man bytte passord. Når passordet er byttet må alle konfigurasjonsfilene oppdateres for at systemet skal fungere, se 4.2. Etter dette skal systemet startes som i kapittel Oppdatering av operativsystem / Oracle database Kunden kan oppdatere serverens Windows installasjon i henhold til egne oppdateringsregler. Før en oppdatering gjennomføres skal driftspersonell for Metering varsles slik at det ikke pågår jobbing mot systemet under oppdateringen. Dette gjelder også patching/oppgradering av Oracle. Side 23 av 28

24 5.8. Sletting av loggfiler De aller fleste programmene vil generere uendelig med loggfiler helt til all diskplass er brukt opp. Det er derfor viktig at gamle loggfiler blir slettet regelmessig. I utgangspunktet er de aller fleste loggfilene ferskvare, men siden terminalen har en lagringskapasitet på opptil 60 døgn så kan det være lurt at man hele tiden har loggfiler for opptil 60 døgn tilbake i tid. Hvor filene er lagret er beskrevet i kapittel Sletting backup-filer generert av kommunikajsonsprogram Noen av kommunikasjonsprogrammene lagrer filene som lastes opp i fra PoliNodene som en backup og for å ha mulighet til å feilsøke dersom det mangler data eller data som hentes inn er feilaktig. Det er to programmer som lagrer unna alle filer som hentes inn, Commserver og PCU400. Hva som kan slettes: Terminalene har en maksimal lagringskapasitet på 60 døgn med timeverdier og/eller timestander. I utgangspunktet kan det lages rutiner som sletter filer som er eldre enn 60 døgn siden det da ikke er mulig å verifisere innhentet data med data i terminalene Commserver Commserver lagrer alle filene i katalogen \EmbriqAccessSystem\CommServer\backup. Det generes en katalog for hver måned med formatet «YYYY-MM» PCU400 PCU400 lagrer alle sine backupfiler i katalogen \Rcs400\Run\backup. Alle filer som hentes opp lagres i denne katalogen. Filene har format «xxxxx YYYY-MM-DD HHmmSS ln_tp.bin», der xxxxx er Polinodenummer, ln er linjenummer som brukes har blitt brukt i kommunikasjonen og tp er type fil (tm data fra automatisk innsamling, fl data fra manuelle kommandoer eller statistikk) Rutiner for feilrapportering Ved feil som ikke kan rettes ved hjelp av dette dokumentet eller vedlegget vennligst kontakt oss via servicedesk på Side 24 av 28

25 6. Release Notes [EMME-XXX]: intern Embriq referanse 6.1. Quant Metering 4.6.3d 6.2. feilrettinger Ringe alle PoliNoder som mangler 100% fra rapporten manglende timesverdier feilet [EMME-495] Forbedringer/Nye funksjoner Lagt inn støtte for L+G E850 [EMME-591] 6.3. Quant Metering Feilrettinger Feil ved henting av manglende verdier / stander fra rapportene manglende verdier / stander når PoliNoden er multidrop [EMME-493] Autoexport - Bruk av CREATED virker ikke [EMME-509] Første time blir borte fra eksport med sommertid og bruk av created parameter [EMME-510] Feil i terminalkodeoversikt [EMME-516] Manuelle kommandoer i rapporten manglende målerstander slutter virke om flagget AT40Days er 0 [EMME-522] Feil ved CREATED i GS2 eksporten [EMME-526] Manuell eksport fra EM Web generer ikke GS2 fil [EMME-527] PT830 trafokonstant virker ikke for timesverdier [EMME-533] [EMME-539] Feil i låsing til node fra rapport [EMME-534] Feil i funksjon for målersnurr for L+G E650 [EMME-537] Selvmeldingsrapport: Viser ikke hvilke node som PT er meldt opp til [EMME-542] Ikke mulig å slette terminaler i lastkontrollgruppe [EMME-547] Lastkontroll: Feil visning av utkoblet effekt for enkelte målere [EMME-548] Eksport flere målepunkt. Fungerer ikke med komma som skille [EMME-551] Manuelle kommandoer mot enkelt terminaler fra manglende stander rapporten generer ikke kommandoer [EMME-559] Klokkereferanser i systemet er ikke entydig [EMME-566] Vise oppsett av automatisk oppringing [EMME-567] Oppsummering av oppringingsliste skal vise hvilke som feilet [EMME-568] Låsing av PT8x0 til PoliNode feiler [EMME-571] Commserver lagrer ikke alltid timestander korrekt på PT8x0 [EMME-573] Inkonsekvent håndtering av små og store bokstaver ved generell søk [EMME-574] Enhetlig visning av firmware versjon for PoliTerm [EMME-576] En del PoliNoder med SW v f lagrer ikke GSM statistikk i Embriq Metering [EMME-584] Eksport til Excel har en "tom" kolonne [EMME-587] Rettet ledetekster for eksport til GS2 og MSCONS [EMME-588] Side 25 av 28

26 Automatisk oppdatering av eksportstatus ved manuell eksport fungerer ikke [EMME-593] Søk etter måler som ikke har målergruppe lister ikke de som har blank målepunktid [EMME-599] Lastkontroll: Relé på kanal 2 ble ikke rapportert korrekt [EMME-603] Bryterstatus på 5A målere skal ikke vises [EMME-604] #Step får et datostempel dersom en måler mangler data [EMME-607] Målergrupper: PT8x0 medfører 4 målere i gruppen. [EMME-636] Ved endring av måleravlesningsgruppe ble det sendt kommando til node [EMME-97] Fikk ikke trykke bruk i rekonfigurerte terminaler [EMME-242] Forbedringer/Nye funksjoner Politermsøk > mulighet til å søke/liste ut både main og dlc firmware på terminaler [EMME-385] Håndtering av multidrop via EM Web [EMME-411] Teksten for bryter tilkoplet er nå tatt bort for LPU631, LPU730, PT740, PT741, PT750, PT760, PT770, PT780 og gamle Aidon GPRS målere [EMME-486] Legge til terminal ID i søkeresultat fra generelt søk [EMME-504] Søk sekundær nummer PoliNode [EMME-508] Fjerne tidsstyring av GPRS P2P [EMME-520] Hente og vise målertype fra terminal [EMME-521] Endre kanalnummer til OBIS benevnelser for PT8XX [EMME-525] Oppdatere CommserverQA til kun å skrive GPRS connection data til noder som har kommunikasjonsmetode tcpip [EMME-528] Konfigurasjon for å enable endring av strupeverdier [EMME-529] Strøm kommer inn på 5A anlegg. Denne må ganges med konstanten for å være riktig [EMME-543] Endre nodekonfigurasjon til å støtte grupper [EMME-557] Oppgradere QA til å kjøre.net 4 [EMME-558] Felt for å angi eksport av måleverdi til Elwin [EMME-569] Forbedring av resultatlisten ved generell søk [EMME-575] Støtte for å sette trafokonstant i GUI [EMME-577] Støtte for LAN kort [EMME-580] Clean-up funksjon for å slette alle PT8x0 på noder de ikke er låst [EMME-581] Manuell GS2/MSCONS eksport av dagens verdier [EMME-582] Tidsstempel på status for PT8x0 [EMME-589] Fjerne fasefeil fra PT8x0 enfase terminaler/målere [EMME-590] Nye felt for skalering for L&G P2P målere i PluralDCS [EMME-592] Legge til nytt felt for telefonnummer for pluraldcs og legge støtte for disse inn i Radius [EMME-594] Filtrering målerstatus for PT8x0 [EMME-596] Lastkontroll for PT8x0 [EMME-597] Støtte for å definere digital utgang for PT8x0 [EMME-600] Automatisk eksport av dagens timeverdier [EMME-601] Støtte for valg av displaysekvens for PT830 [EMME-605] Krav av låsing av nye PT8XX ved redigering av terminal [EMME-653] Filtrere rekonfigurerete Terminaler til kun vise PT740, PT741 og PT750 [EMME-683] Rekonfigurerte terminaler. Kun terminaler som kan skrives til skal komme i listen [EMME-685] Filtrere bryterstatus (tta hensyn til at noen målere ikke har brytere) [EMME-687] Side 26 av 28

27 Sortering av målere i PoliTerm bildet [EMME-688] Database rydding av logg tabeller [EMME-351] Støtte for tilgangskontroll i node [EMME-357] Mer info om måler i terminal konfig bildet [EMME-416] Lese trafokontant fra måler i PT820/830 [EMME-425] Mulighet for å ikke lagre datagram fra pt8xx som fil [EMME-489] Støtte i EM for passord på PoliNode [EMME-546] [EMME-564] Mulighet for bokstaver/tegn i målernummer og målepunktid [EMME-550] Ny rapport: datasjekk timeverdier [EMME-507] [EMME-556] Konfigurasjon av jordfeilsovervåking for PT830 [EMME-606] Node alarmteller [EMME-679] Kommunikasjonsgraf på forsiden som viser de mest aktive PoliNodene og kommunikasjonsgraf på hver enkelt PoliNode [EMME-680] 6.4. Quant Metering c Feilrettinger Feil trafo/nettstasjon ble vist i lastkontroll/terminaler [EMME-749] Oppdatering av manuelle eksporter var uregelmessig og medførte av og til at web-server gikk i heng [EMME-748] Feil ved sortering og bytting av side over repeatere under PoliNode [EMME-738] Feil sorteringsrekkefølge på kanaler for L&G og AIDON GPRS målere [EMME-736] Trafokonstant til PT830 ble skrevet hver gang den endres i QM Web uansett om det var krysset av for programmert i måler eller ei [EMME-735] Låsing av PT8x0 var ikke mulig om ikke PT8x0 parametere eksisterer [EMME-734] Det er nå mulig å låse en PT8x0 terminal fra PoliTerm bildet selv om det ikke finnes innlest parametere i fra terminal. Visning av 3 faser under strøm og spenning for PT761 1-fase terminaler [EMME-729] Rapport for utkoblede anlegg viste ikke stand og kommentar [EMME-726] Stengte anlegg styrt med gruppestyring kom ikke opp i listen over stengte anlegg [EMME-724] Problemer med visning av anlegg som er klargjort for innkobling rettet [EMME-723] Selvmeldte PT8x0 hentet ikke inn automatisk fra noder uten UDP (push) [EMME-720] Feil antall terminaler i hurtigsøk ved søk på terminalnummer og det fantes en nedtatt terminal som inneholdt søkenummer [EMME-713] Autoexport programmet stoppet opp [EMME-747] Forbedringer/Nye funksjoner Fjernet overvåking/skriving av spenningsovervåkings parametere til PT8x0 [EMME-741] Gruppestyring av last; mulighet for å styre relé 1 og 2 samtidig [EMME-739] GS2 stand eksport bruker nå timestander for PT8x0 ved eksport av måned/uke-stander [EMME-733] Fjernet visning av målertyper som ikke støttes for PT8x0 [EMME-731] Mulighet for å "låse opp" PT8x0 terminaler implementert [EMME-698] Rapport over utkobling, innkobling og klargjort for innkobling er endret slik at det er lettere å se hva som er gruppestyring og hva som er enkeltstyring [EMME-727] Side 27 av 28

28 Det er nå mulig å selv legge opp automatisk innhenting av PT8x0 "Push" status [EMME-722] Automatisk innhenting av PT8x0 statusinformasjon [EMME-716] Lagt inn funksjon for enten låse opp eller flytte låsing av terminaler ved PoliNode bytte. Men kan velge mellom å løse opp eventuelle PT8x0 eller låse eventuelle PT8x0 til ny node. Dersom det velges at terminaler skal låses til ny node vil det ikke være mulig å også velge å låse opp. [EMME-698] Side 28 av 28