Guide de l'utilisateur du logiciel WOLFVISION vSolution Link Pro

Produit : vSolution Link Pro
Fabricant : WolfVision GmbH
Version: 1.9.1
Compatibilité du système d'exploitation : Windows IIS
Type d'application : Web application serveur
Compatibilité des navigateurs : navigateurs modernes entièrement compatibles HTML5
Configuration requise :
- Systèmes d'exploitation : Windows Web Services (serveur d'informations Internet IIS)
- Autres exigences : identifiants de messagerie, certificat SSL, accès Internet, disponibilité du serveur 24h/7 et XNUMXj/XNUMX

Instructions d'utilisation du produit

Installation
Suivez le guide d'installation de vSolution Link Pro fourni par WolfVision pour configurer l'application sur un serveur Windows IIS.

Configuration requise
Pour garantir le bon fonctionnement de vSolution Link Pro, assurez-vous de respecter la configuration système requise suivante :

Installez l'application sur un serveur Windows IIS.
Utilisez un navigateur moderne entièrement compatible HTML5 pour accéder à l'application.
Disposez d'informations d'identification de messagerie, d'un certificat SSL, d'un accès Internet et maintenez la disponibilité du serveur 24h/7 et XNUMXj/XNUMX.

Fournisseur de messagerie personnalisé :
Si vous n'avez pas défini de fournisseur de messagerie personnalisé, le compte Sendgrid intégré sera utilisé pour l'envoi d'e-mails.

Règles du pare-feu :
Assurez-vous que tous les ports, services et adresses IP nécessaires sont disponibles et non bloqués par votre pare-feu (externe et personnel). Définissez une règle pour autoriser l'application WolfVision.MgmtTool.Api.exe à bénéficier de toutes les fonctionnalités.

FAQ:
Q : Que dois-je faire si je rencontre des erreurs techniques lors de l'utilisation de vSolution Link Pro ?
R : En cas d'erreurs ou de problèmes techniques, veuillez contacter le support WolfVision pour obtenir de l'aide. Ils vous apporteront l’aide nécessaire pour résoudre les problèmes que vous pourriez rencontrer.

Guide d'installation : vSolution Link Pro sur IIS
Version 1.9.1

À propos de ce guide

Ce document explique la configuration de l'application vSolution Link Pro par WolfVision sur un serveur Windows IIS.

Droits d'auteur
Copyright © par WolfVision. Tous les droits sont réservés.
WolfVision, Wofu Vision et sont des marques déposées de WolfVision Center GmbH, Autriche.

Le logiciel est la propriété de WolfVision et de ses concédants de licence. Toute reproduction totale ou partielle est strictement interdite.
Aucune partie de ce document ne peut être copiée, reproduite ou transmise par quelque moyen que ce soit, sans l'autorisation écrite préalable de WolfVision, à l'exception de la documentation conservée par l'acheteur à des fins de sauvegarde.
Dans l'intérêt de l'amélioration continue du produit, WolfVision se réserve le droit de modifier les spécifications du produit sans préavis.
Les informations contenues dans ce document peuvent changer sans préavis.
Clause de non-responsabilité : WolfVision ne peut être tenu responsable des erreurs ou omissions techniques ou éditoriales.
Utilisation des marques commerciales, des marques déposées et d'autres noms et symboles protégés
Ce manuel peut faire référence à des marques commerciales, des marques déposées et d'autres noms protégés et/ou symboles de sociétés tierces sans aucun lien avec WolfVision. Lorsqu'elles apparaissent, ces références sont uniquement à des fins d'illustration et ne représentent pas une approbation d'un produit ou d'un service par WolfVision, ni une approbation du ou des produits auxquels ce manuel s'applique par la société tierce en question. Indépendamment de toute reconnaissance directe ailleurs dans le corps de ce document, WolfVision reconnaît par la présente que toutes les marques commerciales, marques déposées, marques de service et autres noms et/ou symboles protégés contenus dans ce manuel et les documents associés sont la propriété de leurs détenteurs respectifs.

Configuration requise

Fenêtres Web Services (serveur d'informations Internet IIS)
Comme vSolution Link Pro est un web application serveur, il est accessible par n'importe quel navigateur moderne entièrement compatible HTML5 d'un appareil tiers du réseau local.
Pour utiliser toutes les fonctionnalités fournies par l'application, celle-ci doit être installée en tant que IIS (Internet Information Server). Des identifiants de messagerie, un certificat SSL, un accès Internet et une disponibilité du serveur 24h/7 et XNUMXj/XNUMX sont également requis.
Le logiciel (application 64 bits) peut être installé sur les systèmes d'exploitation suivants. Ce qui suit montre la configuration minimale requise, plus recommandée :

Windows Server 2019 ou version ultérieure (toutes les exigences selon Microsoft doivent être remplies)
Processeur minimum 1 cœur avec 2.60 GHz (2 cœurs ou plus recommandés)
4 Go de RAM (8 Go ou plus recommandés)
100 Go d'espace disque libre minimum pour le micrologiciel files (250 Go ou plus recommandé)
Accès au port sécurisé (par exemple 443, https par défaut)
L'adresse du serveur (IP:port) doit être accessible via un accès sécurisé web prise (wss)
.NET Core Hosting Bundle, testé avec la version 7.0.3

Veuillez noter

Dernières mises à jour recommandées.
Les versions antérieures des systèmes d'exploitation ne sont pas testées et peuvent ne pas être prises en charge.
Veuillez noter l'espace disque requis pour le référentiel de micrologiciel local, un espace disque d'au moins 20 Go est recommandé.
Pour accéder aux appareils, ils doivent être en ligne et sur le même réseau pour être joignables ! Faites attention aux paramètres réseau corrects, en particulier lors de l'exécution dans des environnements réseau spéciaux.
Les systèmes Cynap désactiveront leurs ports LAN lors de la mise hors tension par défaut et peuvent être mis sous tension en utilisant la fonctionnalité Wake on LAN. Pour les infrastructures réseau avec Wake on LAN bloqué, utilisez le mode de mise hors tension Power Save pour garder le port LAN de votre Cynap actif. Quand
à l'aide des appareils WolfVision Visualizer, utilisez les modes de mise hors tension Normal ou ECO pour garder le port LAN actif. Certains modèles de Visualizer prennent en charge Wake on LAN (vérifiez le mode de mise hors tension du Visualizer connecté).
Une heure système incorrecte peut entraîner l'échec de la connexion réseau, l'utilisation d'un serveur de temps valide est recommandée.

Fournisseur de messagerie personnalisé
Des informations d'identification valides du fournisseur de messagerie personnalisé sont requises lors de l'activation :

Authentification à 2 facteurs
Centre de gestion
Journal des événements Notification par e-mail
Remplacement de la boîte*
Réinitialisation du mot de passe*.

* Si aucun fournisseur personnalisé n'est défini, le compte Sendgrid intégré sera utilisé pour l'envoi d'e-mails.

Certificat SSL – une condition préalable à l'activation de Management Hub
Un certificat SSL valide est requis pour restreindre l'accès à https.

Règles de pare-feu
Assurez-vous que tous les ports, services et adresses IP nécessaires sont disponibles et ne sont pas bloqués par votre pare-feu (externe et personnel).

Les accusés de réception (« ACK ») des paquets TCP ne sont pas pris en compte dans le tableau suivant afin de pouvoir illustrer la direction des paquets de données. Étant donné que les accusés de réception sont généralement renvoyés via le même port TCP, l'autre sens ne doit pas être bloqué pour garantir un bon fonctionnement.

Sur certains systèmes, vous devez définir une règle pour autoriser l'application :
WolfVision.MgmtTool.Api.exe pour toutes les fonctionnalités.

Fonction/Application	Port	Taper	Entrant et sortant	Description
vSolution Lien Pro
Réveil sur LAN	7 / 9	Protocole UDP	Entrant et sortant	Wake On LAN - Habituellement, le port 7 est utilisé pour envoyer le paquet magique
DNS	53	TCP/UDP	Entrant et sortant	DNS – Ce port sera utilisé pour le système de noms de domaine. Si ce port est bloqué, le service DNS n'est pas disponible
http, contrôle Cynap	80	TCP	Entrant et sortant	Il s'agit du port par défaut pour se connecter au web (httpd) de vSolution Link Pro. Si ce port est bloqué, la connexion ne peut pas être établi
https, SSL, par exemple Cloud Service, contrôle Cynap	443	TCP	Entrant et sortant	Il s'agit du port par défaut auquel se connecter web interface (https) de vSolution Link Pro. Si ce port est bloqué, la connexion ne peut pas être établie.
SMTP	587	SMTP	Sortant	Serveur de messagerie – Port pour la communication avec le serveur SMTP.
Découverte Multidiffusion	50000	Protocole UDP	Entrant	Ce port est utilisé pour la découverte de périphériques tous les Cynap et Visualizer disponibles sur le réseau par les applications vSolution (utilise l'adresse IP de multidiffusion 239.255.255.250). Si ce port est bloqué, la découverte de périphérique n'est pas possible
Découverte d'appareils	50913	Protocole UDP	Entrant	Ce port est utilisé pour la découverte de périphériques. Si ce port est bloqué, la détection de périphérique n'est pas possible.
A des fins de contrôle	50915	TCP	Entrant et sortant	Ce port est utilisé pour le contrôle fins. Si ce port est bloqué, aucun contrôle n'est possible

Option DHCP 43 (ou 60)

Pour permettre aux appareils de s'enregistrer de manière entièrement automatisée, définissez l'option DHCP 43 (ou 60) sur le serveur DHCP de votre environnement réseau.
Cette option est utilisée par les clients et les serveurs pour échanger des informations spécifiques au fournisseur.
Le paramètre peut être défini pour une ou plusieurs étendues (Options d’étendue) ou pour l’ensemble du serveur (Options du serveur).
Les différentes versions des systèmes d'exploitation de serveur DHCP varient. Les étapes suivantes décrivent la configuration sur un centre de données Windows Server 2019.
Ouvrez votre application DHCP et sélectionnez « Configurer les options » dans le menu contextuel de « Options de portée », « ou « Options du serveur ».

Example avec IP 192.168.246.5

0x02 = Type Cynap Devices (défini par WolfVision)
0x0D = décimal 13 en hexadécimal = longueur de l'adresse IP (4 octets, points inclus)

Example avec URL vlinkpro.wolfvision.com

0x02 = Type Cynap Devices (défini par WolfVision)
0x17 = décimal 23 en hexadécimal = longueur du URL

Veuillez noter
Les systèmes Cynap suivants prennent en charge l'option DHCP 43, l'option DHCP 60 et les entrées manuelles URL du serveur vSolution Link Pro dans leurs paramètres :

Cynape
Cynap PRO
Noyau Cynap
Cynap Core PRO
Cynap pur
Cynap Pure Pro
Récepteur pur Cynap
Cynap Pure SDM
Cynap Pur Mini

Les systèmes Visualizer suivants prennent en charge l'option DHCP 43 et sont entrés manuellement URL du serveur vSolution Link Pro dans leurs paramètres :

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

Avec les paramètres par défaut, l'écoute de l'option DHCP est activée.

Sur site ou hub de gestion

Le vSolution Link Pro est un web application serveur et doit être installé, de préférence sur un serveur pour garantir une disponibilité 24h/7 et XNUMXj/XNUMX.

Hébergé sur site (installation locale)
Lorsque l'application est hébergée sur site, ce serveur, tous les systèmes Cynap et Visualizer ainsi que les appareils tiers (ordinateurs de bureau, postes de travail, tablettes) doivent être sur le même réseau Ethernet.

Hébergé avec Management Hub (installation cloud)
Lorsque l'application est hébergée avec la fonctionnalité Management Hub activée, les appareils pris en charge par le Cloud peuvent être gérés en plus.

Systèmes WolfVision Cynap pris en charge dans Management Hub :

Cynape
CynapPro
Noyau Cynap
Cynap Core Pro
Cynap pur
Cynap Pure Pro
Récepteur pur Cynap
Cynap Pure SDM

Pour une compatibilité totale, maintenez à jour la version du micrologiciel installé sur tous vos appareils.

Installation du serveur (Windows IIS)

Le vSolution Link Pro est un web application serveur et doit être installé, de préférence sur un serveur pour garantir une disponibilité 24h/7 et XNUMXj/XNUMX.
Les différentes versions d'IIS peuvent varier légèrement. Les étapes suivantes décrivent l'installation sur un centre de données Windows Server 2019 (version du système d'exploitation 17763.1131) avec .NET Core Hosting Bundle version 7.0.3. L'installation sur d'autres versions peut varier.
vSolution Link Pro est livré avec un standard web.config, qui peut être adopté, en fonction de vos besoins.
Notez les paramètres supplémentaires pour l’utilisation de la fonctionnalité Management Hub (accès au cloud).

Télécharger l'installation files
Téléchargez l'archive zip vSolutionLinkPro_WindowsServer.zip depuis WolfVision web page et décompressez-la.

Ajouter la fonctionnalité IIS
Ouvrez le tableau de bord du gestionnaire de serveur et ajoutez des rôles et des fonctionnalités :

Important
WebLe rôle DAV doit rester désactivé pour le serveur vSolution Link Pro pour bénéficier de toutes les fonctionnalités.

Sélectionner WebProtocole de socket (développement d'applications, sous-élément d'IIS Web Serveur)

Préparer file structure
Copiez le dossier décompressé vSolutionLinkPro_WindowsServer dans c:\inetpub\wwwroot

Modifiez les propriétés pour gérer les autorisations de IIS afin de permettre un contrôle total

Démarrer le gestionnaire des services Internet (IIS)

Configurer IIS
Gérer les sites IIS et ajouter le chemin physique

Restreignez l'accès à https et vérifiez le port utilisé.
Ce paramètre est requis avant d’activer la fonctionnalité Management Hub.

Définissez votre certificat SSL valide pour une connexion https appropriée.
Ce paramètre est requis avant d’activer la fonctionnalité Management Hub.
Remplacez la version .NET CLR dans les paramètres de base par « Aucun code géré »
Remplacez le mode de pipeline géré par « Intégré ».

Modifiez le mode de démarrage dans les paramètres avancés sur « AlwaysRunning » pour permettre un fonctionnement 24h/7 et XNUMXj/XNUMX.

Modifiez le délai d'inactivité (minutes) dans les paramètres avancés sur « 0 »

Veuillez noter
Lorsque IIS exécute OnDemand, il s'arrête lorsque :

Aucune fenêtre vSolution Link Pro n'est ouverte dans une fenêtre de navigateur sur aucun client
Aucune connexion Management Hub n’est ouverte
Aucun appareil n'utilise l'appel à la maison.

Installation de l'hébergement de serveur Windows .NET Core

Installez le pack d'hébergement .NET Core.
L'application a été testée avec .NET version 7.0.3 : https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.3-windows-hosting-bundle-installer

Pour plus de détails sur IIS, veuillez visiter : https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/?view=aspnetcore-7.

Arrêtez et redémarrez le service dans Tâches du pool d'applications dans le Gestionnaire IIS.

Adopter appsettings.json
Le file appsettings.json permet de modifier tous les paramètres hors ligne en utilisant un éditeur de texte commun. Les paramètres les plus importants sont accessibles sur l'interface utilisateur graphique (Configuration – Paramètres).

Utilisation du centre de gestion (Cloud)
« UseHttps » dans la section « Hébergement » doit être défini sur « true ».

Activer Management Hub (facultatif, selon la configuration)
La prise en charge de Management Hub for Cloud doit être activée dans le paramètre au démarrage initial :

Alternativement, activez le Management Hub dans le file appsettings.json et adoptez manuellement tous les paramètres en fonction de vos besoins :

Démarrer l'application

Pour démarrer vSolution Link Pro, ouvrez le navigateur du poste de travail et saisissez l'adresse IP du serveur.
Example URL http://192.168.0.1:80

Pour des raisons de sécurité, le mot de passe par défaut doit être modifié lors de la première connexion.
Attention, après 30 minutes d'inactivité, vous serez automatiquement déconnecté.

Configuration requise pour l'appareil
Pour accéder aux appareils, ils doivent être en ligne et joignables !
Les appareils connectés au cloud (Management Hub) assurent une sécurité webconnexion socket (WSS) ouverte pour permettre la gestion.
Par exemple, les appareils Cynap désactiveront leurs ports LAN lors de la mise hors tension par défaut et pourront être alimentés en utilisant la fonctionnalité Wake on LAN. Pour les infrastructures réseau avec Wake on LAN bloqué, utilisez le mode de mise hors tension Power Save pour garder le port LAN de votre système Cynap actif.
En fonction de l'infrastructure réseau et en raison de plusieurs ports réseau, le routage IP doit être spécifié pour acheminer le trafic réseau.
Lorsque vous utilisez des appareils WolfVision Visualizer, utilisez les modes de mise hors tension Normal ou ECO pour garder le port LAN actif.

Première connexion – Changer le mot de passe (« admin » au démarrage initial)
Lors de votre première connexion, le mot de passe doit être défini :

Lorsque la page IIS vierge du serveur Windows doit être ouverte, vérifiez les ports utilisés et redémarrez le serveur.

Mise à jour de vSolution Link Pro

Arrêtez vSolution Link Pro dans IIS Manager.
Sauvegardez le dossier « Data » à partir de votre dossier d'installation actuel.
Décompressez l'archive zip de la nouvelle version et copiez l'intégralité du contenu dans le dossier d'installation. Copiez le contenu de votre contenu « Data » précédemment enregistré dans le dossier « Data » actuel.

Important
Lorsque le dossier d'installation « vSolutionLinkPro » a été échangé, l'autorisation doit être renouvelée (voir chapitre 5.5 Préparer file structure).

Terminez la mise à jour
Démarrez vSolution Link Pro sur le gestionnaire IIS.

Mise à jour à partir de la version v1.8.0 (ou antérieure)
Lorsque vSolution Link Pro version 1.8.0 ou antérieure a été installée précédemment, le pool d'applications doit être modifié.
Définissez Activer les applications 32 bits sur « Faux »

Modifiez le mode de démarrage dans les paramètres avancés sur « AlwaysRunning » pour permettre un fonctionnement 24h/7 et XNUMXj/XNUMX.

Modifiez le délai d'inactivité (minutes) dans les paramètres avancés sur « 0 »

Veuillez noter
Lorsque IIS exécute OnDemand, il s'arrête lorsque :

Aucune fenêtre vSolution Link Pro n'est ouverte dans une fenêtre de navigateur sur aucun client
Aucune connexion Management Hub n’est ouverte
Aucun appareil n'utilise l'appel à la maison.

Vérifiez les paramètres files web.config et appsettings.json
Vérifier web.config (sera trouvé dans le dossier racine d'IIS), le modèle d'hébergement doit
Définissez Activer les applications 32 bits sur « Faux »

Vérifier web.config (sera trouvé dans le dossier racine d'IIS), le modèle d'hébergement doit être défini sur « inprocess ».

Le paramètre « InProcessHostingModel » dans le file appsettings.json est obsolète depuis vSolution Link Pro v1.9 et versions ultérieures.
Ce paramètre est ignoré et n'a plus d'effet.

Passer de l'installation de bureau à l'installation IIS

Pour déplacer toutes les données d'une ancienne installation de bureau vers une installation de serveur, assurez-vous que vSolution Link Pro est correctement installé sur le serveur IIS.

Important
Une nouvelle installation de vSolution Link Pro sur le serveur avec un numéro de version identique à celui de l'ancienne installation de bureau est fortement recommandée.
En poursuivant les étapes suivantes, toutes les données de l'installation de vSolution Link Pro sur le serveur sont perdues.

Arrêtez le serveur vSolution Link Pro sur le gestionnaire IIS.
tout supprimer files et sous-dossiers du dossier « Data » sur votre installation IIS.
Chemin par défaut:
C:\inetpub\wwwroot\vSolutionLinkPro\
Copiez tout le contenu du dossier « Data » à partir de votre installation de bureau.
Chemin par défaut:
Installation du bureau Windows (dossier caché) C:\ProgramData\WolfVision\vSolution Link Pro\
Installation du bureau MacOS /Bibliothèque/Application Support/WolfVision/vSolution Link Pro/
Collez le files dans le dossier « Data » de votre installation IIS.
Chemin par défaut:
C:\inetpub\wwwroot\vSolutionLinkPro\

Important
Vérifiez tous les chemins répertoriés dans appsettings.json file et corrigez-le en conséquence.
Chemin par défaut sur IIS : C:\\inetpub\\wwwroot\\vSolutionLinkPro\\Data\\
Démarrez vSolution Link Pro sur le gestionnaire IIS.
Tous les paramètres et données de l'ancienne installation de Desktop sont transférés au serveur, y compris les informations de connexion.

Indice

Version	Date	Changements
1.9.1	2024-05-02	Option DHCP ajoutée
1.9.1	2023-10-27	Mise à jour vers vSolution Link Pro version 1.9.1 Ajout de la section « Passer de l'installation du bureau à l'installation IIS ».
1.9.0	2023-07-25	Mise à jour vers vSolution Link Pro version 1.9.0 Ajout de règles de mise à jour de l'application.
La numérotation des versions a été adaptée au versioning de l'application.
1.5	2023-05-17	Ajout de l'activation du Management Hub (Cloud)
1.4	2023-04-25	Mise à jour vers vSolution Link Pro version 1.8.0
1.3	2022-06-21	Mise à jour de .NET Core vers la version 5.0.17
1.2	2022-05-23	Ajouté WebRemarque DAV
1.1	2021-07-07	Règles de pare-feu mises à jour
1.0	2021-03-09	Créé

WolfVision GmbH Oberes Ried 14
A-6833 Klaus / AUTRICHE

Tél. + 43-5523-52250
Télécopieur +43-5523-52249
E-mail: wolfvision@wolfvision.com
www.wolfvision.com

Documents / Ressources

Logiciel WOLFVISION vSolution Link Pro [pdf] Guide de l'utilisateur
Logiciel vSolution Link Pro, Logiciel Link Pro, Logiciel

Références

Manuel d'utilisation

WOLFVISION-vSolution-Link-Pro-Logiciel