VOS050 - Licence de logiciel & extension IFM - Notice d'utilisation et mode d'emploi gratuit

Type de produit	Licence de logiciel & extension - VSE OPC UA Server
Marque	IFM
Modèle	VOS050
Fonction principale	Serveur OPC UA pour mettre à disposition les données des électroniques de diagnostic ifm VSE
Systèmes d'exploitation supportés	Windows (avec droits administrateur) et Linux (Debian avec Docker)
Configuration minimale Windows	Voir fiche technique sur www.ifm.com (droits administrateur requis)
Configuration minimale Linux	Distribution basée sur Debian, Docker Engine et Docker Compose installés, droits sudo
Ports utilisés	5433 (PostgreSQL), 44350 (Configurator), 32210 (Server), 5093 (Sentinel RMS), 3321 (appareils VSE)
Base de données	PostgreSQL intégrée (port par défaut 5433, modifiable sous Windows)
Interface de configuration	Configurateur Web accessible via navigateur (https://localhost:44350 par défaut)
Activation de licence	En ligne via internet ou hors ligne via empreinte digitale (fingerprint)
Gestion des appareils	Ajout par scan réseau, adresse IP spécifique ou plage IP
Exigences de mot de passe	8 caractères minimum : majuscule, minuscule, chiffre, caractère spécial
Sécurité	Connexion HTTPS, certificat à valider dans le navigateur, blocage après 3 tentatives échouées
Désinstallation	Sous Windows via Panneau de configuration ; sous Linux via script uninstall-vse-opc-ua-server.sh
Conservation des licences	Les licences ne sont pas supprimées lors de la désinstallation, réutilisables après réinstallation
Sauvegarde	Export des logs et de la base de données via commande Docker (VSE_OPC_UA_Server_Backup.tar)
Navigateurs recommandés	Google Chrome, Mozilla Firefox, Microsoft Edge
Documentation	Notice d'installation disponible en téléchargement gratuit

FOIRE AUX QUESTIONS - VOS050 IFM

Comment installer le VSE OPC UA Server sur Windows ?

Ouvrez le fichier d'installation en tant qu'administrateur, acceptez les conditions de licence, puis suivez l'assistant pour installer la base de données PostgreSQL et le Configurateur. Par défaut, les ports 5433 (base de données) et 44350 (Configurateur) sont utilisés.

Quels sont les ports utilisés par le logiciel ?

Les ports sont : 5433 (PostgreSQL), 44350 (Configurator), 32210 (Server), 5093 (Sentinel RMS License Manager) et 3321 (appareils VSE). Sous Windows, les ports PostgreSQL et Configurator sont modifiables lors de la première installation.

Comment activer la licence en ligne ?

Dans le Configurateur, allez dans Licences, cliquez sur Ajouter une licence, sélectionnez Activation en ligne, saisissez le code d'activation (LAC) reçu par email, puis cliquez sur Continuer.

Comment activer la licence hors ligne ?

Dans le Configurateur, allez dans Licences, cliquez sur Ajouter une licence, sélectionnez Activation hors ligne. Notez l'empreinte digitale affichée ou sauvegardez-la. Sur un ordinateur avec accès internet, ouvrez https://licensing.ifm.com, activez la licence et saisissez la clé générée dans le logiciel.

Comment ajouter un appareil VSE au serveur ?

Dans le Configurateur, allez dans Sources de données, cliquez sur + Appareil. Vous pouvez ajouter par scan réseau (diffusion), par adresse IP spécifique ou par plage IP. Après ajout, activez les appareils souhaités et cliquez sur Upload and Restart.

Quelles sont les exigences pour le mot de passe de l'utilisateur ?

Le mot de passe doit comporter au moins 8 caractères, inclure une majuscule, une minuscule, un chiffre et un caractère spécial.

Comment désinstaller le logiciel ?

Sous Windows : Panneau de configuration > Programmes et fonctionnalités, sélectionnez VSE OPC UA Server et cliquez sur Désinstaller. Sous Linux : exécutez la commande 'uninstall-vse-opc-ua-server.sh' en tant que sudo.

Comment sauvegarder les logs et la base de données ?

Sous Linux, exécutez la commande Docker : 'sudo docker run --rm -v vse_opc.ua_server_postgres:/Backup/Database -v vse_opc.ua_server_server_logs:/Backup/Server -v vse_opc.ua_server_configurator_logs:/Backup/Configurator -v ~:/backup ubuntu tar cvf /backup/VSE_OPC.uaServer_Backup.tar /Backup'. Le fichier de sauvegarde est créé dans votre répertoire personnel.

Quels navigateurs sont recommandés pour accéder au Configurateur ?

Les navigateurs recommandés sont Google Chrome, Mozilla Firefox et Microsoft Edge. Lors de la première connexion, vous devrez valider le certificat de sécurité du site.

Que faire si le certificat du Configurateur est considéré comme non sécurisé ?

Lors de la première ouverture, le navigateur peut signaler un risque. Vous devez valider manuellement le certificat dans les paramètres de sécurité du navigateur pour autoriser l'accès à l'URL du Configurateur.

MODE D'EMPLOI VOS050 IFM

Notice d'installation

VSE OPC UA Server

VOS050

1 Remarques préliminaires 3

1.1 Notes légales 3 1.2 Symboles utilisés 3 1.3 Avis juridique OPC Foundation SDK 3

2 Consignes de sécurité. 4 3 Usage prévu 5 4 Installation sous Windows 6

4.1 Exigences du système 6 4.2 Ports utilisés 6 4.3 Installation 6

4.3.1 Exigences relatives au mot de passe 7

5. Installation sous Linux. 8

5.1 Exigences du système 8 5.2 Ports utilisés 8 5.3 Installation 8

5.3.1 Exigences relatives au mot de passe 9

6. Première connexion au Configurator. 10

6.1 Partager le certificat dans le navigateur 10 6.2 Se connecter. 10 6.3 Activation des licences 10

6.3.1 Activation de licence en ligne 10 6.3.2 Activation de licence hors ligne 10

6.4 Connecter des appareils 11

6.4.1 Ajouter une source de données / un appareil 11

7 Désinstallation sous Windows. 13 8 Désinstallation sous Linux. 14

1 Remarques préliminaires

Ce document sert à la mise en service et à l'utilisation du logiciel VSE OPC UA Server.

1.1 Notes légales

© Tous droits réservés par ifm electronic gmbh. Cette notice ne peut être reproduite ou exploitée, même par extraits, sans l'accord d'ifm electronic gmbh.

Tous les noms de produits, les images, sociétés ou autres marques sont la propriété de leurs titulaires.

• Microsoft® est la propriété de Microsoft Corporation, États-Unis
• Windows® est la propriété de Microsoft Corporation, Etats-Unis Linux® est une marque déposée de Linus Torvalds aux États-Unis et dans d'autres pays.
• Debian est une marque déposée de Software in the Public Interest, Inc., USA

1.2 Symboles utilisés

✓ Condition Action à faire

Résultat intermédiaire, réaction intermédiaire

Résultat final, réaction [...] Désignation d'une touche, d'un bouton ou d'un affichage Voir lien, référence

Remarque importante

Le non-respect peut aboutir à des dysfonctionnements ou perturbations

Information

Remarque supplémentaire

1.3 Avis juridique OPC foundation SDK

Ce produit comprend un logiciel régi par l'OPC Redistributables Agreement of Use de l'OPC Foundation, dans la version en vigueur au moment de la commande.

2 Consignes de sécurité

Lire la notice d'installation avant d'installer le logiciel.

S'assurer que le logiciel est approprié pour l'application concernée sans aucune restriction d'utilisation.

Le non-respect des consignes ou des données techniques peut provoquer des dommages corporels et/ou matériels.

Le non-respect des consignes, l'emploi non conforme par rapport aux prescriptions, un montage ou une manipulation incorrects peuvent porter atteinte à la sécurité des personnes et des installations.

L'utilisation doit être conforme aux normes nationales et internationales en vigueur. La personne qui installe le logiciel en est responsable.

3 Usage prévu

VSE OPC UA Server met à disposition les valeurs de données des électroniques de diagnostic ifm VSE intégrées via l'interface OPC UA pour un traitement ultérieur sur un client OPC UA (non inclus dans la livraison).

Le logiciel VSE OPC UA Server Configurator sert à l'utilisateur pour la maintenance et la configuration de VSE OPC UA Server.

4.1 Exigences du système

Voir fiche technique et spécification technique sur www.ifm.com.

4.2 Ports utilisés

Les ports suivants sont utilisés par VSE OPC UA Server sous Windows et ne doivent pas être utilisés par d'autres applications :

Port Application Modifiable
5433 (TCP) PostgreSQL Oui, lors de la première installation
44350 (TCP) Configurator Oui, lors de la première installation
32210 (TCP) Server Port Oui, dans le Configurator
5093 (TCP/UDP) Sentinel RMS License Manager Non
3321 (TCP) Appareils VSE Standard VSE	Device Port	(en fonction de la configuration VSE)

Le logiciel ne peut pas être installé correctement ni fonctionner correctement si au moins un de ces ports est utilisé ou bloqué par d'autres applications.

4.3 Installation

Avant de commencer l'installation, veuillez vous assurer que vous disposez des droits d'administrateur. Effectuer l'installation en tant qu'administrateur. Recommandation : si possible, conservez les paramètres d'installation par défaut. S'assurer que les ports choisis sont libres. Pour un accès externe au réseau, s'assurer que les ports sont configurés en conséquence dans un éventuel pare-feu.

Installer le logiciel de la manière suivante :

Étape 1 : Démarrer l'installation et accepter les conditions de licence

Ouvrir le fichier d'installation VSE OPC UA Server_v. x. x. x. exe en tant qu'administrateur (bouton droit de la souris [Run as administrator]). Accepter les termes de la licence et cliquer sur [Install].

VSE OPC UA Server est installé (entre autres dans le chemin C:\Program Files\ifm electronic\VSE OPC UA Server). Ensuite : Le [VSE OPC UA Server Database Setup Wizard] apparait.

Étape 2: installer la base de données

▶ Cliquer sur [Suivant].

La vue [PostgreSQL database configuration] s'affiche. L'adresse s'affiche.

Saisir dans le champ [Port] le port TCP de la base de données. Default: 5433 Saisir le nom de la base de données dans le champ [Database name]. Default: OPCConfiguration Cliquer sur [Install].

Installation de la base de données en cours. ▶ Cliquer sur [Finish]. La base de données est installée. L'assistant: Assistant [VSE OPC UA Server Configurator] apparait.

Étape 3: installer VSE OPC UA server configurator

Cliquez sur [Next]. La vue [Adjust Configurator Settings] s'affiche :

Saisir dans le champ [Port] le port TCP du Configurator. Default: 44350 Dans le champ [User], entrer le nom d'utilisateur. Default: admin Saisir le mot de passe de l'utilisateur dans le champ [Password]. A noter : Exigences relatives au mot de passe ( 7)

L'utilisateur et le mot de passe sont nécessaires pour se connecter à l'interface web du Configurator.

Cliquer sur [Install].

Installation [VSE OPC UA Server Configurator] en cours. La vue [Setup successful] s'affiche.

▶ Cliquer sur [Finish]. Installer VSE OPC UA Server Configurator. - Une fois l'installation terminée, cliquer sur [Launch] pour lancer le [VSE OPC UA Server Configurator].

Une fois l'installation terminée, cliquer sur [Close] pour fermer le programme d'installation.

4.3.1 Exigences relatives au mot de passe

• Longueur minimale : 8 caractères
• Doit inclure :

-Au moins une lettre majuscule -Au moins une lettre minuscule -Au moins un chiffre -Au moins un caractère spécial

5.1 Exigences du système

Voir fiche technique et spécification technique sur www.ifm.com.

5.2 Ports utilisés

Les ports suivants sont utilisés par VSE OPC UA Server sous Linux et ne doivent pas être utilisés par d'autres applications :

Port Application Modifiable
5433 (TCP) PostgreSQL Non
44350 (TCP) Configurator Non
32210 (TCP) Server Port Oui, dans Configurator
5093 (TCP/UDP) Sentinel RMS License Manager Non
3321 (TCP) Appareils VSE Standard VSE	Device Port	(en fonction de la configuration VSE)

Le logiciel ne peut pas être installé correctement ni fonctionner correctement si au moins un de ces ports est utilisé ou bloqué par d'autres applications.

5.3 Installation

Avant de commencer l'installation, veuillez vous assurer que vous disposez de droits sudo. Recommendation: si possible, conservez les paramètres d'installation par défaut. S'assurer que les ports choisis sont libres. Pour un accès externe au réseau, s'assurer que les ports sont configurés en conséquence dans un éventuel pare-feu. Docker Engine et Docker Compose sont installés.

Installer le logiciel de la manière suivante :

Effectuer l'installation

Copier le fichier binaire VSE_OPC_UA_Servers_Installer_1.1.0.tar sur un système avec distribution Linux basée sur Debian. Passer au répertoire de l'installation. Modifier la permission du fichier binaire pour qu'il soit exécutable : chmod u+x VSE_OPC_UA_Servers_Installer_1.1.0.tar Lancer l'installation : ./VSE_OPC_UA_Server_Installer_1.1.0.tar Une fois l'installation réussie, un message s'affiche avec l'URL pour l'accès et les informations de connexion par défaut. Si Docker-Engine et Docker-Compose ne sont pas installés, un message est affiché avec les liens vers les étapes d'installation.

Les informations de connexion par défaut ne conviennent pas pour l'exploitation durable.

Après la première connexion, modifier le mot de passe.

L'utilisateur et le mot de passe sont nécessaires pour se connecter à l'interface web du Configurator.

Exporter les fichiers log et la base de données

Pour enregistrer une sauvegarde des fichiers log et de la base de données dans le fichier VSE_OPC_UA_Server_Backup.tar, executer la commande suivante: sudo docker run --rm -v vse_opc.ua_server_postgres:/Backup/Database -v vse_opc.ua_server_server_logs:/Backup/Server -v vse_opc.ua_server_configurator_logs:/Backup/Configurator -v ~:/backup ubuntu tar cvf /backup/VSE_OPC.uaServer_Backup.tar /Backup La sauvegarde est créée sous: /VSE_OPC_UA_Server_Backup.tar

Ouvrir les volumes docker

Ouvrir manuellement les volumes Docker avec :

• Installation Docker avec apt package manager: /var/lib/docker/volumes
• Installation Docker avec snap package manager: /var/snap/docker/common/var-lib-docker/volumes/

5.3.1 Exigences relatives au mot de passe

• Longueur minimum : 8 caractères
• Doit inclure :

-Au moins une lettre majuscule -Au moins une lettre minuscule -Au moins un chiffre -Au moins un caractère spécial

6 Première connexion au configurator

Pour les installations Linux :

Les informations de connexion par défaut ne conviennent pas pour l'exploitation durable.

Après la première connexion, modifier le mot de passe.

6.1 Partager le certificat dans le navigateur

Lors de la première ouverture du VSE OPC UA Server Configurator dans le navigateur, l'URL peut être identifiée comme un risque de sécurité.

Pour permettre l'accès :

• Valider le certificat dans le navigateur concerné.

6.2 Se connecter

✓ Utiliser le navigateur recommandé : Google Chrome, Mozilla Firefox ou Microsoft Edge. Accéder à l'URL du configurateur de serveur VSE OPC UA dans le navigateur : https://:/Configurator-Port> Défaut : https://localhost:44350/

L'écran de connexion s'affiche.

Se connecter avec les données de connexion attribuées lors de l'installation.

Si le mot de passe d'un utilisateur existant est saisi 3 fois de manière erronée, la connexion de cet utilisateur sera bloquée pendant 10 minutes.

L'interface du Configurator apparait.

6.3 Activation des licences

L'activation des codes d'activation de licence (LAC) est décrite dans le manuel du logiciel.

6.3.1 Activation de licence en ligne

Sur [Licences], cliquer sur [Ajouter une licence]. Sélectionner [Online activation]. ▶ Cliquer sur [CONTINUER]. Saisir le code d'activation de licence (LAC) reçu par courriel. ▶ Cliquer sur [CONTINUER]. Toutes les licences activées sont affichées.

6.3.2 Activation de licence hors ligne

Si l'activation en ligne n'est pas possible parce qu'il n'y a pas de connexion internet, les licences peuvent également être activées hors ligne.

Sur [Licences] cliquer sur [Ajouter une licence]. Sélectionner [Offline activation]. Cliquer sur [CONTINUER].

Noter l'empreinte digitale affichée. OU cliquer sur [Sauvegarder en tant que fichier.txt], sélectionner le répertoire souhaité et enregistrer fingerprint.txt. Sur un ordinateur avec une connexion en ligne, ouvrir la page https://licensing.ifm.com, cliquer sur [Activate licence], suivre les instructions de cette page et copier la clé de licence qui y est générée. Poursuivre l'octroi de la licence dans le programme : Cliquer sur [CONTINUER]. Saisir la clé de licence reçue. Cliquer sur [CONTINUER]. Cliquer sur [FIN]. Toutes les licences activées sont affichées.

6.4.1 Ajouter une source de données / un appareil

Sur [Sources de données] cliquer sur + [Appareil]. La boîte de dialogue [Ajouter un appareil VSE] apparait. Sélectionner l'option [Scan du réseau] pour rechercher tous les appareils disponibles sur le réseau. ▶ Cliquer sur [Rechercher]. Le programme recherche les appareils disponibles. Le tableau indique tous les appareils détectés.

L'option [Scan du réseau] recherche tous les appareils disponibles par diffusion. Il est possible que tous les appareils disponibles dans un environnement réseau ne soient pas détectés, par exemple en raison de la segmentation du réseau, de l'utilisation de pare-feu ou de routeurs.

Si tous les appareils ne sont pas trouvés : Ajouter les appareils à l'aide des options [Spécifique] ou [Plage], voir ci-dessous.

Sélectionner l'option [Spécifique] et saisir l'adresse IP et le port d'un appareil. Cliquer sur [Ajouter à la liste].

Le programme ajoute l'appareil au tableau.

Ce n'est qu'après l'ajout de l'appareil à la vue [Sources de données] et le redémarrage du serveur que le logiciel vérifie si l'appareil existe sur le réseau.

Sélectionner l'option [Plage] et saisir l'adresse de début et de fin d'une plage IP ainsi que le port. Cliquer sur [Ajouter à la liste].

Le logiciel ajoute tous les appareils de la plage IP au tableau.

Ce n'est qu'après l'ajout de l'appareil à la vue [Sources de données] et le redémarrage du serveur que le programme vérifie si l'appareil existe sur le réseau.

Le tableau ci-dessous répertorie les appareils. Activer les appareils du tableau qui doivent être inclus dans la vue [Sources de données].

Désactiver les appareils du tableau qui ne doivent pas être inclus dans la vue [Sources de données]. En cliquant sur [Ajouter un appareil], ajouter les appareils sélectionnés à la vue [Sources de données].

La vue [Sources de données] montre tous les appareils ajoutés. La vue [Sources de données] montre les fonctions disponibles (colonne [Actions]).

En cliquant sur [Upload changes], télécharger les modifications sur le serveur. Pour que les modifications prennent effet, redémarrer le serveur dans la section [Etat du serveur].

En cliquant sur [Upload and Restart], charger les modifications sur le serveur et redémarrer le serveur.

Annuler les modifications en cliquant sur [Reset changes]. Option : Filtrer la liste des sources de données

7 Désinstallation sous windows

Le logiciel peut être désinstallé via le panneau de configuration de Windows.

Les licences ne sont pas supprimées par la désinstallation et peuvent être réutilisées après une nouvelle installation du logiciel.

Déinstaller le logiciel comme suit :

L'utilisateur possède des droits d'administrateur dans Windows. Ouvrir le panneau de configuration de Windows. Cliquer sur [Programs and Features]. ▶ Cliquer sur [VSE OPC UA Server x. x]. ▶ Cliquer sur [Uninstall] et confirmer l'invite de sécurité. Dans la fenêtre d'installation, cliquer sur [Uninstall].

Le programme est désinstallé.

Une fois la déinstallation terminée, cliquer sur [Close]. Le programme a été désinstallé. Si vous souhaitez ensuite réinstaller le programme ou une nouvelle version du programme, redémarrez le système au préalable.

8 Désinstallation sous linux

Les licences ne sont pas supprimées par la désinstallation et peuvent être réutilisées après une nouvelle installation du logiciel.

Déinstaller le logiciel sous Linux comme suit :

Exécuter la commande suivante : uninstall-vse-opc-ua-server.sh

Les conteneurs Docker (Server, Configurator et Database) sont stoppés. Les conteneurs Docker sont supprimés. Les images Docker ne sont pas supprimées. Les volumes Docker ne sont pas supprimés. Le service GemaltoRMS est désinscrit et les fichiers binaires sont supprimés. (/opt/ifm/GemaltoRMS) Le service LicenseGateway est désinscrit et les fichiers binaires sont supprimés. (/opt/ifm/LicenseGateway) Le script de désinstallation est supprimé. (/usr/local/bin/uninstall-vse-opua-server.sh)