Guía do usuario do software WOLFVISION vSolution Link Pro

WOLFVISION-vSolution-Link-Pro-Software

Especificacións

• Produto: vSolution Link Pro
• Fabricante: WolfVision GmbH
• Versión: 1.9.1
• Compatibilidade do sistema operativo: Windows IIS
• Tipo de aplicación: Web aplicación de servidor
• Compatibilidade do navegador: navegadores modernos totalmente compatibles con HTML5
• Requisitos do sistema:
  • Sistemas operativos: Windows Web Servizos (IIS Internet Information Server)
  • Outros requisitos: credenciais de correo electrónico, certificado SSL, acceso a Internet, dispoñibilidade de servidor 24/7

Instrucións de uso do produto

Instalación
Siga a Guía de instalación de vSolution Link Pro proporcionada por WolfVision para configurar a aplicación nun servidor Windows IIS.

Requisitos do sistema
Para garantir o bo funcionamento de vSolution Link Pro, asegúrese de cumprir os seguintes requisitos do sistema:

• Instale a aplicación nun servidor Windows IIS.
• Use un navegador moderno totalmente compatible con HTML5 para acceder á aplicación.
• Ten credenciais de correo electrónico, certificado SSL, acceso a Internet e manteña a dispoñibilidade do servidor 24 horas ao día, 7 días ao día.

Provedor de correo electrónico personalizado:
Se non tes un fornecedor de correo electrónico personalizado configurado, utilizarase a conta de Sendgrid integrada para enviar correos electrónicos.

 Regras do firewall:
Asegúrate de que todos os portos, servizos e enderezos IP necesarios estean dispoñibles e non están bloqueados polo teu firewall (externo e persoal). Establece unha regra para permitir que a aplicación WolfVision.MgmtTool.Api.exe teña unha funcionalidade completa.

FAQ:
P: Que debo facer se encontro erros técnicos ao usar vSolution Link Pro?
R: En caso de erros técnicos ou problemas, póñase en contacto co soporte de WolfVision para obter asistencia. Proporcionaránlle a axuda necesaria para resolver calquera problema que poida ter.

Guía de instalación: vSolution Link Pro en IIS
Versión 1.9.1

 Sobre esta Guía

Este documento explica a configuración da aplicación vSolution Link Pro de WolfVision nun servidor IIS de Windows.

Dereitos de autor
Copyright © por WolfVision. Todos os dereitos reservados.
WolfVision, Wofu Vision e son marcas rexistradas de WolfVision Center GmbH, Austria.

• O software é propiedade de WolfVision e dos seus licenciantes. Queda terminantemente prohibida calquera reprodución total ou parcial.
• Non se pode copiar, reproducir ou transmitir ningunha parte deste documento por ningún medio sen o permiso previo por escrito de WolfVision, excepto a documentación conservada polo comprador para fins de copia de seguridade.
• Co interese da mellora continua do produto, WolfVision resérvase o dereito de cambiar as especificacións do produto sen previo aviso.
• A información deste documento pode cambiar sen previo aviso.
• Exención de responsabilidade: WolfVision non será responsable dos erros ou omisións técnicos ou editoriais.
• Uso de marcas comerciais, marcas rexistradas e outros nomes e símbolos protexidos
• Este manual pode facer referencia a marcas comerciais, marcas rexistradas e outros nomes e/ou símbolos protexidos de empresas de terceiros non relacionadas de ningún xeito con WolfVision. Cando se produzan, estas referencias son só con fins ilustrativos e non representan unha aprobación dun produto ou servizo por parte de WolfVision, nin unha aprobación do produto ou dos produtos aos que se aplica este manual por parte da empresa de terceiros en cuestión. Independentemente de calquera recoñecemento directo noutras partes do corpo deste documento, WolfVision recoñece pola presente que todas as marcas comerciais, marcas rexistradas, marcas de servizo e outros nomes e/ou símbolos protexidos contidos neste manual e documentos relacionados son propiedade dos seus respectivos titulares.

Requisitos do sistema

Windows Web Servizos (IIS Internet Information Server)
Como vSolution Link Pro é un web aplicación de servidor, pódese acceder a ela desde calquera navegador moderno totalmente compatible con HTML5 dun dispositivo de terceiros na rede local.
Para utilizar todas as funcións que ofrece a aplicación, ten que estar instalada como IIS (Internet Information Server). Tamén se requiren credenciais de correo electrónico, certificado SSL, acceso a Internet e dispoñibilidade de servidor 24 horas ao día, 7 días de hoxe.
O software (aplicación de 64 bits) pódese instalar nos seguintes sistemas operativos. O seguinte mostra os requisitos mínimos do sistema, máis recomendables:

• Windows Server 2019 ou posterior (deben cumprirse todos os requisitos de Microsoft)
• CPU mínimo 1 núcleo con 2.60 GHz (2 núcleos, ou máis recomendado)
• 4 GB de RAM (8 GB ou máis recomendado)
• 100 GB de espazo libre mínimo para o firmware files (250 GB ou máis recomendado)
• Acceso ao porto seguro (por exemplo, 443, https predeterminado)
• O enderezo do servidor (IP:port) ten que ser accesible a través de seguranza web socket (wss)
• Paquete de hospedaxe .NET Core, probado coa versión 7.0.3

Teña en conta

• Recoméndase as últimas actualizacións.
• As versións anteriores dos sistemas operativos non se proban e poden non ser compatibles.
• Teña en conta o espazo de disco necesario para o repositorio de firmware local, recoméndase un espazo de disco de polo menos 20 GB.
• Para acceder aos dispositivos, teñen que estar en liña e na mesma rede para poder acceder! Preste atención á configuración de rede correcta, especialmente cando se executa en contornos especiais de rede.
• Os sistemas Cynap desactivarán os seus portos LAN cando se apaguen de forma predeterminada e pódense activar mediante a función Wake on LAN. Para infraestruturas de rede con Wake on LAN bloqueado, utiliza o modo de apagado Aforro de enerxía para manter o porto LAN do teu Cynap activo. Cando
• usando dispositivos WolfVision Visualizer, use os modos de apagado Normal ou ECO para manter o porto LAN activo. Algúns modelos de Visualizer admiten Wake on LAN (comproba o modo de apagado do Visualizer conectado).
• Unha hora incorrecta do sistema pode provocar un fallo na conexión de rede, recoméndase o uso dun servidor de tempo válido.

Provedor de correo electrónico personalizado
Requírense credenciais válidas do provedor de correo electrónico personalizado ao activar:

• Autenticación de 2 factores
• Centro de xestión
• Rexistro de eventos Notificación por correo electrónico
• Substitución da caixa*
• Restablecer o contrasinal*.

* Se non se define ningún provedor personalizado, utilizarase a conta de Sendgrid integrada para enviar correos electrónicos.

Certificado SSL: un requisito previo para habilitar Management Hub
Requírese un certificado SSL válido ao restrinxir o acceso a https.

Regras de firewall
Asegúrate de que todos os portos, servizos e enderezos IP necesarios estean dispoñibles e non están bloqueados polo teu firewall (externo e persoal).

Os recoñecementos ("ACKs") dos paquetes TCP non se consideran na seguinte táboa para poder ilustrar a dirección dos paquetes de datos. Dado que os recoñecementos adoitan enviarse de volta a través do mesmo porto TCP, a outra dirección non se bloqueará para garantir un bo funcionamento.

En certos sistemas, tes que establecer unha regra para permitir a aplicación:
WolfVision.MgmtTool.Api.exe para unha funcionalidade completa.

Función / Aplicación	Porto	Tipo	Entrada / Saída	Descrición
vSolution Link Pro
Wake On LAN	7 / 9	UDP	Entrada / Saída	Wake On LAN - Normalmente úsase o porto 7 para enviar o paquete máxico
DNS	53	TCP/UDP	Entrada / Saída	DNS: este porto será usado para o sistema de nomes de dominio. Se este porto está bloqueado, o servizo DNS non está dispoñible
http, control Cynap	80	TCP	Entrada / Saída	Este é o porto predeterminado para conectarse a web interface (httpd) de vSolution Link Pro. Deste porto está bloqueado, a conexión non pode ser establecido
https, SSL, por exemplo, Cloud Service, Cynap control	443	TCP	Entrada / Saída	Este é o porto predeterminado para conectarse web interface (https) de vSolution Link Pro. Se este porto está bloqueado, non se pode establecer a conexión.
SMTP	587	SMTP	Saída	Servidor de correo: porto para comunicación co servidor SMTP.
Discovery Multicast	50000	UDP	Entrante	Este porto utilízase para o descubrimento do dispositivo de todos os Cynap e Visualizer dispoñibles na rede polas aplicacións vSolution (usa o enderezo IP de multidifusión 239.255.255.250). Se este porto está bloqueado, non é posible a detección do dispositivo
Descubrimento de dispositivos	50913	UDP	Entrante	Este porto úsase para detectar dispositivos. Se este porto está bloqueado, non é posible a detección do dispositivo.
Para fins de control	50915	TCP	Entrada / Saída	Este porto úsase para o control fins. Se este porto está bloqueado, non é posible controlar

 Opción DHCP 43 (ou 60)

• Para permitir que os dispositivos se rexistren de forma totalmente automatizada, configure a opción DHCP 43 (ou 60) no servidor DHCP do seu contorno de rede.
• Esta opción é utilizada polos clientes e servidores para intercambiar información específica do provedor.
• A configuración pódese establecer para un ou máis ámbitos (Opcións de ámbito) ou para todo o servidor (Opcións do servidor).
• As diferentes versións dos sistemas operativos do servidor DHCP varían; os seguintes pasos describen a configuración nun centro de datos de Windows Server 2019.
• Abra a súa aplicación DHCP e seleccione "Configurar opcións" no menú contextual de "Opcións de alcance", "ou "Opcións do servidor".

Example con IP 192.168.246.5

0x02 = Tipo Cynap Devices (definido por WolfVision)
0x0D = decimal 13 en hexadecimal = lonxitude do enderezo IP (4 octetos, puntos incluídos)

Example con URL vlinkpro.wolfvision.com

0x02 = Tipo Cynap Devices (definido por WolfVision)
0x17 = decimal 23 en hexadecimal = lonxitude do URL

Teña en conta
Os seguintes sistemas Cynap admiten a opción DHCP 43, a opción DHCP 60 e introducíronse manualmente URL do servidor vSolution Link Pro na súa configuración:

• Cynap
• Cynap PRO
• Cynap Core
• Cynap Core PRO
• Cynap Pure
• Cynap Pure Pro
• Receptor Cynap Pure
• Cynap Pure SDM
• Cynap Pure Mini

Os seguintes sistemas Visualizer admiten a opción DHCP 43 e introducíronse manualmente URL do servidor vSolution Link Pro na súa configuración:

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

Coa configuración predeterminada, a opción de escoitar DHCP está activada.

On-Premise ou Centro de xestión

vSolution Link Pro é un web aplicación de servidor e precisa ser instalada, preferiblemente nun servidor para garantir a dispoñibilidade 24/7.

 Aloxado localmente (instalación local)
Cando a aplicación está aloxada localmente, este servidor, todos os sistemas Cynap e Visualizer e tamén os dispositivos de terceiros (escritorios, estacións de traballo, tabletas) teñen que estar na mesma rede Ethernet.

 Aloxado con Management Hub (instalación na nube)
Cando a aplicación está aloxada coa función de centro de xestión activada, pódense xestionar adicionalmente os dispositivos compatibles coa nube.

Sistemas WolfVision Cynap compatibles en Management Hub:

• Cynap
• Cynap Pro
• Cynap Core
• Cynap Core Pro
• Cynap Pure
• Cynap Pure Pro
• Receptor Cynap Pure
• Cynap Pure SDM

Para unha compatibilidade total, mantén actualizada a versión de firmware instalada de todos os teus dispositivos.

Instalación de servidor (Windows IIS)

vSolution Link Pro é un web aplicación de servidor e precisa ser instalada, preferiblemente nun servidor para garantir a dispoñibilidade 24/7.
As diferentes versións de IIS poden variar lixeiramente; os seguintes pasos describen a instalación nun centro de datos de Windows Server 2019 (compilación do SO 17763.1131) con .NET Core Hosting Bundle versión 7.0.3. A instalación noutras versións pode variar.
vSolution Link Pro entrégase cun estándar web.config, que se pode adoptar, dependendo das súas necesidades.
Teña en conta as opcións adicionais para usar a función Management Hub (acceso á nube).

Descarga a instalación files
Descarga o arquivo zip vSolutionLinkPro_WindowsServer.zip de WolfVision web páxina e descomprimilo.

Engade a funcionalidade de IIS
Abre o panel do Xestor do servidor e engade roles e funcións:

Importante
WebO rol DAV debe permanecer desactivado para o servidor vSolution Link Pro para obter unha funcionalidade completa.

Seleccione WebProtocolo de socket (Desenvolvemento de aplicacións, subelemento de IIS Web servidor)

Prepárate file estrutura
Copie o cartafol descomprimido vSolutionLinkPro_WindowsServer en c:\inetpub\wwwroot

Cambia as propiedades para xestionar os permisos do IIS para permitir o control total

Inicie o Xestor de Internet Information Services (IIS).

Configurar IIS
Xestiona sitios de IIS e engade a ruta física

Restrinxir o acceso a https e comprobar o porto utilizado.
Esta configuración é necesaria antes de activar a función Management Hub.

• Define o teu certificado SSL válido para unha conexión https correcta.
• Esta configuración é necesaria antes de activar a función Management Hub.
• Cambia a versión de .NET CLR na configuración básica a "Sen código xestionado"
• Cambia o modo de canalización xestionado a "Integrado".

Cambia o modo de inicio na configuración avanzada a "Sempre en funcionamento" para permitir o funcionamento 24/7

Cambia o tempo de espera de inactividade (minutos) na configuración avanzada a "0"

Teña en conta
Cando o IIS está a executar OnDemand, detense cando:

• Non hai xanela de vSolution Link Pro aberta nunha xanela do navegador en ningún cliente
• Non hai ningunha conexión aberta ao Centro de xestión
• Ningún dispositivo usa as chamadas á casa.

Instalación de .NET Core Windows Server Hosting

Instala o paquete de hospedaxe .NET Core.
A aplicación probouse coa versión .NET 7.0.3:  https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.3-windows-hosting-bundle-installer

Para obter máis detalles sobre IIS, visite: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/?view=aspnetcore-7.

Detén e reinicia o servizo en Tarefas do grupo de aplicacións no Xestor de IIS.

Adopte appsettings.json
O file appsettings.json permite modificar todas as opcións sen conexión mediante un editor de texto común. A configuración máis importante está accesible na interface gráfica de usuario (Configuración - Configuración).

Usando Management Hub (Cloud)
"UseHttps" na sección "Hosting" ten que ser "true".

Activar o centro de xestión (opcional, dependendo da configuración)
O soporte de Xestión Hub para Cloud debe estar activado na configuración ao inicio inicial:

Alternativa, active o Centro de xestión no file appsettings.json e adopta manualmente todas as opcións segundo as túas necesidades:

Inicia a aplicación

Para iniciar vSolution Link Pro, abra o navegador da estación de traballo e introduza o enderezo IP do servidor.
Example URL http://192.168.0.1:80

Por motivos de seguridade, o contrasinal predeterminado debe cambiarse no primeiro inicio de sesión.
Ten en conta que despois de 30 minutos de inactividade, pecharase automaticamente.

Requisitos do dispositivo
Para acceder aos dispositivos, teñen que estar en liña e accesibles!
Os dispositivos conectados á nube (Management Hub) están protexidos webconexión de socket (WSS) aberta para permitir a xestión.
Por exemplo, os dispositivos Cynap desactivarán os seus portos LAN cando se apaguen de forma predeterminada e pódense acender mediante a función Wake on LAN. Para infraestruturas de rede con Wake on LAN bloqueado, use o modo de apagado Aforro de enerxía para manter o porto LAN do seu sistema Cynap activo.
Dependendo da infraestrutura de rede e debido a varios portos de rede, hai que especificar o enrutamento IP para enrutar o tráfico da rede.
Cando use dispositivos WolfVision Visualizer, use os modos de apagado Normal ou ECO para manter o porto LAN activo.

Primeiro inicio de sesión: cambiar o contrasinal ("admin" ao inicio inicial)
Cando inicie sesión por primeira vez, debe establecerse o contrasinal:

Cando se deba abrir a páxina en branco IIS do servidor de Windows, comprobe os portos utilizados e reinicie o servidor.

Actualizando vSolution Link Pro

Detén vSolution Link Pro en IIS Manager.
Fai unha copia de seguranza do cartafol `Datos` desde o teu cartafol de instalación actual.
Desempaquete o arquivo zip da nova versión e copie o contido completo no cartafol de instalación. Copia o contido do teu contido previamente gardado de `Datos` ao cartafol `Datos` actual.

 Importante
Cando se trocou o cartafol de instalación "vSolutionLinkPro", o permiso ten que ser renovado (consulte o capítulo 5.5 Preparación). file estrutura).

Completa a actualización
Inicie vSolution Link Pro no Xestor de IIS.

Actualizando desde a versión v1.8.0 (ou anterior)
Cando se instalou vSolution Link Pro versión 1.8.0 ou anterior, o grupo de aplicacións debe modificarse.
Establece Activar aplicacións de 32 bits en "Falso"

Cambia o modo de inicio na configuración avanzada a "Sempre en funcionamento" para permitir o funcionamento 24/7

Cambia o tempo de espera de inactividade (minutos) na configuración avanzada a "0"

Teña en conta
Cando o IIS está a executar OnDemand, detense cando:

• Non hai xanela de vSolution Link Pro aberta nunha xanela do navegador en ningún cliente
• Non hai ningunha conexión aberta ao Centro de xestión
• Ningún dispositivo usa as chamadas á casa.

Comprobe a configuración files web.config e appsettings.json
Verifica web.config (atópase no cartafol raíz do IIS), hostingmodel ten que facelo
Establece Activar aplicacións de 32 bits en "Falso"

Verifica web.config (atópase no cartafol raíz do IIS), o hostingmodel ten que estar configurado como "en proceso".

A configuración "InProcessHostingModel" no ficheiro file appsettings.json está obsoleto desde vSolution Link Pro v1.9 e posteriores.
Esta configuración ignorouse e xa non ten efecto.

Pasa de Instalación de escritorio a Instalación de IIS

Para mover todos os datos dunha instalación de escritorio anterior a unha instalación de servidor, asegúrese de que vSolution Link Pro estea instalado correctamente no servidor IIS.

Importante
Recoméndase encarecidamente unha nova instalación de vSolution Link Pro no servidor cun número de versión idéntico que a anterior instalación de escritorio.
Ao continuar cos seguintes pasos, pérdense todos os datos da instalación de vSolution Link Pro no servidor.

1. Detén o servidor vSolution Link Pro no Xestor de IIS.
2. elete todo files e subcartafoles do cartafol `Datos` na súa instalación de IIS.
3. Camiño predeterminado:
   C:\inetpub\wwwroot\vSolutionLinkPro\
4. Copia todo o contido do cartafol `Datos` desde a instalación do teu escritorio.
   Camiño predeterminado:
   Instalación de escritorio de Windows (cartafol oculto) C:\ProgramData\WolfVision\vSolution Link Pro\
   Instalación de escritorio de MacOS /Biblioteca/Soporte de aplicación/WolfVision/vSolution Link Pro/
5. Pega o files no cartafol "Datos" da súa instalación de IIS.
6.  Camiño predeterminado:
   C:\inetpub\wwwroot\vSolutionLinkPro\

Importante
Comprobe todas as rutas listadas en appsettings.json file e corrixao en consecuencia.
Ruta predeterminada en IIS: C:\\inetpub\\wwwroot\\vSolutionLinkPro\\Data\\
Inicie vSolution Link Pro no Xestor de IIS.
Todos os axustes e datos da antiga instalación do escritorio transfírense ao servidor, incluídas as credenciais de inicio de sesión.

Índice

Versión	Data	Cambios
1.9.1	2024-05-02	Engadiuse a opción DHCP
1.9.1	2023-10-27	Actualizar a vSolution Link Pro versión 1.9.1 Engadida a sección "Mover da instalación de escritorio á instalación de IIS".
1.9.0	2023-07-25	Actualización á versión 1.9.0 de vSolution Link Pro Engadidas regras para actualizar a aplicación.
Adaptouse a numeración das versións á versión da aplicación.
1.5	2023-05-17	Engadida a activación do centro de xestión (Cloud)
1.4	2023-04-25	Actualizar a vSolution Link Pro versión 1.8.0
1.3	2022-06-21	Actualización de .NET Core á versión 5.0.17
1.2	2022-05-23	Engadido WebNota DAV
1.1	2021-07-07	Regras de firewall actualizadas
1.0	2021-03-09	Creado

WolfVision GmbH Oberes Ried 14
A-6833 Klaus / AUSTRIA

Tel + 43-5523-52250
Fax +43-5523-52249
Correo electrónico: wolfvision@wolfvision.com
www.wolfvision.com