WOLFVISION vSolution Link Pro Software User Guide

WOLFVISION-vSolution-Link-Pro-Software

Spesifikaasjes

• Produkt: vSolution Link Pro
• Makker: WolfVision GmbH
• Ferzje: 1.9.1
• Bestjoeringssysteemkompatibiliteit: Windows IIS
• Applikaasje type: Web tsjinner applikaasje
• Browserkompatibiliteit: Moderne folslein HTML5-kompatibele browsers
• Systeem easken:
  • Bestjoeringssystemen: Windows Web Tsjinsten (IIS Internet Information Server)
  • Oare easken: E-postbewiis, SSL-sertifikaat, Ynternet tagong, 24/7 tsjinner beskikberens

Produkt Usage Ynstruksjes

Ynstallaasje
Folgje de vSolution Link Pro-ynstallaasjegids levere troch WolfVision by it ynstellen fan de applikaasje op in Windows IIS-tsjinner.

Systeem easken
Om it soepele funksjonearjen fan vSolution Link Pro te garandearjen, soargje derfoar dat jo foldogge oan de folgjende systeemeasken:

• Ynstallearje de applikaasje op in Windows IIS-tsjinner.
• Brûk in moderne folslein HTML5-kompatibele browser om tagong te krijen ta de applikaasje.
• Hawwe e-postbewizen, SSL-sertifikaat, ynternet tagong, en ûnderhâlde 24/7 tsjinner beskikberens.

Oanpaste e-postoanbieder:
As jo ​​gjin oanpaste e-postprovider set hawwe, sil it yntegreare Sendgrid-akkount brûkt wurde foar it ferstjoeren fan e-post.

 Firewall regels:
Soargje derfoar dat alle nedige havens, tsjinsten en IP-adressen beskikber binne en net blokkearre binne troch jo firewall (ekstern en persoanlik). Stel in regel yn om de applikaasje WolfVision.MgmtTool.Api.exe foar= folsleine funksjonaliteit ta te stean.

FAQ:
F: Wat moat ik dwaan as ik technyske flaters tsjinkomme by it brûken fan vSolution Link Pro?
A: Yn gefal fan technyske flaters of problemen, nim dan kontakt op mei WolfVision-stipe foar assistinsje. Se sille jo de nedige help leverje om alle problemen op te lossen dy't jo kinne tsjinkomme.

Ynstallaasjegids: vSolution Link Pro op IIS
Ferzje 1.9.1

 Oer dizze gids

Dit dokumint ferklearret de opset fan vSolution Link Pro-applikaasje troch WolfVision op in Windows IIS-tsjinner.

Copyright
Copyright © by WolfVision. Alle rjochten foarbehâlden.
WolfVision, Wofu Vision en binne registrearre hannelsmerken fan WolfVision Center GmbH, Eastenryk.

• De software is it eigendom fan WolfVision en syn lisinsjejouwers. Elke reproduksje is hielendal of foar in part strang ferbean.
• Gjin diel fan dit dokumint meie wurde kopiearre, reprodusearre, of oerdroegen op hokker wize, sûnder foarôfgeande skriftlike tastimming fan WolfVision útsein dokumintaasje bewarre troch de keaper foar reservekopy doelen.
• Yn it belang fan oanhâldende produktferbettering behâldt WolfVision it rjocht foar om produktspesifikaasjes sûnder notice te feroarjen.
• Ynformaasje yn dit dokumint kin feroarje sûnder foarôfgeande notice.
• Disclaimer: WolfVision sil net oanspraaklik wêze foar technyske of redaksjeflaters of weglatingen.
• Gebrûk fan hannelsmerken, registrearre hannelsmerken en oare beskerme nammen en symboalen
• Dizze hantlieding kin ferwize nei hannelsmerken, registrearre hannelsmerken en oare beskerme nammen en / of symboalen fan bedriuwen fan tredden dy't net op ien of oare manier relatearre binne oan WolfVision. Wêr't se foarkomme, binne dizze ferwizings allinich foar yllustrative doelen en fertsjinwurdigje gjin goedkarring fan in produkt of tsjinst troch WolfVision, of in goedkarring fan it produkt (en) wêrop dizze hantlieding jildt troch it oanbelangjende bedriuw fan tredden. Nettsjinsteande elke direkte erkenning earne oars yn it lichem fan dit dokumint, erkent WolfVision hjirby dat alle hannelsmerken, registrearre hannelsmerken, tsjinstmerken en oare beskerme nammen en/of symboalen yn dizze hantlieding en relatearre dokuminten it eigendom binne fan har respektive holders.

Systeem easken

Windows Web Tsjinsten (IIS Internet Information Server)
As vSolution Link Pro is in web serverapplikaasje, kin it tagonklik wurde troch elke moderne folslein HTML5-kompatibele browser fan in apparaat fan tredden yn it lokale netwurk.
Om alle funksjes te brûken dy't de applikaasje leveret, moat it ynstalleare wurde as IIS (Internet Information Server). E-postbewizen, SSL-sertifikaat, ynternet tagong en 24/7 tsjinner beskikberens binne ek fereaske.
De software (64bit applikaasje) kin ynstalleare wurde op folgjende bestjoeringssystemen. It folgjende toant de minimale systeemeasken, mear oan te rieden:

• Windows Server 2019 of nijer (alle easken neffens Microsoft moatte foldien wurde)
• CPU minimaal 1 kearn mei 2.60GHz (2 kearnen, of mear oanrikkemandearre)
• 4GB RAM (8GB, of mear oanrikkemandearre)
• 100GB minimum frije skiifromte foar firmware files (250GB, of mear oanrikkemandearre)
• Tagong ta feilige poarte (bygelyks 443, https standert)
• Tsjinneradres (IP:poarte) moat fia feilich berikber wêze web socket (wss)
• .NET Core Hosting Bundle, hifke mei ferzje 7.0.3

Let op

• Lêste updates oanrikkemandearre.
• Eardere ferzjes fan bestjoeringssystemen wurde net hifke en wurde mooglik net stipe.
• Tink derom dat de fereaske skiifromte foar it lokale firmware-repository, skiifromte fan op syn minst 20GB wurdt oanrikkemandearre.
• Om tagong te krijen ta de apparaten, moatte se online en yn itselde netwurk wêze om berikber te wêzen! Soarch omtinken foar juste netwurkynstellingen, foaral as jo rinne yn spesjale netwurkomjouwings.
• Cynap-systemen sille har LAN-poarten útskeakelje by it útskeakeljen fan standert en kinne wurde oanstutsen troch de Wake on LAN-funksjonaliteit te brûken. Foar netwurkynfrastruktuer mei blokkearre Wake on LAN, brûk de power down-modus Power Save om de LAN-poarte fan jo Cynap aktyf te hâlden. Wannear
• mei help fan WolfVision Visualizer-apparaten, brûke power down modes Normaal of ECO om de LAN-poarte aktyf te hâlden. Bepaalde Visualizer-modellen stypje Wake on LAN (kontrolearje de power-down-modus fan ferbûne Visualizer).
• In ferkearde systeemtiid kin feroarsaakje dat netwurkferbining mislearret, it brûken fan in jildige tiidserver wurdt oanrikkemandearre.

Oanpaste e-postoanbieder
Jildige oanpaste referinsjes fan e-postprovider binne fereaske by it ynskeakeljen fan:

• 2-faktor autentikaasje
• Management Hub
• Event log E-post notifikaasje
• Box ferfanging*
• Wachtwurdreset*.

* As gjin oanpaste provider is ynsteld, sil it yntegreare Sendgrid-akkount wurde brûkt foar it ferstjoeren fan e-post.

SSL-sertifikaat - in betingst foar it ynskeakeljen fan Management Hub
In jildich SSL-sertifikaat is fereaske by it beheinen fan de tagong ta https.

Firewall regels
Soargje derfoar dat alle nedige havens, tsjinsten en IP-adressen beskikber binne en net blokkearre binne troch jo firewall (ekstern en persoanlik).

Acknowledgements ("ACK's") fan TCP-pakketten wurde net beskôge yn 'e folgjende tabel om de rjochting fan' e gegevenspakketten te yllustrearjen. Om't erkenningen normaal weromstjoerd wurde fia deselde TCP-poarte, sil de oare rjochting net blokkearre wurde om soepel funksjonearjen te garandearjen.

Op bepaalde systemen moatte jo in regel ynstelle om de applikaasje ta te stean:
WolfVision.MgmtTool.Api.exe foar folsleine funksjonaliteit.

Funksje / Applikaasje	Haven	Type	Ynbound / Outbound	Beskriuwing
vSolution Link Pro
Wake On LAN	7 / 9	UDP	Ynbound / Outbound	Wake On LAN - Normaal wurdt poarte 7 brûkt foar it ferstjoeren fan it magyske pakket
DNS	53	TCP / UDP	Ynbound / Outbound	DNS - Dizze poarte sil brûkt wurde foar domeinnammesysteem. As dizze poarte is blokkearre, binne DNS-tsjinsten net beskikber
http, Cynap kontrôle	80	TCP	Ynbound / Outbound	Dit is de standert haven om te ferbinen mei de web ynterface (httpd) fan vSolution Link Pro. Fan dizze poarte is blokkearre, ferbining kin net wêze fêstige
https, SSL, bygelyks Cloud Service, Cynap kontrôle	443	TCP	Ynbound / Outbound	Dit is de standert poarte om te ferbinen mei web ynterface (https) fan vSolution Link Pro. As dizze poarte is blokkearre, ferbining kin net fêststeld wurde.
SMTP	587	SMTP	Outbound	Posttsjinner - Poarte foar kommunikaasje mei SMTP-tsjinner.
Discovery Multicast	50000	UDP	Inbound	Dizze poarte wurdt brûkt foar apparaat ûntdekking alle beskikbere Cynap en Visualizer yn it netwurk troch vSolution applikaasjes (brûkt Multicast IP adres 239.255.255.250). As dizze poarte is blokkearre, is apparaat ûntdekking net mooglik
Device Discovery	50913	UDP	Inbound	Dizze poarte wurdt brûkt foar apparaatûntdekking. As dizze poarte is blokkearre, is apparaat ûntdekking net mooglik.
Foar kontrôle doelen	50915	TCP	Ynbound / Outbound	Dizze poarte wurdt brûkt foar kontrôle doelen. As dizze poarte is blokkearre, is gjin kontrôle mooglik

 DHCP opsje 43 (of 60)

• Om de apparaten folslein automatisearre te registrearjen, set de DHCP-opsje 43 (of 60) yn op de DHCP-tsjinner yn jo netwurkomjouwing.
• Dizze opsje wurdt brûkt troch kliïnten en servers om ferkeaper spesifike ynformaasje út te wikseljen.
• De ynstelling kin ynsteld wurde foar ien of mear scopes (Scope Options) of foar de hiele tsjinner (Server Options).
• Ferskillende ferzjes fan DHCP-tsjinner bestjoeringssystemen fariearje, de folgjende stappen beskriuwe it ynstellen op in Windows Server 2019 Datacenter.
• Iepenje jo DHCP-applikaasje en selektearje "Opsjes ynstelle" yn it kontekstmenu fan "Scope-opsjes", "of "Tsjinneropsjes".

Example mei IP 192.168.246.5

0x02 = Typ Cynap-apparaten (definieare troch WolfVision)
0x0D = desimaal 13 yn hex = lingte fan it IP-adres (4 oktetten, ynklusive punten)

Example mei URL vlinkpro.wolfvision.com

0x02 = Typ Cynap-apparaten (definieare troch WolfVision)
0x17 = desimaal 23 yn hex = lingte fan de URL

Please Note
De folgjende Cynap-systemen stypje DHCP-opsje 43, DHCP-opsje 60, en manuell ynfierd URL fan vSolution Link Pro-tsjinner yn har ynstellingen:

• Cynap
• Cynap PRO
• Cynap Core
• Cynap Core PRO
• Cynap Pure
• Cynap Pure Pro
• Cynap Pure ûntfanger
• Cynap Pure SDM
• Cynap Pure Mini

De folgjende Visualizer systemen stypje DHCP opsje 43, en mei de hân ynfierd URL fan vSolution Link Pro-tsjinner yn har ynstellingen:

• VZ-2.UHD
• VZ-3neo.UHD
• VZ-8neo.UHD
• VZ-8.UHD

Mei standertynstellingen is it harkjen fan de DHCP-opsje ynskeakele.

On-Premise of Management Hub

De vSolution Link Pro is in web serverapplikaasje en moat ynstalleare wurde, foarkar op in server om 24/7 beskikberens te garandearjen.

 Hosted on-premise (lokale ynstallaasje)
As de applikaasje on-premise wurdt hosted, moatte dizze server, alle Cynap- en Visualizer-systemen en ek de apparaten fan tredden (buroblêden, wurkstasjons, tablets) yn itselde Ethernet-netwurk wêze.

 Hosted mei Management Hub (Cloud Ynstallaasje)
As de applikaasje wurdt host mei ynskeakele Management Hub-funksje, kinne Cloud-stipe apparaten ek wurde beheard.

Stipe WolfVision Cynap-systemen yn Management Hub:

• Cynap
• Cynap Pro
• Cynap Core
• Cynap Core Pro
• Cynap Pure
• Cynap Pure Pro
• Cynap Pure ûntfanger
• Cynap Pure SDM

Foar folsleine kompatibiliteit, hâld de ynstalleare firmwareferzje fan al jo apparaten by de tiid.

Serverynstallaasje (Windows IIS)

De vSolution Link Pro is in web serverapplikaasje en moat ynstalleare wurde, foarkar op in server om 24/7 beskikberens te garandearjen.
Ferskillende ferzjes fan IIS kinne wat ferskille, de folgjende stappen beskriuwe de ynstallaasje op in Windows Server 2019 Datacenter (OS build 17763.1131) mei .NET Core Hosting Bundle ferzje 7.0.3. De ynstallaasje op oare ferzjes kin ferskille.
vSolution Link Pro wurdt levere mei in standert web.config, dat kin wurde oannommen, ôfhinklik fan jo behoeften.
Notysje ekstra ynstellings foar it brûken fan Management Hub (wolke tagong) funksje.

Download de ynstallaasje files
Download it zip-argyf vSolutionLinkPro_WindowsServer.zip fan 'e WolfVision web side en útpakke it.

Foegje IIS-funksjonaliteit ta
Iepenje it Server Manager Dashboard en tafoegje rollen en funksjes:

Belangryk
WebDAV-rol moat útskeakele bliuwe foar vSolution Link Pro-tsjinner foar folsleine funksjonaliteit.

Selektearje WebSocket Protocol (Applikaasjeûntwikkeling, sub item fan IIS Web Server)

Tariede file struktuer
Kopiearje de unzipped map vSolutionLinkPro_WindowsServer nei c:\inetpub\wwwroot

Feroarje eigenskippen om tagongsrjochten fan 'e IIS te behearjen om folsleine kontrôle mooglik te meitsjen

Start Internet Information Services (IIS) Manager

IIS ynstelle
Behear siden fan IIS en foegje it fysike paad ta

Beheine tagong ta https en kontrolearje de brûkte poarte.
Dizze ynstelling is nedich foar it aktivearjen fan Management Hub-funksje.

• Definiearje jo jildich SSL-sertifikaat foar juste https-ferbining.
• Dizze ynstelling is nedich foar it aktivearjen fan Management Hub-funksje.
• Feroarje .NET CLR-ferzje yn Basisynstellingen nei "Gjin beheare koade"
• Feroarje Managed pipeline modus nei "Yntegrearre".

Feroarje Startmodus yn Avansearre ynstellings nei "AlwaysRunning" om 24/7 operaasje mooglik te meitsjen

Feroarje Idle Time-out (minuten) yn Avansearre ynstellings nei "0"

Let op
As de IIS OnDemand rint, stopet it as:

• Gjin vSolution Link Pro-finster is iepen yn in browserfinster by elke kliïnt
• Gjin Management Hub-ferbining is iepen
• Gjin apparaat brûkt thús skiljen.

Ynstallaasje fan .NET Core Windows Server Hosting

Ynstallearje de .NET Core Hosting Bundle.
De applikaasje waard hifke mei .NET ferzje 7.0.3:  https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.3-windows-hosting-bundle-installer

Foar mear details oer IIS, besykje asjebleaft: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/?view=aspnetcore-7.

Stopje en opnij starte de tsjinst by Application Pool Tasks by IIS Manager.

Appsettings.json oannimme
De file appsettings.json lit alle ynstellings offline wizigje troch in gewoane tekstbewurker te brûken. De wichtichste ynstellings binne tagonklik by de grafyske brûkersynterface (Konfiguraasje - Ynstellings).

Management Hub (Cloud) brûke
"UseHttps" yn seksje "Hosting" moat ynsteld wurde op "wier".

Aktivearje Management Hub (opsjoneel, ôfhinklik fan opset)
De Management Hub foar Cloud-stipe moat ynskeakele wurde yn 'e ynstelling by it earste begjin:

Alternatyf, aktivearje de Management Hub yn 'e file appsettings.json en adoptearje alle ynstellingen neffens jo behoeften mei de hân:

Start de applikaasje

Om vSolution Link Pro te starten, iepenje de browser fan it wurkstasjon en fier it IP-adres fan 'e tsjinner yn.
Example URL http://192.168.0.1:80

Om feiligens redenen moat it standert wachtwurd wizige wurde by de earste oanmelding.
Tink derom, nei inaktiviteit fan 30 minuten wurde jo automatysk útlogd.

Apparaat easken
Om tagong te krijen ta de apparaten, moatte se online en berikber wêze!
Cloud-ferbûne apparaten (Management Hub) hâlde in feilich websocket ferbining (WSS) iepen om behear mooglik te meitsjen.
Bygelyks, Cynap-apparaten sille har LAN-poarten útskeakelje by it útskeakeljen fan standert en kinne wurde oanstutsen troch de Wake on LAN-funksjonaliteit te brûken. Foar netwurkynfrastruktuer mei blokkearre Wake on LAN, brûk de power down-modus Power Save om de LAN-poarte fan jo Cynap-systeem aktyf te hâlden.
Ofhinklik fan netwurkynfrastruktuer en troch meardere netwurkpoarten, moat IP-routing oantsjutte wurde om it netwurkferkear te routeren.
By it brûken fan WolfVision Visualizer-apparaten, brûk dan de macht-down-modi Normaal of ECO om de LAN-poarte aktyf te hâlden.

Earste oanmelding - Wachtwurd feroarje ("admin" by earste start)
As jo ​​​​de earste kear ynlogge, moat it wachtwurd ynsteld wurde:

As de lege Windows-tsjinner IIS-side iepene wurde moat, kontrolearje de brûkte havens en start de tsjinner op 'e nij.

vSolution Link Pro bywurkje

Stop vSolution Link Pro by IIS Manager.
Reservekopy de map 'Data' fan jo hjoeddeistige ynstallaasjemap.
Pake it zip-argyf fan 'e nije ferzje út en kopiearje de folsleine ynhâld nei de ynstallaasjemap. Kopiearje de ynhâld fan jo earder bewarre ynhâld fan 'Data' nei de aktuele 'Data'-map.

 Belangryk
Doe't de ynstallaasjemap "vSolutionLinkPro" waard útwiksele, moat de tastimming fernijd wurde (sjoch haadstik 5.5 Tariede file struktuer).

Folje de fernijing
Start de vSolution Link Pro by de IIS Manager.

Bywurkjen fan ferzje v1.8.0 (of earder)
As vSolution Link Pro ferzje 1.8.0, of earder earder ynstalleare is, moat de applikaasjepool wizige wurde.
Stel 32-bit applikaasjes ynskeakelje op "False"

Feroarje Startmodus yn Avansearre ynstellings nei "AlwaysRunning" om 24/7 operaasje mooglik te meitsjen

Feroarje Idle Time-out (minuten) yn Avansearre ynstellings nei "0"

Let op
As de IIS OnDemand rint, stopet it as:

• Gjin vSolution Link Pro-finster is iepen yn in browserfinster by elke kliïnt
• Gjin Management Hub-ferbining is iepen
• Gjin apparaat brûkt thús skiljen.

Kontrolearje de ynstellings files web.config en appsettings.json
Ferifiearje web.config (sil fûn wurde yn 'e root-map fan' e IIS), hostingmodel moat
Stel 32-bit applikaasjes ynskeakelje op "False"

Ferifiearje web.config (sil fûn wurde yn 'e root-map fan' e IIS), hostingmodel moat ynsteld wurde op "inprocess".

De ynstelling "InProcessHostingModel" yn 'e file appsettings.json is ferâldere sûnt vSolution Link Pro v1.9 en letter.
Dizze ynstelling wurdt negearre en hat gjin effekt mear.

Ferpleatse fan buroblêdynstallaasje nei IIS-ynstallaasje

Om alle gegevens fan in eardere buroblêdynstallaasje nei in serverynstallaasje te ferpleatsen, soargje derfoar dat vSolution Link Pro goed is ynstalleare op 'e IIS-tsjinner.

Belangryk
In frisse ynstallaasje fan vSolution Link Pro op 'e tsjinner mei identike ferzjenûmer as de eardere buroblêdynstallaasje wurdt sterk oanrikkemandearre.
Troch troch te gean mei de folgjende stappen, geane alle gegevens fan 'e vSolution Link Pro-ynstallaasje op' e tsjinner ferlern.

1. Stopje de vSolution Link Pro-tsjinner by de IIS Manager.
2. elete allegear files en submappen fan 'e map 'Data' op jo IIS-ynstallaasje.
3. Standert paad:
   C:\inetpub\wwwroot\vSolutionLinkPro\
4. Kopiearje de folsleine ynhâld fan 'e map 'Data' fan jo buroblêdynstallaasje.
   Standert paad:
   Windows buroblêd ynstallaasje (ferburgen map) C:\ProgramData\WolfVision\vSolution Link Pro\
   MacOS-buroblêdynstallaasje /Bibliotheek/Applikaasjestipe/WolfVision/vSolution Link Pro/
5. Plak de files yn 'e map 'Data' fan jo IIS-ynstallaasje.
6.  Standert paad:
   C:\inetpub\wwwroot\vSolutionLinkPro\

Belangryk
Kontrolearje alle fermelde paden yn 'e appsettings.json file en korrigearje it neffens.
Standert paad op IIS: C:\\inetpub\\wwwroot\\vSolutionLinkPro\\Data\\
Start de vSolution Link Pro by de IIS Manager.
Alle ynstellingen en gegevens fan 'e eardere Desktop-ynstallaasje wurde oerbrocht nei de tsjinner, ynklusyf oanmeldgegevens.

Yndeks

Ferzje	Datum	Feroarings
1.9.1	2024-05-02	DHCP-opsje tafoege
1.9.1	2023-10-27	Update nei vSolution Link Pro ferzje 1.9.1 Seksje tafoege "Ferpleatse fan buroblêdynstallaasje nei IIS-ynstallaasje".
1.9.0	2023-07-25	Update nei vSolution Link Pro ferzje 1.9.0 Regels tafoege foar it bywurkjen fan de applikaasje.
De ferzjenûmering is oanpast oan de ferzje fan de applikaasje.
1.5	2023-05-17	Tafoege Management Hub aktivearring (Cloud)
1.4	2023-04-25	Update nei vSolution Link Pro ferzje 1.8.0
1.3	2022-06-21	.NET Core Update nei ferzje 5.0.17
1.2	2022-05-23	Added WebDAV notysje
1.1	2021-07-07	Updated Firewall regels
1.0	2021-03-09	Oanmakke

WolfVision GmbH Oberes Ried 14
A-6833 Klaus / Eastenryk

Tel. + 43-5523-52250
Fax +43-5523-52249
E-post: wolfvision@wolfvision.com
www.wolfvision.com