Installieren und AusführenAWS IoT Greengrassauf dem Core-Gerät

So installieren und AusführenAWS IoT Greengrass

1. FromAWS IoT GreengrassCore-Softwarein diesem Handbuch die DateiAWS IoT GreengrassCore-Software—Installationspaket Wählen Sie das Paket aus, das am besten zu CPU-Architektur, Verteilung und Betriebssystem Ihres Core-Geräts passt.

   • Laden Sie für Raspberry Pi das Paket für die Armv7l-Architektur und das Linux-Betriebssystem herunter.

   • Laden Sie für eine Amazon EC2 EC2-Instance das Paket für die x86_64-Architektur und das Linux-Betriebssystem herunter.

   • Laden Sie für NVIDIA Jetson TX2 das Paket für die Armv8 (AArch64) -Architektur und das Linux-Betriebssystem herunter.

   • Laden Sie für Intel Atom das Paket für die x86_64-Architektur und das Linux-Betriebssystem herunter.

2. In den vorherigen Schritten haben Sie fünf Dateien auf Ihren Computer heruntergeladen:

   • greengrass-OS-architecture-1.11.6.tar.gz— Diese komprimierte Datei enthältAWS IoT GreengrassCore-Software, die auf dem Core-Gerät ausgeführt wird.

   • certificateId-certificate.pem.crt— Die Gerätezertifikatdatei.

   • certificateId-public.pem.key— Die öffentliche Schlüsseldatei des Gerätezertifikats.

   • certificateId-private.pem.key— Die private Schlüsseldatei des Gerätezertifikats.

   • AmazonRootCA1.pem— Amazon-Stammzertifizierungsstelle (Certificate Authority, CA)

   In diesem Schritt übertragen Sie diese Dateien von Ihrem Computer auf Ihr Core-Gerät. Gehen Sie wie folgt vor:

   1. Wenn Sie die IP-Adresse Ihres Greengrass Core-Geräts nicht kennen, öffnen Sie ein Terminal auf dem Core-Gerät und führen den folgenden Befehl aus.

      Anmerkung

      Dieser Befehl gibt für einige Geräte möglicherweise nicht die richtige IP-Adresse zurück. Informationen zum Abrufen der IP-Adresse Ihres Geräts finden Sie in der Dokumentation.

      hostname -I

   2. Übertragen Sie diese Dateien von Ihrem Computer auf Ihr Core-Gerät. Die Schritte für die Dateiübertragung variieren je nach dem Betriebssystem Ihres Computers. Wählen Sie Ihr Betriebssystem für Schritte, die zeigen, wie Sie Dateien an Ihr Raspberry Pi-Gerät übertragen.

      Anmerkung

      Bei einem Rasberry PI lautet der Standardbenutzername pi und das Passwort ist raspberry.

      Bei einem NVIDIA Jetson TX2-Gerät lautet der Standardbenutzername nvidia und das Passwort ist nvidia.

      Windows

      Verwenden Sie zum Übertragen der komprimierten Dateien von Ihrem Computer zu einem Raspberry Pi-Core-Gerät ein Tool wie WinSCP oder den PuTTY-Befehl pscp. Für die Verwendung des pscp-Befehls öffnen Sie ein Eingabeaufforderungsfenster auf Ihrem Computer und führen die folgenden Schritte aus:

      cd path-to-downloaded-files
      pscp -pw Pi-password greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
      pscp -pw Pi-password certificateId-certificate.pem.crt pi@IP-address:/home/pi
      pscp -pw Pi-password certificateId-public.pem.key pi@IP-address:/home/pi
      pscp -pw Pi-password certificateId-private.pem.key pi@IP-address:/home/pi
      pscp -pw Pi-password AmazonRootCA1.pem pi@IP-address:/home/pi

      Anmerkung

      Die Versionsnummer in diesem Befehl muss mit der Version Ihres AWS IoT Greengrass-Core-Softwarepakets übereinstimmen.

      macOS

      Öffnen Sie zum Übertragen der komprimierten Dateien von Ihrem Mac auf ein Raspberry Pi-Core-Gerät ein Terminalfenster auf Ihrem Computer und führen Sie die folgenden Befehle aus. Diepath-to-downloaded-filesist in der Regel~/Downloadsaus.

      Anmerkung

      Sie werden möglicherweise aufgefordert, zwei Passwörter einzugeben. In diesem Fall gilt das erste Passwort für den sudo-Befehl des Mac, und das zweite ist das Passwort für den Raspberry Pi.

      cd path-to-downloaded-files
      scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
      scp certificateId-certificate.pem.crt pi@IP-address:/home/pi
      scp certificateId-public.pem.key pi@IP-address:/home/pi
      scp certificateId-private.pem.key pi@IP-address:/home/pi
      scp AmazonRootCA1.pem pi@IP-address:/home/pi

      Anmerkung

      Die Versionsnummer in diesem Befehl muss mit der Version Ihres AWS IoT Greengrass-Core-Softwarepakets übereinstimmen.

      UNIX-like system

      Öffnen Sie zum Übertragen der komprimierten Dateien von Ihrem Computer auf ein Raspberry Pi-Core-Gerät ein Terminalfenster auf Ihrem Computer und führen Sie die folgenden Befehle aus:

      cd path-to-downloaded-files
      scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
      scp certificateId-certificate.pem.crt pi@IP-address:/home/pi
      scp certificateId-public.pem.key pi@IP-address:/home/pi
      scp certificateId-private.pem.key pi@IP-address:/home/pi
      scp AmazonRootCA1.pem pi@IP-address:/home/pi

      Anmerkung

      Die Versionsnummer in diesem Befehl muss mit der Version Ihres AWS IoT Greengrass-Core-Softwarepakets übereinstimmen.

      Raspberry Pi web browser

      Wenn Sie den Webbrowser des Raspberry Pi zum Herunterladen der komprimierten Dateien verwendeten, sollten sich die Dateien in den von Pi befinden~/DownloadsOrdner, wie/home/pi/Downloadsaus. Andernfalls sollten sich die komprimierten Dateien in den Pi befinden~Ordner, wie/home/piaus.

3. Öffnen Sie auf dem Greengrass Core-Gerät ein Terminal und gehen zu dem Ordner mit dem VerzeichnisAWS IoT GreengrassKernsoftware und -zertifikate. Ersetzenpath-to-transferred-filesmit dem Pfad, in den Sie die Dateien auf das Core-Gerät übertragen haben. Führen Sie z. B. auf einem Raspberry Pi auscd /home/piaus.

   cd path-to-transferred-files

4. Extrahieren Sie dasAWS IoT GreengrassCore-Software auf dem Core-Gerät. Führen Sie den folgenden Befehl aus, um das Softwarearchiv, das Sie auf das Core-Gerät übertragen haben, zu entpacken. Dieser Befehl verwendet den-C /Argument zum Erstellen des/greengrassim Stammordner des Core-Geräts.

   sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C /

   Anmerkung

   Die Versionsnummer in diesem Befehl muss mit der Version Ihres AWS IoT Greengrass-Core-Softwarepakets übereinstimmen.

5. Verschieben Sie die Zertifikate und Schlüssel in dieAWS IoT GreengrassCore-Software Ordner. Führen Sie die folgenden Befehle aus, um einen Ordner für Zertifikate zu erstellen und die Zertifikate und Schlüssel dorthin zu verschieben. Ersetzenpath-to-transferred-filesmit dem Pfad, in den Sie die Dateien auf das Kerngerät übertragen haben, und ersetzen SiecertificateIdmit der Zertifikat-ID in den Dateinamen. Ersetzen Sie z. B. auf einem Raspberry Pipath-to-transferred-filesmit/home/pi

   sudo mv path-to-transferred-files/certificateId-certificate.pem.crt /greengrass/certs
   sudo mv path-to-transferred-files/certificateId-public.pem.key /greengrass/certs
   sudo mv path-to-transferred-files/certificateId-private.pem.key /greengrass/certs
   sudo mv path-to-transferred-files/AmazonRootCA1.pem /greengrass/certs

6. DieAWS IoT GreengrassDie Kernsoftware verwendet eine Konfigurationsdatei, die Parameter für die Software festlegt. Diese Konfigurationsdatei legt die Dateipfade für Zertifikatsdateien fest undAWS Cloudzu verwendende -Endpunkte. In diesem Schritt erstellen Sie das VerzeichnisAWS IoT GreengrassCore-Software-Konfigurationsdatei für Ihren Core. Gehen Sie wie folgt vor:

   1. Holen Sie sich den Amazon-Ressourcennamen (ARN) Ihres Core'sAWS IoTthing. Gehen Sie wie folgt vor:

      1. In derAWS IoTKonsole, unterVerwalten, unterGreengrass Geräte, wählenGruppen (V1)aus.

      2. Auf derGreengrass Gruppendie -Gruppe, die Sie vorher erstellt haben.

      3. UnderÜbersicht, wählenGreengrass-Kernaus.

      4. Kopieren Sie auf der Core-Detailseite die DateiAWS IoTARN des, und speichern Sie es zur Verwendung imAWS IoT GreengrassCore-Konfigurationsdatei.

   2. Get dasAWS IoTGerätedaten-Endpunkt für IhrAWS-Kontoin der aktuellen -Region. Geräte verwenden diesen Endpunkt, um eine Verbindung herzustellenAWSalsAWS IoTthings. Gehen Sie wie folgt vor:

      1. In derAWS IoTKonsole, wählenEinstellungenaus.

      2. UnderGerätedatenendpunktkopieren Sie das Verzeichnis-Endpunkt, und speichern Sie es zur Verwendung imAWS IoT GreengrassCore-Konfigurationsdatei.

   3. Erstellen derAWS IoT GreengrassKonfigurationsdatei für die Kernsoftware. Zum Beispiel können Sie den folgenden Befehl ausführen, um GNU nano zum Erstellen der Datei zu verwenden.

      sudo nano /greengrass/config/config.json

      Ersetzen Sie den Inhalt der Datei durch das folgende JSON-Dokument.

      {
        "coreThing" : {
          "caPath": "AmazonRootCA1.pem",
          "certPath": "certificateId-certificate.pem.crt",
          "keyPath": "certificateId-private.pem.key",
          "thingArn": "arn:aws:iot:region:account-id:thing/MyGreengrassV1Core",
          "iotHost": "device-data-prefix-ats.iot.region.amazonaws.com",
          "ggHost": "greengrass-ats.iot.region.amazonaws.com",
          "keepAlive": 600
        },
        "runtime": {
          "cgroup": {
            "useSystemd": "yes"
          }
        },
        "managedRespawn": false,
        "crypto": {
          "caPath": "file:///greengrass/certs/AmazonRootCA1.pem",
          "principals": {
            "SecretsManager": {
              "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key"
            },
            "IoTCertificate": {
              "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key",
              "certificatePath": "file:///greengrass/certs/certificateId-certificate.pem.crt"
            }
          }
        }
      }
      

      Führen Sie anschließend die folgenden Schritte aus:

      • Wenn Sie ein anderes Amazon-Root-CA-Zertifikat als Amazon Root CA 1 heruntergeladen haben, ersetzen Sie jede Instanz vonAmazonRootCA1.pemmit dem Namen der Amazon-Root-CA-Datei.

      • Ersetzen Sie jede Instanz voncertificateIdmit der Zertifikat-ID im Namen des Zertifikats und der Schlüsseldateien.

      • Ersetzenarn: aws:iot:Region:account-id:thing/MyGreengrassV1-Kernmit dem ARN Ihres Core, den Sie zuvor gespeichert haben.

      • ErsetzenMyGreengrassV1-Kernmit dem Namen Ihres Core's thing.

      • Ersetzendevice-data-prefix-ats---iot---region.amazonaws.com.rproxy.goskope.commit demAWS IoTGerätedatenendpunkt, den Sie zuvor gespeichert haben.

      • ErsetzenRegionmit IhremAWS-Regionaus.

      Weitere Informationen zu den Konfigurationsoptionen, die Sie in dieser Konfigurationsdatei angeben können, finden Sie unterAWS IoT Greengrass Core-Konfigurationsdateiaus.

7. Stellen Sie sicher, dass Ihr Core-Gerät mit dem Internet verbunden ist. Starten Sie anschließendAWS IoT Greengrassauf Ihrem Core-Gerät.

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

   Es sollte die Meldung Greengrass successfully started angezeigt werden. Notieren Sie sich die PID.

   Anmerkung

   Informationen zur Einrichtung Ihres Core-Geräts für die Ausführung von AWS IoT Greengrass beim Systemstart finden Sie unter Konfigurieren das Init-Systems zum Starten des Greengrass-Daemons.

   Sie können den folgenden Befehl ausführen, um den ordnungsgemäßen Betrieb der AWS IoT Greengrass Core-Software (Greengrass-Daemon) zu bestätigen. Ersetzten Sie PID-number durch Ihre PID:

   ps aux | grep PID-number

   Es sollte ein Eintrag für die PID mit einem Pfad zum laufenden Greengrass-Daemon angezeigt werden (z. B. /greengrass/ggc/packages/1.11.6/bin/daemon). Bei Problemen mit dem Starten von AWS IoT Greengrass vgl. Fehlerbehebung für AWS IoT Greengrass.