Le contenu d'un dongle peut-être affiché en clair en utilisant l'outil NLDongleUtility.
Cet outil est disponible au téléchargement à l'adresse suivante:

Les dernières versions en cours et les anciennes versions des outils de configuration de la doGATE ou des solutions logicielles sont disponibles au lien suivant :

doGateServerForPc (anciennement doMoovServerForPc)

L'installation doGateServerForPc va configurer votre ordinateur en doGATE.
L'installation comprend les outils Station Configuration tool, doBUILD, doDESIGN, doMoov OPC Server For doGATE.
La licence utilisée est disponible sur dongle uniquement.
Une seule instance de doGateServerForPc peut être installé sur une machine.
Toute ré-installation remplace l'ancienne version.

doMoovStationsDashboard

L'installation doMoovStationsDashboard installe les outils qui permettent de configurer à distance une doGATE.
L'installation comprend les outils Station Configuration tool, doBUILD, doDESIGN.
Plusieurs versions de doMoovStationsDashboard peuvent être installées sur une machine.
Chaque version est installée dans son propre répertoire (C:\Program Files (x86)\Newron System\doMoov Stations Dashboard x.y.z.xxx)
A chaque version de firmware installée sur une doGATE correspond une installation de doMoovStationsDashboard.
Pour pouvoir accéder à une doGATE de version x.y.z.xxx il vous faut doMoovStationsDashboard x.y.z.xxx installé sur l'ordinateur

Pour la majorité des projets, vous pouvez utiliser l'une ou l'autre des installations de l'outil.
En revanche, si l'utilisation de doMOOV OPC Server For doGATE est nécessaire sur la machine du site, vous devez utiliser la version complète doGateServerForPc.

Pour importer les fichiers catalogue dans une doGATE il faut:

• Copier les fichiers catalogue utilisateur dans le répertoire « C:\doMoov\Catalogs\Lon\User»
• Générer le fichier LDRF.cat dans le répertoire « C:\doMoov\Catalogs\Lon\»
• Envoyer du patch fichier catalogue du répertoire « C:\doMoov\Catalogs\Lon\»

Construction du fichier catalogue (LDRF.cat) pour une base TE :

• Placez l’ensemble des fichiers catalogue à utiliser dans le répertoire « C:\doMoov\Catalogs\Lon\User »
• Lancez l’outil LNS Resource Files Catalog Utility et sélectionnez le répertoire « C:\doMoov\Catalogs\Lon »
• Ajoutez les différents répertoires de vos fichiers catalogue afin qu’ils soient déclarés dans le fichier LDRF.CAT, puis cliquez sur « Refresh now » pour mettre à jour le fichier en question.
  
• Le fichier LDRF.CAT du répertoire C:\doMoov\Catalogs\Lon doit alors être à jour.

Construction du fichier catalogue (LDRF.cat) pour une base OpenLNS (Izot) :

• Placez l’ensemble des fichiers catalogue à utiliser dans le répertoire « C:\doMoov\Catalogs\Lon\User »
• Lancez OpenLNS Object Browser
• Changer le répertoire LdrfCatalogPath pour pointer sur le répertoire doMoov :
• Rebuildez le catalogue par clic-droit sur Objectserver :
  
• Le fichier LDRF de C:\doMoov\Catalogs\Lon\ est alors mis à jour

Création et import du patch fichier catalogue :

• Lancez l’outil « doMoov Patch Builder for Lonworks catalog patches »

Cet outil (LonWorksCatalogPatchBuilder.exe) est installé en même temps que doMoov à partir de la version 2.0.6.0 dans le répertoire bin de l'application. 

• Faites glisser l’intégralité des fichiers présents dans le répertoire « C:\doMoov\Catalogs\Lon » dans l’outil 
• Sélectionnez l’endroit où vous souhaitez enregistrer le patch et générez-le
• Il ne reste plus qu’à envoyer ce patch dans la doGATE ; depuis le dashboard, allez dans configuration station dans l’onglet Updater, et cliquez sur « Envoyer patch » pour sélectionner et envoyer le patch créé.

Archive créée à partir de Configuration station/General/Sauver Restaurer projet

L'archive les informations du projet d'une doGATE :

• La configuration bus de terrain : la définition des réseaux, leur configuration (Adresse ConfigServer,Vitesse du port...) et leur organisation.
• La configuration d'automation : les configurations d'alarme , les configurations d'historisation, les configurations BACnet/Notification server, les programmations horaires.
• Les données historisées : les historiques d'alarme et les historiques de valeur.
• La configuration LEO : la configuration des compteurs.
• Les données historisées LEO : l'historique des données des compteurs.
• Les données doCONTROL : les données déployées depuis doBuild , les évènements utilisateur historisés.
• Les données ZoneServer : les données de configuration et les données du site.

Archive créée à partir de Configuration station/Updater/Backup données...

Une doGATE peut avoir plusieurs projets, un seul de ces projets est actifs à un instant T. Mais les données de plusieurs projets peuvent être présents dans la doGATE.
L'archive créée à partir de Configuration station/Updater/Backup données... contient donc les informations suivantes :

• L'ensemble des données des projets définis sur une doGATE, avec pour chaque projet:
  • La configuration bus de terrain : la définition des réseaux, leur configuration (Adresse ConfigServer,Vitesse du port...) et leur organisation.
  • La configuration d'automation : les configurations d'alarme , les configurations d'historisation, les configurations BACnet/Notification server, les programmations horaires.
  • Les données historisées : les historiques d'alarme et les historiques de valeur.
  • La configuration LEO : la configuration des compteurs
  • Les données historisées LEO : l'historique des données des compteurs
  • Les données ZoneServer : les données de configuration et les données du site.
• La définition des packages (importés depuis doBUILD)

En effet, en restaurant le projet d'une doGATE simulée sur une doGATE réelle, la totalité du projet de la dogate réelle est remplacée.
Ceci inclut les historiques d'alarmes, de trend,...

Afin de pouvoir importer les organisations réseaux d'une doGATE simulée sur une doGATE réelle, il faut exporter la network organisation au format CSV. Puis la réimporter dans la doGATE réelle manuellement.

De cette manière l'intégralité des historiques d'alarmes et trend n'est pas écrasée.

La documentation de la dogateV2 est disponible en ligne à l'adresse:

 https://abb.jffi.net/index.php/s/aP8iY5azR5sHJcG 

Les documentations disponibles se situent dans 1 - Solutions doGATE, puis 3 - Documentation:

•  doBUILD - Guide Utilisateur : Documentation de l'outil de programmation doBUILD. Décrit la configuration de doGATE/doCONTROL/LIZ/LEO via l'outil doBUILD
• doGATE - Guide Utilisateur : Documentation de la mise en route de la doGATE. Décrit la configuration via le station configuration tool

Les fichiers catalogues utilisateurs ne peuvent être ajoutés individuellement sur la doGATE.
Pour pouvoir mettre à jour les fichiers catalogues d'une doGATE merci de vous référer à la FAQ suivante.

La licence d'une doGate est composée de :

• Limite de points : c'est le nombre de points maximum que la doGate peut lire ou écrire.
  • Un point est lié à son adresse réseau protocolaire. Si le point réseau est une structure  de valeur (SNVT_switch) la lecture de chaque champs de cette structure consommera un seul point du point de vue de la license.
  • Les options de lecture/ecriture sur une même adresse protocolaire  (/wo, /ro,/event...)  ne consomment qu'un  seul point dans la licence.
  • Des fréquences de lectures différentes sur même adresse protocolaire ne consomment qu'un seul point dans la licence. (une fréquence pour les historiques et autre fréquence pour les alarmes)
  • Les points utilisés dans doControl sont consommés lorsqu'ils sont utilisés  dans une animation d'un écran et que cet écran est affiché. Les écrans qui ne sont pas affichés ne consomment pas de point de licence.
  • Un point ajouté en monitoring par l'intermédiaire de l'écran de monitoring du Dashboard consomme des points dans la licence.
  • Un point ajouté en monitoring par l'intermédiaire d'un serveur OPC/Obix consomme des points dans la licence. 
  • Les points du réseau"mémoire" consomment des points de licence.
  • Les points utilisés pour LEO consomment des points de licence
• doCONTROL points : c'est le nombre de points maximum utilisés dans doControl :
  • Toute doGATE qui est configurée en serveur "Root" ou configurée avec un locataire doit avoir un nombre de points doCONTROL. Le calcul du nombre de points est éffectué lors du deploiement et un message d'avertissement est affiché si le nombre de points déployés sur la dogate dépasse la limite de la licence de la doGATE.
  • Si deux clients sont connectés sur deux pages différentes , chaque point de chaque page consomme un point de licence.
  • Si deux clients sont connectés sur la même page les points de la page seront consommés une seul fois.
• LEO Meters : c'est le nombre de compteurs maximum utilisés par le serveur d'énergie LEO.
• LIZ Remote controles : c'est le nombre maximum de télécommande LIZ d'une doGATE.
  • Lors du téléchargement, un avertissement est affiché si le nombre de LIZ déployées est supérieur à la licence. Seules les LIZ supportées par la license seront accessibles.

Exemple de configuration : 

• 100 points Modbus IP mappés sur le serveur BACnet.
• 100 points Mobus Serial configurés en alarme.
• 100 autre points Modbus serial configurés pour le server d'énergie LEO.
• 100 points KNX configurés en historisation.
• 100 points Lonworks configurés pour des animations doControl.
• 100 autres points Lonwork configurés pour des télécommandes LIZ
• Une doGATE configurée pour être doControl root.
• La licence doit être :
  • Limite de points = 100+100+100+100+100+100 100 =600
  • doCONTROL points = 100
  • LEO Meters = 100
  • Liz Remote Controle = 100
  • Activation de chaque protocole
  • Activation du serveur BACnet

Les informations de licence de la doGATE sont fournies en format papier à l'expédition de la doGATE.
Sur les documents 2 clefs sont fournies:
 - Le terme CLEF MACHINE nomme l'identifiant unique de la doGATE
 - Le terme CLEF LICENCE nomme la clef d'activation de la licence de la doGATE

La CLEF LICENCE de la doGATE est une chaine alpha numérique à saisir dans la doGATE via l'outil Station Configuration tool.
Une CLEF LICENCE n'est valide que pour une seule CLEF MACHINE

Pour activer une licence:

• Exécutez l'outil Station Configuration Tool sur votre ordinateur. (L'outil est installé avec le programme d'installation doMOOVStationsDashboard x.y.z.xxx)
• Saisir les données de connexion à la doGATE (par défaut une doGATE sortie d'usine est configurée à l'adresse 192.168.1.154)
• Une fois la connexion établie avec la doGATE.
• Cliquer sur le bouton "Licence".
• La fenêtre de licence apparaît.
• Vérifier que le champs "Identification machine" contient la même valeur que CLEF MACHINE que vous avez reçu
• Finalement saisir CLEF LICENCE dans le champs "Clef logicielle"
• Valider en cliquant sur le bouton "Mise à jour"

Si un message d'erreur apparait, vérifier bien que le champs "Identification machine" contient la même valeur que CLEF MACHINE et que la valeur saisie dans le champs "Clef logicielle" correspond bien à CLEF LICENCE 

doGATE Lite & doGATE 2.0

• - doGATE Lite 1k
• Acquisition de 1000 points de données terrain
• doCONTROL permettant la gestion de 1000 points de données
• - doGATE Lite 2k
• Acquisition de 2000 points de données terrain
• doCONTROL permettant la gestion de 2000 points de données

doGATE Server

Dans le cas où le backup d'une doGATE ne fonctionne pas : 

1. Vérifier la qualité de la communication IP entre le PC et la doGATE. Le temps de réponse d'un "Ping" doit être de  moins de 50ms.
2. Désactiver le parefeu du PC pour l'outil Station Configuration Tool.
3. Se connecter à la doGATE et arrêter explicitement les services LEO/Notification server ainsi que les xClients
4. Se connecter à la doGATE et arrêter explicitement le service doMoov Server

Une fois ces actions effectuées, réaliser à nouveau l'opération de backup.
Une fois le backup effectué, n'oubliez pas de relancer les services précédemment arrêtés.

Si l'opération n'a toujours pas fonctionné:

• Redémarrer la doGATE en vérifiant bien que le cable Ethernet LAN1 est bien connecté.

Lorsque le Station Configuration Tool n'arrive pas à se connecter à la doGATE avec une erreur de type "Aucune connexion n'a pu être établie car l'ordinateur cible l'a expressément refusée :...:12801"
Cela signifie que la doGATE n'est pas accessible sur le réseau IP ou que les services doMoovServer et doMoovUpdater ne sont pas démarrés sur la doGATE.

Vérifier l'accessibilité réseau de la doGATE :

1. Effectuer une commande ping à l'adresse IP supposée de la doGATE.
   • Cette opération peut être effectué via une invite de commande ( ping aaa.bbb.ccc.ddd)
     ou en utilisant le bouton de ping disponible dans le Station Configuration Tool
     
2. Vérifier qu'il n'y ait pas d'autre équipement IP utilisant la même adresse IP.
   • Pour cela, débrancher la doGATE du réseau et recommencer l'opération numéro 1
3. S'assurer que la doGATE a démarré avec le port IP LAN1 connecté avec un câble.
4. Si le PC possède plusieurs cartes interface IP,
   • Définir l'interface réseau utilisée par le Station Configuration Tool.
   • Dans l'écran "Site", il est possible de sélectionner la carte interface utilisée pour se connecter à la doGATE.
     
     
5. Désactiver le parefeu du PC: Un pare-feu mal configuré peut empêcher la réception des valeurs réseaux dans le Station Configuration Tool.
6. Désactiver l'antivirus du PC: Un antivirus mal configuré peut empêcher la réception des valeurs réseaux dans le Station Configuration Tool.

Lorsque le Station Configuration Tool se connecte à la doGATE mais qu'une erreur apparaît et seul l'option "Configuration station" est active. il faut :

• Cliquer sur le bouton "Configuration Station"
• Vérifier que le service doMoov Server est démarré : En vérifiant le status du service dans le l'ongle "Général" . Le status doit être "Démarré".
• Si le statut n'est pas "Démarré", cliquer sur le bouton "Démarrer" pour forcer un redémarrage du service.

Lorsque le mode simulation de doControl ne fonctionne pas :

• Effectuer un déploiement doBUILD pour forcer une mise à jour automatique du service de publications web
• Vérifier les fonctionnalités IIS activées
• Vérifier l'état des services IIS

Effectuer un déploiement doBUILD

• Depuis doBUILD, effectuer un déploiement
• A la fin du déploiement, cliquer sur le bouton "About Testing doControl" pour accéder aux outils de vérification
  • Cliquer sur le bouton Réinstaller IIS maintenant : Pour redéfinir l'applicatif dans IIS
  • Cliquer sur le bouton "Mettre à jour les binaires doCONTROL" : Pour mettre à jour le site de simulation avec la dernière version

Vérifier les services liés à IIS

Si le site de simulation ne fonctionne toujours pas, il faut vérifier que les fonctions IIS (Internet Information Services) sont correctement activées sur le PC.

• Vérifier que les services nécessaires à IIS sont actifs et démarrés
  • Saisir Touche Windows+R -> services.msc
  • Chercher Service de publication World Wide Web (W3SVC) et vérifier qu'il est démarré
  • Chercher Service d'activation des processus Windows (WAS) et vérifier qu'il est démarré

Vérifier les fonctionnalités IIS activées sur le PC

Vérifier que toutes les fonctionnalités nécessaires IIS sont disponibles.
Sur l'ordinateur ouvrir le panneau d'activation/désactivation de fonctionnalités Windows. Vérifier que les éléments suivants sont côchés à minima:

• Services d'activation des processus Windows
  • API de configuration
  • Environnement .NET
  • Modèle de processus
• Internet Information Services
  • Outils d'administration Web
    • Console de gestion IIS
• Services World Wide Web
  • Fonctionnalités ... d'applications
    • .NET Extensibility 4.x
    • ASP.NET 4.x
    • Extensibilité .NET 3.5
    • Extensions ISAPI
    • Filtres ISAPI
  • Fonctionnalités de performances
    • Compression du contenu statique
  • Fonctionnalités HTTP communes
    • Contenu statique
    • Document par défaut
    • Erreurs HTTP
    • Exploration de répertoire
  • Intégrité et diagnostics
    • Journalisation HTTP
  • Sécurité
    • Filtrage des demandes

Le premier test à effectuer lorsque  le doGATE n'arrive pas à communiquer avec un équipement BACnet est de vérifier que l'équipement est bien trouvé par le scan du réseau.

Effectuer un scan du réseau

• Depuis le Dashboard, allez dans la fenêtre Réseaux, puis dans l'onglet du réseau BACnet
• A la ligne Organisation Réseau, cliquer sur la fenêtre en bout de ligne et choisir Scan BACnet
• Lancer le scan et regarder la liste des équipements trouvés

Si votre équipement n'a pas été trouvé par le scan, il y a différentes possibilités  de causes en fonction de la configuration et de la topologie du réseau.
Pour plus d'information, se référer au tutoriel de la BACnet organization expliquant les différentes topologie IP utilisables.

Vérification si les équipements BACnet sont sur le même sous-réseau IP

• Tous les équipements doivent avoir un numéro de réseau BACnet identique
• Chaque équipement BACnet doit avoir un ID BACnet unique sur le réseau

Dans le tableau Adressage , vérifier que le "Local device Id" n'est pas utilisé par un autre équipement du réseau BACnet et que le "Network Number" est le même que celui défini dans l'équipement distant.

Vérification si les équipements BACnet dans sous-réseaux IP différents

Ce schéma implique l'utilisation de la fonction BBMD.

• Chaque sous-réseau doit avoir un équipement assurant la fonction BBMD
• Chaque sous-réseau IP peut avoir un numéro de réseau BACnet différent
• Chaque équipement BBMD connait la liste de tous les autres BBMD

Pour accéder à la configuration BBMD de la doGATE, cliquer sur "Plus d'options", puis dans le tableau BACnet/IP, vous avez accès à la liste BBMD de la doGATE.
Vérifier que tous les équipements BBMD sont déclarés et que la doGATE est déclarée dans la liste  des autres équipements BBMD.

Vérification si un équipement est seul sur un sous-réseau distant

Ce schéma implique l'utilisation de la fonction Foreign Device.

• L'équipement distant doit être déclaré en tant que Foreign Device. Cliquer sur "Plus d'options", puis dans le tableau BACnet/IP, vous pouvez déclarer l'équipement à la ligne Foreign Device.

Lors de la modification d'une adresse IP depuis l'option Configuration station.
Il arrive que l'adresse IP affichée dans le tableau ne corresponde pas à l'adresse saisie précédemment au moment de la modification.

En effet, si le réseau n'est pas Up ou qu'un conflit d'adresse IP est détecté sur le réseau, le système d'exploitation de la doGATE le détecte automatiquement et l'adresse saisie est alors ignorée et remplacée par une adresse au format 169.xxx.yyy.zzz

Avant tout changement d'adresse IP d'une doGATE, vérifier:

• Qu'aucun équipement n'est présent à l'adresse indiquée (En effectuant un ping à l'adresse voulue en veillant à déconnecter préalablement la doGATE)
• Que la Led verte du port LAN est bien allumée.

Lorsque les valeurs des données réseaux ne sont pas correctement affichées dans l'écran de monitoring, cela peut provenir :

• De l'interface réseau de connexion utilisée par le Station configuration tool
• Du profil réseau utilisé (public/privé)
• De la configuration du pare-feu Windows
• De la configuration des anti-virus résidents

Vérification de l'interface réseau de connexion

• Si le PC possède plusieurs cartes interface IP, il se peut que les connexions vers les doGATE n'utilisent pas la bonne carte, et que donc des problèmes interviennent.
  Il est possible d'indiquer au Station Configuration Tool l'interface réseau à utiliser pour les connexions.
  Pour cela:
  • Vérifier l'interface réseau utilisée par le Station Configuration Tool.
  • Dans l'écran "Site", sélectionner la carte interface à utiliser
    
  • Si la valeur est affectée à "N'importe", la connexion en sortie se fait sur la 1ère carte trouvée et donc cela peut engendrer des problèmes de connexions. Comme par exemple les remontées de valeurs non fonctionnelles

Vérification du profil réseau

Il arrive que des réseaux Windows soient configurés par défaut en mode profil réseau public.
Dans ce cas, les restrictions au niveau du système d'exploitation sont beaucoup plus strictes et peuvent engendrer un problème de remontée des valeurs réseau dans le Station Configuration Tool.
Vérifier bien que le réseau que vous utilisez n'est pas déclaré en tant que réseau de profil public.

Configuration pare-feu

Le pare-feu Windows peut, si il est mal configuré, empêcher la remontée des valeurs de monitoring et de tous autres événements provenant de la doGATE. Pour vérifier que le problème n'est pas lié au pare-feu Windows, il est recommandé de désactiver temporairement le pare-feu Windows et de réeffectuer une acquisition via la fenêtre de monitoring.

• Désactiver le parefeu du PC: Un pare-feu mal configuré peut empêcher la réception des valeurs réseaux dans le Station Configuration Tool.

Configuration anti-virus

• Désactiver l'antivirus du PC: Un antivirus mal configuré peut empêcher la réception des valeurs réseaux dans le Station Configuration Tool.

Les causes de problème de communcation LonWorks peuvent être multiples. Cet article présente les premières vérifications à effectuer en cas de problème de ce type.

Vérification de la communication IP

• Les adresses IP de la doGATE et du "Config Server" doivent utiliser la même plage d'adresse,
• Dans les paramètres du réseau LonWorks de la doGATE, vérifier que l'adresse IP du Config Server et le port qu'il utilise (par défaut 1629) sont bien renseignés,
• Depuis l'interface du config server, vérifier que la doGATE est bien déclarée et enregistrée dans la Channel List,
• Vérifier que le port utilisé par la doGATE (ligne Port EIA852) est bien le même que celui déclaré dans la Channel List.

Vérification de l'adressage de la doGATE par rapport à la base LNS

• Vérifier que le domaine déclaré dans l'adressage de la doGATE corresponde bien au domaine de votre base LNS,
• Vérifier que l'adresse subnet/node du réseau Lonworks de la doGATE ne soit pas utilisée par un équipement raccordé au bus.

Cas : Problème de communication avec un modèle d'équipement

Symptômes : pour certains modèles d'équipement, la qualité des variables balotte entre "good" et "bad". 

L'une des causes possibles est que l'équipement ne supporte pas la lecture multiple de variables.
Pour vérifier si le problème vient bien de là, effectuer la manipulation ci-dessous:

• Arrêter les lectures de toutes les variables d'un équipement (trends, alarmes, serveur BACnet, etc.). 
• Dans "Monitoring", ajouter un unique point de cet équipement dans le tableau de lecture
  • La qualité doit être "good"
• Ajouter une seconde variable en lecture de ce même équipement
  • Si la qualité passe à bad au moment de l'ajout du second point, l'équipement ne supporte pas la lecture multiple.

Il est possible de désactiver la lecture multiple pour l'ensemble du réseau LonWorks ou pour un type d'équipement:

• Désactiver la lecture multiple pour l'ensemble du réseau:
  Dans les paramètres du réseau LonWorks, décocher la case Lecture multiple active.
  
  
• Désactiver la lecture multiple pour un modèle d'équipement:
  Lors de l'import de la base LNS dans la doGATE, sélectionner "Inactive" dans la colonne FastPolling à la ligne du modèle d'équipement concerné.
  
  
• Désactiver la lecture multiple pour un seul équipement depuis une variable
  En ajoutant la variable dans le centre d'automation, dans option, selectionner "No" à la ligne Lecture multiple. "/rm=0" serait ajouté à la fin de l'adresse de votre point.
  
  
• Désactiver la lecture multiple pour les points NLFacilities/doBUILD
  
  

Symptômes : l'équipement est bien présent, certaines variables sont correctement lues, d'autres non

Cause possible: il s'agit d'un automatomate programmable dont on a modifié le programme, le nombre de variable. Le nuérmo d'index des variables a donc été modifié 

• Comparer l'index de la variable du noeud déclarée dans la doGATE (dans l'arborescence de l'organisation, affiche Noms et adresses) et l'index de la variable du noeud dans la base LNS à jour.

Résolution : Réimporter la base LNS à jour dans la doGATE

Cas : Problème de communication avec un ou plusieurs équipement alors que le reste fonctionne

Symthôme :  l'ensmeble de mon réseau fonctionne sauf ou (ou quelques) équipements dont toutes les variables sont "bad" et l'équipement répond bien dans NL220

Cause possible : l'adresse subnet/node du noeud a été modifiée dans la base LNS et la base à jour n'a pas été réimportée dans la doGATE.

• Comparer l'adresse Subnet/Node du noeud déclarée dans la doGATE (dans l'arborescence de l'organisation, affiche Noms et adresses) et l'adresse Subnet/Node du noeud dans la base LNS à jour.

Résolution : Réimporter la base LNS à jour dans la doGATE

Cas : Problème de communication ou de stabilité avec une partie du réseau

Symptômes : la communication avec plusieurs équipements géogrphiquement proches sur le bus n'est pas stable.

• Vérifier la présence des bouchons de fin de lignes.
• Vérifier le traffic et le statistiques du canal depuis la page Web de votre routeur
  • Nombre d'erreur important (CRC, messages manqés...)?

La problème est sans doute d'ordre physique, il est nécessaire d'effectuer une analyse du canal.

Réseau Modbus

• Avant tout test de communication Modbus , il faut s'assurer que la doGATE n'est pas en train de lire des points Modbus. Pour cela il faut s'assurer qu'il y a aucun point Modbus configuré en Alarme/Historique/BACnet/Scheduler/Gateway et qu'il n y aucun point dans l'ecran monitoring.
• Vérifier la présence d'une résistance de fin de ligne sur le bus Modbus, particulièrement si vous utilisez le port COM2 de la doGATE V2
• Vérifier le câblage du connecteur DB9 raccordé à la doGATE en cliquant sur le bouton "Câblage" sur l'écran du réseau Modbus.
• Vérifier la configuration RS485 (Vitesse, parité,bit de stop...)
• Certains équipements Modbus ne supportent la lecture/écriture multiple. Il faut donc désactiver sur le réseau Modbus la lecture multiple.
• Certains équipements Modbus utilisent une plage d'adresse de registre qui commence à 0 et d'autres qui commence à 1.  Il faut modifier sur le réseau Modbus de la doGATE l'option JBus. Si l'option est cochée la doGATE utilise l'adressage en base 0 sinon l'adressage est en base 1.
• Dans l'ecran monitoring du Dashboard, ajouter un point à une addresse dont la valeur du registre est connue.
  • si la qualité est BAD il faut :
    • supprimer ce point du monitoring et ajouter un point avec une adresse +1 ou -1.
    • supprimer le point et ajouter un nouveau point en changeant le format de lecture entier 16 bits/32 bits.
  • si la qualité est Good mais la valeur ne correspond pas à la valeur connue :
    • supprimer le point et ajouter un nouveau point en changeant le format de lecture entier 16 bits/32 bits , jusqu'à trouver le bon format.

Dans la majorité des cas, les problèmes de communication entre une doGATE et un réseau de terrain KNX sont dûs soit à un problème de filtrage (les transactions sont filtrés par les routeurs IP), soit un problème d'activation des Flags KNX dans les adresses de groupe.

Routing et Tunneling

En KNX, on distingue deux types de réseaux; les réseau Tunneling et les réseau Routing. Si nous travaillons en réseau Tunneling, alors l'interface KNX/IP ouvre une communication point à point entre la doGATE et l'interface IP.
Aucun filtrage n'est effectué par le routeur. Les cas de problème de filtrage sont donc uniquement relatifs au réseau de type Routing. 

Problème  d'ouverture d'interface

 Le réseau est configuré en Tunneling mais une erreur "badniopen" est affichée dans la qualité:

• Vérifier que l'inteface IP n'est pas utilisée par une autre application

Problème de routage 

 Par défaut, un routeur KNX est configuré pour filtrer les trames afin de ne pas encombrer le réseau de trames inutiles. Seules les transactions d'une adresse de groupe  comprenant des objets de groupes de plusieurs participants  sur des lignes distantes sont transmises.
Afin que le routeur laisse passer les adresses de groupes que vous souhaitez remonter dans la doGATE, plusieurs configurations sont possibles:

• Utilisation du dummy device (solution reconmmandée) : on déclare un participant fictif, sur une ligne distante fictive, et on ajoute son objet de groupe dans l'adresse de groupe que l'on souhaite remonter.
  • Avantage : seules les adresses nécessaires sont remontées, pas d'encombrement inutile du réseau
  • Inconvénient : il faut recharger le routeur lorsque l'on crée une nouvelle adresse de groupe (ATTENTION: ceci est également vrai si vous utilisez Moov'n'Group et que vous créez une nouvelle zone).
• Filtrage manuel (configuration fastidieuse) : avec certains types de routeurs, il est possible de définir manuellement les adresses de groupes qu'il doit laisser passer.
  • Avantage : seules les adresses nécessaires sont remontées, pas d'encombrement inutile du réseau
  • Inconvénient : il faut ajouter chaque adresse de groupe manuellement dans la table de routage et recharger le routeur lorsque l'on crée une nouvelle adresse de groupe.
• Aucun filtrage du routeur (non recommandé) : on configure le routeur afin qu'il laisse passer la totalité des messages.
  • Avantage : il n'est pas nécessaire de recharger le routeur à chaque modification
  • Inconvénient : aucune adresse de groupe n'est filtrée, le réseau peut être encombré.
  • Il n'est pas recommandé d'utiliser cette configuration mais, en test, elle peut permettre de vérifier que le problème de communication sont dûs à un problème de routage.

 Les flags KNX

 Avec la doGATE en KNX, il est possible d'obtenir les données terrain de deux manières : soit par lecture cyclique, soit en évenementiel (notification du réseau en cas de changement de valeur).

Lecture explicite

 En lecture cyclique, vous obtenez des qualités "bad" ou "baddeviceabsent":

• Vérifier que le flag "Read" est activé sur l'adresse de groupe en question

Système événementiel

L'utilisation d'une adresse avec les options "/event/noinit" permet de laisser la doGATE en mode "écoute".
Dans ce cas les valeurs ne seront JAMAIS lues explicitement sur le réseau.

 En événementiel, vous obtenez des qualités "bad":

• Vérifier que le flag "Transmit" est activé sur l'adresse de groupe en question
• Noter également que si aucun changement de valeur n'a eu lieu depuis le démarrage du serveur doMOOV, il est normal de ne pas avoir de valeur si aucune lecture d'initialisation n'est configurée. 
  Si la lecture d'initialisation est configurée, l'adresse de groupe doit avoir le flag "Read" pour obtenir une valeur de départ.

Ecriture de point

Si vous avez une erreur d'écriture:

• Vérifier que le flag "Write" est activé sur l'adresse de groupe en question

Les problèmes de communication MBus sont dans la grande majorité des cas des problèmes d'ordre physique ou de mauvais paramétrages.

Voici les premiers points à regarder lorsque vous rencontrez des problèmes de communication avec un équipement MBus:

• Vérifier que le câble est correct. Le schéma du câblage est disponible en cliquant sur "Câblage" depuis les paramètre du réseau MBus.
• Vérifier que les pins M- et M+ n'ont pas été inversés sur le câblage du convertisseur
• Vérifier que les paramètres de communication définis dans la doGATE sont bien à ce qui est requis pour l'équipement. (Baude rate, Parity, DataBit, Stop Bit, etc...)
• Vérifier que l'alimentation du bus est suffisament puissante pour le nombre d'équipements rattachés au bus.
  • Les alimentations MBus sont dimensionnées pour un nombre précis maximum d'équipements
• Vérifier que vous avez de l'activité sur les LED de communication de votre convertisseur (Tx et Rx).
• Vérifier que le compteur supporte la fréquence de lecture utilisée (Certains compteurs ne supportent pas plus de 24 lectures jour)

Si vous importez un fichier .csv contenat des caractères non ASCII, vous devez utiliser la procédure suivante :

• Créer un nouveau fichier Excell
• Sélectionner l'onglet "Données"
• Cliquer sur le bouton fichier texte
• Suivre le wizard en prenant soin de sélectionner que l'origine du fichier est de type Unicode (UTF-8).
• Puis cliquer sur terminer

Pour exporter un fichier Excell contenant des caractères non ASCII en fichier .csv, vous devez suivre la procédure suivante :

• Dans le fichier Excell, sélectionner l'onglet "Fichier"
• Puis sélectionner l'option "Enregistrer sous..."
• Lorsque la fenêtre "Enregistrez sous..." apparaît, sélectionner "options web" dans le menu déroulant "outils"
  
• Sélectionner l'onglet "Codage"
• Dans la liste déroulante du type de fichier, sélectionner "Unicode(UTF-8)"

Depuis Station Configuration Tool, il vous faut aller dans "Configuration Station". Puis, dans l'onglet paramètres, parcourez les différents tableaux jusqu'à celui intitulé "Projects". Il contient une ligne nommé "DataServerProject". Au bout de cette ligne vous avez deux icônes : la première représente un disque et permet de faire un backup/restore du projet, la seconde est une croix rouge située qui vous permet de supprimer le projet de la doGATE.

Remarque : la suppression de ce projet ne remet pas la doGATE en configuration usine ; les adresses IP, les paramètres de la doGATE sont conservés.

Le projet supprimé contient :

• Les réseaux déclarés sur chacun des ports de la doGATE
• Les organisations réseaux
• Toutes les fonctions définies dans le centre d'automation
• La base de données des alarmes et des tendances

Cette erreur apparait dans le cas où vous avez tenté d'importer une base LNS dans une doGATE mais que le serveur LNS n'est pas présent sur la machine depuis laquelle vous configurez la doGATE. Pur pouvoir faire cette manipulation, l'outil de configuration de la doGATE et le serveur LNS (LNS-TE ou Open LNS) doivent être tous deux présents sur la même machine.

 4 - Dongle - Files - Nextcloud (jffi.net)

Il est en effet possible de transférer la confirmation d’un dongle d’une machine à une autre.

Cependant, il faut que vous vous assuriez de plusieurs points avant de mettre en œuvre la procédure :

• Aucun autre dongle ne doit avoir été confirmé préalablement sur la machine où vous souhaitez porter le dongle. Si un autre dongle a déjà été confirmé alors vous ne pourrez pas confirmer de nouveau celui-ci.
• Vérifier que le nombre de crédits LNS (rattachés à la machine, visible via LNS License Wizard) soit supérieur au nombre de crédits NL (rattachés au dongle, visible via NLDongleUtility)

Une fois ces deux points vérifiés, on peut procéder à la libération du dongle.

Il faut donc :

• Connecter le dongle à libérer
• Exécuter NLDongleUtility.
• Cliquer sur le bouton « free » qui se situe en bas de la fenêtre.
• Un code est alors généré et nous est envoyé par e-mail (à fr-newron-credits@abb.com).

Suite à ceci, nous vous régénérons un code qu’il faut saisir dans NLDongleUtility, en dessous du 1er généré. Puis cliquez de nouveau sur Free.

Votre clé est alors libérée et peut-être confirmée sur le PC que vous souhaitez.

 Vous pouvez télécharger NLDongleUtility depuis le lien suivant:

http://file.newron-system.com/
Id: dongle
Pw: 1r2ama

Le compteur de désinstallation est un compteur de sécurité qui compte le nombre de désinstallations effectuées. La limite est fixée à 200 désinstallations.

Si vous souhaitez décommissionner plus, vous devez ouvrir NLCreditsGenerator (Menu démarrer -> Tous les programmes -> NLSuite) et entrer "0" pour la quantité de crédits demandés. Un code est alors généré que vous envoyez à FR-newron-support@abb.com.

Vous devrez également motiver cette demande afin d'éviter des vols de crédits par des personnes malintentionnées qui viendrait décommissionner tous les modules de bases de données.

Notez que lorsqu'un code est généré(que ce soit pour une commande de crédits, mise à jour licence, libération ou remise à zéro du compteur) il est l’image du dongle à l’instant T.
Toute modification faîte entretemps (commissionnement/décommissionnement) rendra le code renvoyé alors obsolète. Il est donc indispensable de NE PAS utiliser le dongle entre deux échanges de codes. 

• Vérifiez dans le répertoire c:\windows\newronsystem\NLCreditsGenerator la taille du fichier sx32w.dll.
• Ce fichier doit faire une taille de 3470Ko pour que l'outil fonctionne correctement.
• Si la taille du fichier fait 99 ko, alors regardez dans c:\windows\newronsystem\NLlicensemgr, ce même fichier devrait faire 3470ko.
• Fermez alors tous les outils Newron et recopiez le fichier sx32w.dll de 3470ko dans le répertoire windows\newronsystem\NLCreditsGenerator.
• Relancer l'application NLCreditsGenerator

Les crédits LNS correspondent au système de licence utilisé dans les versions Turbo Edition de LNS.

Le nombre de crédits LNS nécessaire à un projet correspond au nombre d'équipements (noeuds) qui seront installés dans la base LNS. 

Les équipements d'infrastructure du réseau LonWorks, tels que les routeurs Lon/IP ou les répéteurs,  ne consomment pas de crédit lors de leur installation.

Remarque : il est possible de déclarer une doGATE dans une base LNS, mais il n'est pas nécessaire de la commissionner. De ce fait, elle ne nécessite pas de crédit.

Remarque : Les crédits LNS ne sont plus utilisés dans les version LNS Open/Izot. Dans ces versions le système de licence LNS est à base de clef logiciel d'activation par ordinateur.

NL220 TE

Dans NL220 TE, les crédits sont consommés au moment où l'équipement est commissionné/installé sur le réseau.
Avec cette version, un crédit NL et un crédit LNS sont consommés pour chaque nouvel équipement installé.

NLFacilities TE

Dans NLFacilities TE, les crédits sont consommés au moment où un équipement est installé sur le réseau (de la même manière que NL220 TE) ou lorsque les modifications NLFacilities sont appliquées sur le réseau.
Dans NLFacilities TE, tout équipement présent dans une zone consommera un crédit NL.

NL220 Open

Avec une licence NL220 Open (licence logicielle) il n'y a pas de système de crédits.
La licence logicielle est reliée à la licence logicielle du serveur OpenLNS/Izot server.
L'outil peut être utilisé pour installer sans limite les équipements LonWorks.

NL220 Open Pro

Avec cette licence un crédit est consommé à l'installation de nouvel équipement.
La licence NL220-Pro Open est une licence dongle.
La particularité de cette licence est qu'elle n'est pas reliée à une licence OpenLNS/Izot server, elle peut être utilisée librement sur différents ordinateurs.
Cette licence utilisent un système de crédits appelés crédits Runtime (ou crédits Open). Ces crédits sont stockés sur le dongle.

NLFacilities Open

La licence NLFacilities Open est une licence dongle.
Cette licence utilise des crédits Runtime (ou crédits Open).
Dans NLFacilities Open, tout équipement présent dans une zone consommera un crédit Runtime (ou crédits Open).

Connaitre le nombre de crédits NL restants

Pour connaître le nombre de  crédits NL restants (rattachés à votre dongle):

• Exécuter le programme NLCreditsGenerator depuis Menu démarrer -> Tous les programmes -> NLSuite.
• Vous pourrez alors visualiser le nombre de crédits restant dans la case 'Remaining NL credits" .

Connaitre le nombre de crédits LNS restants

NOTE : Les crédits LNS ne sont disponibles que pour les versions Turbo Edition (TE)
Pour connaitre le nombre de crédits LNS restants (rattachés à votre ordinateur):

• Exécuter le programme Echelon Server License Wizard situé dans Menu démarrer -> Tous les programmes -> Echelon LNS Utilities.
• Vous pouvez alors visualiser le nombre de crédits restants dans la case "Credits available"

NL220 Open est basé sur le serveur d'Echelon Open LNS / Izot server.

Le serveur LNS doit être activé sur chaque machine où il est installé par une clé d'activation qui sera liée à cette machine.

Il existe deux types de licences pour l'outil NL220 Open:

• NL220 Open : la licence de NL220 Open est une clé logicielle.
  Elle est liée à la clé d'activation Open LNS. Elle est compatible uniquement avec cette clé Open LNS.
  De ce fait, elle ne peut être utilisée que sur une unique machine.
  Si la clé d'activation Open LNS est déplacée sur une nouvelle machine, alors il sera possible d'activer la licence NL220 sur cette nouvelle machine.
  Attention : ce type de licence n'est pas compatible avec les machines virtuelles.
• NL220 Pro Open : la licence NL220 Pro Open est une licence matériel, un dongle.
  Elle inclut également la licence de NLCSV.
  Le dongle est nomade; il peut être utilisé sur n'importe quelle machine disposant d'un serveur Open LNS actif (clé d'activation Open LNS).
  Le dongle peut également être utilisé  sur des machines virtuelles.

Pour plus d'information, veuillez trouver ci-joint le datasheet de NLSuite Open.

 https://abb.jffi.net/index.php/s/zbxt4Nj5zoJZAKC

Initier une demande de mise à jour de dongle après achat

Après avoir reçu la validation d'un achat auprès de nos services commerciaux:

• Exécuter l'application NLDongleUtility
• Connecter physiquement le dongle à libérer
• Cliquer sur le bouton « Update » qui se situe en bas de la fenêtre. 
• Un code est alors généré et nous est envoyé par e-mail à fr-newron-credits@abb.com
  • Assurez-vous d'indiquer le numéro de commande associé à cette demande

La seconde étape consistera à effectivement activer cette nouvelle licence sur le dongle.

Mettre à jour son dongle avec une clef de mise à jour

La clef de mise à jour de licence d'un dongle est une chaîne de caractère de longueur variable reçue par mail.
Pour mettre à jour le dongle et bénéficier de cette nouvelle licence :

• Assurez-vous d'avoir installé le logiciel NLDongleUtility sur votre Ordinateur.
• Branchez le dongle à votre ordinateur
• Exécuter l'application NLDongleUtility
• Le logiciel apparaît et indique le contenu du dongle
• En bas de l'application un bouton Update the dongle est disponible 

• Cliquer sur Update the dongle, 2 nouveaux champs de saisies apparaissent
• Saisir la clef de licence reçue par mail dans le champs "Update key" et cliquer sur le bouton Update
• Le dongle va être mis à jour avec la nouvelle licence. 

Où trouver l'application NLDongleUtility?

 4 - Dongle - Files - Nextcloud (jffi.net)

Pour commander des crédits NL sur un dongle (i.e. commissionner plus d'équipements):

• Exécuter l'application NLCreditsGenerator (Menu Démarrer –> Tous les programmes –> NLSuite).
• Saisissez la quantité de crédits voulus dans le champs NLCredits to add

La quantité de crédits doit être supérieure à 20.

Un code est alors généré et directement inséré dans un e-mail à notre destination.
Note : Si vous rencontrez un quelconque problème, vous pouvez l’envoyer manuellement à l'adresse FR-newron-credits@abb.com
Attention : le dongle doit d'abord être confirmé sur le PC ou est généré la clé.

 Si le nombre de crédits LNS n'est pas suffisant sur la machine NLCreditsGenerator incluera automatiquement une commande de crédits LNS nécessaire.

 N'oubliez pas de joindre votre numéro de commande à votre demande.

Il est en effet possible de transférer la confirmation d’un dongle d’une machine à une autre. Cependant, il faut que vous vous assuriez de plusieurs points avant de mettre en œuvre la procédure : 

• Aucun autre dongle ne doit avoir été confirmé préalablement sur la machine où vous souhaitez porter le dit dongle.
  Si un autre dongle a déjà été confirmé alors vous ne pourrez pas confirmer de nouveau celui-ci.
• Vérifier que le nombre de crédits LNS (rattachés à la machine, visible via LNS License Wizard) soit supérieur au nombre de crédits NL (rattachés au dongle, visible via NLDongleUtility)  

Une fois ces deux points vérifiés, on peut procéder à la libération du dongle. Pour cela,

• Exécuter l'application NLDongleUtility
• Connecter physiquement le dongle à libérer
• Cliquer sur le bouton « Free » qui se situe en bas de la fenêtre. 
• Un code est alors généré et nous est envoyé par e-mail à fr-newron-credits@abb.com
• Suite à ceci, un code est fournit en retour par email.
• Dans NLDongleUtility, coller la clef reçue par email en dessous de la 1ere généré.
• Puis cliquez de nouveau sur le bouton Free. 
• Votre clé est alors libérée et peut-être confirmée sur le PC que vous souhaitez.

Les crédits LNS sont à la base du système de licence Echelon utilisé pour les versions Turbo Edition du serveur LNS.
Un crédit LNS correspond à l'installation d'un équipement LonWorks au sein d'un réseau dans une base de données LNS.
Les crédits LNS sont des entités purement logicielles.
Les crédits LNS sont rattachés à un ordinateur.
Il est possible de faire évoluer le nombre de crédits LNS présent sur un ordinateur en effectuant des demandes de crédits supplémentaires.
Ces demandes de crédits supplémentaires peuvent être effectuées via l'outil Echlon LNS server licence wizard.

NOTE : Les nouvelles versions des serveurs LNS (OpenLNS/Izot server) n'utilisent plus de système de crédits mais utilisent un système de clef d'activation unique par ordinateur.

 REMARQUE: Dans les logiciels NLSuite TE, un crédit LNS est relié à un crédit NL (NLCredits présents dans le dongle).
Lorsque des crédits NL sont livrés les crédits LNS nécessaires au fonctionnement de l'outil sont également livrés.

Un crédit Open ou crédit Runtime correspond à un crédit présent sur le dongle ABB newron pour les applications NL220 Open Pro et NLFacilities Open.

Un tel crédit est utilisé lors de l'installation d'un équipement au sein d'un réseau LonWorks dans une base de données LNS.

Les crédits Open sont stockés dans le dongle.
Il est possible d'effectuer des demandes de crédits supplémentaires via l'outil Runtime Site Generator Utility fournit à cet effet.

L'outil Runtime Site Generator Utility est installé automatiquement lors de l'installation des applications NL220 ou NLFacilities.

Après avoir passé commande pour le nombre de crédits désirés, vous devez lancer l'outil NLCreditsGenerator sur la machine qui sera utilisée pour l'intégration. Le dongle doit être confirmé sur cette machine.

Une fois l'outil lancé, renseignez le nombre de crédits correspondant à votre commande puis cliquez su  "Next". renseignez les informations demandées, générez le mail de requête pour l'envoyer à fr-newron-credits@abb.com.

Nous vous retournerons un code à renseigner dans le champ "Upgrade key". Une fois le code collé, cliquez sur Upgrade pour l'appliquer sur le dongle. Vos crédits sont alors ajoutés.

Après avoir passé commande pour le nombre de crédits désirés, vous devez lancer l'outil Runtime Site Generator Utility sur une machine où NL220 Pro Open est installé et où le dongle est connecté.

Une fois l'outil lancé, renseignez le nombre de crédits correspondant à votre commande puis cliquez sur  "Next". renseignez les informations demandées, générez le mail de requête pour l'envoyer à fr-newron-credits@abb.com.

Nous vous retournerons un code à coller dans le champ "Upgrade key". Une fois le code collé, cliquez sur Upgrade pour l'appliquer sur le dongle. Vos crédits sont alors ajoutés.

Si cette erreur apparaît dans NLCreditsGenerator:

• Ouvrir NL220
• Depuis le menu principal sélectionner l'option Projet/Supprimer...
• Dans la liste sélectionner le projet qui se nomme 82807E44116C482
• Cliquer sur le bouton Supprimer

Une fois l'opération effectuée, exécuter à nouveau NLCreditsGenerator, l'erreur ne doit plus s'afficher.

Avec LNS-TE, vous avez besoin de crédits LNS (attachés à la machine) pour commissionner les équipements. Avec NL220, vous avez également des crédits attachés au dongle. 

ll est recommandé de commissionner/décommissionner les noeuds depuis le PC où la machine est installée afin de ne pas désynchroniser le nombre de crédits LNS et le nombre de crédits NL; vous devez avoir un nombre de crédits LNS supérieur ou égal au nombre de crédits NL restants sur votre dongle.

En effet, lorsque vous ajoutez des crédits sur votre dongle, nous vous livrons également des crédits LNS. Les crédits LNS sont des crédits que nous achetons à Echelon. De ce fait, nous ne pouvons donc pas livrer plus de crédits LNS que de crédits commandés. C'est pourquoi, la demande de crédits doit être effectuée depuis le PC où le dongle est confirmé.

NLCreditsGenerator Utility est l'outil vous permettant d'ajouter des crédits NL sur les dongles NL220-TE, NL220-TE Pro, NLFacilities-TE et NLFacilities-TE Pro.
NOTE : Il crédite également la machine des crédits LNS nécessaires si besoin.

L'outil NLCreditsGenerator Utility est installé en même temps que NL220 -TE ou NLFacilities-TE.
Une fois installé l'outil est disponible via le menu :

• Démarrez/Tous les programmes/NLSuite/NLCreditsGenerator/NLCreditsGenerator utility

Lorsqu'un dongle est confirmé sur une machine, un identifiant de la machine est calculé et sauvegardé dans le dongle.

Cet identifiant calculé regroupe un ensemble de caractéristiques système (identifiant carte mère + disque dur + ...)
Une mise à jour importante du BIOS ou un changement de matériel (remplacement d'un disque dur) peuvent donc modifier l'identifiant calculé de la machine.
Le dongle ne reconnaît donc plus la machine comme étant celle sur laquelle il est confirmé.

Dans ce cas, vous pouvez effectuer une procédure classique de libération du dongle.
Pour ensuite, le reconfirmer à nouveau sur l'ordinateur.

Runtimes Site Generator Utility est l'outil vous permettant d'ajouter des crédits Runtimes sur les dongles NL220 Pro Open, NLFacilities Open et NLFacilities Pro Open.

Runtimes Site Generator Utility est installé en même temps que NL220 Open ou NLFacilities Open.
Si l'installation de l'un de ces outils a été exécutée sur la machine, RunTimes Site Generator a également été installé.

Une fois installé l'outil est disponible via le menu :

• Démarrez/Tous les programmes/NLSuite/Runtimes Site Generator/Runtimes Site Generator utility

Informations

La livraison de crédits LNS seuls est exceptionnelle. Les crédits LNS sont généralement livrés en conjonction des crédits NL.
Cette procédure ne s'applique que dans certains cas avec une validation commerciale préalable.

Procédure

Pour commander manuellement des crédits LNS, il faut passer une commande en utilisant l'outil Echelon dédié à cet effet.

Pour générer la commande:

• Exécuter l'application LNS Server License Wizard (Menu Démarrer –> Tous les programmes –> Echelon LNS Utilities).
• Sur la 1ère page de l'assistant, Saisir le nombre de crédits LNS voulus dans le champs "Enter number of credits to add":

• Cliquer sur le bouton Next, l'assistant générera une clef de commande de crédits.
• Cliquer sur le bouton Copy to clipboard et coller le résultat dans un corps de mail
• Envoyer directement la demande de crédits générée à l'adresse fr-newron-credits@abb.com
• Cliquer sur le bouton Finish pour sortir de l'assistant

En réponse de la commande vous recevrez par email une clef logiciel de mise à jour. Pour bénéficier de cette mise à jour:

• Exécuter l'application LNS Server License Wizard (Menu Démarrer –> Tous les programmes –> Echelon LNS Utilities).
• Passez la 1ère page de l'assistant
• Saisir la clef reçue par email dans le champs PC Key
• Cliquer sur Finish
• Les crédits supplémentaires ont été ajoutés. Pour le vérifier, exécuter à nouveau l'assistant Echelon LNS Server License Wizard et vérifier la valeur affichée dans le champs "Max credits"

Depuis le lien suivant, vous trouverez les outils et fichiers relatifs à la doGATE et NLSuite (Open et TE): 

https://abb.jffi.net/index.php/s/aP8iY5azR5sHJcG 

Dans le cas d'un changement de machine,  il faut retourner la clé Open LNS sur le serveur Echelon, pour cela deux solutions possibles. Il est recommandé d’utiliser la fonction de retour (PC accessible) et non la fonction de récupération (PC non accessible) car, par clé, sont autorisés 10 déplacements et 5 récupérations.

Les deux solutions impliquent d’avoir créé ou de créer un compte Echelon depuis l’outil Echelon License Wizard.

1. Si le PC où la clé est enregistrée est accessible : 

Si vous avez la possibilité de remettre la machine dans le même état que lors de la validation, vous pouvez effectuer cette procédure. Par exemple dans le cas d'une validation avec une clé USB connectée en moment de la validation, reconnectez cette clé pour retourner la licence sur la serveur avant de la retirer pour réactiver la licence.

• Dans Echelon License Wizard sur le PC où la clé est enregistrée, sélectionnez « Manager product licenses »
• Dans la liste déroulante de la colonne Action, choisissez « Return » et continuez la procédure jusqu’au bout.
• Si la manipulation à bien fonctionner, vous aurez alors un message indiquant que la licence est bien retournée sur le serveur.

2. Récupérer une licence sur un PC inaccessible, depuis n’importe quel PC : 

• Cliquez sur "Show advanced tasks" afin de faire apparaitre des options supplémentaires
• Choisissez "Recover licenses on an inaccessible computer", puis cliquez sur "Next"

• Renseignez les identifiants de votre compte Echelon et cliquez sur "Next".
• Vous aurez alors un tableau comprenant la liste des licences liées à ce compte. Dans la liste déroulante de la première colonne, choisissez "Recover" à la ligne de la licence à récupérer, puis cliquez sur "Next".
• Si la manipulation à bien fonctionner, vous aurez alors un message indiquant que la licence est bien retournée sur le serveur. 

Une fois la licence retournée sur le serveur :

• Vous pourrez alors activer votre licence sur le PC de votre choix.

Possibles raisons : 

1. Il y a 2 dongles sédentaires connectés en parallèle sur la machine qui interfèrent l'un avec l'autre
2. Le dongle ne contient pas la licence de déprotection de l'outil
3. Le driver de reconnaissance de dongle n'est pas installé

Résolutions :

• 1 - Déconnecter le ou les dongle(s) qui ne sont pas NLFacilities ou NL220 et relancer l'outil. Vérifier que celui-ci soit alors licencié correctement.
• 2 - Télécharger et exécuter l'outil de gestion des dongles, NLDongleUtility.
  Disponible à l'adresse :
  http://file.newron-system.com/
  Identifiant : dongle
  Mot de passe : 1r2ama
  Dans celui-ci, sont listées les différentes licences activées par le dongle.
  Vérifier que la licence de l'outil souhaité soit bien listée (Attention NL220 TE ≠ NL220 Pro Open)

• 3 - Le driver du dongle est nommé "Safenet Sentinel".
  Le driver est normalement installé en même temps que les outils.
  Si ce n'est pas le cas : 
  Télécharger le fichier d'installation driver "Safenet Sentinel" en exécutable seul :
  http://file.newron-system.com/
  Identifiant : dongle
  Mot de passe : 1r2ama
  Et forcer sa réinstallation manuellement.

Cet article présente comment déclarer une interface LonWorks IP-852 sur sa machine en utilisant OpenLDV5.0 pour pouvoir se connecter à un réseau Lonworks administré par un Configuration Server IP-852.

Tout d'abord assurez-vous d'avoir bien installé l'application OpenLDV 5.0 sur votre ordinateur.
Ouvrir le panneau de configuration et exécuter l'application LonWorks interfaces (32-bit).

Pour ajouter une interface cliquer sur Add et sélectionner l'option IP-852 interface.
Saisir un nom pour la nouvelle interface (Ex: Mon_PC) puis sélectionner l'adresse IP à laquelle vous souhaitez vous attacher.
Le port par défaut utilisé est 1628, sauf besoin particulier il n'est pas nécessaire de modifier ce port.

NOTE IMPORTANTE : L'adresse IP doit être une adresse valide sur votre ordinateur. Si vous effectuez un changement d'adresse IP sur votre ordinateur, il faudra refaire toute la déclaration afin de bien utiliser la bonne adresse IP.

Cliquer sur OK. L'interface est définie sur votre ordinateur.

Il faut ensuite déclarer, sur le Configuration Server, un nouvel équipement dans la "Channel list" qui correspond à votre ordinateur avec l'adresse IP utilisée précédemment.
Le Configuration Server est généralement un L-IP Loytec ou encore un Routeur Occitaline.
La déclaration d'un PC sur un Configuration Server est le sujet d'une autre FAQ.

Une fois votre ordinateur enregistré dans le Configuration Server, retournez dans l'outil LonWorks Interfaces (32-bit).
Sélectionnez votre interface réseau dans la liste de gauche et cliquer sur le bouton Test dans la barre de menu.

Une fenêtre demande de saisir l'adresse du "Configuration server" à contacter.
Saisissez l'adresse de votre "Configuration Server" (vous pouvez laisser le champs port vide si vous avez utilisé la configuration standard) puis cliquer sur OK.
Le test s'effectue et un message "IP-852 test completed successfully" doit s'afficher dans la fenêtre de trace si tout est correctement configuré.

Par défaut, NL220 crée tous les projets dans le répertoire C:\NLPrj.
Chaque sous-répertoire représente alors une base de données distincte.
Exemple : C:\NLPrj\DEMO correspondra alors au projet DEMO.

A la création du projet NL220 il est possible de modifier le répertoire où sera créé le projet. Pour cela il suffit de modifier le champ Chemin projet pour modifier le répertoire destination.

NOTE : Le chemin complet pour un projet NL220 ne peut dépasser la limite de 23 caractères.

Compatibilité NL220 TE

Compatibilité NL220 Open

Licence NL220 TE

Licences NL220 Open

• NL220 Open : licence logicielle rattaché à une instance d'un server Open LNS (Izot). Aucune notion de crédits, il est possible d'installer autant d'équipement que l'on souhaite.
• NL220 Open Pro : licence dongle qui peut être utilisée entre différentes instances de server OpenLNS (Izot). Le dongle contient le nombre d'équipements qui peuvent être installés avec le dongle. Il est à tout moment possible d'ajouter de nouveaux crédits sur le dongle pour installer des noeuds supplémentaires.

Les différentes licences disponibles pour NL220 sont:

• NL220 Open Pro
• NL220 Open

NL220 Open Pro

NL220 Open est basé sur le serveur d'Echelon OpenLNS (Izot server).
La licence de NL220 Open Pro est une licence dongle. licence dongle qui peut être utilisée entre différentes instances de server OpenLNS (Izot). Le dongle contient le nombre d'équipements qui peuvent être installés avec le dongle. Il est à tout moment possible d'ajouter de nouveaux crédits sur le dongle pour installer des noeuds supplémentaires.

Cette licence inclut également la licence de NLCSV et autorise toutes les fonctionnalités de l'outil NL220 Backup/Restore Création de projet, Ajout/Suppression/Remplacement d'équipement, Modification de variable de configuration,...

NL220 Open

NL220 Open est basé sur le serveur d'Echelon OpenLNS (Izot server).
La licence de NL220 Open est une clé logicielle. Elle est liée à la clé d'activation Open LNS. Elle est compatible uniquement une instance de clef Open LNS.
Cette licence autorise toutes les fonctionnalités de l'outil Backup/Restore Création de projet, Ajout/Suppression/Remplacement d'équipement, Modification de variable de configuration,...

Attention : ce type de licence n'est pas compatible avec les machines virtuelles.

Les dongles intégrateur possèdent un compteur de sécurité correspondant au nombre de désinstallations/suppressions faîtes.
La limite est fixée à 200 modules.

Ceci est fait volontairement afin d‘éviter des vols de crédits par des personnes malintentionnées qui viendraient décommissionner tous les modules de bases de données.

Si vous voulez décommissionner plus, vous devez nous envoyer un code généré par NLCreditsGenerator (pour LNS-TE) ou NLRuntimeSiteGenerator (pour OpenLNS) (Menu Démarrer – Tous les programmes – NLSuite) et entrer “0” pour la quantité de crédits demandée.
Votre demande doit être envoyée à fr-newron-credits@abb.com. 

Merci de justifier cette demande.

Problème de taille de backup

Un problème rencontré concerne la taille du fichier backup généré.
Vérifier alors que la taille du répertoire de la base de données LNS (C:\NLPrj\<projectName>) ne dépasse pas les 2Gb.
Si c'est le cas, vérifier qu'il n'y a pas de fichier de trace (.log) qui prendraient beaucoup de place. Supprimer ces fichiers si nécessaires avant de réessayer l'opération de backup.

Problème de base de données verrouillée

Un autre problème possible est que le backup d'une base de données LNS ne peut se faire, à cause d'un fichier verouillé.
  - Arrêter toutes les applications et services qui utilisent LNS dont NLFacilities/NL220/NLopc
  - Vérifier dans les répertoires des bases de données LNS qu'il n'y ait pas de fichier en lecture seule
  - Redémarrer NL220 et utiliser directement la fonction Projet/Archiver... sans ouvrir de projet

NL220 -TE est basé sur la version du seveur Echelon LNS-TE. LNS-TE est compatible avec les systèmes d'exploitation Windows de version Windows XP SP3 à Windows 7 64bis et Windows Server 2008 R2. 

Echelon n’a pas testé et approuvé le fonctionnement de LNS-TE sous Windows 8, 10 et Server 2012 de manière officielle . Et encore moins sous Windows Server 2016.

NL220 Open est basé sur la version du serveur Echelon Open LNS (IzotNet Server). Open LNS (IzotNet Server) est compatible avec les systèmes d'exploitation Windows de version Windows XP SP3 à Windows 10 et Windows Server 2012 R2.

 La version la plus récente de Open LNS (IzotNet Server 4.1) est compatible avec Windows Server 2016 :
https://www.echelon.com/assets/bltc2ae4dfbe83dba3b/IzoT_Net_Server_4.1_Datasheet.pdf

Configuration matérielle minimale  :

processeur 500 MHz, 512 MB RAM, espace disque : 2 GB , 1024 MB page file, lecteur DVD-ROM, Résolution minimale :1024 x 768 avec au moins 256 couleurs, souris ou dispositif de poinrtage et OpenLNS ou interface de réseau IP. 

Configuration minimale recommandée : processeur 2 GHz , 2 GB RAM, and 2048 MB page file. 

En LonWorks, certaines variables peuvent être de type utilisateurs, c'est à dire un format créé par le constructeur de l'équipement et donc non présent dans le catalogue standard LonWorks. 

Lors de l'installation du serveur LNS-TE, l'outil LNS Resource Files Catalog Utility est installé sur la machine. C'est cet outil qui va vous permettre de construire le catalogue.

• Placez l’ensemble des fichiers catalogue à utiliser dans le répertoire « C:\LonWorks\Types\user »
• Lancez l’outil LNS Resource Files Catalog Utility
• Ajoutez les différents répertoires de vos fichiers catalogues afin qu’ils soient déclarés dans le fichier LDRF.CAT, puis cliquez sur « Refresh now » pour mettre à jour le fichier en question.
• Le fichier LDRF.CAT du répertoire C:\LonWorks\Types doit alors être à jour. Les formats des variables utilisateur doivent maintenant être correctement affichés.

En LonWorks, certaines variables peuvent être de type utilisateurs, c'est à dire un format créé par le constructeur de l'équipement et donc non présent dans le catalogue standard LonWorks. 

En OpenLNS, la mise à jour des catalogue est automatique à condition que les fichiers soient enregistrés au bon endroit. 

Il arrive que cela ne fonctionne pas directement. Dans ce cas, vérifiez que les registres associés aux catalogues pointent bien sur les répertoires que vous utilisez :

• Dans \HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\LonWorks\LCA\Data Server\Defaults, vérifez les registres "Format Catalog Path" et Format File Path"

OU

•  Dans \HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\LonWorks, vérifez les registres "LonWorks Data Path" et "LonWorks Path"

OU

Si après avoir vérifié ce point, les catalogues ne sont toujours pas reconnus, suivez la procédure suivante:

• Lancer OpenLNS Object Browser
• Cliquez sur F8 pour activer les modifications
• Changer le répertoire LdrfCatalogPath pour pointer sur le répertoire "C:\LonWorks\Types" ou "C:\Program Files (x86)\LonWorks\Types" :
• Rebuilder le catalogue par clic-droit sur Objectserver, puis "RebuildLdrfCatalog":
• Le fichier LDRF.cat de "C:\LonWorks\Types" ou "C:\Program Files (x86)\LonWorks\Types" est alors mis à jour.

Cela peut être dû à un conflit sur les ports 6001 ou 6002 (ports par défaut de LNS). Pour résoudre ce problème, vous pouvez changer les ports par défaut utilisés par LNS ou fermer l'application qui utilise un de ces ports.

Pour changer les ports par défaut de LNS, suivez la procédure suivante :

- Sous Windows, ouvrir le fichier "C:\Windows\System32\drivers\etc\services" avec un éditeur de texte démarré en tant qu'administrateur.
-Si vous avez  les entrées poet and _poet , changez les numéros de port  XXXX et YYYY en sachant que l'on doit avoir XXXX=YYYY + 1. Par exemple, les ports par défaut de LNS étant 6001 and 6002, si vous choisissez  XXXX=9001 alors  YYYY=9002. Pour connaître les ports utilisés, vous pouvez lancer la commande DOS netstat -a
- Si les entrées n'existent pas, ajouter alors les 2 lignes suivantes (9001 et 9002 ne doivent pas être utilisées) :

 poet 9001/tcp #FastObjects services
 _poet 9002/tcp #FastObjects services

- Sauvegarder le fichier et redémarrer l'ordinateur

 En OpenLNS, il peut être nécessaire d'effectuer en plus la procédure suivante :

-        Ouvrir le fichier ptserver400.cfg (C:\LonWorks\Bin) avec un éditeur de texte

-        Ajouter la ligne suivante dans le section [servers\ptserver]

service = 9001 / tcp

-        Sauvegarder le fichier

-        Rebooter la machine

Les projets Turbo Edition peuvent être convertis de manière simple. En effet, une simple ouverture d'un projet avec une édition Open (Izot server) effectuera nativement la migration.

ATTENTION: L'inverse n'est pas vrai. Il n'est pas possible d'importer un projet Open (Izot) en Turbo Edition.

Pour migrer un projet créé sous NL220 TE vers NL220 Open, il suffit de  faire un backup du projet sous NL220  TE puis simplement de l'importer avec NL220 Open.

ATTENTION : NL220 TE et NL220 Open ne peuvent pas coexister sur la même machine.

Ce message signifie que le backup du projet, le fichier .gz utilisé, est corrompu.

Il faut utiliser un autre fichier de backup.

L'outil NLDongleUtility vous permet de visualiser les différentes licences et options présentes dans votre dongle. Il vous permet également d'en connaitre le numéro de série.

Vous pouvez télécharger NLDongleUtility depuis le lien suivant:

4 - Dongle - Files - Nextcloud (jffi.net)

Où trouver les drivers?

Les drivers pour les interfaces LonWorks standards ou Echelon sont installés en même temps que le serveur LNS. 

La version la plus récente actuellement est OpenLDV 5.0, elle est disponible au téléchargement depuis le lien suivant :

https://www.echelon.com/software-downloads?ele=153-0411-01B

 Comment déclarer une interface LonWorks IP sur le PC?

Vous devez utiliser l'outil LonWorks Interfaces que vous trouverez dans le panneau de configuration. 

Une fois ouvert, ajoutez une inteface de type IP-852 et définissez son nom, l'adresse IP de votre machine à utiliser et le port de votre machine à utiliser (pardéfaut 1628).

Une fois l'interface déclarée sur votre machine, ajoutez votre machine dans la Channel List du Config Server. Ensuite effectuez le test de communication pour valider la bonne communication entre eux.

Comment déclarer une interface USB de type U10/U20?

Dès qu'une interface de type U10/U20 est connectée à la machine, celle-ci apparaît dans LonWorks Interfaces si elle est correctement reconnue.

Pour raccorder votre PC à un réseau LonWorks IP, vous devez au préalable avoir déclarer une interface LonWorks IP sur votre machine.

Une fois déclarée, sélectionnez cette interface à l'ouverture du projet NL220. 

Une fois le projet ouvert, allez dans le SmartChannel pour vérifier sur quel canal de l'architecture, le PC est déclaré.

Pour changer le PC de canal, faites un clic-droit  sur le canal où mettre le PC, puis dans Avancé, choisissez "Déplacer le PC sur ce canal".

Ce problème peut survenir avec les versions NLopcOpen 1.2.0.3

Ce problème a été corrigé avec la version NLopcOpen_1_2_0_7 qui est téléchargeable à l'adresse suivante :

Nous mettons à disposition sur notre site la dernière version du serveur LNS.

Elle est disponible via le lien de téléchargement suivant: 

Dans ce cas, il peut y avoir un problème avec la compatibilité des services Bureau à distance de Windows Installer :

1. Cliquer sur Démarrage  (ou la touche windows + R)
2. Taper "gpedit.msc" and faire Entrée
3. Aller jusqu' à : Computer Configuration >> Administrative Templates >> Windows Components >> Remote Desktop Services >> Remote Desktop Session Host >> Application Compatibility 
4. Click droit de souris sur la ligne  "Eteindre compatibilité des services Bureau à distance de Windows Installer" et selectionner  "Editer depuis le menu déroulant.
5. Selectionner le bouton radio  'Activer'
6. Cliquer sur ok.
   
   

Après installation du logiciel, ce paramètre peut être remis à sa valeur d'origine .

Pour plus de renseignements :

https://echelon.force.com/support/s/article/IzoT-CT-or-IzoT-Net-Server-installer-never-seems-to-complete-KB1348

Ce problème peut arriver sous NL220 Open si la version de NLCSV utilisée est la même que pour NL220-TE.

Vous devez mettre à jour NLCSV pour que tous les outils fonctionnent correctement. 

La dernière version de NLCSV est disponible depuis le lien suivant: 

1 - Les outils - Files - Nextcloud (jffi.net)

Laissez l'erreur ouverte et avant de cliquer sur "Retry", effecutez la manipualtion suivante:

• Ouvrir le fichier ptserver400.cfg (C:\LonWorks\Bin ou C:\Program Files (x86)\LonWorks\Bin) avec un éditeur de texte ouvert en tant qu'Admin
• Ajouter la ligne suivante dans le section [servers\ptserver]
                                        service = 9001 / tcp
• Sauvegarder le fichier
• Cliquer sur "Retry" de la fenêtre d'erreur

L'installation doit se poursuivre normalement.

Hello,

You have to send the free key to fr-newron-credits@abb.com 

Best regards,

NL220 Open is asoftware key license attached to one machine. This refernce does not use NLCredits-Open. This kind of license is not compatible to virtual environment 

NL220-Pro-Open use NLCredits-Open. Includ NLCSV license to integrate a lot of equipment easily. The dongle can be used on each machine with OpenLNS server actived. You receive your dongle with 100 credits by default. It is compatible with VM. 

Please find attached the NLSuite Open Brochure 

Il est nécessaire que les 2 machines ait la même version du serveur LNS et une clé d’activation valide.  

Si la machine A héberge la base et la machine B y accède à distance :  

• Sur la machine A, démarrer OpenLNS Remote Server, sélectionner la base et son interface réseau.  
• Sur la machine B, dans NL220, sélectionner le mode Remote TCP/IP et indiquer l’adresse IP de la machine A et le nom de la base LNS.

Il y a 2 raisons possibles à ceci : 

1. Licence
   Le dongle est équipé d'un compteur de suppression incrémentiel. Cela signifie que tout décommissionnement de module est comptabilisé sur la licence.
   Ce compteur est fixé à 200 décommissionnements. 
   Une fois cette quantité atteinte, il faut envoyer un code de demande de remise à zéro (RAZ) à fr-newron-credits@abb.com.
   Pour se faire, il faut générer une demande de 0 crédit via l'outil NLCreditsGenerator qui se trouve dans le menu démarrer de Windows ou depuis les onglets licences dans NL220/NLFacilities. 
   Merci de motiver cette demande de RAZ qui est normalement marginale et ne pourra être reconduite à de multiples reprises consécutivement (le process de décommissionnement ne devant normalement intervenir que pour le test).
   Rappel : le remplacement d'équipements LonWorks doit se faire par l'opération 'Remplacer' et non pas en supprimant/recréant un nouveau noeud.
   Cette opération de remplacement n'est pas prise en compte par ce compteur de décommissionnement.
   
   
2. Intégrité de la base
   1. Si l'erreur remontée lors de la suppression d'un équipement dans la base de données est plus orientée projet (à contrario de licence), il est conseillé de vérifier et possiblement corriger l'intégrité de la base de données LNS en question.
   2. Pour se faire, Echelon met à disposition un outil de validation de base qui se trouve dans le menu démarrer de Windows, dans le sous menu 'Echelon LNS Utilities', qui s'appelle 'LNS Database Validation Tool'. 
   3. Lors de l'ouverture de celui-ci, veiller à ce que la base LNS ne soit pas accédée par un autre outil, e.g. NL220/NLFacilities.
   4. Choisir alors dans la liste déroulante la base LNS souhaitée et cocher, si désiré, l'option permettant à l'outil de tenter la réparation de la base. 
   5. Exécuter la validation.
   6. L'outil va alors analyser l'intégrité de la base et retourner les possibles erreurs trouvées et leur état de réparation.
   7. Si des erreurs ne peuvent pas être réparées, cela signifie que la base est corrompue. ABB/Newron n'a pas la capacité de fournir plus de support que ce que l'outil ne le permet à ce sujet. Deux options sont possibles : 
      • Envoyer la base en réparation auprès d'Echelon. Ceci a un coût et un délai. De plus, Echelon ne s'engage pas sur la réparation de la base mais sur la recherche de l'erreur et sa possible réparation. ABB/Newron peut faire l'intermédiaire auprès du support Echelon.
      • Restaurer une sauvegarde précédente du projet et vérifier son intégrité. Ceci peut entrainer une perte de synchronisation entre le contenu de la base de données et le réseau dans le cas où des modifications intermédiaires auraient été apportées. Il faudra donc refaire les modifications nécessaires dans la base afin de remettre le projet en accord avec l'état actuel du réseau

Il est possible que l'erreur "Erreur lors de l'extraction des fichiers de support" apparaîsse :

Pour la résoudre:

Supprimer le répertoire  C:\Program Files (x86)\InstallShield Installation Information\{2C8884F5-068A-11D6-9DBC-525405DE2F61}

Attention, ce répertoire est un répertoire système. S'il n'est pas visible dans votre explorateur de fichiers il vous faudra cocher l'option montrer les fichier/repertoire systemes ou cachés.

Il existe plusieurs références pour les dongles exploitants correspondant à différents droits. 

Les droits commun à toutes les références sont :

• Visualisation des plans
• Réparation des équipements et des zones
• Remplacement d'équipement
• Affichage des valeurs et controle/commande selon ce qui a été défini dans le Modeler

Toutes les références commence par NLFac-R, que ce soit un dongle TE, ou un dongle Open (NLFac-R-Open). Le R designe Runtime pour l'utilisation de NLFacilities RunTime.

Ensuite, nous avons un nombre (250, 500 ou UL). Cela correspond au nombre d'équipement maximum dans le projet NLFacilities:

• 250 pour 250 équipements au maximum
• 500 pour 500 équipements au maximum
• UL pour illimité, projet de plus de 500 équipements.

Les références terminant par "Z" donne les droits de recloisement à l'exploitant. Il peut donc agrandir, réduire, créer ou supprimer une zone.

Il existe une option supplémentaire que l'on peut ajouter sur un dongle exploitant : NLFac-R-Design. Cette option donne accès au mode NLFacilities Designer pour un exploitant. 

Attention : aucune option ne permet à un dongle Exploitant d'avoir accès à NLModeler.

NLFacilities Designer est l'outil d'intégration graphique permettant de créer/supprimer les plans, les objets et les zones. Cet outil doit être utilisé par l'intégrateur pour construire la base LNS du projet. L'outil nécessite la connaissance du protocole LonWorks.

Seuls les dongles intégrateurs permettent d'accéder à cet outil. Néanmoins, il est possible d'ajouter une option sur un dongle exploitant pour l'autoriser à accéder au mode Designer.

NLFacilities Runtime est l'outil d'exploitation du projet. Il y est possible de réparer des zones et des équipements, de remplacer des équipements, d'afficher des valeurs, de passer des commandes et, selon si l'option est active, de modifier les zones. Cet outil doit être utilisé par l'exploitant. Il n'est pas nécessaire de connaitre le protocole pour utiliser cet outil.

Les dongles intégrateur permettent d'accéder au mode Runtime afin d'en valider le fonctionnement, mais ceux-ci ne doivent pas rester sur site. L'exploitant doit utiliser un dongle Runtime (NLFac-R-xxx) pour accéder à NLFacilities Runtime.

Les fichiers backup de NLFacilities peuvent contenir:
   - La base de données Modeler
   - La base de données NLFacilities
   - Les bases de données Izot server (anciennement LNS)
   - Le projet doBUILD

Problème de taille de backup

Le problème le plus fréquent concerne la taille du fichier backup généré.
En premier lieu, un backup de plus d'1Gb nécessitera la version NLFacilities Open 5.8.0.18 minimum avec l'utilisation de la fonctionnalité Zip du backup.
Pour les versions antérieures,
1 - Vérifier la taille disque prise par les différentes entités et de supprimer tous les fichiers potentiellement inutiles au backup:
   - Les fichiers log(journal)
   - Les images wmf;jpg non utilisées par le projet
   - Les backup des stations du projet doBUILD (situé dans C:\NLFacPrj\<ProjectName>\AST\Stations Backups)
2 - Lors de la création du backup dans NLFacilities (Projet/Archiver...) désélectionner les options Base de données Modeler et Base de données LNS pour identifier quelle partie pose problème.

Problème de base de données verrouillée

Un autre problème possible est que le backup d'une base de données LNS ne peut se faire, à cause d'un fichier verouillé.
  - Arrêter toutes les applications et services qui utilisent Izot Net Server (anciennement LNS) dont NLFacilities
  - Vérifier dans les répertoires des bases de données LNS qu'il n'y ait pas de fichier en lecture seule
  - Redémarrer NLFacilities et utiliser directement la fonction Projet/Archiver... sans ouvrir de projet

1 - Vérifier que l'interface réseau sélectionnée est correcte

Pour cela, sélectionner le plan dans l'arbre des plans, cliquer droit et sélectionner l'option Propriétés.
Dans le champ Interface assurez-vous que la carte réseau sélectionnez est la bonne.
La valeur <Aucune> indique que le projet n'utilise pas d'interface réseau (toutes les modifications sont envoyées dans la base de données)
La valeur <Défaut> indique que le projet utilise la dernière niterface réseau utilisée
Tout autre valeur indique le nom de l'interface utilisée (dans ce cas assurez-vous que l'interface est bien disponible sur votre ordinateur) 

2 - Vérifier l'attachement au réseau
Pour envoyer les modifications au réseau NLFacilities doit être rattaché au réseau.
Une icône  est disponible dans la boite à outils et doit être enfoncée.
Dans le cas inverse, NLFacilities envoie les modifications uniquement dans la base de données. Il est nécessaire d'appuyer ultérieurement sur le bouton d'attachement au réseau pour réellement appliquer les modifications sur le bus.

3 - Appliquer les modifications
Si une modification n'a pas été envoyée sur le réseau, alors une icône Appliquer les modifications ( / )clignote dans NLFacilities.
En appuyant sur cette icône, NLFacilities va calculer les modifications et essayer de les appliquer.

4 - Les options de mise à jour réseau
En plus des éléments précédents, une liste d'options est utilisée par NLFacilities pour mettre à jour le réseau.
Ces options sont accessibles via Projet/Propriétés... onglet Mise à jour réseau.
Exemple : L'option "Toujours réparer les noeuds modifiés" permet par exemple d'effectuer une fonction LNS de réparation sur tous les modules impactés par une modification de zone. Cette option peut s'avérer utile pour certains types de contrôleur. 

Il n'est pas possible de modifier directement une base de données associée à un plan.
Néanmoins, il est possible de remplacer une base de données utilisée dans un projet NLFacilities par une autre.

NOTE : Cette opération peut s'avérer dangereuse et corrompre les données du projet NLFacilities. Elle ne doit être effectuée qu'en connaissance de cause.

Pour modifier les bases de données LNS d'un projet:
   - Ouvrir le projet NLFacilities
   - Fermer tout plan ouvert dans NLFacilities
   - Sélectionner l'option Projet/Changer les base de données... depuis le menu principal
   - Une fenêtre s'ouvre avec la liste des bases de données utilisées par le projet

   - Pour chaque base de données il est possible de définir une base de données cible qui remplacera la base de données source
   - Cliquer sur le bouton d'édition (...) en face de chacune des bases de données et sélectionner la base de données cible.

   - Cliquer sur OK pour valider la modification

Pour accéder au réseau NLFacilities utilise les cartes d'interface réseau LonWorks classique.

Ces cartes peuvent être IP (L-IP/Oxtopus,...) USB, PCI,...

Vérification de l'interface réseau utilisée par NLFacilities

Tout d'abord vérifier que l'interface réseau utilisée est correcte.
   - Cliquer droit sur le plan dans l'arbre des plans de NLFacilities
   - Sélectionner l'option Propriétés
   - Vérifier la valeur du champ Interface
         <Aucune> : Indique que l'application n'accède pas au réseau LonWorks
         <Défaut> : Indique que l'application utilise la dernière interface utilisée pour accéder au réseau
         Autres valeurs : Sélectionne spécifiquement une carte présente sur le réseau
   - Une fois l'interface sélectionnée, cliquer sur OK pour valider
Vérifier que vous pouvez lire les valeurs sur le réseau

Configuration de l'interface IP

Si votre carte d'interface est une carte IP (L-IP/Oxtopus) il est nécessaire de valider que votre ordinateur est correctement configuré dans le Configuration Server, et que la connexion se fait correctement.
Pour cela vous pouvez vous référez à la FAQ suivante : Comment déclarer une interface IP sur sa machine

Problème réseau

Si l'interface réseau est correctement configurée, il est possible que le problème soit dû à un problème réseau.
Pour diagnostiquer, il faut tout d'abord effectuer un Test sur les différents modules lus.
Pour cela, sélectionner l'objet sur le plan NLFacilities, cliquer droit et sélectionner l'option Outils réseau/Tester... cette opération va vérifier l'état de la communication et de l'adressage du module par rapport à ce qui est présent dans la base de données LNS.
Suivant le résultat du test il peut être nécessaire de réparer ou ré-adresser le module.

Les croix violettes indiquent un problème de communication entre NLFacilities et le réseau LonWorks.

Les premières vérifications à effectuer sont:

• Vérifier que depuis le PC vous pouvez pinger l'adresse du Configuration serveur.
  • Ouvrir une commande DOS (Windows+R --> cmd) et saisir "ping a.b.c.d" ou a.b.c.d est l'adresse IP fixe du configuration server
• Vérifier la connexion du PC au Configuration server
  • Pour cela, se connecter au Configuration Server et vérifier que l'adresse IP du PC est bien présente dans la channel list)
• Vérifier, avec NL220, l'état de tous les routeurs qui sont présents dans la base de données LNS en effectuant une opération de Test

L'outil Runtimes Site Generator Utility est installé en même temps que NL220 Open ou NLFacilities Open.
Si l'installation de l'un de ces outils a été exécutée sur la machine, RunTimes Site Generator a également été installé.

Runtimes Site Generator Utility est l'outil vous permettant d'ajouter des crédits Runtimes sur les dongles NL220 Pro Open, NLFacilities Open et NLFacilities Pro Open.

 Lien vers les dernières versions de NLFacilities

Un projet NLFacilities est une association de plusieurs bases de données différentes:

• Une base de données NLModeler (Définition des modèles de zones)
• Une base de données NLFacilities (Définition des plans/zones)
• Une ou plusieurs bases de données LNS (Bus de terrain)

Il n'y a de plus, aucun intérêt à séparer les différentes entités d'un projet NLFacilities.
En conséquence, une archive NLFacilities ne peut et ne doit se faire que via l'option archive de NLFacilities.
Cette option archivera l'ensemble des données constituant le projet.

A fin d'information, les emplacements par défaut des différentes entités sont :
- Les bases de données NLModeler sont par défaut stockées dans C:\NLModelerDbs\<DbName>
- Les bases de données NLFacilities sont par défaut stockées dans C:\NLFacPrj\<DbName>
- Les bases de données LNS sont par défaut stockées dans C:\NLPrj\<DbName>

Pour renommer une base LNS d'un projet NLFacilities existant, suivre la procédure suivante :

1. Faire une sauvegarde du projet sous NL220.
2. Créer un nouveau projet avec le nom voulu.
3. Restaurer le projet sauvegardé.
4. Dans NLFacilities, ouvrir le projet puis dans le menu projet sélectionner 'Changer les bases de données LNS' . Une popup apparaît qui vous permet de sélectionner la base renommée.

Cette erreur peut apparaitre lorsque vous tentez d'effectuer un backup d'un projet NLFacility très volumineux en .gz. 

Le format .gz ne supporte pas les projets trop volumineux. De ce cas, sélectionnez le format .zip pour effectuer votre backup. 

Cette erreur est lié à un problème d'installation du framework Microsoft.NET. 

Pour la résoudre : 

• Désinstaller NLFacilities, puis redémarrer la machine
• Dans les fonctionnalités Windows, désactiver .NET framework 3.5, puis redémarrer la machine 
  
• Réactiver la fonction .NET framework 3.5, puis redémarrer la machine 
• Réinstaller NLFacilities 

Cette erreur signifie que le serveur LNS ne peut pas communiquer avec le nœud.

Vous pouvez effectuer les vérifications suivantes :

• Effectuer un test de communication avec le module depuis NL220
• Vérifier la connexion au Configuration server
• Tester la communication avec chacun des routeurs IP du réseau
• Effectuer un test de communication direct avec NLUtil

Effectuer un test de communication avec le module

• Depuis NL220 effectuer une commande Test sur le module incriminé
  • Une erreur commune est par exemple que le module répond par son NeuronID et pas par son Subnet/Node (c'est-à-dire que le noeud a été "touché" depuis un outil extérieur et qu'il doit être réinstallé dans la base de données LNS)

Vérifier la connexion au configuration serveur

• Effectuer une commande ping aaa.bbb.ccc.ddd vers l'adresse du configuration server pour vérifier qu'il est accessible via le réseau IP
• Ouvrir le panneau de configuration windows sélectionner l'applicatif LonWorks interfaces et effectuer un Test sur l'interface réseau IP de votre PC

Tester la communication avec chacun des routeurs IP du réseau

• Effectuer une commande ping aaa.bbb.ccc.ddd vers l'adresse IP de chacun des routeurs LonWorks IP
• Depuis NL220 effectuer une commande Test sur chacun des routeurs

Ce message d'erreur signifie que l'accès aux fichiers de la base de données a été refusé par le système d'exploitation.
Lorsque le système d'exploitation est utilisé avec la sécurité de fichiers tels que Windows XP, Windows Vista ou 7, les autorisations d'accès doivent être accordées à des applications avec les outils appropriés du système: 

1. Vous devez donner à l'utilisateur un accès complet au dossier LonWorks, ainsi que le dossier de base de données et assurez-vous que ces dossiers ne soient pas en lecture seule.
   • Historiquement, la base de données se trouve par défaut dans le répertoire C:\NLprj\<nom du réseau>.
   • Recherchez le dossier contenant la base de données de réseau, cliquez-droit sur le dossier et sélectionnez Propriétés.
   • Ensuite, allez à l'onglet de sécurité, et ajouter ou modifier une entrée pour "Tout le monde" pour permettre l'accès « Modifier ».
2. Il pourrait également être intéressant d'essayer de lancer l'application NL220 en tant qu'administrateur.
   • Cliquez droit sur le fichier .exe et sélectionnez Exécuter en tant qu'administrateur.
   • Notez que ceci est différent d'être connecté en tant qu'administrateur.
3. Vous devez également vous assurez que OpenLNS est pas dans SingleUserMode.
   • Vous pouvez vérifier cela en exécutant l'application lnsobjectbrowser.exe (disponible depuis c:\lonworks\bin).
   • Une fois le logiciel ouvert, double-cliquez sur le noeud ObjectServer sur le volet de gauche.
   • Vous verrez une propriété appelée "SingleUserMode" dans le volet droit.
   • Cela devrait être défini sur False.
4. Il est arrivé dans le passé que des logiciels anti-virus incorrectement supprimés bloquent certains fichiers de base de données LNS (probablement des fichiers .dat, soit dans votre dossier de projet de base de données, soit dans le dossier LonWorks\ObjectServer\GlobalDb).
   Vérifiez le journal de l'anti-virus pour identifier un tel problème.
5. Si le dossier de la base de données LNS est un dossier partagé, vérifiez également qu'aucun autre utilisateur ne bloque certains fichiers.

Cela peut être dû à un conflit sur les ports 6001 ou 6002 (ports par défaut de LNS). Pour résoudre ce problème, vous pouvez changer les ports par défaut utilisés par LNS ou fermer l'application qui utilise un de ces ports.

Pour changer les ports par défaut de LNS, suivez la procédure suivante :

- Sous Windows, ouvrir le fichier "C:\Windows\System32\drivers\etc\services" avec un éditeur de texte démarré en tant qu'administrateur.
-Si vous avez  les entrées poet and _poet , changez les numéros de port  XXXX et YYYY en sachant que l'on doit avoir XXXX=YYYY + 1. Par exemple, les ports par défaut de LNS étant 6001 and 6002, si vous choisissez  XXXX=9001 alors  YYYY=9002. Pour connaître les ports utilisés, vous pouvez lancer la commande DOS netstat -a
- Si les entrées n'existent pas, ajouter alors les 2 lignes suivantes (9001 et 9002 ne doivent pas être utilisées) :

 poet 9001/tcp #FastObjects services
 _poet 9002/tcp #FastObjects services

- Sauvegarder le fichier et redémarrer l'ordinateur

 En OpenLNS, il peut être nécessaire d'effectuer en plus la procédure suivante :

-        Ouvrir le fichier ptserver400.cfg (C:\LonWorks\Bin) avec un éditeur de texte

-        Ajouter la ligne suivante dans le section [servers\ptserver]

service = 9001 / tcp

-        Sauvegarder le fichier

-        Rebooter la machine

Cela peut être dû à un conflit sur les ports 6001 ou 6002 (ports par défaut de LNS). Pour résoudre ce problème, vous pouvez changer les ports par défaut utilisés par LNS ou fermer l'application qui utilise un de ces ports.

Pour changer les ports par défaut de LNS, suivez la procédure suivante :

- Sous Windows, ouvrir le fichier "C:\Windows\System32\drivers\etc\services" avec un éditeur de texte démarré en tant qu'administrateur.
-Si vous avez  les entrées poet and _poet , changez les numéros de port  XXXX et YYYY en sachant que l'on doit avoir XXXX=YYYY + 1. Par exemple, les ports par défaut de LNS étant 6001 and 6002, si vous choisissez  XXXX=9001 alors  YYYY=9002. Pour connaître les ports utilisés, vous pouvez lancer la commande DOS netstat -a
- Si les entrées n'existent pas, ajouter alors les 2 lignes suivantes (9001 et 9002 ne doivent pas être utilisées) :

 poet 9001/tcp #FastObjects services
 _poet 9002/tcp #FastObjects services

- Sauvegarder le fichier et redémarrer l'ordinateur

 En OpenLNS, il peut être nécessaire d'effectuer en plus la procédure suivante :

-        Ouvrir le fichier ptserver400.cfg (C:\LonWorks\Bin) avec un éditeur de texte

-        Ajouter la ligne suivante dans le section [servers\ptserver]

service = 9001 / tcp

-        Sauvegarder le fichier

-        Rebooter la machine

Cette erreur correspond à une erreur d’interface réseau; elle indique que le driver d’interface n’a pas réussi à ouvrir l’interface réseau. Elle peut être liée au driver ou directement à l’interface.

• S'il s'agit d'une carte d'interface USB Echelon ou d'un routeur IP, effectuez le test de communication via LonWorks Interface du Panneau de Configuration.
  Il peut être intéressant de mettre à jour OpenLDV sur votre machine, vous pouvez télécharger la dernière version ici.
• S'il s'agit d'une carte d'interface USB Loytec, effectuez le test via LConfig et vérifiez que vos drivers sont bien à jour  
  Vous pouvez trouver la dernière version des drivers sur le site de Loytec.

Si vous obtenez cette erreur à l'ouverture de NLCreditsGenerator, supprimez le projet nommé "82807E44116C482". 
Pour cela, ouvrez NL220, dans le menu Projet, choisissez Supprimer, puis sélectionnez le projet à supprimer.
Une fois le projet supprimé, NLCreditsGenerator devrait s'ouvrir sans erreur.

Cette erreur apparait lorsqu'un objet demandé par nom ou par index est introuvable dans les bases de données. En règle générale, il s’agit d’une demande émanant d’un objet de la collection LNS portant un mauvais nom ou un mauvais index.

Il convient de noter que cette erreur peut également se produire dans certaines assignations implicites ; par exemple, si l'interface réseau à utiliser n'a pas été explicitement affectée à la propriété appropriée, LNS continuera à utiliser l'interface réseau précédemment affectée à la propriété ActiveRemoteNI ou NetworkInterface, respectivement.
Dans un tel scénario, cette exception peut se produire même si aucune affectation explicite n'a été effectuée, indiquant qu'une affectation implicite correspond à un objet non disponible.

Pour tenter de réparer cette erreur, la première chose à faire est une analyse et réparation de la base LNS:

Cette erreur peut se produire lorsque vous essayez de charger l'image d'application d'un noeud de la base en sélectionnant le fichier d'extension APB.

Une cause possible est que le fichier soir déjà ouvert par une autre application.

Pour contourner le problème, utilisez le fichier avec l'extension .NXE plutôt que celui qui a l'extension .ABP.

Cette erreur peut se produire en utilisant NL220, NL Facilities ou NL opc TE.

Si l'OS de la machine est Windows 10 ou plus récent, cette procédure ne s'applique pas. LNS-TE n'est pas garantie compatible avec les derniers OS. Dans ce cas, il faut passer en Open LNS.

Si vous utilisez Windows 7 ou inférieur, cette erreur correspond à une corruption de la licence LNS.

Si cette erreur survient, voici la marche à suivre:

• Ouvrir une fenêtre DOS
• Taper "checklic nsseng.exe" et appuyer sur entrée
• Faire un screenshot du résultat

Suivant le résultat de la commande, merci de suivre la procédure indiquée dans le document ci-joint.

• Puis, ouvrir LNS License Wizard (Démarrer-Programmes-Echelon LNS Utilities-LNS Server License Wizard)
• Faire un screenshot 
• Nous envoyer les deux screenshots à l'adresse du support fr-newron-support@abb.com, et la demande de crédits de remplacement si nécessaire.

Cette erreur indique une corruption de la base de données LNS. 

Si vous obtenez cette erreur uniquement lorsque vous ouvrez la base avec une interface réseau , vérifiez que l'interface réseau utilisée soit de même type que celle utilisée dans le projet; si vous utilisez une interface réseau différente, il se peut que les ressources ne soient pas suffisantes (par exemple, si vous utilisez une interface de type NSI au lieu de VNI).

Si vous obtenez cette erreur avec et sans interface, essayez de lancer une analyse de la base avec LNS database Validation tool. Il est possible que l'erreur apparaisse au moment de commencer l'analyse, dans ce cas, tentez la manipulation suivante:

Utiliser méthode Compact DB du LNS object browser (dans C:\LonWorks\bin)
-> Options -> Allow Modifications (ou F8)
-> Double clic sur ObjectServer
-> networks
-> choisir la DB
-> clic droit et compact DB

 Essayez de nouveau d'analyser la base avec l'outil de validation.

• Restaurer un backup plus ancien du projet qui ne contiendrait pas l'erreur.
• Envoyer la base à Echelon pour diagnostic/réparation. Cette réparation peut être facturée. Merci de nous contacter à fr-newron-support@abb.com si vous choisissez cette option.

Cette erreur apparaît quand la base de données LNS est corrompue.

 En premier lieu, vérifier la base de données en utilisant l'outil de validation de base LNS. Lancer l'analyse de la base avec LNS database Validation tool. Il est possible que l'erreur apparaisse au moment de commencer l'analyse, dans ce cas, tentez la manipulation suivante:

Utiliser méthode Compact DB du LNS object browser (dans C:\LonWorks\bin)
-> Options -> Allow Modifications (ou F8)
-> Double clic sur ObjectServer
-> networks
-> choisir la DB
-> clic droit et compact DB

 Essayez de nouveau d'analyser la base avec l'outil de validation.

• Restaurer un backup plus ancien du projet qui ne contiendrait pas l'erreur.
• Envoyer la base à Echelon pour diagnostic/réparation. Cette réparation peut être facturée. Merci de nous contacter à fr-newron-support@abb.com si vous choisissez cette option.

Cette erreur correspond à une erreur d'écriture. Elle peut apparaître si la communication est en acquittée et que le module (ou un des modules) sur lequel l'écriture a été envoyée n'a pas acquitté le message.

Pour éviter d'obtenir ce message d'erreur, vous pouvez  définir la transaction en non-acquittée et répétée dans le paramétrage de la connexion.

Toute fois, vérifier que l'écriture se fait correctement car il est possible que le problème soit lié au module récepteur.

Cette erreur signifie que vous tentez d'effectuer une opération nécessitant d'être connecté au réseau mais que le projet a été ouvert sans interface réseau.

Vérfiez que votre interface réseau est bien connectée et fonctionnelle, puis rouvrez le projet en sélectionnant l'interface réseau à utiliser.

Vous pouvez trouver comment déclarer une interface IP sur votre machine ici.

Cette erreur est obtenue lorsque vous tentez de restaurer ou d'ouvrir une base Open LNS (IzotNet Server) avec une version LNS-TE.

Open LNS (IzotNet Server) est une version plus récente du serveur LNS que LNS-TE. Il est possible de convertir une base de données LNS-TE en Open LNS (IzotNet Server), en revanche l'inverse n'est pas vrai. 

Pour ouvrir votre projet ou restaurer votre backup d'une base Open LNS, il est nécessaire de disposer d'une version de l'outil compatible avec cette version. 

Cette erreur apparaît lorsque la clé a été validée sur cette machine mais que les caractéristiques hardware de la machine ont été modifiées.

Cela peut arriver par exemple , si vous aviez un espace de stockage externe connecté à la machine (clé USB) et qu’il a été pris en compte dans l’ID de votre machine au moment de la validation de la clé ou encore si le BIOS de la machine a été mis à jour.

Dans ce cas,  il faut retourner la clé Open LNS sur le serveur Echelon, pour cela deux solutions possibles. Il est recommandé d’utiliser la fonction de retour (PC accessible) et non la fonction de récupération (PC non accessible) car, par clé, sont autorisés 10 déplacements et 5 récupérations.

Les deux solutions impliquent d’avoir créé ou de créer un compte Echelon depuis l’outil Echelon License Wizard.

1. Si le PC où la clé est enregistrée est accessible : 

Si vous avez la possibilité de remettre la machine dans le même état que lors de la validation, vous pouvez effectuer cette procédure. Par exemple dans le cas d'une validation avec une clé USB connectée en moment de la validation, reconnectez cette clé pour retourner la licence sur la serveur avant de la retirer pour réactiver la licence.

• Dans Echelon License Wizard sur le PC où la clé est enregistrée, sélectionnez « Manager product licenses »
• Dans la liste déroulante de la colonne Action, choisissez « Return » et continuez la procédure jusqu’au bout.
• Si la manipulation à bien fonctionner, vous aurez alors un message indiquant que la licence est bien retournée sur le serveur.

2. Récupérer une licence sur un PC inaccessible, depuis n’importe quel PC : 

• Cliquez sur "Show advanced tasks" afin de faire apparaitre des options supplémentaires
• Choisissez "Recover licenses on an inaccessible computer", puis cliquez sur "Next"

• Renseignez les identifiants de votre compte Echelon et cliquez sur "Next".
• Vous aurez alors un tableau comprenant la liste des licences liées à ce compte. Dans la liste déroulante de la première colonne, choisissez "Recover" à la ligne de la licence à récupérer, puis cliquez sur "Next".
• Si la manipulation à bien fonctionner, vous aurez alors un message indiquant que la licence est bien retournée sur le serveur. 

Une fois la licence retournée sur le serveur :

• Vous pourrez alors activer votre licence sur le PC de votre choix.

L’erreur NI #39 correspond à une erreur d’interface réseau. Elle indique que le driver d’interface n’a pas réussi à ouvrir l’interface réseau.
Elle peut être liée au driver ou directement à l’interface. 

Si cette erreur apparit à l'ouverture d'un projet, vérifiez que l'interface réseau sélectionnée est bien disponible.

Si cette erreur apparait à l'ouverture de NLCreditsGenerator, ouvrez NL220, dans le menu Projet, choisissez Supprimer, puis sélectionnez le projet à supprimer (il s'agit du projet nommé 82807E44116C482 ).
Une fois le projet supprimé, NLCreditsGenerator devrait s'ouvrir sans erreur.

Si, lors de la sychronisation entre le projet NLFac et doBUILD,  vous rencontrez des erreurs  de type "point <>non trouvé" ou modèle non-trouvé :

Merci de suivre les instructions suivantes :

• Ouvrez le Modeler du projet NLFacilities
• Pour chaque modèle de noeuds, faites un clic-droit -> Edit, puis cliquez sur "Ok"
• Enregistrez le Modeler 
• Rouvrez le projet NLFacilities
• Synchronisez de nouveau

L'erreur devrait être résolue, si ce n'est pas le cas, contactez le support technique. 

Ce problème est lié à une mise à jour récente de Edge. Il suffit d'activer une option dans le PC où est installé Edge pour résoudre le problème.

Dans le panneau de configuration, allez dans Options Internet.
Puis dans les propriétés avancées, activez l'option suivante :

Redémarrez Edge pour que la modification soit prise en compte.

Si vous obtenez l'erreur suivante en enregistrant un composant dans doDESIGN , merci de suivre la procéduire ci-dessous. 

• Télécharger et dézipper le répertoire "gacutil.zip" disponible sur cette page
• Démarrer une invit de commande en tant qu'administateur 
• Avec la commande "cd" suivi du chemin du répertoire, se placer dans le dossier
• Exécuter la commande suivante :  gacutil /i Microsoft.mshtml.dll