Uživatelská příručka k softwaru WOLFVISION vSolution Link Pro

WOLFVISION-vSolution-Link-Pro-Software

Specifikace

• Produkt: vSolution Link Pro
• Výrobce: WolfVision GmbH
• Verze: 1.9.1
• Kompatibilita operačního systému: Windows IIS
• Typ aplikace: Web serverová aplikace
• Kompatibilita prohlížečů: Moderní prohlížeče plně kompatibilní s HTML5
• Systémové požadavky:
  • Operační systémy: Windows Web Služby (IIS Internet Information Server)
  • Další požadavky: E-mailové přihlašovací údaje, SSL certifikát, přístup k internetu, 24/7 dostupnost serveru

Návod k použití produktu

Instalace
Při nastavení aplikace na serveru Windows IIS postupujte podle instalační příručky vSolution Link Pro od společnosti WolfVision.

Systémové požadavky
Chcete-li zajistit hladké fungování vSolution Link Pro, ujistěte se, že splňujete následující systémové požadavky:

• Nainstalujte aplikaci na server Windows IIS.
• Pro přístup k aplikaci použijte moderní prohlížeč plně kompatibilní s HTML5.
• Mějte e-mailové přihlašovací údaje, certifikát SSL, přístup k internetu a udržujte dostupnost serveru 24 hodin denně, 7 dní v týdnu.

Vlastní e-mailový poskytovatel:
Pokud nemáte nastaveného vlastního poskytovatele e-mailu, bude pro odesílání e-mailů použit integrovaný účet Sendgrid.

 Pravidla brány firewall:
Ujistěte se, že všechny potřebné porty, služby a IP adresy jsou dostupné a nejsou blokovány vaším firewallem (externím a osobním). Nastavte pravidlo, které umožní aplikaci WolfVision.MgmtTool.Api.exe pro plnou funkčnost.

FAQ:
Otázka: Co mám dělat, pokud při používání vSolution Link Pro narazím na technické chyby?
Odpověď: V případě technických chyb nebo problémů se prosím obraťte na podporu WolfVision. Poskytnou vám nezbytnou pomoc při řešení jakýchkoli problémů, se kterými se můžete setkat.

Instalační příručka: vSolution Link Pro na IIS
Verze 1.9.1

 O tomto průvodci

Tento dokument vysvětluje nastavení aplikace vSolution Link Pro od společnosti WolfVision na serveru Windows IIS.

Copyright
Copyright © od WolfVision. Všechna práva vyhrazena.
WolfVision, Wofu Vision a jsou registrované ochranné známky společnosti WolfVision Center GmbH, Rakousko.

• Software je majetkem společnosti WolfVision a jejích poskytovatelů licencí. Jakákoli reprodukce celého nebo jeho části je přísně zakázána.
• Žádná část tohoto dokumentu nesmí být kopírována, reprodukována nebo přenášena žádnými prostředky bez předchozího písemného souhlasu společnosti WolfVision s výjimkou dokumentace uchovávané kupujícím pro účely zálohování.
• V zájmu neustálého zlepšování produktu si WolfVision vyhrazuje právo změnit specifikace produktu bez upozornění.
• Informace v tomto dokumentu se mohou změnit bez předchozího upozornění.
• Zřeknutí se odpovědnosti: WolfVision nenese odpovědnost za technické nebo redakční chyby nebo opomenutí.
• Používání ochranných známek, registrovaných ochranných známek a dalších chráněných názvů a symbolů
• Tato příručka může obsahovat odkazy na ochranné známky, registrované ochranné známky a další chráněná jména a/nebo symboly společností třetích stran, které nemají žádný vztah ke společnosti WolfVision. Tam, kde se vyskytují, jsou tyto odkazy pouze pro ilustrativní účely a nepředstavují podporu produktu nebo služby společnosti WolfVision ani podporu produktu (produktů), na který se vztahuje tato příručka, příslušnou třetí stranou. Bez ohledu na jakékoli přímé potvrzení jinde v těle tohoto dokumentu společnost WolfVision tímto potvrzuje, že všechny ochranné známky, registrované ochranné známky, servisní značky a další chráněná jména a/nebo symboly obsažené v této příručce a souvisejících dokumentech jsou majetkem příslušných držitelů.

Systémové požadavky

Windows Web Služby (IIS Internet Information Server)
Protože vSolution Link Pro je a web serverová aplikace, je přístupná z jakéhokoli moderního plně HTML5 kompatibilního prohlížeče zařízení třetí strany v lokální síti.
Abyste mohli využívat všechny funkce, které aplikace poskytuje, musí být nainstalována jako IIS (Internet Information Server). Dále jsou vyžadovány e-mailové přihlašovací údaje, certifikát SSL, přístup k internetu a nepřetržitá dostupnost serveru.
Software (64bitová aplikace) lze nainstalovat na následující operační systémy. Níže jsou uvedeny minimální systémové požadavky, více doporučeno:

• Windows Server 2019 nebo novější (musí být splněny všechny požadavky podle Microsoftu)
• CPU minimálně 1 jádro s 2.60 GHz (doporučeno 2 jádra nebo více)
• 4 GB RAM (doporučeno 8 GB nebo více)
• Minimálně 100 GB volného místa na disku pro firmware files (doporučeno 250 GB nebo více)
• Přístup k zabezpečenému portu (např. 443, výchozí https)
• Adresa serveru (IP:port) musí být dostupná přes zabezpečený web zásuvka (wss)
• .NET Core Hosting Bundle, testováno s verzí 7.0.3

Vezměte prosím na vědomí

• Doporučeny nejnovější aktualizace.
• Starší verze operačních systémů nejsou testovány a nemusí být podporovány.
• Vezměte prosím na vědomí požadovaný prostor na disku pro místní úložiště firmwaru, doporučuje se místo na disku alespoň 20 GB.
• Pro přístup k zařízením musí být online a ve stejné síti, aby byla dosažitelná! Věnujte pozornost správnému nastavení sítě, zejména při provozu ve speciálních síťových prostředích.
• Systémy Cynap ve výchozím nastavení deaktivují své porty LAN při vypnutí a lze je zapnout pomocí funkce Wake on LAN. U síťových infrastruktur s zablokovanou funkcí Wake on LAN použijte režim vypnutí Power Save, aby byl LAN port vašeho Cynapu aktivní. Když
• při použití zařízení WolfVision Visualizer použijte režimy vypnutí Normal nebo ECO, aby byl port LAN aktivní. Některé modely Visualizeru podporují Wake on LAN (zkontrolujte režim vypnutí připojeného Visualizeru).
• Nesprávný systémový čas může způsobit selhání síťového připojení, doporučujeme použít platný časový server.

Vlastní e-mailový poskytovatel
Při povolení:

• 2-faktorová autentizace
• Centrum pro správu
• Protokol událostí Upozornění e-mailem
• Výměna krabice*
• Resetovat heslo*.

* Pokud není nastaven žádný vlastní poskytovatel, bude pro odesílání e-mailů použit integrovaný účet Sendgrid.

SSL certifikát – předpoklad pro aktivaci Management Hub
Při omezení přístupu na https je vyžadován platný SSL certifikát.

Pravidla brány firewall
Ujistěte se, že všechny potřebné porty, služby a IP adresy jsou dostupné a nejsou blokovány vaším firewallem (externím a osobním).

Potvrzení („ACK“) paketů TCP nejsou v následující tabulce zohledněna, aby bylo možné ilustrovat směr datových paketů. Vzhledem k tomu, že potvrzení jsou obvykle zasílána zpět přes stejný TCP port, druhý směr nesmí být blokován, aby bylo zajištěno hladké fungování.

Na některých systémech musíte nastavit pravidlo pro povolení aplikace:
WolfVision.MgmtTool.Api.exe pro plnou funkčnost.

Funkce / Aplikace	Přístav	Typ	Příchozí / odchozí	Popis
vSolution Link Pro
Wake On LAN	7/9	UDP	Příchozí / odchozí	Wake On LAN – Pro odeslání magického paketu se obvykle používá port 7
DNS	53	TCP / UDP	Příchozí / odchozí	DNS – Tento port bude použit pro Domain Name System. Pokud je tento port blokován, služba DNS není dostupná
http, ovládání Cynap	80	TCP	Příchozí / odchozí	Toto je výchozí port pro připojení k web rozhraní (httpd) vSolution Link Pro. Tento port je blokován, nelze se připojit založeno
https, SSL, např. Cloud Service, ovládání Cynap	443	TCP	Příchozí / odchozí	Toto je výchozí port pro připojení web rozhraní (https) vSolution Link Pro. Pokud je tento port zablokován, nelze navázat spojení.
SMTP	587	SMTP	Odchozí	Mail Server – Port pro komunikaci se serverem SMTP.
Discovery Multicast	50000	UDP	Příchozí	Tento port se používá pro zjištění zařízení všech dostupných Cynap a Visualizer v síti aplikacemi vSolution (používá Multicast IP adresu 239.255.255.250). Pokud je tento port zablokován, zjišťování zařízení není možné
Objevování zařízení	50913	UDP	Příchozí	Tento port se používá pro vyhledávání zařízení. Pokud je tento port zablokován, zjišťování zařízení není možné.
Pro kontrolní účely	50915	TCP	Příchozí / odchozí	Tento port se používá pro ovládání účely. Pokud je tento port zablokován, není možná žádná kontrola

 Možnost DHCP 43 (nebo 60)

• Chcete-li, aby se zařízení registrovala plně automaticky, nastavte volbu DHCP 43 (nebo 60) na serveru DHCP ve vašem síťovém prostředí.
• Tuto možnost používají klienti a servery k výměně informací specifických pro dodavatele.
• Nastavení lze nastavit pro jeden nebo více oborů (Scope Options) nebo pro celý server (Server Options).
• Různé verze operačních systémů serveru DHCP se liší, následující kroky popisují nastavení v datovém centru Windows Server 2019.
• Otevřete aplikaci DHCP a v kontextové nabídce „Možnosti rozsahu“ nebo „Možnosti serveru“ vyberte „Možnosti konfigurace“.

Example s IP 192.168.246.5

0x02 = Typ zařízení Cynap (definovaný WolfVision)
0x0D = desetinné číslo 13 v hex = délka IP adresy (4 oktety, včetně teček)

Example s URL vlinkpro.wolfvision.com

0x02 = Typ zařízení Cynap (definovaný WolfVision)
0x17 = desetinné číslo 23 v hex = délka URL

Poznámka:
Následující systémy Cynap podporují volbu DHCP 43, volbu DHCP 60 a ručně zadané URL serveru vSolution Link Pro v jejich nastavení:

• Cynap
• Cynap PRO
• Jádro Cynap
• Cynap Core PRO
• Cynap Pure
• Cynap Pure Pro
• Přijímač Cynap Pure
• Cynap Pure SDM
• Cynap Pure Mini

Následující systémy Visualizer podporují volbu DHCP 43 a zadávají se ručně URL serveru vSolution Link Pro v jejich nastavení:

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

Ve výchozím nastavení je povolena možnost naslouchání DHCP.

On-Premise nebo Management Hub

vSolution Link Pro je a web serverová aplikace a musí být nainstalován, preferováno na serveru, aby byla zajištěna dostupnost 24/7.

 Hostované on-premise (místní instalace)
Když je aplikace hostována on-premise, tento server, všechny systémy Cynap a Visualizer a také zařízení třetích stran (stolní počítače, pracovní stanice, tablety) musí být ve stejné síti Ethernet.

 Hostováno v centru pro správu (cloudová instalace)
Když je aplikace hostována s povolenou funkcí Centrum správy, lze zařízení s podporou cloudu spravovat dodatečně.

Podporované systémy WolfVision Cynap v Management Hub:

• Cynap
• Cynap Pro
• Jádro Cynap
• Cynap Core Pro
• Cynap Pure
• Cynap Pure Pro
• Přijímač Cynap Pure
• Cynap Pure SDM

Pro plnou kompatibilitu udržujte nainstalovanou verzi firmwaru všech svých zařízení aktuální.

Instalace serveru (Windows IIS)

vSolution Link Pro je a web serverová aplikace a musí být nainstalován, preferováno na serveru, aby byla zajištěna dostupnost 24/7.
Různé verze IIS se mohou mírně lišit, následující kroky popisují instalaci na Windows Server 2019 Datacenter (OS build 17763.1131) s .NET Core Hosting Bundle verze 7.0.3. Instalace v jiných verzích se může lišit.
vSolution Link Pro je dodáván se standardem web.config, který lze převzít v závislosti na vašich potřebách.
Všimněte si dalších nastavení pro používání funkce Management Hub (cloudový přístup).

Stáhněte si instalaci files
Stáhněte si zip archiv vSolutionLinkPro_WindowsServer.zip z WolfVision web stránku a rozbalte ji.

Přidejte funkce IIS
Otevřete řídicí panel správce serveru a přidejte role a funkce:

Důležité
WebPro plnou funkčnost by pro server vSolution Link Pro měla zůstat role DAV deaktivována.

Vybrat WebSocket Protocol (vývoj aplikací, podpoložka IIS Web server)

Připravit file struktura
Zkopírujte rozbalenou složku vSolutionLinkPro_WindowsServer do c:\inetpub\wwwroot

Změňte vlastnosti, abyste mohli spravovat oprávnění služby IIS, abyste měli plnou kontrolu

Spusťte Správce Internetové informační služby (IIS).

Nastavení služby IIS
Spravujte weby služby IIS a přidejte fyzickou cestu

Omezte přístup k https a zkontrolujte použitý port.
Toto nastavení je vyžadováno před aktivací funkce Centrum správy.

• Definujte svůj platný certifikát SSL pro správné připojení https.
• Toto nastavení je vyžadováno před aktivací funkce Centrum správy.
• Změňte verzi .NET CLR v Základním nastavení na „Žádný spravovaný kód“
• Změňte režim spravovaného kanálu na „Integrovaný“.

Změňte Start Mode v Advanced settings na „AlwaysRunning“, abyste umožnili provoz 24/7

Změňte prodlevu nečinnosti (minuty) v pokročilých nastaveních na „0“

Vezměte prosím na vědomí
Když služba IIS běží OnDemand, zastaví se, když:

• Žádné okno vSolution Link Pro není otevřeno v okně prohlížeče u žádného klienta
• Není otevřené žádné připojení k centru pro správu
• Žádné zařízení nepoužívá volání domů.

Instalace .NET Core Windows Server Hosting

Nainstalujte balíček .NET Core Hosting Bundle.
Aplikace byla testována s .NET verze 7.0.3:  https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.3-windows-hosting-bundle-installer

Další podrobnosti o službě IIS naleznete na adrese: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/?view=aspnetcore-7.

Zastavte a restartujte službu v části Úlohy fondu aplikací ve Správci služby IIS.

Přijměte soubor appsettings.json
The file appsettings.json umožňuje upravovat všechna nastavení offline pomocí běžného textového editoru. Nejdůležitější nastavení jsou dostupná v grafickém uživatelském rozhraní (Konfigurace – Nastavení).

Použití centra pro správu (cloud)
„UseHttps“ v sekci „Hosting“ musí být nastaveno na „true“.

Aktivace centra správy (volitelné, v závislosti na nastavení)
Podpora Management Hub for Cloud musí být povolena v nastavení při prvním spuštění:

Alternativně aktivujte Centrum správy v file appsettings.json a ručně převezměte všechna nastavení podle svých potřeb:

Spusťte aplikaci

Chcete-li spustit vSolution Link Pro, otevřete prohlížeč pracovní stanice a zadejte IP adresu serveru.
Example URL http://192.168.0.1:80

Z bezpečnostních důvodů je třeba při prvním přihlášení změnit výchozí heslo.
Upozorňujeme, že po nečinnosti 30 minut budete automaticky odhlášeni.

Požadavky na zařízení
Pro přístup k zařízením musí být online a dosažitelná!
Zařízení připojená ke cloudu (Management Hub) jsou v bezpečí websoketové připojení (WSS) otevřené pro umožnění správy.
Např. zařízení Cynap ve výchozím nastavení deaktivují své LAN porty při vypnutí a lze je zapnout pomocí funkce Wake on LAN. U síťových infrastruktur s zablokovanou funkcí Wake on LAN použijte režim vypnutí Power Save, aby byl port LAN vašeho systému Cynap aktivní.
V závislosti na síťové infrastruktuře a kvůli více síťovým portům musí být pro směrování síťového provozu specifikováno IP směrování.
Při používání zařízení WolfVision Visualizer používejte režimy vypnutí Normální nebo ECO, aby byl port LAN aktivní.

První přihlášení – Změňte heslo („admin“ při prvním spuštění)
Při prvním přihlášení je nutné nastavit heslo:

Když by se měla otevřít prázdná stránka IIS serveru Windows, zkontrolujte použité porty a restartujte server.

Aktualizace vSolution Link Pro

Zastavte vSolution Link Pro ve Správci IIS.
Zálohujte složku `Data` z aktuální instalační složky.
Rozbalte zip archiv nové verze a zkopírujte celý obsah do instalační složky. Zkopírujte obsah z dříve uloženého obsahu `Data` do aktuální složky `Data`.

 Důležité
Při výměně instalační složky „vSolutionLinkPro“ je třeba obnovit oprávnění (viz kapitola 5.5 Příprava file struktura).

Dokončete aktualizaci
Spusťte vSolution Link Pro ve Správci IIS.

Aktualizace z verze v1.8.0 (nebo starší)
Když byla dříve nainstalována vSolution Link Pro verze 1.8.0 nebo starší, je třeba upravit fond aplikací.
Nastavte Povolit 32bitové aplikace na „False“

Změňte Start Mode v Advanced settings na „AlwaysRunning“, abyste umožnili provoz 24/7

Změňte prodlevu nečinnosti (minuty) v pokročilých nastaveních na „0“

Vezměte prosím na vědomí
Když služba IIS běží OnDemand, zastaví se, když:

• Žádné okno vSolution Link Pro není otevřeno v okně prohlížeče u žádného klienta
• Není otevřené žádné připojení k centru pro správu
• Žádné zařízení nepoužívá volání domů.

Zkontrolujte nastavení files web.config a appsettings.json
Ověřte web.config (bude nalezen v kořenové složce IIS), hostingmodel musí
Nastavte Povolit 32bitové aplikace na „False“

Ověřte web.config (bude nalezen v kořenové složce IIS), hostingmodel musí být nastaven na „inprocess“.

Nastavení „InProcessHostingModel“ v file Appsettings.json je zastaralý od verze vSolution Link Pro v1.9 a novější.
Toto nastavení je ignorováno a již nemá žádný účinek.

Přejděte z instalace na plochu na instalaci IIS

Chcete-li přesunout všechna data z dřívější desktopové instalace na serverovou instalaci, ujistěte se, že je vSolution Link Pro správně nainstalován na serveru IIS.

Důležité
Důrazně se doporučuje nová instalace vSolution Link Pro na server s identickým číslem verze než předchozí instalace pro stolní počítač.
Pokračováním v následujících krocích se všechna data instalace vSolution Link Pro na serveru ztratí.

1. Zastavte server vSolution Link Pro ve Správci IIS.
2. smazat všechny files a podsložky složky `Data` ve vaší instalaci IIS.
3. Výchozí cesta:
   C:\inetpub\wwwroot\vSolutionLinkPro\
4. Zkopírujte celý obsah složky `Data` z instalace na ploše.
   Výchozí cesta:
   Instalace na plochu Windows (skrytá složka) C:\ProgramData\WolfVision\vSolution Link Pro\
   Desktopová instalace MacOS /Library/Application Support/WolfVision/vSolution Link Pro/
5. Vložte files do složky `Data` vaší instalace IIS.
6.  Výchozí cesta:
   C:\inetpub\wwwroot\vSolutionLinkPro\

Důležité
Zkontrolujte všechny uvedené cesty v souboru appsettings.json file a podle toho to opravit.
Výchozí cesta na IIS: C:\\inetpub\\wwwroot\\vSolutionLinkPro\\Data\\
Spusťte vSolution Link Pro ve Správci IIS.
Všechna nastavení a data předchozí instalace Desktop se přenesou na server, včetně přihlašovacích údajů.

Index

Verze	Datum	Změny
1.9.1	2024-05-02	Přidána možnost DHCP
1.9.1	2023-10-27	Aktualizace na vSolution Link Pro verze 1.9.1 Přidána sekce „Přejít z instalace na plochu na instalaci IIS“.
1.9.0	2023-07-25	Aktualizace na vSolution Link Pro verze 1.9.0 Přidána pravidla pro aktualizaci aplikace.
Číslování verzí bylo přizpůsobeno verzování aplikace.
1.5	2023-05-17	Přidána aktivace centra správy (Cloud)
1.4	2023-04-25	Aktualizace na vSolution Link Pro verze 1.8.0
1.3	2022-06-21	Aktualizace .NET Core na verzi 5.0.17
1.2	2022-05-23	Přidáno WebPoznámka DAV
1.1	2021-07-07	Aktualizovaná pravidla brány firewall
1.0	2021-03-09	Vytvořeno

WolfVision GmbH Oberes Ried 14
A-6833 Klaus / RAKOUSKO

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