Domande frequenti sull'acceleratore di soluzioni di connected factory

  • Articolo

Vedere anche le domande frequenti generali sugli acceleratori di soluzioni IoT.

Dove è possibile visualizzare il codice sorgente per l'acceleratore di soluzioni?

Il codice sorgente è archiviato nel repository di GitHub seguente:

Che cos'è OPC UA?

OPC Unified Architecture (UA), rilasciato nel 2008, è uno standard di interoperabilità indipendente dalla piattaforma e orientato ai servizi. OPC UA viene anche usato da svariati sistemi e dispositivi di settore, ad esempio PC, PLC e sensori. OPC UA integra la funzionalità delle specifiche OPC Classic in un unico framework estendibile con sicurezza predefinita. È uno standard definito da OPC Foundation. OPC Foundation è un'organizzazione no profit che conta più di 440 membri. L'obiettivo dell'organizzazione è di usare le specifiche OPC per realizzare un'interoperabilità sicura e affidabile multifornitore e multipiattaforma tramite:

  • Infrastruttura
  • Specifiche
  • Tecnologia
  • Processi

Perché Microsoft ha scelto OPC UA per l'acceleratore di soluzioni di connected factory?

Microsoft ha scelto OPC UA perché è uno standard aperto, non proprietario, indipendente dalla piattaforma, riconosciuto nel settore e collaudato. È un requisito per le soluzioni basate sull'architettura di riferimento Industrie 4.0 (RAMI4.0) che assicurano l'interoperabilità tra un'ampia serie di processi e attrezzature di produzione. Microsoft assiste alla crescente richiesta da parte dei clienti di creare soluzioni conformi al piano Industria 4.0. Il supporto per OPC UA consente di agevolare i clienti nel raggiungimento degli obiettivi e offre immediatamente valore aggiunto.

Come è possibile aggiungere un indirizzo IP pubblico alla macchina virtuale di simulazione?

Sono disponibili due opzioni per aggiungere l'indirizzo IP:

  • Usare lo script di PowerShell Simulation/Factory/Add-SimulationPublicIp.ps1 nel repository. Passare il nome della distribuzione come parametro. Per una distribuzione locale, usare <your username>ConnFactoryLocal. Lo visualizza l'indirizzo IP della VM.

  • Nel portale di Azure individuare il gruppo di risorse della distribuzione. Fatta eccezione per una distribuzione locale, il gruppo di risorse ha il nome specificato come nome della soluzione o della distribuzione. Per una distribuzione locale che usa lo script di compilazione, il nome del gruppo di risorse è <your username>ConnFactoryLocal. Aggiungere ora una nuova risorsa Indirizzo IP pubblico al gruppo di risorse.

Nota

In entrambi i casi, assicurarsi di installare le patch più recenti seguendo le istruzioni del sito Web Ubuntu. Mantenere l'installazione aggiornata finché la VM è accessibile tramite un indirizzo IP pubblico.

Come è possibile rimuovere l'indirizzo IP pubblico alla macchina virtuale di simulazione?

Sono disponibili due opzioni per rimuovere l'indirizzo IP:

  • Usare lo script di PowerShell Simulation/Factory/Remove-SimulationPublicIp.ps1 del repository. Passare il nome della distribuzione come parametro. Per una distribuzione locale, usare <your username>ConnFactoryLocal. Lo visualizza l'indirizzo IP della VM.

  • Nel portale di Azure individuare il gruppo di risorse della distribuzione. Fatta eccezione per una distribuzione locale, il gruppo di risorse ha il nome specificato come nome della soluzione o della distribuzione. Per una distribuzione locale che usa lo script di compilazione, il nome del gruppo di risorse è <your username>ConnFactoryLocal. Rimuovere ora la risorsa Indirizzo IP pubblico dal gruppo di risorse.

Come è possibile accedere alla VM di simulazione?

L'accesso alla VM di simulazione è supportato solo se la soluzione è stata distribuita usando lo script di PowerShell build.ps1 nel repository.

Se la soluzione è stata distribuita da www.azureiotsolutions.com, non è possibile accedere alla macchina virtuale. perché la password viene generata in modo casuale e non è possibile reimpostarla.

  1. Aggiungere un indirizzo IP pubblico alla VM. Vedere Come è possibile aggiungere un indirizzo IP pubblico alla macchina virtuale di simulazione?
  2. Creare una sessione SSH per la macchina virtuale usando l'indirizzo IP della macchina virtuale.
  3. Il nome utente da usare è: docker.
  4. La password da usare dipende dalla versione usata per la distribuzione:
    • Per le soluzioni distribuite usando lo script build.ps1 prima dell'1 giugno 2017, la password è: Passw0rd.
    • Per le soluzioni distribuite usando lo script build.ps1 dopo l'1 giugno 2017, è possibile trovare la password nel file <name of your deployment>.config.user. La password viene archiviata nell'impostazione VmAdminPassword. La password viene generata in modo casuale in fase di distribuzione a meno che non la si specifichi usando il parametro -VmAdminPassword dello script build.ps1

Come è possibile arrestare e avviare tutti i processi docker nella VM di simulazione?

  1. Accedere alla VM di simulazione. Vedere Come è possibile accedere alla VM di simulazione?
  2. Per controllare quali sono i contenitori attivi, eseguire: docker ps.
  3. Per arrestare tutti i contenitori della simulazione, eseguire: ./stopsimulation.
  4. Per avviare tutti i contenitori della simulazione:

    • Esportare una variabile della shell con il nome IOTHUB_CONNECTIONSTRING. Usare il valore dell'impostazione IotHubOwnerConnectionString nel file <name of your deployment>.config.user. Ad esempio:

      export IOTHUB_CONNECTIONSTRING="HostName={yourdeployment}.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey={your key}"

    • Eseguire ./startsimulation.

Come è possibile aggiornare la simulazione nella VM?

Se sono state apportate modifiche alla simulazione, è possibile usare lo script di PowerShell build.ps1 nel repository eseguendo il comando updatedimulation. Questo script compila tutti i componenti della simulazione, arresta la simulazione nella VM, li carica, li installa e li avvia.

Come è possibile trovare la stringa di connessione dell'hub IoT usato dalla soluzione?

Se la soluzione è stata distribuita con lo script build.ps1 nel repository, la stringa di connessione è il valore di IotHubOwnerConnectionString nel file <name of your deployment>.config.user.

Per trovare la stringa di connessione, è anche possibile usare il portale di Azure. Nella risorsa Hub IoT del gruppo di risorse della distribuzione individuare le impostazioni della stringa di connessione.

Quali dispositivi dell'hub IoT usano la simulazione di Connected Factory?

La simulazione registra automaticamente i dispositivi seguenti:

  • 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

Con lo strumento Device Explorer o con l'estensione IoT dell'interfaccia della riga di comando di Azure è possibile controllare quali dispositivi sono registrati nell'hub IoT usato dalla soluzione. Per usare Device Explorer, è necessaria la stringa di connessione per l'hub IoT della distribuzione. Per usare l'estensione IoT dell'interfaccia della riga di comando di Azure, è necessario il nome dell'hub IoT.

Come è possibile ottenere i dati dei log dai componenti della simulazione?

Tutti i componenti della simulazione registrano informazioni nei file di log, disponibili nella cartella home/docker/Logs della VM. Per recuperare i log, è possibile usare lo script di PowerShell Simulation/Factory/Get-SimulationLogs.ps1 nel repository.

È necessario che questo script acceda alla VM. Potrebbe essere necessario specificare le credenziali per l'accesso. Vedere Come è possibile accedere alla VM di simulazione? per trovare le credenziali.

Lo script aggiunge/rimuove un indirizzo IP pubblico nella VM, se non ne è già presente uno che viene rimosso. Lo script inserisce tutti i file di log in un archivio che scarica nella workstation di sviluppo.

In alternativa, accedere alla VM tramite SSH ed esaminare i file di log in fase di esecuzione.

Come è possibile controllare se la simulazione sta inviando dati al cloud?

Con Azure IoT Explorer o il comando monitor-events dell'estensione dell'interfaccia della riga di comando di Azure IoT, è possibile esaminare i dati inviati a hub IoT da determinati dispositivi. Per usare questi strumenti, è necessario conoscere la stringa di connessione per l'hub IoT della distribuzione. Vedere Come è possibile trovare la stringa di connessione dell'hub IoT usato dalla soluzione?

Esaminare i dati inviati da uno dei dispositivi di pubblicazione:

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

Se non vengono visualizzati dati inviati all'hub IoT, si è verificato un problema con la simulazione. Come primo passaggio è consigliabile analizzare i file di log dei componenti della simulazione. Vedere Come è possibile ottenere i dati di log dai componenti di simulazione? Provare quindi ad arrestare e avviare la simulazione e, se non sono ancora presenti dati inviati, aggiornare completamente la simulazione. Vedere Come è possibile aggiornare la simulazione nella VM?

Come è possibile abilitare una mappa interattiva nella soluzione Connected Factory?

Per abilitare una mappa interattiva nella soluzione Connected Factory, è necessario avere un account Mappe di Azure.

Quando si esegue la distribuzione da www.azureiotsolutions.com, il processo di distribuzione aggiunge un account Mappe di Azure al gruppo di risorse che contiene i servizi dell'acceleratore di soluzione.

Quando si esegue la distribuzione usando lo script build.ps1 disponibile nel repository GitHub della soluzione Connected Factory, impostare la variabile di ambiente $env:MapApiQueryKey nella finestra di compilazione sulla chiave dell'account Mappe di Azure. La mappa interattiva viene quindi abilitata automaticamente.

È anche possibile aggiungere una chiave dell'account Mappe di Azure all'acceleratore di soluzione dopo la distribuzione. Passare al portale di Azure e accedere alla risorsa Servizio app nella distribuzione della soluzione Connected Factory. Passare a Impostazioni dell'applicazione, in cui si trova una sezione Impostazioni applicazione. Impostare MapApiQueryKey sulla chiave dell'account Mappe di Azure. Salvare le impostazioni e quindi passare a Panoramica e riavviare il servizio app.

Ricerca per categorie creare un account di Mappe di Azure?

Vedere Come gestire l'account e le chiavi di Mappe di Azure.

Come ottenere la chiave dell'account Mappe di Azure

Vedere Come gestire l'account e le chiavi di Mappe di Azure.

Come è possibile abilitare la mappa interattiva durante il debug in locale?

Per abilitare la mappa interattiva durante il debug in locale, impostare il valore di MapApiQueryKey nei file local.user.config e <yourdeploymentname>.user.config della radice della distribuzione sul valore di QueryKey copiato in precedenza.

Come è possibile impostare un'immagine diversa nella home page del dashboard?

Per cambiare l'immagine statica visualizzata nella home page del dashboard, sostituire l'immagine WebApp\Content\img\world.jpg e quindi ricompilare e ridistribuire l'app Web.

Come è possibile usare dispositivi non OPC UA con la soluzione Connected Factory?

Per inviare dati di telemetria da dispositivi non OPC UA alla soluzione Connected Factory:

  1. Configurare una nuova stazione nella topologia di Connected Factory nel file ContosoTopologyDescription.json.

  2. Inserire i dati di telemetria in formato JSON compatibile con la soluzione Connected Factory:

    [
  {
    "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>"
    }
  }
]

  3. Il formato di <timestamp> è: 2017-12-08T19:24:51.886753Z

  4. Riavviare il servizio app della soluzione Connected Factory.

Passaggi successivi

È anche possibile esplorare alcune altre funzionalità degli acceleratori di soluzioni IoT: