Instal dan jalankanAWS IoT Greengrasspada perangkat inti

Untuk menginstal dan menjalankanAWS IoT Greengrass

1. DariAWS IoT GreengrassPerangkat lunak intibagian dalam panduan ini, unduh bagian dalam panduan ini, unduhAWS IoT GreengrassPaket penginstalan perangkat lunak inti. Pilih paket yang paling sesuai dengan arsitektur CPU, distribusi, dan OS perangkat core Anda.

   • Untuk Raspberry Pi, unduh paket untuk arsitektur Armv7l dan sistem operasi Linux.

   • Untuk instans Amazon EC2, unduh paket untuk arsitektur x86_64 dan sistem operasi Linux.

   • Untuk NVIDIA Jetson TX2, unduh paket untuk arsitektur Armv8 (AArmv64) dan sistem operasi Linux.

   • Untuk Intel Atom, unduh paket untuk arsitektur x86_64 dan sistem operasi Linux.

2. Pada langkah sebelumnya, Anda mengunduh lima file ke komputer Anda:

   • greengrass-OS-architecture-1.11.6.tar.gz- File terkompresi ini berisiAWS IoT GreengrassPerangkat lunak inti yang berjalan pada perangkat inti.

   • certificateId-certificate.pem.crt- File sertifikat perangkat.

   • certificateId-public.pem.key- File kunci publik sertifikat perangkat.

   • certificateId-private.pem.key- File kunci privat sertifikat perangkat.

   • AmazonRootCA1.pem— File otoritas sertifikat root (CA).

   Pada langkah ini, Anda mentransfer file ini dari komputer Anda ke perangkat inti Anda. Lakukan hal berikut:

   1. Jika Anda tidak tahu alamat IP perangkat inti Greengrass Anda, buka terminal pada perangkat inti dan jalankan perintah berikut.

      catatan

      Perintah ini mungkin tidak mengembalikan alamat IP yang benar untuk beberapa perangkat. Konsultasikan dokumentasi untuk perangkat Anda untuk mengambil alamat IP perangkat Anda.

      hostname -I

   2. Transfer file ini dari komputer Anda ke perangkat inti Anda. Langkah transfer file bervariasi tergantung pada sistem operasi komputer Anda. Pilih sistem operasi Anda untuk langkah-langkah yang menunjukkan cara untuk mentransfer file ke perangkat Raspberry Pi Anda.

      catatan

      Untuk Raspberry Pi, nama pengguna default adalah pi dan kata sandi default-nya adalah raspberry.

      Untuk NVIDIA Jetson TX2, nama pengguna default adalah nvidia dan kata sandi default-nya adalah nvidia.

      Windows

      Untuk mentransfer file terkompresi dari komputer Anda ke perangkat core Raspberry Pi, gunakan alat seperti WinSCP atau PuTTY pscp perintah. Untuk menggunakan pscp perintah, buka jendela Command Prompt pada komputer Anda dan jalankan hal berikut:

      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

      catatan

      Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak Core AWS IoT Greengrass Anda.

      macOS

      Untuk mentransfer file terkompresi dari Mac Anda ke perangkat core Raspberry Pi, buka jendela Terminal pada komputer Anda dan jalankan perintah berikut. Parameterpath-to-downloaded-filesbiasanya adalah~/Downloads.

      catatan

      Anda mungkin diminta untuk memasukkan dua kata sandi. Jika demikian, kata sandi pertama adalah untuk sudo perintah Mac dan yang kedua adalah kata sandi untuk 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

      catatan

      Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak Core AWS IoT Greengrass Anda.

      UNIX-like system

      Untuk mentransfer file terkompresi dari komputer Anda ke perangkat core Raspberry Pi, buka jendela terminal pada komputer Anda dan jalankan perintah berikut:

      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

      catatan

      Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak Core AWS IoT Greengrass Anda.

      Raspberry Pi web browser

      Jika Anda menggunakan peramban web Raspberry Pi untuk mengunduh file terkompresi, file harus berada di file Pi~/Downloadsfolder, seperti/home/pi/Downloads. Jika tidak, file yang dikompresi harus ada di Pi~folder, seperti/home/pi.

3. Pada perangkat inti Greengrass, buka terminal, dan arahkan ke folder yang berisiAWS IoT GreengrassSertifikat dan perangkat lunak inti. Gantipath-to-transferred-filesdengan jalur tempat Anda mentransfer file pada perangkat inti. Sebagai contoh, pada Raspberry Pi, jalankancd /home/pi.

   cd path-to-transferred-files

4. Buka kemasan kemasanAWS IoT GreengrassPerangkat lunak inti pada perangkat inti. Jalankan perintah berikut untuk membongkar arsip perangkat lunak yang Anda transfer ke perangkat inti. Perintah ini menggunakan-C /argumen untuk membuat/greengrassfolder di folder root perangkat inti.

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

   catatan

   Nomor versi dalam perintah ini harus sesuai dengan versi paket perangkat lunak Core AWS IoT Greengrass Anda.

5. Pindahkan sertifikat dan kunci keAWS IoT GreengrassFolder perangkat lunak inti. Jalankan perintah berikut untuk membuat folder untuk sertifikat dan memindahkan sertifikat dan kunci untuk itu. Gantipath-to-transferred-filesdengan jalur di mana Anda mentransfer file pada perangkat inti, dan mengganticertificateIddengan ID sertifikat dalam nama file. Misalnya, pada Raspberry Pi, gantipath-to-transferred-filesbersama/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. ParameterAWS IoT GreengrassPerangkat lunak inti menggunakan file konfigurasi yang menentukan parameter untuk perangkat lunak. File konfigurasi ini menentukan path file untuk file sertifikat danAWS Cloudtitik akhir untuk digunakan. Pada langkah ini, Anda membuatAWS IoT GreengrassFile konfigurasi perangkat lunak inti untuk inti Anda. Lakukan hal berikut:

   1. Dapatkan Amazon Resource Name (ARN) untuk perangkat inti AndaAWS IoThal-hal. Lakukan hal berikut:

      1. DiAWS IoTkonsol, di bawahKelola, di bawahPerangkat Greengrass, pilihGrup (V1).

      2. PadaGrup Greengrasshalaman, pilih grup yang Anda buat sebelumnya.

      3. Di bawahIkhtisar, pilihCore Greengrass.

      4. Pada halaman detail inti, salinAWS IoThal ARN, dan simpan untuk digunakan diAWS IoT GreengrassFile konfigurasi core.

   2. DapatkanAWS IoTtitik akhir data perangkat untuk perangkatAkun AWSdi Wilayah saat ini. Perangkat menggunakan titik akhir ini untuk terhubung keAWSsebagaiAWS IoThal-hal. Lakukan hal berikut:

      1. DiAWS IoTkonsol, pilihPengaturan.

      2. Di bawahTitik akhir data perangkat, salinTitik akhir, dan simpan untuk digunakan diAWS IoT GreengrassFile konfigurasi core.

   3. BuatAWS IoT GreengrassFile konfigurasi perangkat lunak inti. Misalnya, Anda dapat menjalankan perintah berikut untuk menggunakan GNU nano untuk membuat file .

      sudo nano /greengrass/config/config.json

      Ganti isi file dengan dokumen JSON berikut.

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

      Kemudian, lakukan hal berikut:

      • Jika Anda mengunduh sertifikat CA root Amazon yang berbeda dari Amazon Root CA 1, ganti setiap instanceAmazonRootCa1.pemdengan nama file CA root Amazon.

      • Ganti setiap contohcertificateIddengan ID sertifikat atas nama sertifikat dan file kunci.

      • Gantiarn: aws:iot:daerah:account-id:hal/MyGreengrassV1Coredengan ARN hal inti Anda yang Anda simpan sebelumnya.

      • GantiMyGreengrassV1coreDengan nama hal-hal inti Anda.

      • Gantidevice-data-prefix-ats---iot---region.amazonaws.com.rproxy.goskope.comdenganAWS IoTendpoint data perangkat yang Anda simpan sebelumnya.

      • Gantidaerahdengan AndaWilayah AWS.

      Untuk informasi selengkapnya tentang opsi konfigurasi yang dapat Anda tentukan di file konfigurasi ini, lihatAWS IoT Greengrass file konfigurasi core.

7. Pastikan bahwa perangkat core Anda tersambung ke internet. Kemudian, mulaiAWS IoT Greengrasspada perangkat inti Anda.

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

   Anda akan melihat Greengrass successfully started pesan. Perhatikan PID.

   catatan

   Untuk menyiapkan perangkat core untuk memulai AWS IoT Greengrass pada system boot, lihat Konfigurasikan sistem init untuk memulai Greengrass daemon.

   Anda dapat menjalankan perintah berikut untuk mengonfirmasi bahwa AWS IoT Greengrass Perangkat lunak core (Greengrass daemon) berfungsi. Ganti Angka PID dengan PID Anda:

   ps aux | grep PID-number

   Anda akan melihat entri untuk PID dengan path ke Greengrass daemon yang sedang berjalan (sebagai contoh, /greengrass/ggc/packages/1.11.6/bin/daemon). Jika Anda mengalami masalah memulai AWS IoT Greengrass, lihat Pemecahan Masalah AWS IoT Greengrass.