EnviSync Opsætning v2.1

Indledning:

EnviSync er EnviDan’s program til håndtering af data fra/til eksterne systemer. Softwaren har mulighed for at sende data til EnviDan, samt eksporter data fra EnviDan til kunden. EnviSync kræver næsten ingen ressourcer og er designet til at have mindst mulig påvirkning af kundens system. Da der ikke kræves mange ressourcer, kan derfor installeres på næsten alle maskiner i kundens netværk.

EnviSync er et .NET program og skal installeres på en maskine, som har adgang til internettet, så den kan kommunikere med EnviDan.

EnviSync består af 2 dele. Den ene del er en webservice, som afvikles på EnviDan’s Portal, mens den anden del er selve EnviSync programmet.

EnviSync leves som en Windows services. Denne Service er den primære Windows service - ”EnviDan Data Services”. De 4 støtte services er alle afhængig af EnviSync, for kommunikation med Portalen. De 4 services bruges til at sikre driften eller læse/skrive data til kundens systemer.

Al kommunikation imellem EnviSync og EnviDan Portal er sikret via krypteret forbindelse. EnviSync kommunikere via port 80 (http) og 443 (https). På lokalt netværk kommunikeres der via port 6373 og 6374. EnviSync skaber sin egen vpn tunnel via port 80, når denne benyttes.

Efter EnviSync er installeret er programmet selvkørende og opdateres automatisk. Hvis der er en opdatering, vil EnviSync, samt tilhørende services, blive opdateret kl. 07:45. Tidspunktet tillader, at der opdateres, mens der er udviklere og supportere på arbejde. Denne automatiske opdatering kan også deaktiveres, hvis dette gøres, vil EnviSync ikke modtage evt. fejlrettelser.

I få tilfælde skal data hentes fra en enhed, som ikke har adgang til internettet. I dette tilfælde kan EnviSync blive konfigureret i en master/klientopsætning (beskrives særskilt).

EnviSync kan hente/eksportere data til localhost, samt over netværket.

Hvis data skal hentes over netværket, skal EnviSync (EnviDan Data Service) være logget på med en Active Directory bruger, som har tilladelse til lokation der skal tilgås.

En EnviSync kan håndtere alle synkroniseringsopgaver der behov for til en kunde, så længe dataene, der skal tilgås, er placeret på samme netværk. Dog kan der installeres flere EnviSync’er på samme netværk. Én Pc kan have én installation af EnviSync.

NB: Vi gør opmærksom på, at det kan være vigtig for videre analyse af modtagne data at sikre alle systemer, leverer tidsstempler til målingerne. Det er også vigtigt at de enkelte systemer anvender den samme tidszone (ikke et krav, men hvis der er forskel, er det nødvendigt EnviDan har relevante informationer).

Spørgsmål ang. sikkerhed, for EnviSync, rettes til support@envidan.dk.

Forberedelse:

Hent Installationsfilen:

Installationsfilen samt dokumentationen, er placeret på EnviDan’s OneDrive og kan tilgås i browser.

Adresse:

· https://envidan-my.sharepoint.com/:f:/g/personal/support_envidan_dk/Et4nRqSOZb9NvH2RYJdGm24ByrIUzzOmQbwuhePZkVfXRA?e=0gUJsc

EnviSync kræver minimum .NET 4.7.1. Dog foretrækkes nyeste .NET version. Hvis .NET installeres/opgraderes

er en genstart muligvis påkrævet.

Skal data hentes fra en Access database, skal ”Microsoft Access Database Engine 2010” installeres. OLEDB driveren til Access kan findes og downloades her: https://www.microsoft.com/en-us/download/details.aspx?id=54920

NB: Der er en x32 og x 64 versioner af installationen. Installer den version som passer med den installerede Office. Hvis ikke der er installeret Office, vælges x64.

Beskrivelse af serviceprogrammer:

EnviSync har 3 hjælpeprogrammer, som bruges til læsning/skrivning af data, samt til at sikre driften.

Watchdog

Watchdog skal installeres på alle maskiner, hvor EnviSync eller et af de andre hjælpeprogrammer er installeret. Programmet holder øje med, om programmerne er kørende. Hvis ikke, genstarter den automatisk programmerne.

EnviSync Datalink

EnviSync Datalink (32bit/64bit) er hjælpeprogrammer, der bruges i forbindelse med EnviSync skal læse/skrive filer eller kommunikere med databaser. Programmet bruges typisk, hvis EnviSync ikke selv kan få adgang til datakilderne. Eksempelvis hvis EnviSync er installeret i en DMZ-zone, eller hvis der sker kommunikation med en 32bit driver på en 64bit maskine. Datalink programmet etablerer en krypteret kommunikationstunnel til EnviSync, hvorefter datapakker sikkert via digital signatur kan sendes frem og tilbage, uden at data kan kompromitteres. Programmet findes i en 32bit og en 64bit udgave, og den korrekte udgave installeres, alt efter om man skal kommunikere med 32bit eller 64bit drivere.

EnviSync OPC Connector

EnviSync OPC Connector er et program til kommunikation med OPC-servere enten via OPC-DA eller OPC-UA. OPC-DA via COM/DCOM kræver normal COM-opsætning for lokal og netværkskommunikation med det nødvendige brugernavn/adgangskode, som OPC-serveren kræver. OPC-UA kører via certifikater, hvor der skal installeres et certifikat på maskinen, hvor connectoren er installeret, samt en registrering af den tilhørende certifikat-fil på OPC-serveren. Connector programmet benytter sig af samme kommunikation til EnviSync som EnviSync Datalink programmet, via en krypteret tunnel.

Firewall:

For at EnviSync kan kommunikere med EnviDan Portal, skal nedenstående åbnes i firewallen.

HTTPS: 20.23.117.218

- portal.envidan.com:443

I nogle tilfælde kan det være nødvendigt at tilføje ”EnviSyncConfig.exe” til tilladte programmer i firewallen.

Installation af EnviSync:

1. Opret en mappe navngivet "EnviSync" i roden på C-drevet.
NB: mappen kan placeres på en anden lokation.

2. Hent "EnviSyncConfig.zip" fra fil server, og placeres i mappen "EnviSync".

3. Kør: ”EnviSyncConfig.exe” som administrator.

4. Installer ”EnviSync” og ”EnviSync Watchdog”

5. klik på ”Install” – De to services installeres nu.

6. Indtast nu ”Username”, ”Password” og ”Location”.

Disse informationer udleveres af EnviDan. Når der er indtastet korrekte loginoplysninger, vil felterne blive ”grønne”, og kunden, der er logget ind på, vises.

NB: ”Lokation” bruges til at identificer hvor/hvilke data der hentes.

Eks. ”EnviDan SRO” eller ”EnviDan Dandas”.

7. Tryk nu på ”Save credentials”. Der gives bekræftelse på, at de indtastede oplysninger er gemt.

8. Start nu de installeret services – klik på ”Start Service” og vent ca. 3 min.
Alle støttefiler hentes fra EnviDan og vil blive placeret i mappen, hvor ”EnviSyncConfig.exe” er placeret.

Når nedenstående er grønt, er alt konfigureret korrekt. Det er muligt at skifte de porte, som EnviSync bruger til kommunikationen. Portene bør kun ændres, hvis der er konflikter på netværket.

9. Installationen er nu færdig og datahentning kan konfigureres fra EnviDan Portal (separat dokument).

Ændre logon for EnviDan Data Service:

Hvis data skal hentes over netværket skal ”EnviDan Data Service” være logget på med en Active Directory bruger. Nedenstående beskriver processen for at logge ”EnviDan Data Service” på med en AD bruger.

1. Åben ”Tjenester/Services”.

2. Find ”EnviDan Data Service” i listen.

3. Højreklik på ”EnviDan Data Service” og vælg ”Egenskaber/Properties”.

4. I dialogboksen vælges fanen ”Log på”.

5. Vælg nu ”Denne konto”.

6. Indtast/find nu den bruger, der skal benyttes til servicen.

7. Tryk på ”OK”. Tjenesten skal genstartes før ændringer træder i kraft. Hvis loginoplysningerne er i orden, vil tjenesten genstarte. Hvis der er blevet indtastet forkerte oplysninger, vil der blive kastet en fejl.

EnviSync Layout:

Dette afsnit vil kort beskrive de forskellige elementer i EnviSync.

1. Viser versionen af EnviSync + .NET versionen.

2. Faner

a. Configurations-fanen er den primære fane.

Denne benyttes til at konfigurere EnviSync/EnviSync Klient.

b. Tracelog live.

Viser logninger i realtid.

c. Tracelog history.

Viser den historiske log.

d. Quick installation guide, giver en hurtig vejledning på engelsk.

3. Viser kunde.

Dette felt viser hvilken kunde, EnviSync er logget ind på. Dette felt bliver udfyldt, når korrekt login information er indtastet.

4. Gem/fortryd ændringer.

5. Location.

Indtast en lokation der benyttes senere til at identificere EnviSync installationen. F.eks. EnviDan Silkeborg.

6. Felt til brugernavn – Indtast brugernavn.

7. Felt til kode – Indtast kode.

8. ”Custom service” - Benyttes ikke ved en almindelig opsætning. Dette benyttes kun af EnviDan.

9. Viser om EnviSync er installeret på et x64bit operativsystem.

10. Liste over services, som kan installeres.

11. Installationsstatus på en given service.

12. Status på om servicen er kørende/ikke kørende.

13. Installer/afinstaller service.

14. Start/stop service.

15. Opdater service.

16. Automatisk opdatering af service.

17. Server IP Address.

Feltet bliver udfyldt automatisk. Dette ændres kun, hvis der skal laves en opsætning med en EnviSync klient.

18. EnviSync server port på det lokale netværk.

19. Watchdog port på det lokale netværk.

20. Installationslog.

21. Liste over IP’er fra alle aktive netværkskort.

EnviSync Diagram:

Nedenstående diagram beskriver, hvordan EnviSync kommunikerer internt og med EnviDan.

EnviSync - Den primær Windows service, som al kommunikation går igennem.

Datalink x32 – Benyttes hvis der skal hentes data fra x32bit applikationer. Dette bliver brugt, hvis der skal hentes data fra x32 Access, eller hvis der skal kobles op mod en EnviSync server.

Datalink x64 - Benyttes hvis der skal hentes data fra x64bit applikationer. Benyttes hovedsageligt hvis der skal kobles op mod en EnviSync server.

OPC Connector – Benyttes til opsætning af EnviStyr.

Watchdog - Denne service kører for sig selv. Dens eneste formål er at sikre, at de andre services er startet. Hvis en service stoppes, vil watchdog genstarte denne indenfor 5 min.

Afinstaller EnviSync:

Følgende skal gøres for at fjerne en EnviSync installation:

1. Lokaliser EnviSync Installationsmappen. Typisk i roden på C: drevet.

2. I mappen findes ”EnviSyncConfig.exe” – Kør denne som administrator.

3. Stop alle servises.

Tryk på ”Stop service” - Servicen stoppes. Knappen ændres til ”Start service”.

4. Afinstaller alle services.

Tryk på ”Uninstall” – Servicen afinstalleres nu, og knappen ændres til ”Install”.

5. Luk vinduet.

6. Slet mappen med alle EnviSync filer.

7. EnviSync er nu helt afinstalleret fra maskinen.

NB: Windows registreringsdatabasen benyttes ikke.

FAQ:

Genstart af EnviSync:

Genstart fra EnviSync Configuration Manager

1. Lokaliser EnviSync Installationsmappen. Typisk i roden på C: drevet.

2. I mappen findes ”EnviSyncConfig.exe” – Kør denne som administrator.

3. Tryk på ”Stop service” - Servicen stoppes. Knappen ændres til ”Start service”.

4. Tryk på ”Start service” - Servicen startes. Knappen ændres til ”Stop service”.

5. EnviSync er nu genstartet. På fanen ”Tracelog live” kan man nu se loggen for genstart.

Genstart EnviSync fra ”Tjenester”:

1. Åbn ”Tjenester” (Services).

2. Find ”EnviDan Data Service”.

3. Højreklik på servicen og vælg ”Genstart”.

4. Servicen genstartes nu.

Mine loginfelter er røde:

Hvis logininformationen er indtastet forkert, vil felterne vil blive ”røde”. Det betyder, at EnviSync ikke kan logge ind på EnviDans Portal, før den korrekte information er blevet indtastet. Korrekte informationer skal leveres af EnviDan. Når informationerne er indtastet/rettet, skal det trykkes på ”Save credentials”. Der vil komme en bekræftelse frem på, at informationerne er gemt.

NB: Hvis der ikke er åbnet de korrekte porte i firewallen, kan dette også være grunden til at felterne forbliver røde.

Kan EnviSync flyttes til en anden maskine?

En EnviSync installation kan ikke flyttes til en anden maskine, da installationen er bundet til hardwarekonfigurationen på den oprindelige maskine. For at få EnviSync på en ny maskine, kræves der en ny installation. Dog kan ”EnviSync Config.exe” kopieres over til den ny maskine. For at få oplysninger til installationen, kan disse hentes fra den oprindelige installation eller udleveres af EnviDan.

For at se nuværende oplysninger køres ”EnviSync Config.exe”, på den oprindelige maskine, som ”administrator”.

Hvordan finder jeg ud af hvilken .NET version jeg har?

Åben kommandoprompt og indtast følgende kommando:

reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\full" /v version