Questions fréquentes sur l’accélérateur de solution d’usine connectée

Article
12/12/2017

Voir aussi les questions fréquentes (FAQ) d’ordre général sur les accélérateurs de solution IoT.

Où trouver le code source de l’accélérateur de solution ?

Le code source est stocké dans le dépôt GitHub suivant :

Accélérateur de solution Usine connectée

Qu’est-ce que l’UA OPC ?

OPC UA (Unified Architecture) est un standard d’interopérabilité indépendant de la plateforme et orienté services, qui date de 2008. OPC UA est utilisé par différents systèmes et dispositifs industriels tels que les PC industriels, les automates programmables industriels et les capteurs. OPC UA intègre les fonctionnalités des spécifications OPC Classic dans un seul et même framework extensible avec un dispositif de sécurité intégré. La fondation OPC Foundation est à l’origine de cette norme. OPC Foundation est une organisation à but non lucratif qui compte plus de 440 membres. L’objectif de cette organisation est d’utiliser les spécifications OPC de façon à favoriser une interopérabilité fiable et sécurisée entre les fabricants et les plateformes par les moyens suivants :

Infrastructure
Spécifications
Technology
Processus

Pourquoi le choix de Microsoft s’est-il porté sur OPC UA en matière d’accélérateur de solution d’usine connectée ?

Microsoft a choisi l’UA OPC, car il s’agit d’une norme ouverte, non propriétaire, ne dépendant pas d’une plateforme, reconnue par le secteur et éprouvée. Elle est exigée pour les solutions d’architecture de référence Industrie 4.0 (RAMI4.0) assurant l’interopérabilité entre un large ensemble de processus de fabrication et les équipements. Microsoft constate une demande de solutions Industrie 4.0 chez ses clients. La prise en charge de l’UA OPC permet de supprimer la barrière empêchant les clients d’atteindre leurs objectifs et leur apporte une valeur commerciale instantanée.

Comment ajouter une adresse IP publique à la machine virtuelle de simulation ?

Vous pouvez ajouter l’adresse IP de deux manières :

Utilisez le script PowerShell Simulation/Factory/Add-SimulationPublicIp.ps1 dans le dépôt. Passez le nom de votre déploiement en tant que paramètre. Pour un déploiement local, utilisez <your username>ConnFactoryLocal. Le script imprime l’adresse IP de la machine virtuelle.
Dans le portail Azure, recherchez le groupe de ressources de votre déploiement. À moins qu’il s’agisse d’un déploiement local, le groupe de ressources porte le nom que vous avez spécifié comme nom de solution ou de déploiement. Pour un déploiement local utilisant le script build, le nom du groupe de ressources est <your username>ConnFactoryLocal. À présent, ajoutez une nouvelle ressource Adresse IP publique au groupe de ressources.

Notes

Dans les deux cas, veillez à installer les derniers correctifs en suivant les instructions sur le site web Ubuntu. Tenez à jour l’installation aussi longtemps que votre machine virtuelle est accessible via une adresse IP publique.

Comment supprimer l’adresse IP publique de la machine virtuelle de simulation ?

Vous pouvez supprimer l’adresse IP de deux manières :

Utilisez le script PowerShell Simulation/Factory/Remove-SimulationPublicIp.ps1 du dépôt. Passez le nom de votre déploiement en tant que paramètre. Pour un déploiement local, utilisez <your username>ConnFactoryLocal. Le script imprime l’adresse IP de la machine virtuelle.
Dans le portail Azure, recherchez le groupe de ressources de votre déploiement. À moins qu’il s’agisse d’un déploiement local, le groupe de ressources porte le nom que vous avez spécifié comme nom de solution ou de déploiement. Pour un déploiement local utilisant le script build, le nom du groupe de ressources est <your username>ConnFactoryLocal. À présent, supprimez la ressource Adresse IP publique du groupe de ressources.

La connexion à la machine virtuelle de simulation n’est prise en charge que si vous avez déployé votre solution à l’aide du script PowerShell build.ps1 du dépôt.

Si vous avez déployé la solution à partir de www.azureiotsolutions.com, vous ne pouvez pas vous connecter à la machine virtuelle. En effet, le mot de passe est généré de façon aléatoire, donc vous ne pouvez pas le réinitialiser.

Ajoutez une adresse IP publique à la machine virtuelle. Consultez Comment ajouter une adresse IP publique à la machine virtuelle de simulation ?.
Créez une session SSH sur votre machine virtuelle en utilisant l’adresse IP de la machine virtuelle.
Le nom d’utilisateur à utiliser est docker.
Le mot de passe à utiliser dépend de la version que vous avez utilisée pour le déploiement :
- Pour les solutions déployées à l’aide du script build.ps1 avant le 1er juin 2017, le mot de passe est Passw0rd.
- Pour les solutions déployées à l’aide du script build.ps1 après le 1er juin 2017, le mot de passe est <name of your deployment>.config.user. Le mot de passe est stocké dans le paramètre VmAdminPassword. Le mot de passe est généré de façon aléatoire au moment du déploiement, sauf si vous le spécifiez à l’aide du paramètre -VmAdminPassword du script build.ps1.

Comment arrêter et démarrer tous les processus Docker dans la machine virtuelle de simulation ?

Connectez-vous à la machine virtuelle de simulation. Consultez Comment se connecter à la machine virtuelle de simulation ?.
Pour identifier les conteneurs actifs, exécutez docker ps.
Pour arrêter tous les conteneurs de simulation, exécutez ./stopsimulation.
Pour démarrer tous les conteneurs de simulation :
- Exportez une variable shell sous le nom IOTHUB_CONNECTIONSTRING. Utilisez la valeur du paramètre IotHubOwnerConnectionString du fichier <name of your deployment>.config.user. Par exemple :
```
export IOTHUB_CONNECTIONSTRING="HostName={yourdeployment}.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey={your key}"
```
- Exécutez ./startsimulation.

Comment mettre à jour la simulation dans la machine virtuelle ?

Si vous avez apporté des modifications à la simulation, vous pouvez utiliser le script PowerShell build.ps1 du dépôt en utilisant la commande updatedimulation. Ce script génère tous les composants de simulation, arrête la simulation dans la machine virtuelle, puis les charge, les installe et les démarre.

Comment identifier la chaîne de connexion du hub IoT utilisé par ma solution ?

Si vous avez déployé votre solution avec le script build.ps1 du dépôt, la chaîne de connexion est la valeur de IotHubOwnerConnectionString du fichier <name of your deployment>.config.user.

Vous pouvez aussi trouver la chaîne de connexion dans le portail Azure. Dans la ressource IoT Hub du groupe de ressources de votre déploiement, recherchez les paramètres de chaîne de connexion.

Quels sont les appareils IoT Hub utilisés par la simulation d’usine connectée ?

La simulation inscrit elle-même les appareils suivants :

proxy.beijing.corp.contoso
proxy.capetown.corp.contoso
proxy.mumbai.corp.contoso
proxy.munich0.corp.contoso
proxy.rio.corp.contoso
proxy.seattle.corp.contoso
publisher.beijing.corp.contoso
publisher.capetown.corp.contoso
publisher.mumbai.corp.contoso
publisher.munich0.corp.contoso
publisher.rio.corp.contoso
publisher.seattle.corp.contoso

À l’aide de l’outil DeviceExplorer ou de l’extension IoT pour Azure CLI, vous pouvez identifier les appareils inscrits auprès du hub IoT utilisé par votre solution. Pour utiliser l’explorateur d’appareils, vous avez besoin de la chaîne de connexion du hub IoT de votre déploiement. Pour utiliser l’extension IoT pour Azure CLI, vous avez besoin de votre nom d’IoT Hub.

Comment obtenir les données de journal des composants de simulation ?

Tous les composants de la simulation enregistrent des informations dans des fichiers journaux. Ces fichiers se trouvent dans la machine virtuelle dans le dossier home/docker/Logs. Pour récupérer les journaux d’activité, vous pouvez utiliser le script PowerShell Simulation/Factory/Get-SimulationLogs.ps1 du dépôt.

Ce script doit se connecter à la machine virtuelle. Vous serez peut-être amené à fournir des informations d’identification pour vous connecter. Pour savoir comment trouver les informations d’identification, consultez Comment se connecter à la machine virtuelle de simulation ?.

Le script ajoute une adresse IP publique à la machine virtuelle, si elle n’en dispose pas déjà d’une, puis la supprime. Le script place tous les fichiers journaux dans une archive et télécharge celle-ci sur votre station de travail de développement.

Vous pouvez aussi vous connecter à la machine virtuelle via SSH et inspecter les fichiers journaux au moment de l’exécution.

Comment vérifier si la simulation envoie des données vers le cloud ?

Avec l’Explorateur Azure IoT ou la commande d’extension CLI Azure IoT monitor-events, vous pouvez inspecter les données envoyées à IoT Hub à partir de certains appareils. Pour utiliser ces outils, vous devez connaître la chaîne de connexion du hub IoT de votre déploiement. Consultez Comment identifier la chaîne de connexion du hub IoT utilisé par ma solution ?.

Inspecter les données envoyées par l’un des appareils serveur de publication :

publisher.beijing.corp.contoso
publisher.capetown.corp.contoso
publisher.mumbai.corp.contoso
publisher.munich0.corp.contoso
publisher.rio.corp.contoso
publisher.seattle.corp.contoso

Si vous constatez qu’aucune donnée n’a été envoyée à IoT Hub, c’est qu’il y a un problème au niveau de la simulation. La première étape d’analyse que vous devez effectuer consiste à analyser les fichiers journaux des composants de simulation. Découvrez comment obtenir des données de journal à partir des composants de simulation ? Ensuite, essayez d’arrêter et de démarrer la simulation et, s’il n’y a toujours pas de données envoyées, mettez à jour complètement la simulation. Consultez Comment mettre à jour la simulation dans la machine virtuelle ?.

Comment activer une carte interactive dans ma solution d’usine connectée ?

Pour activer une carte interactive dans votre solution d’usine connectée, vous devez disposer d’un compte Azure Maps.

Lors du déploiement à partir de www.azureiotsolutions.com, le processus de déploiement ajoute un compte Azure Maps au groupe de ressources qui contient les services d’accélérateur de solution.

Quand vous procédez au déploiement à l’aide du script build.ps1 dans le dépôt GitHub d’usine connectée, affectez à la variable d’environnement $env:MapApiQueryKey dans la fenêtre de build la clé de votre compte Azure Maps. La carte interactive est ensuite automatiquement activée.

Vous pouvez également ajouter une clé de compte Azure Maps à votre accélérateur de solution après le déploiement. Accédez au portail Azure, puis à la ressource App Service dans le déploiement de votre solution d’usine connectée. Accédez aux Paramètres de l’application, où vous trouverez une section Paramètres de l’application. Affectez la valeur MapApiQueryKey à la clé de votre compte Azure Maps. Enregistrez les paramètres, puis accédez à la Vue d’ensemble et redémarrez App Service.

Comment créer un compte Azure Maps ?

Consultez Guide pratique sur la gestion de votre compte et de vos clés Azure Maps.

Comment obtenir votre clé de compte Azure Maps

Consultez Guide pratique sur la gestion de votre compte et de vos clés Azure Maps.

Comment activer la carte interactive pendant un débogage local ?

Pour activer la carte interactive pendant un débogage local, affectez la valeur de la QueryKey copiée précédemment au paramètre MapApiQueryKey dans les fichiers local.user.config et <yourdeploymentname>.user.config à la racine de votre déploiement.

Comment utiliser une autre image sur la page d’accueil du tableau de bord ?

Pour modifier l’image statique qui s’affiche sur la page d’accueil du tableau de bord, remplacez l’image WebApp\Content\img\world.jpg. Ensuite, régénérez et redéployez l’application WebApp.

Comment utiliser des appareils d’un autre type qu’OPC UA avec la solution d’usine connectée ?

Pour envoyer des données de télémétrie à la solution d’usine connectée à partir d’appareils d’un autre type qu’OPC UA :

Configurez une nouvelle station dans la topologie d’usine connectée dans le fichier ContosoTopologyDescription.json.

Ingérez les données de télémétrie dans un format JSON compatible avec la solution d’usine connectée :

[
  {
    "ApplicationUri": "<the_value_of_OpcUri_of_your_station",
    "DisplayName": "<name_of_the_datapoint>",
    "NodeId": "value_of_NodeId_of_your_datapoint_in_the_station",
    "Value": {
      "Value": <datapoint_value>,
      "SourceTimestamp": "<timestamp>"
    }
  }
]

Le format de <timestamp> est 2017-12-08T19:24:51.886753Z.
Redémarrez l’App Service d’usine connectée.

Étapes suivantes

Vous pouvez également explorer certaines des autres fonctionnalités des accélérateurs de solution IoT :