Dépannage - Metasys - LIT-12012115 - Server - Metasys UI - 10.1

Fiche technique de l’interface utilisateur Metasys

Product name
Metasys UI
Document type
Technical Bulletin
Document number
LIT-12012115
Version
10.1
Revision date
2019-10-14
Tableau 1. Dépannage

Erreur ou message d’erreur

Description et résolution

Après l’installation de l’IU Metasys ou de l’IU Metasys hors ligne, vous recevez l’erreur suivante en navigant vers le site :

HTTP Error 500.21 – Internal Server Error.

Handler “ExtensionlessUrlHandler-Integrated-4.0″ has a bad module “ManagedPipelineHandler” in its module list.

Le composant ASP.NET rencontre un problème d’enregistrement. Ce problème se produit quand le composant ASP.NET s’installe avant que le composant Gestionnaire des services Internet (IIS) ne soit installé et configuré correctement.

Pour résoudre ce problème :
  • Windows 10, Windows 8.1, Windows Server 2012 R2 et Windows Server 2012 :
    1. Cliquez avec le bouton droit sur Windows PowerShell et sélectionnez Exécuter comme administrateur.
    2. Saisissez la ligne suivante : Install-WindowsFeature Web-Asp-Net45.
    3. Appuyez sur Entrée.
  • Windows 7 (64 bits) et Windows Server 2008 R2 (64 bits) :
    1. Cliquez avec le bouton droit sur Invite de commande et sélectionnez Exécuter comme administrateur.
    2. Saisissez la ligne suivante : C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i.
      Remarque : Veillez à mettre « -i » à la fin de la ligne de commande.
    3. Appuyez sur Entrée.

Pour plus d’informations sur cette solution, allez à https://msdn.microsoft.com/en-us/library/k6h9cz8h%28v=vs.140%29.aspx.

Si cette solution ne résout pas l’erreur, envisagez la solution suivante.

Après l’installation de l’IU Metasys ou de l’IU Metasys hors ligne, vous recevez l’erreur suivante en navigant vers le site :

HTTP Error 500.21 – Internal Server Error.

Handler “ExtensionlessUrlHandler-Integrated-4.0″ has a bad module “ManagedPipelineHandler” in its module list.

Le Mode pipeline géré de l’UI_AppPool ou de l’UIOffline_AppPool est défini sur Classique au lieu de l’être sur Intégré.

Pour changer le réglage du Mode pipeline géré :
  1. Sur l’ADS/ADX ou l’ADS-Lite où l’IU Metasys est installée, sélectionnez Démarrer > Panneau de commande > Outils d’administration et double-cliquez sur Gestionnaire des services Internet (IIS).
  2. Dans le volet Connexions, développez Site web par défaut et sélectionnez UI ou UIOffline.
  3. Dans le volet Actions, cliquez sur Paramètres de base.
  4. La fenêtre Modifier les applications s’affiche. Vérifiez que le champ Pool d’applications est défini sur UI_AppPool. Cliquez sur OK.
  5. Dans le volet Connexions, sélectionnez Pools d’applications.
  6. Dans le Pool d’applications, sélectionnez UI_AppPool ou UIOffline_AppPool.
  7. Dans le volet Actions, sous Modifier le pool d’applications, cliquez sur Paramètres de base.
  8. La fenêtre Paramètres de base s’affiche. Dans le champ Mode pipeline géré, changez le mode de Classique à Intégré.
  9. Cliquez sur OK.

Pour plus d’informations sur la gestion de Request-Processing pour les pools d’applications, rendez-vous sur https://technet.microsoft.com/en-us/library/cc725564(v=ws.10).aspx.

Un problème requiert un recyclage du pool d’applications.

Please refresh your browser to check if Metasys is available.

Les exemples suivants sont relatifs à des problèmes qui requièrent un recyclage des pools d’applications :
  • Lorsqu’un utilisateur est connecté au SCT ou à l’IU Metasys hors ligne pendant des périodes prolongées sans que la session expire, l’IU Metasys hors ligne cesse de répondre et affiche le message Unexpected Error. Pour résoudre ce problème, recyclez les pools UIOffline_AppPool et MSEA_SCT_AppPool.
  • Quand vous travaillez avec Custom Symbols, après avoir importé le pack Custom Symbols, actualisez le navigateur (Ctrl + F5) ainsi que le Gestionnaire des services Internet (IIS) pour résoudre les problèmes de dictionnaire potentiels et assurer que l’animation et Custom Behavior fonctionnent correctement.
  • Recyclez le pool UI_AppPool pour voir les nouveaux programmes ajoutés dans SMP, les programmes supprimés de SMP ou les nouveaux programmes provenant de moteurs ajoutés récemment sur SMP.
  • Recyclez le pool UI_AppPool quand il manque l’image du diagramme Trend dans un rapport Trend.
Important : Lorsque vous recyclez un pool d’applications de l’IU Metasys ou de l’IU Metasys hors ligne, tous les utilisateurs connectés au site sont déconnectés. Lorsque vous recyclez un pool d’applications de l’IUMetasys, les utilisateurs peuvent perdre du travail, notamment l’ajout d’exceptions ou la modification de programmes dans le widget Schedules. Faites attention lorsque vous recyclez le pool d’applications.

Un problème requiert un recyclage du pool d’applications de l’IU Metasys.

Pour recycler le pool d’applications de l’IU Metasys :
  1. Sur le serveur sur lequel le logiciel de l’IU Metasys est installé, sélectionnez Panneau de configuration > Outils d’administration.
  2. Cliquez deux fois sur Gestionnaire des services Internet (IIS).
  3. Dans le volet Connexions, sélectionnez le serveur et cliquez sur Pools d’applications.
  4. Sur la page Pools d’applications, sélectionnez le pool UI_AppPool.
  5. Dans le volet Actions, cliquez sur Recycler, puis sur Oui.

Un problème requiert un recyclage du pool d’applications de l’IU Metasys hors ligne.

Pour recycler le pool d’applications de l’IU Metasys hors ligne :
  1. Sur le serveur ou l’ordinateur sur lequel le logiciel Metasys UI Offline est installé, sélectionnez Panneau de configuration > Outils d’administration.
  2. Cliquez deux fois sur Gestionnaire des services Internet (IIS).
  3. Dans le volet Connexions, sélectionnez le serveur et cliquez sur Pools d’applications.
  4. Sur la page Pools d’applications, sélectionnez le pool UIOffline_AppPool.
  5. Dans le volet Actions, cliquez sur Recycler, puis sur Oui.

Un problème requiert un recyclage du pool d’applications de SCT.

Pour recycler le pool d’applications de SCT :
  1. Sur le serveur ou l’ordinateur sur lequel le logiciel Metasys UI Offline est installé, sélectionnez Panneau de configuration > Outils d’administration.
  2. Cliquez deux fois sur Gestionnaire des services Internet (IIS).
  3. Dans le volet Connexions, sélectionnez le serveur et cliquez sur Pools d’applications.
  4. Sur la page Pools d’applications, sélectionnez le pool MSEA_SCT_AppPool.
  5. Dans le volet Actions, cliquez sur Recycler, puis sur Oui.
Lorsque vous essayez de visualiser un graphique Aliased, qui est un graphique associé à une définition d’équipement, dans le Metasys UI Graphics Manager, la Graphics List affiche une erreur Device Offline et l’aperçu du graphique ne se charge pas. Ce problème se produit quand un périphérique hors ligne a des points dans la définition d’équipement associée.

Pour résoudre ce problème, vérifiez que tous les périphériques associés à la définition d’équipement sont en ligne.

Pour pallier ce problème, créez et éditez les graphiques Aliased dans l’IU Metasys hors ligne.

Dans le widget Graphics, les graphiques Graphics+ n’affichent pas les liaisons par défaut dans le Room Control Module (RCM).

Ce problème se produit car le SMP (Site Management Portal) ne gère pas les données du RCM de la même façon que l’IU Metasys.

Pour résoudre ce problème :
  1. Ouvrez les graphiques Graphics+ dans le Graphic Generation Tool (GGT).
  2. Modifiez les liaisons du RCM. Lorsque vous modifiez les liaisons, vous pouvez simplement supprimer puis ressaisir les mêmes données de liaison.
  3. Enregistrez les graphiques Graphics+ sur l’hôte Metasys.

Lorsque vous afficherez par la suite le graphique Graphics+ dans le widget Graphics, les données du RCM devraient être indiquées correctement.

Si des données sont ajoutées à la base de données d’historique en utilisant Metasys Database Manager alors que l’IU Metasys est exécutée, le calcul des données de moyenne est faussé. La base de données de reporting utilisée par l’IU Metasys n’effectue pas la synchronisation pour les données entrées de cette manière, ce qui fait que les calculs de données de moyenne peuvent être inexacts.

N’ajoutez pas de données à la base de données d’historique en utilisant Metasys Database Manager pendant l’exécution de l’IU Metasys.

Si vous avez déjà ajouté des données à la base de données d’historique de cette manière, suivez la solution ci-dessous :
  1. Contactez votre représentant de l’assistance de Johnson Controls® pour obtenir des scripts qui résoudront ce problème.
  2. Désinstallez l’ADS/ADX/OAS.
  3. Effacez la base de données JCIReporting en utilisant les scripts de l’Étape 1.
  4. Réinstallez l’ADS/ADX/OAS.

Le widget Trend et la visionneuse Custom Trend n’affichent pas les données relatives à des périodes de temps dépassant 7 jours.

L’ads-user n’est pas mappé à la base de données JCIReportingDB.

Sur un OAS, ce problème peut également se produire en l’absence de licence pour la fonctionnalité Historical Data Add-On.

Pour résoudre ce problème, suivez les étapes ci-après sur l’ordinateur de la base de données :
  1. Dans SQL Server Management Studio, connectez-vous à l’ordinateur de la base de données.
  2. Dans l’Explorateur d’objets, développez Bases de données > JCIReportingDB.
  3. Développez Sécurité > Utilisateurs.
  4. Cliquez avec le bouton droit sur ads-user et sélectionnez Supprimer.
  5. Dans l’Explorateur d’objets, développez Sécurité > Connexions.
  6. Cliquez avec le bouton droit sur ads-user et sélectionnez Propriétés.
  7. Dans Propriétés, sélectionnez la page Mappage de l’utilisateur.
  8. Sélectionnez JCIReportingDB et sélectionnez le db_owner et les options relatives à l’appartenance au rôle pour la base de données publique.
  9. Redémarrez l’UI_AppPool ou redémarrez l’ADS/ADX/OAS.

Au moment de l’installation, la base de données JCIHistorianDB se synchronise avec la base de données JCIReportingDB. Cette synchronisation initiale peut prendre plusieurs heures. La synchronisation prend en moyenne une heure pour 5 à 10 Go. Pendant le déroulement de la synchronisation, le widget Trend de l’IU Metasys est disponible, mais les données de tendance historiques ne s’affichent pas tant que la synchronisation n’est pas terminée.

Sur les sites plus grands, les problèmes suivants peuvent être observés dans l’IU Metasys :
  • Vous pouvez voir des messages de déconnexion et de reconnexion.
  • Vous pouvez recevoir une erreur en donnant des commandes, les commandes risquent d’échouer ou leur envoi risque de prendre plus de 10 secondes.
  • Vous pouvez voir un message Network Error dans les widgets.
  • Vous pouvez observer des temps de chargement plus longs pour les tableaux de bord.

Ce problème peut être lié au fait que l’attribut Offline Detection Poll Rate de l’objet Site est défini sur Fast.

Sur les sites plus grands où les alarmes hors ligne et en ligne ne sont pas critiques, définissez l’attribut Offline Detection Poll Rate de l’objet Site sur Slow pour résoudre ces problèmes.

Lorsque vous mettez à niveau un site sans télécharger d’archive sur l’ADS, il n’y a pas de relations disponibles lorsque vous visualisez le widget Equipment Relationships pour un équipement dans l’arborescence Building Networks.

Pour afficher les relations pour un équipement, vous devez télécharger une archive sur l’ADS que vous visualisez avant de vous connecter à l’IU Metasys.

Remarque : Si vous ne téléchargez pas d’archive, un message d’erreur s’affiche quand vous visualisez le widget Equipment Relationships.

Aucun rapport CSV Trend n’est créé.

Le CSV builder a une mémoire limitée et ne peut pas gérer la génération d’un rapport relatif à la taille des données pour les points de données sélectionnés.

Pour générer un rapport, sélectionnez un moins grand nombre de points.

Le widget Detail, la boîte de dialogue Commanding ou d’autres widgets ne se chargent pas complètement, affichent des données partielles ou affichent Null comme valeur après l’installation du logiciel Metasys Server et pendant le démarrage initial de l’IU Metasys.

Laissez une à deux heures par groupe de 500 moteurs à l’archive en ligne pour rassembler et renseigner les attributs et les autres données affichées dans l’arborescence Building Network. Nous recommandons de ne pas accéder aux objets de l’arborescence Building Network et de ne pas afficher le widget Detail de l’objet pendant le démarrage initial et la synchronisation. De plus, ne donnez pas de commandes groupées par le biais de la fonctionnalité Advanced Search dans l’IU Metasys pendant le démarrage initial et la synchronisation.

Un point non valide bloque les abonnements d’autres points.

Lorsqu’un équipement qui avait des points liés dans un graphique est supprimé, les abonnements de ces points deviennent non valides, ce qui cause le blocage des abonnements d’autres points. Pour empêcher cela, supprimez le point qui est maintenant non valide de la liaison. L’équipement ne peut être supprimé qu’hors ligne via un téléchargement, tandis que les points peuvent être supprimés en ligne et hors ligne.

Les valeurs de texte des états des commandes affichées dans l’IU Metasys diffèrent des états de commande affichés dans SMP. Ce problème requiert une commande Sync Engine.
Les cas de figure suivants peuvent aussi requérir une commande Sync Engine :
  • les données sont modifiées directement depuis un moteur réseau et non pas depuis le Site Director ;
  • une extension est créée en ligne avec SMP ;
  • une découverte de points est exécutée sur un site actif dans SMP ;
  • après l’exécution d’un téléchargement sur OAS.

La commande Sync Engine vous permet de synchroniser les derniers attributs et informations disponibles sur un moteur réseau avec l’archive en ligne disponible sur le Site Director. La commande Sync Engine ne revient pas au même qu’une commande Archive ou qu’un téléchargement effectué sur SCT. Vous pouvez uniquement effectuer une commande Sync Engine sur un objet Engine dans l’IU Metasys. La commande propage les changements d’attributs des objets sur le système actif. Un téléchargement sur SCT propage les attributs des objets (et d’autres données) dans la base de données d’archives. Vous pouvez afficher la progression d’un téléchargement dans l’ActionQ dans SCT. Lorsque que vous émettez une commande Sync Engine, celle-ci est exécutée en arrière-plan et n’est pas surveillée par ActionQ. Un indicateur s’affiche cependant sur l’objet Site dans le SMP et l’IU Metasys lorsqu’une synchronisation des moteurs exécutée par une commande Sync Engine est en cours.

Pour émettre une commande Sync Engine, suivez les étapes ci-dessous :
  1. Dans l’IU Metasys, sélectionnez l’objet Engine dans l’arborescence Building Network.
  2. Appuyez ou cliquez sur l’état ou la valeur dans le widget Detail. La boîte de dialogue Command s’affiche.
  3. Dans le menu déroulant Command, sélectionnez Sync Engine.
  4. Appuyez ou cliquez sur Save.
Les points, contrôleur ou moteurs en ligne affichent l’état Remote Device Offline, Value Inaccessible ou Value Cannot be Read dans le widget Building Network, le widget Priority Array ou le widget Potential Problem Areas. Metasys UI 4.0 et les versions ultérieures ne peuvent pas lire les valeurs de moteurs de la version 3.0 ou de versions antérieures de Metasys. Cela signifie que les points, contrôleur ou moteurs en ligne associés à un moteur réseau de la version 3.0 ou d’une version antérieure peuvent se trouver à l’état Remote Device Offline, Value Inaccessible ou Value Cannot be Read .
Divers problèmes de téléchargement et de performances surviennent dans l’IU Metasys. Il est possible que trop d’espaces et équipements soient définis dans le système. Le logiciel vous permet de configurer un nombre illimité de bâtiments dans un objet Space parent générique, idem pour les étages d’un bâtiment et les pièces d’un étage. Vous pouvez aussi configurer des espaces au sein des pièces. La limite recommandée, toutefois, est de 20 000 espaces. Un nombre plus élevé cause des problèmes de téléchargement et de performances. La même limite, 20 000, s’applique à l’équipement.
Le Status Summary affiche des points d’interrogation (????) en mode en ligne. Les points du Status Summary ne sont pas résolus lorsque vous liez un espace générique sans filtre. Pour les points à résoudre dans la visionneuse, choisissez au moins un filtre (liaison), de sorte que le Status Summary puisse rechercher ce nom court dans tout l’équipement qui dessert l’espace.
Un point n’est pas résolu dans un graphique dans lequel vous voyez d’ailleurs des points d’interrogation. Les conditions suivantes peuvent empêcher des points de se résoudre :
  • Le moteur est soit hors ligne soit déconnecté depuis le serveur.
  • La définition de l’équipement est modifiée après avoir été mappée à un équipement et les points sont utilisés depuis cet équipement dans le graphique.
  • La définition de l’équipement est supprimée après avoir été mappée à un équipement et les points sont utilisés depuis cet équipement dans le graphique.
  • Les services Metasys se sont arrêtés.
  • Les points mappés sont supprimés depuis le moteur.
L’envoi par e-mail d’un rapport programmé échoue. Pour résoudre ce problème, effectuez les opérations préliminaires suivantes pour l’envoi des rapports :
  1. Configurez votre serveur de messagerie. Reportez-vous à la section Remote Notifications du document Metasys® UI Help (LIT-12011953) pour plus de détails.
  2. Configurez vos paramètres de messagerie électronique en utilisant la fonctionnalité Remote Notifications de l’IU Metasys pour ADS. Seuls les paramètres de messagerie électronique du type Simple Mail Transfer Protocol (SMTP) sont pris en charge pour la fonctionnalité Scheduled Report. Les paramètres de messagerie électronique du type POP Before SMTP ne sont pas pris en charge pour la fonctionnalité Scheduled Report.
  3. Si la taille de fichier du rapport généré dépasse la limite du serveur de messagerie électronique, qui est par défaut de 20 Mo, la génération du rapport réussit, mais l’envoi par e-mail du rapport programmé peut échouer.
Espace disque limité dû à une taille trop importante des fichiers journaux dans le dossier inetpub>Logs. La taille du dossier peut dépasser 50 Go à cause des fichiers journaux IIS, ce qui réduit l’espace disque disponible. L’emplacement de ces fichiers journaux ne dépend pas de Johnson Controls. Pour plus d’informations sur la suppression des vieux fichiers journaux avec un script, rendez-vous sur : https://docs.microsoft.com/en-us/iis/manage/provisioning-and-managing-iis/managing-iis-log-file-storage. Sur les sites Metasys plus importants, vous pouvez opter pour la création d’une tâche programmée pour supprimer les fichiers journaux au moyen d’un script. Pour plus d’informations sur la création de tâches programmées, rendez-vous sur : https://docs.microsoft.com/en-us/iis/manage/provisioning-and-managing-iis/managing-iis-log-file-storage#run-the-script-as-a-scheduled-task.
Certaines fonctionnalités de l’IU Metasys affichent des données limitées, voire pas de données du tout, sur un OAS.

En l’absence de licence pour la fonctionnalité supplémentaire Historical Data pour un OAS, les données sont limitées pour toutes les fonctionnalités qui référencent des données historiques. En plus de Trend, ces fonctionnalités incluent Potential Problem Areas, Advanced Search & Reporting (y compris Scheduled Reports), Equipment Activity et Alarm Manager/Monitor.

En l’absence de licence pour la fonctionnalité supplémentaire Potential Problem Areas pour un OAS, le widget Potential Problem Areas n’affiche aucune donnée. À la place, il affiche un message qui signale l’absence de licence pour la fonctionnalité.

En l’absence de licence pour la fonctionnalité supplémentaire Scheduled Reports pour un OAS, les utilisateurs peuvent télécharger et envoyer immédiatement des rapports depuis Advanced Search et Reporting, mais ils ne peuvent pas enregistrer, afficher ou modifier des rapports programmés ou des modèles. De plus, le processus permettant de générer et d’envoyer des rapport programmés existants ne fonctionnera pas.

Les options de commande ne s’affichent pas dans la boîte de dialogue Commanding de l’IU Metasys

Si la FQR d’un objet contient le symbole &, les options de commande ne s’affichent pas dans la boîte de dialogue Commanding de l’IU Metasys.

Pour résoudre ce problème, supprimez l’objet qui contient le symbole & dans SMP, puis ajoutez-le de nouveau dans SMP avec un nouveau nom. Veillez à télécharger les changements sur votre archive SCT. Il est possible que vous deviez lancer une commande de synchronisation des moteurs dans l’IU Metasys si les données ne sont pas synchronisées.