

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.

# Tutorial: Installation und Konfiguration des AWS IoT Device Clients
<a name="iot-dc-install-dc"></a>

Dieses Tutorial führt Sie durch die Installation und Konfiguration des AWS IoT Geräteclients und die Erstellung von AWS IoT Ressourcen, die Sie in dieser und anderen Demos verwenden werden.

**So beginnen Sie dieses Tutorial:**
+ Halten Sie Ihren lokalen Host-Computer und den Raspberry Pi aus [dem vorherigen Tutorial](iot-dc-prepare-device.md) bereit.

Dieses Tutorial kann bis zu 90 Minuten dauern.

**Wenn Sie mit diesem Thema fertig sind:**
+ Ihr IoT-Gerät kann in anderen AWS IoT Device Client-Demos verwendet werden.
+ Sie haben Ihr IoT-Gerät in AWS IoT Core bereitgestellt.
+ Sie haben den AWS IoT Geräteclient heruntergeladen und auf Ihrem Gerät installiert.
+ Sie haben ein Image der microSD-Karte Ihres Geräts gespeichert, das in nachfolgenden Tutorials verwendet werden kann.

**Erforderliche Ausstattung:**
+ Ihre lokale Entwicklungs- und Testumgebung aus [dem vorherigen Abschnitt](iot-dc-prepare-device-test.md)
+ Der Raspberry Pi, den Sie im [vorherigen Abschnitt](iot-dc-prepare-device-test.md) verwendet haben
+ Die microSD-Speicherkarte des Raspberry Pi, die Sie [im vorherigen Abschnitt](iot-dc-prepare-device-test.md) verwendet haben

**Topics**
+ [Laden Sie den AWS IoT Geräteclient herunter und speichern Sie ihn](iot-dc-install-download.md)
+ [Stellen Sie Ihren Raspberry Pi bereit in AWS IoT](iot-dc-install-provision.md)
+ [Konfigurieren Sie den AWS IoT Geräteclient, um die Konnektivität zu testen](iot-dc-install-configure.md)

# Laden Sie den AWS IoT Geräteclient herunter und speichern Sie ihn
<a name="iot-dc-install-download"></a>

Mit den Verfahren in diesem Abschnitt wird der AWS IoT Device Client heruntergeladen, kompiliert und auf Ihrem Raspberry Pi installiert. Nachdem Sie die Installation getestet haben, können Sie das Image der microSD-Karte des Raspberry Pi speichern, um es später zu verwenden, wenn Sie die Tutorials erneut ausprobieren möchten.

**Topics**
+ [Laden Sie den AWS IoT Geräteclient herunter und erstellen Sie ihn](#iot-dc-install-dc-download)
+ [Erstellen der in den Tutorials verwendeten Verzeichnisse](#iot-dc-install-dc-files)
+ [(Optional) Speichern des microSD-Karten-Images](#iot-dc-install-dc-save)

## Laden Sie den AWS IoT Geräteclient herunter und erstellen Sie ihn
<a name="iot-dc-install-dc-download"></a>

Mit diesem Verfahren wird der AWS IoT Device Client auf Ihrem Raspberry Pi installiert.

Führen Sie diese Befehle im Terminalfenster auf Ihrem lokalen Host-Computer aus, der mit Ihrem Raspberry Pi verbunden ist.

**Um den AWS IoT Device Client auf Ihrem Raspberry Pi zu installieren**

1. Geben Sie diese Befehle ein, um den AWS IoT Geräteclient herunterzuladen und auf Ihrem Raspberry Pi zu erstellen.

   ```
   cd ~
   git clone https://github.com/awslabs/aws-iot-device-client aws-iot-device-client
   mkdir ~/aws-iot-device-client/build && cd ~/aws-iot-device-client/build
   cmake ../
   ```

1. Führen Sie diesen Befehl aus, um den AWS IoT Geräteclient zu erstellen. Die Ausführung dieses Befehls kann bis zu 15 Minuten dauern.

   ```
   cmake --build . --target aws-iot-device-client
   ```

   Die Warnmeldungen, die beim Kompilieren des AWS IoT Geräteclients angezeigt werden, können ignoriert werden.

   Diese Tutorials wurden mit dem AWS IoT Device Client getestet**gcc**, auf dem der Device Client basiert, Version (Raspbian 10.2.1-6\$1rpi1) 10.2.1 20210110 auf der Version von Raspberry Pi OS (bullseye) auf, Version (Raspbian 8.3.0-6\$1rpi1) 8.3.0 auf **gcc** der Version des Raspberry Pi OS (Buster) vom 7. Mai 2021.

1. Nachdem AWS IoT der Geräteclient fertig gebaut wurde, testen Sie ihn, indem Sie diesen Befehl ausführen.

   ```
   ./aws-iot-device-client --help
   ```

Wenn Sie die Befehlszeilenhilfe für den AWS IoT Geräteclient sehen, wurde der AWS IoT Geräteclient erfolgreich erstellt und kann von Ihnen verwendet werden.

## Erstellen der in den Tutorials verwendeten Verzeichnisse
<a name="iot-dc-install-dc-files"></a>

Mit diesem Verfahren werden die Verzeichnisse auf dem Raspberry Pi erstellt, in denen die in den Tutorials in diesem Lernpfad verwendeten Dateien gespeichert werden.

**So erstellen Sie die in den Tutorials in diesem Lernpfad verwendeten Verzeichnisse:**

1. Führen Sie diese Befehle aus, um die erforderlichen Verzeichnisse zu erstellen.

   ```
   mkdir ~/dc-configs
   mkdir ~/policies
   mkdir ~/messages
   mkdir ~/certs/testconn
   mkdir ~/certs/pubsub
   mkdir ~/certs/jobs
   ```

1. Führen Sie diese Befehle aus, um die Berechtigungen für die neuen Verzeichnisse festzulegen.

   ```
   chmod 745 ~
   chmod 700 ~/certs/testconn
   chmod 700 ~/certs/pubsub
   chmod 700 ~/certs/jobs
   ```

Nachdem Sie diese Verzeichnisse erstellt und ihre Berechtigungen festgelegt haben, fahren Sie fort mit [(Optional) Speichern des microSD-Karten-Images](#iot-dc-install-dc-save).

## (Optional) Speichern des microSD-Karten-Images
<a name="iot-dc-install-dc-save"></a>

Zu diesem Zeitpunkt verfügt die microSD-Karte Ihres Raspberry Pi über ein aktualisiertes Betriebssystem, die grundlegende Anwendungssoftware und den AWS IoT Geräteclient. 

Wenn Sie diese Übungen und Tutorials erneut ausprobieren möchten, können Sie die vorherigen Verfahren überspringen, indem Sie das mit diesem Verfahren gespeicherte microSD-Karten-Image auf eine neue microSD-Karte schreiben und mit den Tutorials ab [Stellen Sie Ihren Raspberry Pi bereit in AWS IoT](iot-dc-install-provision.md) fortfahren.

**So speichern Sie das Image der microSD-Karte in einer Datei:**

Gehen Sie im Terminalfenster auf Ihrem lokalen Host-Computer, der mit Ihrem Raspberry Pi verbunden ist, folgendermaßen vor:

1. Vergewissern Sie sich, dass Ihre AWS-Konto Anmeldeinformationen nicht gespeichert wurden.

   1. Führen AWS Sie die Configure-App mit diesem Befehl aus:

      ```
      aws configure
      ```

   1. Wenn Ihre Anmeldeinformationen gespeichert wurden (also in der Eingabeaufforderung angezeigt werden), geben Sie die Zeichenfolge **XYXYXYXYX** ein, wenn Sie dazu aufgefordert werden, wie hier gezeigt. Lassen Sie den **Namen der Standardregion** und das **Standardausgabeformat** leer.

      ```
      AWS Access Key ID [****************YXYX]: XYXYXYXYX
      AWS Secret Access Key [****************YXYX]: XYXYXYXYX
      Default region name: 
      Default output format:
      ```

1. Geben Sie diesen Befehl ein, um den Raspberry Pi herunterzufahren.

   ```
   sudo shutdown -h 0
   ```

1. Nachdem der Raspberry Pi vollständig heruntergefahren ist, trennen Sie ihn von der Stromversorgung.

1. Entfernen Sie die microSD-Karte aus Ihrem Gerät.

1. Auf Ihrem lokalen Host-Computer: 

   1. Legen Sie die microSD-Karte ein.

   1. Speichern Sie das Image der microSD-Karte mithilfe des Imaging-Tools für die SD-Karte in eine Datei.

   1. Nachdem das Image der microSD-Karte gespeichert wurde, werfen Sie die Karte aus dem lokalen Host-Computer aus.

Sie können mit dieser microSD-Karte in [Stellen Sie Ihren Raspberry Pi bereit in AWS IoT](iot-dc-install-provision.md) fortfahren.

# Stellen Sie Ihren Raspberry Pi bereit in AWS IoT
<a name="iot-dc-install-provision"></a>

Die Verfahren in diesem Abschnitt beginnen mit dem gespeicherten microSD-Image, auf dem der AWS IoT Geräteclient installiert ist, AWS CLI und erstellen die AWS IoT Ressourcen und Gerätezertifikate, in AWS IoT denen Ihr Raspberry Pi bereitgestellt wird.

## Installieren der microSD-Karte in Ihrem Raspberry Pi
<a name="iot-dc-install-dc-restore"></a>

Dieses Verfahren installiert die microSD-Karte mit der erforderlichen Software, die auf den Raspberry Pi geladen und konfiguriert ist, und konfiguriert Ihre, AWS-Konto sodass Sie mit den Tutorials in diesem Lernpfad fortfahren können.

Verwenden Sie eine microSD-Karte aus [(Optional) Speichern des microSD-Karten-Images](iot-dc-install-download.md#iot-dc-install-dc-save) mit der erforderlichen Software für die Übungen und Tutorials in diesem Lernpfad.

**So installieren Sie die microSD-Karte in Ihrem Raspberry Pi:**

1. Trennen Sie den Raspberry Pi von der Stromversorgung und legen Sie die microSD-Karte in den Raspberry Pi ein.

1. Schließen Sie den Raspberry Pi an die Stromversorgung an.

1. Starten Sie nach etwa einer Minute auf dem lokalen Host-Computer die Terminalfenstersitzung neu und melden Sie sich beim Raspberry Pi an.

1. Auf Ihrem lokalen Host-Computer, im Terminalfenster und mit den Anmeldeinformationen **Zugriffsschlüssel-ID** und **Geheimer Zugriffsschlüssel** für Ihren Raspberry Pi:

   1. Führen Sie die AWS Configure-App mit diesem Befehl aus:

      ```
      aws configure
      ```

   1. Geben Sie Ihre AWS-Konto Anmeldeinformationen und Konfigurationsinformationen ein, wenn Sie dazu aufgefordert werden:

      ```
      AWS Access Key ID [****************YXYX]: your Access Key ID
      AWS Secret Access Key [****************YXYX]: your Secret Access Key
      Default region name [us-west-2]: your AWS-Region code
      Default output format [json]: json
      ```

Nachdem Sie Ihre AWS-Konto Anmeldeinformationen wiederhergestellt haben, können Sie fortfahren[Stellen Sie Ihr Gerät bereit in AWS IoT Core](#iot-dc-install-dc-provision).

## Stellen Sie Ihr Gerät bereit in AWS IoT Core
<a name="iot-dc-install-dc-provision"></a>

Mit den Verfahren in diesem Abschnitt werden die AWS IoT Ressourcen erstellt, in denen Ihr Raspberry Pi bereitgestellt wird AWS IoT. Bei der Erstellung dieser Ressourcen werden Sie aufgefordert, verschiedene Informationen aufzuzeichnen. Diese Informationen werden von der AWS IoT Geräteclient-Konfiguration im nächsten Verfahren verwendet.

Damit Ihr Raspberry Pi verwendet werden kann AWS IoT, muss er bereitgestellt werden. Bei der Bereitstellung werden die AWS IoT Ressourcen erstellt und konfiguriert, die zur Unterstützung Ihres Raspberry Pi als IoT-Gerät erforderlich sind.

Wenn Ihr Raspberry Pi eingeschaltet ist und neu gestartet wird, verbinden Sie das Terminalfenster auf Ihrem lokalen Host-Computer mit dem Raspberry Pi und führen Sie diese Verfahren durch.

**Topics**
+ [Erstellen und Herunterladen der Gerätezertifikatsdateien](#iot-dc-install-dc-provision-certs)
+ [Ressourcen erstellen AWS IoT](#iot-dc-install-dc-provision-resources)

### Erstellen und Herunterladen der Gerätezertifikatsdateien
<a name="iot-dc-install-dc-provision-certs"></a>

Mit diesem Verfahren werden die Gerätezertifikatsdateien für diese Demo erstellt.

**So erstellen Sie die Gerätezertifikatsdateien für Ihren Raspberry Pi und laden sie herunter:**

1. Geben Sie im Terminalfenster auf Ihrem lokalen Host-Computer diese Befehle ein, um die Gerätezertifikatsdateien für Ihr Gerät zu erstellen.

   ```
   mkdir ~/certs/testconn
   aws iot create-keys-and-certificate \
   --set-as-active \
   --certificate-pem-outfile "~/certs/testconn/device.pem.crt" \
   --public-key-outfile "~/certs/testconn/public.pem.key" \
   --private-key-outfile "~/certs/testconn/private.pem.key"
   ```

   Die Ausgabe des Befehls ähnelt der folgenden: Notieren Sie sich den `certificateArn`-Wert zur späteren Verwendung.

   ```
   {
       "certificateArn": "arn:aws:iot:us-west-2:57EXAMPLE833:cert/76e7e4edb3e52f52334be2f387a06145b2aa4c7fcd810f3aea2d92abc227d269",
       "certificateId": "76e7e4edb3e52f5233EXAMPLE7a06145b2aa4c7fcd810f3aea2d92abc227d269",
       "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCCAkGgAwIBAgI_SHORTENED_FOR_EXAMPLE_Lgn4jfgtS\n-----END CERTIFICATE-----\n",
       "keyPair": {
           "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BA_SHORTENED_FOR_EXAMPLE_ImwIDAQAB\n-----END PUBLIC KEY-----\n",
           "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQE_SHORTENED_FOR_EXAMPLE_T9RoDiukY\n-----END RSA PRIVATE KEY-----\n"
       }
   }
   ```

1. Geben Sie die folgenden Befehle ein, um die Berechtigungen für das Zertifikatsverzeichnis und seine Dateien festzulegen.

   ```
   chmod 745 ~
   chmod 700 ~/certs/testconn
   chmod 644 ~/certs/testconn/*
   chmod 600 ~/certs/testconn/private.pem.key
   ```

1. Führen Sie diesen Befehl aus, um die Berechtigungen für Ihre Zertifikatsverzeichnisse und -dateien zu überprüfen.

   ```
   ls -l ~/certs/testconn
   ```

   Der Befehl sollte ähnliche Werte wie die hier angezeigten ausgeben, mit der Ausnahme, dass Datum und Uhrzeit unterschiedlich sein werden.

   ```
   -rw-r--r-- 1 pi pi 1220 Oct 28 13:02 device.pem.crt
   -rw------- 1 pi pi 1675 Oct 28 13:02 private.pem.key
   -rw-r--r-- 1 pi pi  451 Oct 28 13:02 public.pem.key
   ```

Sie haben die Gerätezertifikatsdateien bereits auf Ihrem Raspberry Pi installiert und können mit [Ressourcen erstellen AWS IoT](#iot-dc-install-dc-provision-resources) fortfahren.

### Ressourcen erstellen AWS IoT
<a name="iot-dc-install-dc-provision-resources"></a>

Bei diesem Verfahren wird Ihr Gerät bereitgestellt, AWS IoT indem die Ressourcen erstellt werden, die Ihr Gerät für den Zugriff auf AWS IoT Funktionen und Dienste benötigt.

**Um Ihr Gerät bereitzustellen in AWS IoT**

1. Geben Sie im Terminalfenster auf Ihrem lokalen Host-Computer den folgenden Befehl ein, um die Adresse des Gerätedatenendpunkts für Ihr AWS-Konto abzurufen.

   ```
   aws iot describe-endpoint --endpoint-type IoT:Data-ATS
   ```

   Der Befehl aus den vorhergehenden Schritten gibt eine Antwort aus, die der folgenden ähnelt: Notieren Sie sich den `endpointAddress`-Wert zur späteren Verwendung.

   ```
   {
       "endpointAddress": "a3qjEXAMPLEffp-ats.iot.us-west-2.amazonaws.com"
   }
   ```

1. Geben Sie diesen Befehl ein, um eine AWS IoT Ding-Ressource für Ihren Raspberry Pi zu erstellen.

   ```
   aws iot create-thing --thing-name "DevCliTestThing"
   ```

   Wenn Ihre AWS IoT Ding-Ressource erstellt wurde, gibt der Befehl eine Antwort wie diese zurück.

   ```
   {
       "thingName": "DevCliTestThing",
       "thingArn": "arn:aws:iot:us-west-2:57EXAMPLE833:thing/DevCliTestThing",
       "thingId": "8ea78707-32c3-4f8a-9232-14bEXAMPLEfd"
   }
   ```

1. Im Terminalfenster:

   1. Öffnen Sie einen Texteditor, z. B. `nano`.

   1. Kopieren Sie dieses JSON-Richtliniendokument und fügen Sie es in Ihren geöffneten Texteditor ein.  
****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": [
                      "iot:Publish",
                      "iot:Subscribe",
                      "iot:Receive",
                      "iot:Connect"
                  ],
                  "Resource": [
                      "*"
                  ]
              }
          ]
      }
      ```
**Anmerkung**  
Dieses Richtliniendokument gewährt allen Ressourcen großzügig die Erlaubnis, Verbindungen herzustellen, zu empfangen, zu veröffentlichen und zu abonnieren. Normalerweise gewähren Richtlinien nur bestimmten Ressourcen die Erlaubnis, bestimmte Aktionen auszuführen. Beim ersten Test der Gerätekonnektivität wird diese zu allgemeine und großzügige Richtlinie jedoch verwendet, um die Wahrscheinlichkeit eines Zugriffsproblems während dieses Tests zu minimieren. In den nachfolgenden Tutorials werden enger abgegrenzte Richtliniendokumente verwendet, um bessere Verfahren für die Richtliniengestaltung zu demonstrieren.

   1. Speichern Sie die Datei als **\$1/policies/dev\$1cli\$1test\$1thing\$1policy.json** in Ihrem Texteditor. 

1. Führen Sie diesen Befehl aus, um das Richtliniendokument aus den vorherigen Schritten zum Erstellen einer AWS IoT Richtlinie zu verwenden.

   ```
   aws iot create-policy \
   --policy-name "DevCliTestThingPolicy" \
   --policy-document "file://~/policies/dev_cli_test_thing_policy.json"
   ```

   Wenn die Richtlinie erstellt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

   ```
   {
       "policyName": "DevCliTestThingPolicy",
       "policyArn": "arn:aws:iot:us-west-2:57EXAMPLE833:policy/DevCliTestThingPolicy",
       "policyDocument": "{\n    \"Version\": \"2012-10-17\",		 	 	 \n    \"Statement\": [\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"iot:Publish\",\n                \"iot:Subscribe\",\n                \"iot:Receive\",\n                \"iot:Connect\"\n            ],\n            \"Resource\": [\n                \"*\"\n            ]\n        }\n    ]\n}\n",
       "policyVersionId": "1"
   }
   ```

1. Führen Sie diesen Befehl aus, um die Richtlinie an das Gerätezertifikat anzufügen. Ersetzen Sie `certificateArn` durch den `certificateArn`-Wert, den Sie zuvor gespeichert haben.

   ```
   aws iot attach-policy \
   --policy-name "DevCliTestThingPolicy" \
   --target "certificateArn"
   ```

   Bei erfolgreicher Ausführung gibt dieser Befehl nichts zurück.

1. Führen Sie diesen Befehl aus, um das Gerätezertifikat an die AWS IoT Ding-Ressource anzuhängen. Ersetzen Sie `certificateArn` durch den `certificateArn`-Wert, den Sie zuvor gespeichert haben.

   ```
   aws iot attach-thing-principal \
   --thing-name "DevCliTestThing" \
   --principal "certificateArn"
   ```

   Bei erfolgreicher Ausführung gibt dieser Befehl nichts zurück.

Nachdem Sie Ihr Gerät erfolgreich bereitgestellt haben AWS IoT, können Sie damit fortfahren[Konfigurieren Sie den AWS IoT Geräteclient, um die Konnektivität zu testen](iot-dc-install-configure.md).

# Konfigurieren Sie den AWS IoT Geräteclient, um die Konnektivität zu testen
<a name="iot-dc-install-configure"></a>

Die Verfahren in diesem Abschnitt konfigurieren den AWS IoT Device Client so, dass er eine MQTT-Nachricht von Ihrem Raspberry Pi veröffentlicht.

**Topics**
+ [Erstellen der Konfigurationsdatei](#iot-dc-install-dc-configure-step1)
+ [Öffnen des MQTT-Testclients](#iot-dc-install-dc-configure-step2)
+ [Führen Sie den Geräteclient aus AWS IoT](#iot-dc-install-dc-configure-step3)

## Erstellen der Konfigurationsdatei
<a name="iot-dc-install-dc-configure-step1"></a>

Dieses Verfahren erstellt die Konfigurationsdatei zum Testen des AWS IoT Geräteclients.

**Um die Konfigurationsdatei zum Testen des AWS IoT Geräteclients zu erstellen**
+ Gehen Sie im Terminalfenster auf Ihrem lokalen Host-Computer, der mit Ihrem Raspberry Pi verbunden ist, folgendermaßen vor:

  1. Geben Sie diese Befehle ein, um ein Verzeichnis für die Konfigurationsdateien zu erstellen und die Berechtigungen für das Verzeichnis festzulegen:

     ```
     mkdir ~/dc-configs
     chmod 745 ~/dc-configs
     ```

  1. Öffnen Sie einen Texteditor, z. B. `nano`.

  1. Kopieren Sie dieses JSON-Dokument und fügen Sie es in Ihren geöffneten Texteditor ein.

     ```
     {
       "endpoint": "a3qEXAMPLEaffp-ats.iot.us-west-2.amazonaws.com",
       "cert": "~/certs/testconn/device.pem.crt",
       "key": "~/certs/testconn/private.pem.key",
       "root-ca": "~/certs/AmazonRootCA1.pem",
       "thing-name": "DevCliTestThing",
       "logging": {
         "enable-sdk-logging": true,
         "level": "DEBUG",
         "type": "STDOUT",
         "file": ""
       },
       "jobs": {
         "enabled": false,
         "handler-directory": ""
       },
       "tunneling": {
         "enabled": false
       },
       "device-defender": {
         "enabled": false,
         "interval": 300
       },
       "fleet-provisioning": {
         "enabled": false,
         "template-name": "",
         "template-parameters": "",
         "csr-file": "",
         "device-key": ""
       },
       "samples": {
         "pub-sub": {
           "enabled": true,
           "publish-topic": "test/dc/pubtopic",
           "publish-file": "",
           "subscribe-topic": "test/dc/subtopic",
           "subscribe-file": ""
         }
       },
       "config-shadow": {
         "enabled": false
       },
       "sample-shadow": {
         "enabled": false,
         "shadow-name": "",
         "shadow-input-file": "",
         "shadow-output-file": ""
       }
     }
     ```

  1. Ersetzen Sie den *endpoint* Wert durch den Gerätedatenendpunkt für Ihren AWS-Konto , den Sie in gefunden haben[Stellen Sie Ihr Gerät bereit in AWS IoT Core](iot-dc-install-provision.md#iot-dc-install-dc-provision).

  1. Speichern Sie die Datei als **\$1/dc-configs/dc-testconn-config.json** in Ihrem Texteditor.

  1. Führen Sie diesen Befehl aus, um die Berechtigungen für die neue Konfigurationsdatei festzulegen.

     ```
     chmod 644 ~/dc-configs/dc-testconn-config.json
     ```

Nachdem Sie die Datei gespeichert haben, können Sie mit [Öffnen des MQTT-Testclients](#iot-dc-install-dc-configure-step2) fortfahren.

## Öffnen des MQTT-Testclients
<a name="iot-dc-install-dc-configure-step2"></a>

Dieses Verfahren bereitet den **MQTT-Testclient** in der AWS IoT Konsole darauf vor, die MQTT-Nachricht zu abonnieren, die der AWS IoT Geräteclient veröffentlicht, wenn er ausgeführt wird.

**So bereiten Sie den **MQTT-Testclient** darauf vor, alle MQTT-Nachrichten zu abonnieren:**

1. Wählen Sie auf Ihrem lokalen Host-Computer in der [AWS IoT -Konsole](https://console.aws.amazon.com//iot/home#/test) **MQTT-Testclient** aus.

1. Geben Sie auf der Registerkarte **Thema abonnieren** unter **Themenfilter** **\$1** (ein einzelnes Rautenzeichen) ein und wählen Sie **Abonnieren** aus, um alle MQTT-Themen zu abonnieren.

1. Vergewissern Sie sich, dass Sie unter der Bezeichnung **Abonnements** **\$1** (ein einzelnes Pfundzeichen) sehen.

Lassen Sie das Fenster mit dem **MQTT-Testclient** geöffnet, während Sie mit [Führen Sie den Geräteclient aus AWS IoT](#iot-dc-install-dc-configure-step3) fortfahren.

## Führen Sie den Geräteclient aus AWS IoT
<a name="iot-dc-install-dc-configure-step3"></a>

Dieses Verfahren führt den AWS IoT Geräteclient so aus, dass er eine einzelne MQTT-Nachricht veröffentlicht, die der **MQTT-Testclient** empfängt und anzeigt.

**Um eine MQTT-Nachricht vom Device Client aus zu senden AWS IoT**

1. Stellen Sie sicher, dass sowohl das Terminalfenster, das mit Ihrem Raspberry Pi verbunden ist, als auch das Fenster mit dem **MQTT-Testclient** sichtbar sind, während Sie dieses Verfahren ausführen.

1. Geben Sie im Terminalfenster diese Befehle ein, um den AWS IoT Geräteclient mithilfe der in [Erstellen der Konfigurationsdatei](#iot-dc-install-dc-configure-step1) erstellten Konfigurationsdatei auszuführen.

   ```
   cd ~/aws-iot-device-client/build
   ./aws-iot-device-client --config-file ~/dc-configs/dc-testconn-config.json
   ```

   Im Terminalfenster zeigt der AWS IoT Geräteclient Informationsmeldungen und alle Fehler an, die bei der Ausführung auftreten.

   Wenn im Terminalfenster keine Fehler angezeigt werden, überprüfen Sie den **MQTT-Testclient**.

1. Im **MQTT-Testclient** finden Sie im Abonnementfenster die Nachricht *Hallo Welt\$1*, die an das `test/dc/pubtopic`-Nachrichtenthema gesendet wurde.

1. Wenn der AWS IoT Geräteclient keine Fehler anzeigt und Sie *Hello World\$1* sehen an die `test/dc/pubtopic` Nachricht im **MQTT-Testclient** gesendet, haben Sie eine erfolgreiche Verbindung nachgewiesen.

1. Geben Sie im Terminalfenster **^C** (Strg-C) ein, um den AWS IoT Geräteclient zu beenden.

Nachdem Sie nachgewiesen haben, dass der AWS IoT Device Client auf Ihrem Raspberry Pi korrekt läuft und mit ihm kommunizieren kann AWS IoT, können Sie mit dem fortfahren. [Tutorial: Demonstrieren Sie die MQTT-Nachrichtenkommunikation mit dem AWS IoT Device Client](iot-dc-testconn.md)