

Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Installation und Ausführung AWS IoT Greengrass auf dem Kerngerät


**Anmerkung**  
Dieses Tutorial enthält Anweisungen zum Ausführen der AWS IoT Greengrass Core-Software auf einem Raspberry Pi. Sie können jedoch jedes unterstützte Gerät verwenden.

In diesem Abschnitt konfigurieren, installieren und führen Sie die AWS IoT Greengrass Core-Software auf Ihrem Core-Gerät aus.

**Zur Installation und Ausführung AWS IoT Greengrass**

1. Laden Sie aus dem Abschnitt [AWS IoT Greengrass Core-Software](what-is-gg.md#gg-core-download-tab) in diesem Handbuch das AWS IoT Greengrass Core-Software-Installationspaket herunter. 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 EC2 Amazon-Instance das Paket für die x86\$164-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\$164-Architektur und das Linux-Betriebssystem herunter.

1. 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ält die AWS IoT Greengrass Core-Software, die auf dem Core-Gerät ausgeführt wird.
   + `certificateId-certificate.pem.crt`— Die Gerätezertifikatsdatei.
   + `certificateId-public.pem.key`— Die öffentliche Schlüsseldatei des Gerätezertifikats.
   + `certificateId-private.pem.key`— Die private Schlüsseldatei des Gerätezertifikats.
   + `AmazonRootCA1.pem`— Die Datei der Amazon Root Certificate Authority (CA).

   In diesem Schritt übertragen Sie diese Dateien von Ihrem Computer auf Ihr Kerngerä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 Sie 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
      ```

   1. <a name="transfer-files-to-device"></a>Übertragen Sie diese Dateien von Ihrem Computer auf Ihr Kerngerät. Die Schritte zur Dateiübertragung variieren je nach 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 lautet der Standardbenutzername **nvidia** und das Standardkennwort**nvidia**.

------
#### [ Windows ]

      Verwenden Sie zum Übertragen der komprimierten Dateien von Ihrem Computer zu einem Raspberry Pi-Core-Gerät ein Tool wie [WinSCP](https://winscp.net/eng/download.php) oder den [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)-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**  
<a name="use-correct-package-version"></a>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. Das *path-to-downloaded-files* ist in der Regel`~/Downloads`.

**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**  
<a name="use-correct-package-version"></a>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**  
<a name="use-correct-package-version"></a>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 verwendet haben, um die komprimierten Dateien herunterzuladen, sollten sich die Dateien im `~/Downloads` Ordner des Pi befinden, `/home/pi/Downloads` z. Andernfalls sollten sich die komprimierten Dateien im `~` Ordner des Pi befinden, `/home/pi` z.

------

1. Öffnen Sie auf dem Greengrass Core-Gerät ein Terminal und navigieren Sie zu dem Ordner, der die AWS IoT Greengrass Core-Software und die Zertifikate enthält. *path-to-transferred-files*Ersetzen Sie es durch den Pfad, in den Sie die Dateien auf das Kerngerät übertragen haben. Führen Sie beispielsweise auf einem Raspberry Pi aus`cd /home/pi`.

   ```
   cd path-to-transferred-files
   ```

1. Entpacken Sie die AWS IoT Greengrass Core-Software auf dem Core-Gerät. Führen Sie den folgenden Befehl aus, um das Softwarearchiv zu entpacken, das Sie auf das Kerngerät übertragen haben. Dieser Befehl verwendet das `-C /` Argument, um den `/greengrass` Ordner im Stammordner des Kerngeräts zu erstellen.

   ```
   sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C /
   ```
**Anmerkung**  
<a name="use-correct-package-version"></a>Die Versionsnummer in diesem Befehl muss mit der Version Ihres AWS IoT Greengrass Core-Softwarepakets übereinstimmen.

1. Verschieben Sie die Zertifikate und Schlüssel in den AWS IoT Greengrass Core-Softwareordner. Führen Sie die folgenden Befehle aus, um einen Ordner für Zertifikate zu erstellen und die Zertifikate und Schlüssel in diesen Ordner zu verschieben. *path-to-transferred-files*Ersetzen Sie es durch den Pfad, in den Sie die Dateien auf dem Kerngerät übertragen haben, und *certificateId* ersetzen Sie es durch die Zertifikat-ID in den Dateinamen. Ersetzen Sie beispielsweise auf einem Raspberry Pi *path-to-transferred-files* durch **/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
   ```

1. Die AWS IoT Greengrass Core-Software verwendet eine Konfigurationsdatei, die Parameter für die Software spezifiziert. Diese Konfigurationsdatei spezifiziert die Dateipfade für Zertifikatsdateien und die zu AWS Cloud verwendenden Endpunkte. In diesem Schritt erstellen Sie die AWS IoT Greengrass Core-Softwarekonfigurationsdatei für Ihren Core. Gehen Sie wie folgt vor:

   1. Holen Sie sich den Amazon Resource Name (ARN) für die AWS IoT Sache Ihres Kerns. Gehen Sie wie folgt vor:

      1. Wählen Sie in der [AWS IoT Konsole](https://console.aws.amazon.com/iot) unter **Verwalten** unter **Greengrass-Geräte** die Option **Gruppen (V1)** aus.

      1. Wählen Sie auf der **Greengrass-Gruppenseite** die Gruppe aus, die Sie zuvor erstellt haben.

      1. Wählen Sie unter **Übersicht** die Option **Greengrass Core** aus.

      1. Kopieren Sie auf der Seite mit den Kerndetails den **AWS IoT Ding-ARN** und speichern Sie ihn zur Verwendung in der AWS IoT Greengrass Core-Konfigurationsdatei.

   1. Ruft den AWS IoT Gerätedatenendpunkt für Sie AWS-Konto in der aktuellen Region ab. Geräte verwenden diesen Endpunkt, um eine Verbindung zu AWS externen Geräten AWS IoT herzustellen. Gehen Sie wie folgt vor:

      1. Wählen Sie in der [AWS IoT Konsole](https://console.aws.amazon.com/iot) **Einstellungen** aus.

      1. Kopieren Sie unter **Gerätedatenendpunkt** **den Endpunkt** und speichern Sie ihn zur Verwendung in der AWS IoT Greengrass Core-Konfigurationsdatei.

   1. Erstellen Sie die AWS IoT Greengrass Core-Software-Konfigurationsdatei. Sie können beispielsweise den folgenden Befehl ausführen, um die Datei mit GNU Nano zu erstellen.

      ```
      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 dann die folgenden Schritte aus:
      + Wenn Sie ein anderes Amazon-Root-CA-Zertifikat als Amazon Root CA 1 heruntergeladen haben, ersetzen Sie jede Instanz von *AmazonRootCA1.pem* durch den Namen der Amazon-Root-CA-Datei.
      + Ersetzen Sie jede Instanz von *certificateId* durch die Zertifikat-ID im Namen des Zertifikats und der Schlüsseldateien.
      + Ersetze es *arn:aws:iot:*region*:*account-id*:thing/MyGreengrassV1Core* durch den ARN des Dings deines Kerns, den du zuvor gespeichert hast.
      + Ersetze es *MyGreengrassV1core* durch den Namen des Dings deines Kerns.
      + *device-data-prefix-ats.iot.region.amazonaws.com*Ersetzen Sie es durch den AWS IoT Gerätedatenendpunkt, den Sie zuvor gespeichert haben.
      + Ersetzen Sie *region* durch Ihren AWS-Region.

      Weitere Informationen zu den Konfigurationsoptionen, die Sie in dieser Konfigurationsdatei angeben können, finden Sie unter[AWS IoT Greengrass Kernkonfigurationsdatei](gg-core.md#config-json).

1. Stellen Sie sicher, dass Ihr Core-Gerät mit dem Internet verbunden ist. Starten Sie dann AWS IoT Greengrass auf 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 dazu, wie Sie Ihr Core-Gerät so einrichten, dass es AWS IoT Greengrass beim Systemstart startet, finden Sie unter[Konfigurieren das Init-Systems zum Starten des Greengrass-Daemons](gg-core.md#start-on-boot).

   Sie können den folgenden Befehl ausführen, um zu überprüfen, ob die AWS IoT Greengrass Core-Software (Greengrass-Daemon) funktioniert. Ersetzen Sie es *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`). Falls beim Starten Probleme auftreten AWS IoT Greengrass, finden Sie weitere Informationen unter[Problembehebung AWS IoT Greengrass](gg-troubleshooting.md).