Používateľská príručka softvéru WOLFVISION vSolution Link Pro

WOLFVISION-vSolution-Link-Pro-Software

Špecifikácie

• Produkt: vSolution Link Pro
• Výrobca: WolfVision GmbH
• Verzia: 1.9.1
• Kompatibilita operačného systému: Windows IIS
• Typ aplikácie: Web serverová aplikácia
• Kompatibilita prehliadača: Moderné prehliadače plne kompatibilné s HTML5
• Systémové požiadavky:
  • Operačné systémy: Windows Web Služby (IIS Internet Information Server)
  • Ďalšie požiadavky: E-mailové poverenia, SSL certifikát, prístup na internet, 24/7 dostupnosť servera

Návod na použitie produktu

Inštalácia
Pri nastavovaní aplikácie na serveri Windows IIS postupujte podľa inštalačnej príručky vSolution Link Pro od spoločnosti WolfVision.

Systémové požiadavky
Ak chcete zabezpečiť hladké fungovanie vSolution Link Pro, uistite sa, že spĺňate nasledujúce systémové požiadavky:

• Nainštalujte aplikáciu na server Windows IIS.
• Na prístup k aplikácii použite moderný prehliadač plne kompatibilný s HTML5.
• Majte e-mailové poverenia, certifikát SSL, prístup na internet a udržujte dostupnosť servera 24 hodín denne, 7 dní v týždni.

Vlastný poskytovateľ e-mailu:
Ak nemáte nastaveného vlastného poskytovateľa e-mailu, na odosielanie e-mailov sa použije integrovaný účet Sendgrid.

 Pravidlá brány firewall:
Uistite sa, že všetky potrebné porty, služby a IP adresy sú dostupné a nie sú blokované vaším firewallom (externým a osobným). Nastavte pravidlo, ktoré aplikácii WolfVision.MgmtTool.Api.exe umožní plnú funkčnosť.

FAQ:
Otázka: Čo mám robiť, ak pri používaní vSolution Link Pro narazím na technické chyby?
Odpoveď: V prípade technických chýb alebo problémov kontaktujte podporu WolfVision so žiadosťou o pomoc. Poskytnú vám potrebnú pomoc pri riešení akýchkoľvek problémov, s ktorými sa môžete stretnúť.

Inštalačná príručka: vSolution Link Pro na IIS
Verzia 1.9.1

 O tejto príručke

Tento dokument vysvetľuje nastavenie aplikácie vSolution Link Pro od spoločnosti WolfVision na serveri Windows IIS.

Autorské práva
Copyright © od WolfVision. Všetky práva vyhradené.
WolfVision, Wofu Vision a sú registrované ochranné známky spoločnosti WolfVision Center GmbH, Rakúsko.

• Softvér je majetkom spoločnosti WolfVision a jej poskytovateľov licencií. Akákoľvek reprodukcia v celku alebo po častiach je prísne zakázaná.
• Žiadna časť tohto dokumentu sa nesmie kopírovať, reprodukovať ani prenášať akýmkoľvek spôsobom bez predchádzajúceho písomného súhlasu spoločnosti WolfVision, s výnimkou dokumentácie uchovávanej kupujúcim na účely zálohovania.
• V záujme neustáleho zlepšovania produktu si WolfVision vyhradzuje právo zmeniť špecifikácie produktu bez upozornenia.
• Informácie v tomto dokumente sa môžu zmeniť bez predchádzajúceho upozornenia.
• Zrieknutie sa zodpovednosti: WolfVision nenesie zodpovednosť za technické alebo redakčné chyby alebo opomenutia.
• Používanie ochranných známok, registrovaných ochranných známok a iných chránených názvov a symbolov
• Táto príručka môže obsahovať odkazy na ochranné známky, registrované ochranné známky a iné chránené názvy a/alebo symboly spoločností tretích strán, ktoré žiadnym spôsobom nesúvisia so spoločnosťou WolfVision. Tam, kde sa vyskytujú, tieto odkazy slúžia len na ilustračné účely a nepredstavujú podporu produktu alebo služby spoločnosťou WolfVision, ani podporu produktu (produktov), ​​na ktorý sa vzťahuje tento návod, príslušnou treťou stranou. Bez ohľadu na akékoľvek priame potvrdenie inde v tomto dokumente, WolfVision týmto potvrdzuje, že všetky ochranné známky, registrované ochranné známky, servisné značky a iné chránené názvy a/alebo symboly obsiahnuté v tejto príručke a súvisiacich dokumentoch sú majetkom ich príslušných držiteľov.

Systémové požiadavky

Windows Web Služby (IIS Internet Information Server)
Keďže vSolution Link Pro je a web serverová aplikácia je prístupná z akéhokoľvek moderného plne HTML5 kompatibilného prehliadača zariadenia tretej strany v lokálnej sieti.
Aby ste mohli využívať všetky funkcie, ktoré aplikácia poskytuje, musí byť nainštalovaná ako IIS (Internet Information Server). Vyžadujú sa aj e-mailové poverenia, certifikát SSL, prístup na internet a nepretržitá dostupnosť servera.
Softvér (64bitová aplikácia) je možné nainštalovať na nasledujúce operačné systémy. Nižšie sú uvedené minimálne systémové požiadavky, viac odporúčané:

• Windows Server 2019 alebo novší (musia byť splnené všetky požiadavky podľa Microsoftu)
• CPU minimálne 1 jadro s 2.60 GHz (odporúčajú sa 2 jadrá alebo viac)
• 4 GB RAM (odporúča sa 8 GB alebo viac)
• Minimálne 100 GB voľného miesta na disku pre firmvér files (odporúča sa 250 GB alebo viac)
• Prístup k zabezpečenému portu (napr. 443, predvolený https)
• Adresa servera (IP:port) musí byť dostupná cez zabezpečený web zásuvka (wss)
• .NET Core Hosting Bundle, testovaný s verziou 7.0.3

Vezmite prosím na vedomie

• Odporúčame najnovšie aktualizácie.
• Staršie verzie operačných systémov nie sú testované a nemusia byť podporované.
• Vezmite prosím na vedomie požadované miesto na disku pre lokálne úložisko firmvéru, odporúča sa miesto na disku aspoň 20 GB.
• Na prístup k zariadeniam musia byť online a v rovnakej sieti, aby boli dosiahnuteľné! Venujte pozornosť správnym sieťovým nastaveniam, najmä pri prevádzke v špeciálnych sieťových prostrediach.
• Systémy Cynap štandardne deaktivujú svoje LAN porty pri vypnutí a možno ich zapnúť pomocou funkcie Wake on LAN. Pre sieťové infraštruktúry so zablokovaným Wake on LAN použite režim vypnutia Power Save, aby zostal LAN port vášho Cynapu aktívny. Kedy
• pomocou zariadení WolfVision Visualizer použite režimy vypnutia Normálny alebo ECO, aby bol port LAN aktívny. Niektoré modely Visualizer podporujú Wake on LAN (skontrolujte režim vypnutia pripojeného Visualizer).
• Nesprávny systémový čas môže spôsobiť zlyhanie sieťového pripojenia, odporúča sa použiť platný časový server.

Vlastný e-mailový poskytovateľ
Pri povolení:

• 2-faktorové overenie
• Centrum riadenia
• Protokol udalostí E-mailové upozornenie
• Výmena krabice*
• Resetovanie hesla*.

* Ak nie je nastavený žiadny vlastný poskytovateľ, na odosielanie e-mailov sa použije integrovaný účet Sendgrid.

SSL certifikát – predpoklad pre aktiváciu Management Hub
Pri obmedzení prístupu na https je potrebný platný SSL certifikát.

Pravidlá brány firewall
Uistite sa, že všetky potrebné porty, služby a IP adresy sú dostupné a nie sú blokované vaším firewallom (externým a osobným).

Potvrdenia (“ACK”) TCP paketov nie sú v nasledujúcej tabuľke zohľadnené, aby bolo možné ilustrovať smer dátových paketov. Keďže potvrdenia sa zvyčajne posielajú späť cez rovnaký port TCP, druhý smer nesmie byť blokovaný, aby sa zabezpečilo hladké fungovanie.

V niektorých systémoch musíte nastaviť pravidlo, aby ste aplikáciu povolili:
WolfVision.MgmtTool.Api.exe pre plnú funkčnosť.

Funkcia / Aplikácia	Port	Typ	Prichádzajúci odchádzajúci	Popis
vSolution Link Pro
Wake On LAN	7/9	UDP	Prichádzajúci odchádzajúci	Wake On LAN – Port 7 sa zvyčajne používa na odosielanie magického paketu
DNS	53	TCP / UDP	Prichádzajúci odchádzajúci	DNS – Tento port sa bude používať pre Domain Name System. Ak je tento port zablokovaný, služba DNS nie je dostupná
http, ovládanie Cynap	80	TCP	Prichádzajúci odchádzajúci	Toto je predvolený port na pripojenie k web rozhranie (httpd) vSolution Link Pro. Tento port je zablokovaný, pripojenie nie je možné založená
https, SSL, napr. Cloud Service, Cynap control	443	TCP	Prichádzajúci odchádzajúci	Toto je predvolený port na pripojenie web rozhranie (https) vSolution Link Pro. Ak je tento port zablokovaný, nie je možné nadviazať spojenie.
SMTP	587	SMTP	Odchádzajúci	Mail Server – Port pre komunikáciu so serverom SMTP.
Discovery Multicast	50000	UDP	Prichádzajúce	Tento port sa používa na zisťovanie všetkých dostupných zariadení Cynap a Visualizer v sieti pomocou aplikácií vSolution (používa Multicast IP adresu 239.255.255.250). Ak je tento port zablokovaný, zisťovanie zariadenia nie je možné
Objavovanie zariadenia	50913	UDP	Prichádzajúce	Tento port sa používa na vyhľadávanie zariadení. Ak je tento port zablokovaný, zisťovanie zariadenia nie je možné.
Na účely kontroly	50915	TCP	Prichádzajúci odchádzajúci	Tento port sa používa na ovládanie účely. Ak je tento port zablokovaný, nie je možná žiadna kontrola

 DHCP možnosť 43 (alebo 60)

• Ak chcete, aby sa zariadenia registrovali plne automaticky, nastavte možnosť DHCP 43 (alebo 60) na serveri DHCP vo vašom sieťovom prostredí.
• Túto možnosť využívajú klienti a servery na výmenu informácií špecifických pre dodávateľa.
• Nastavenie je možné nastaviť pre jeden alebo viac rozsahov (Možnosti rozsahu) alebo pre celý server (Možnosti servera).
• Rôzne verzie operačných systémov serverov DHCP sa líšia, nasledujúce kroky popisujú nastavenie v dátovom centre Windows Server 2019.
• Otvorte aplikáciu DHCP a v kontextovej ponuke „Možnosti rozsahu“ alebo „Možnosti servera“ vyberte „Možnosti konfigurácie“.

Example s IP 192.168.246.5

0x02 = Typ zariadenia Cynap (definované spoločnosťou WolfVision)
0x0D = desatinné číslo 13 v hex = dĺžka adresy IP (4 oktety vrátane bodiek)

Example s URL vlinkpro.wolfvision.com

0x02 = Typ zariadenia Cynap (definované spoločnosťou WolfVision)
0x17 = desatinné číslo 23 v hex = dĺžka URL

Poznámka
Nasledujúce systémy Cynap podporujú možnosť DHCP 43, možnosť DHCP 60 a manuálne zadané URL servera vSolution Link Pro v ich nastaveniach:

• Cynap
• Cynap PRO
• Cynap Core
• Cynap Core PRO
• Cynap Pure
• Cynap Pure Pro
• Prijímač Cynap Pure
• Cynap Pure SDM
• Cynap Pure Mini

Nasledujúce systémy Visualizer podporujú voľbu DHCP 43 a zadávajú sa manuálne URL servera vSolution Link Pro v ich nastaveniach:

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

V predvolených nastaveniach je zapnutá možnosť počúvania DHCP.

On-Premise alebo Management Hub

vSolution Link Pro je a web serverovú aplikáciu a je potrebné ho nainštalovať, uprednostňuje sa na serveri, aby sa zabezpečila dostupnosť 24 hodín denne, 7 dní v týždni.

 Hostené na mieste (miestna inštalácia)
Keď je aplikácia hosťovaná na mieste, tento server, všetky systémy Cynap a Visualizer a tiež zariadenia tretích strán (stolné počítače, pracovné stanice, tablety) musia byť v rovnakej ethernetovej sieti.

 Hostené s centrom správy (inštalácia v cloude)
Keď je aplikácia hosťovaná s povolenou funkciou centra správy, zariadenia s podporou cloudu možno spravovať dodatočne.

Podporované systémy WolfVision Cynap v Management Hub:

• Cynap
• Cynap Pro
• Cynap Core
• Cynap Core Pro
• Cynap Pure
• Cynap Pure Pro
• Prijímač Cynap Pure
• Cynap Pure SDM

Pre plnú kompatibilitu udržujte nainštalovanú verziu firmvéru všetkých svojich zariadení aktuálnu.

Inštalácia servera (Windows IIS)

vSolution Link Pro je a web serverovú aplikáciu a je potrebné ho nainštalovať, uprednostňuje sa na serveri, aby sa zabezpečila dostupnosť 24 hodín denne, 7 dní v týždni.
Rôzne verzie IIS sa môžu mierne líšiť, nasledujúce kroky popisujú inštaláciu na Windows Server 2019 Datacenter (OS zostava 17763.1131) s .NET Core Hosting Bundle verzie 7.0.3. Inštalácia v iných verziách sa môže líšiť.
vSolution Link Pro sa dodáva so štandardom web.config, ktorý je možné prijať v závislosti od vašich potrieb.
Všimnite si ďalšie nastavenia pre používanie funkcie Management Hub (cloudový prístup).

Stiahnite si inštaláciu files
Stiahnite si zip archív vSolutionLinkPro_WindowsServer.zip z WolfVision web stránku a rozbaľte ju.

Pridajte funkčnosť IIS
Otvorte ovládací panel správcu servera a pridajte roly a funkcie:

Dôležité
WebÚloha DAV by mala zostať zakázaná pre server vSolution Link Pro pre plnú funkčnosť.

Vyberte WebSocket Protocol (vývoj aplikácií, podpoložka IIS Web server)

Pripravte sa file štruktúru
Skopírujte rozbalený priečinok vSolutionLinkPro_WindowsServer do c:\inetpub\wwwroot

Zmeňte vlastnosti na správu povolení služby IIS, aby ste mali úplnú kontrolu

Spustite správcu Internetových informačných služieb (IIS).

Nastavenie služby IIS
Spravujte lokality IIS a pridajte fyzickú cestu

Obmedzte prístup k https a skontrolujte použitý port.
Toto nastavenie sa vyžaduje pred aktiváciou funkcie centra správy.

• Definujte svoj platný certifikát SSL pre správne pripojenie https.
• Toto nastavenie sa vyžaduje pred aktiváciou funkcie centra správy.
• Zmeňte verziu .NET CLR v Základných nastaveniach na „No Managed Code“
• Zmeňte režim spravovaného kanála na „Integrovaný“.

Zmeňte režim spustenia v rozšírených nastaveniach na „AlwaysRunning“, aby ste umožnili prevádzku 24 hodín denne, 7 dní v týždni

Zmeňte časový limit nečinnosti (minúty) v rozšírených nastaveniach na „0“

Vezmite prosím na vedomie
Keď IIS beží OnDemand, zastaví sa, keď:

• Žiadne okno vSolution Link Pro nie je otvorené v okne prehliadača žiadneho klienta
• Nie je otvorené žiadne pripojenie k centru správy
• Žiadne zariadenie nepoužíva volanie domov.

Inštalácia .NET Core Windows Server Hosting

Nainštalujte balík .NET Core Hosting Bundle.
Aplikácia bola testovaná s .NET verziou 7.0.3:  https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.3-windows-hosting-bundle-installer

Ďalšie podrobnosti o službe IIS nájdete na stránke: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/?view=aspnetcore-7.

Zastavte a reštartujte službu v časti Application Pool Tasks v IIS Manager.

Prijmite súbor appsettings.json
The file appsettings.json umožňuje upravovať všetky nastavenia offline pomocou bežného textového editora. Najdôležitejšie nastavenia sú dostupné v grafickom používateľskom rozhraní (Konfigurácia – Nastavenia).

Používanie centra správy (cloud)
„UseHttps“ v sekcii „Hosting“ musí byť nastavené na „true“.

Aktivácia centra správy (voliteľné, v závislosti od nastavenia)
Riadiace centrum pre podporu cloudu musí byť povolené v nastavení pri prvom spustení:

Alternatívne aktivujte Centrum správy v file appsettings.json a manuálne prijmite všetky nastavenia podľa svojich potrieb:

Spustite aplikáciu

Ak chcete spustiť vSolution Link Pro, otvorte prehliadač pracovnej stanice a zadajte IP adresu servera.
Example URL http://192.168.0.1:80

Z bezpečnostných dôvodov je potrebné pri prvom prihlásení zmeniť predvolené heslo.
Upozorňujeme, že po nečinnosti 30 minút budete automaticky odhlásení.

Požiadavky na zariadenie
Na prístup k zariadeniam musia byť online a dostupné!
Zariadenia pripojené ku cloudu (Management Hub) sú v bezpečí webpripojenie zásuvky (WSS) otvorené, aby bolo možné spravovať.
Napr. zariadenia Cynap štandardne deaktivujú svoje LAN porty pri vypnutí a možno ich zapnúť pomocou funkcie Wake on LAN. Pre sieťové infraštruktúry so zablokovaným Wake on LAN použite režim vypnutia Power Save, aby bol LAN port vášho systému Cynap aktívny.
V závislosti od sieťovej infraštruktúry a kvôli viacerým sieťovým portom musí byť na smerovanie sieťovej prevádzky špecifikované smerovanie IP.
Keď používate zariadenia WolfVision Visualizer, použite režimy vypnutia Normal alebo ECO, aby zostal port LAN aktívny.

Prvé prihlásenie – Zmeňte heslo („admin“ pri prvom spustení)
Pri prvom prihlásení je potrebné nastaviť heslo:

Keď by sa mala otvoriť prázdna stránka IIS servera Windows, skontrolujte použité porty a reštartujte server.

Aktualizácia vSolution Link Pro

Zastavte vSolution Link Pro v IIS Manager.
Zálohujte priečinok `Data` z aktuálneho inštalačného priečinka.
Rozbaľte zip archív novej verzie a skopírujte celý obsah do inštalačného priečinka. Skopírujte obsah z predtým uloženého obsahu „Údaje“ do aktuálneho priečinka „Údaje“.

 Dôležité
Po výmene inštalačného priečinka „vSolutionLinkPro“ je potrebné obnoviť povolenie (pozri kapitolu 5.5 Príprava file štruktúra).

Dokončite aktualizáciu
Spustite vSolution Link Pro v správcovi IIS.

Aktualizácia z verzie 1.8.0 (alebo staršej)
Keď bola predtým nainštalovaná vSolution Link Pro verzia 1.8.0 alebo staršia, fond aplikácií sa musí upraviť.
Nastavte položku Povoliť 32-bitové aplikácie na hodnotu „False“

Zmeňte režim spustenia v rozšírených nastaveniach na „AlwaysRunning“, aby ste umožnili prevádzku 24 hodín denne, 7 dní v týždni

Zmeňte časový limit nečinnosti (minúty) v rozšírených nastaveniach na „0“

Vezmite prosím na vedomie
Keď IIS beží OnDemand, zastaví sa, keď:

• Žiadne okno vSolution Link Pro nie je otvorené v okne prehliadača žiadneho klienta
• Nie je otvorené žiadne pripojenie k centru správy
• Žiadne zariadenie nepoužíva volanie domov.

Skontrolujte nastavenia files web.config a appsettings.json
Overiť web.config (nájde sa v koreňovom priečinku IIS), hostingmodel musí
Nastavte položku Povoliť 32-bitové aplikácie na hodnotu „False“

Overiť web.config (nájde sa v koreňovom priečinku IIS), hostingmodel musí byť nastavený na „inprocess“.

Nastavenie „InProcessHostingModel“ v file Appsettings.json je zastaraný od verzie vSolution Link Pro v1.9 a novšej.
Toto nastavenie sa ignoruje a už nemá žiadny účinok.

Prejdite z inštalácie na plochu na inštaláciu IIS

Ak chcete presunúť všetky údaje z predchádzajúcej počítačovej inštalácie do serverovej inštalácie, uistite sa, že vSolution Link Pro je správne nainštalovaný na serveri IIS.

Dôležité
Dôrazne sa odporúča nová inštalácia vSolution Link Pro na server s rovnakým číslom verzie ako predchádzajúca inštalácia na počítač.
Pokračovaním v nasledujúcich krokoch sa stratia všetky údaje inštalácie vSolution Link Pro na serveri.

1. Zastavte server vSolution Link Pro v správcovi IIS.
2. vymazať všetky files a podpriečinky priečinka „Údaje“ vo vašej inštalácii IIS.
3. Predvolená cesta:
   C:\inetpub\wwwroot\vSolutionLinkPro\
4. Skopírujte celý obsah priečinka „Data“ z inštalácie na pracovnej ploche.
   Predvolená cesta:
   Inštalácia na pracovnej ploche systému Windows (skrytý priečinok) C:\ProgramData\WolfVision\vSolution Link Pro\
   Inštalácia počítača MacOS /Library/Application Support/WolfVision/vSolution Link Pro/
5. Prilepte filedo priečinka „Data“ vašej inštalácie IIS.
6.  Predvolená cesta:
   C:\inetpub\wwwroot\vSolutionLinkPro\

Dôležité
Skontrolujte všetky uvedené cesty v súbore appsettings.json file a podľa toho ho opravte.
Predvolená cesta na IIS: C:\\inetpub\\wwwroot\\vSolutionLinkPro\\Data\\
Spustite vSolution Link Pro v správcovi IIS.
Všetky nastavenia a údaje predchádzajúcej inštalácie Desktop sa prenesú na server, vrátane prihlasovacích údajov.

Index

Verzia	Dátum	Zmeny
1.9.1	2024-05-02	Pridaná možnosť DHCP
1.9.1	2023-10-27	Aktualizácia na verziu vSolution Link Pro 1.9.1 Pridaná sekcia „Prejsť z inštalácie na plochu na inštaláciu IIS“.
1.9.0	2023-07-25	Aktualizácia na vSolution Link Pro verziu 1.9.0 Pridané pravidlá pre aktualizáciu aplikácie.
Číslovanie verzií bolo prispôsobené verziovaniu aplikácie.
1.5	2023-05-17	Pridaná aktivácia centra správy (Cloud)
1.4	2023-04-25	Aktualizácia na verziu vSolution Link Pro 1.8.0
1.3	2022-06-21	Aktualizácia .NET Core na verziu 5.0.17
1.2	2022-05-23	Pridané WebPoznámka DAV
1.1	2021-07-07	Aktualizované pravidlá brány firewall
1.0	2021-03-09	Vytvorené

WolfVision GmbH Oberes Ried 14
A-6833 Klaus / RAKÚSKO

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