Instal AWS IoT Greengrass perangkat lunak Core

Untuk menghapus perangkat lunak AWS IoT Greengrass inti dan melestarikan informasi konfigurasi

• Jalankan perintah berikut untuk menghapus paket perangkat lunak AWS IoT Greengrass inti dan menyimpan informasi konfigurasi dalam /greengrass folder.

  sudo apt remove aws-iot-greengrass-core aws-iot-greengrass-keyring

Untuk menghapus perangkat lunak AWS IoT Greengrass inti dan menghapus informasi konfigurasi

1. Jalankan perintah berikut untuk menghapus paket perangkat lunak AWS IoT Greengrass inti dan menghapus informasi konfigurasi dari file/greengrass folder.

   sudo apt purge aws-iot-greengrass-core aws-iot-greengrass-keyring

2. Hapus repositori perangkat lunak AWS IoT Greengrass inti dari daftar sumber Anda. Untuk informasi selengkapnya, lihat Hapus sumber repositori perangkat lunak AWS IoT Greengrass inti.

Untuk menghapus repositori APT dari daftar sumber

• Jalankan perintah berikut untuk menghapus repositori perangkat lunak AWS IoT Greengrass inti dari daftar sumber.

  sudo rm /etc/apt/sources.list.d/greengrass.list
  sudo apt update

1. Instal core18 snap dengan menjalankan perintah berikut di terminal perangkat Anda:

   sudo snap install core18

   Snap core18 adalah snap dasar yang menyediakan lingkungan waktu aktif dengan perpustakaan umum yang digunakan. Snap ini dibangun dari LTS Ubuntu 18.04.

2. Upgrade snapd dengan menjalankan perintah berikut:

   sudo snap install --channel=edge snapd; sudo snap refresh --channel=edge snapd

3. Jalankan snap list perintah untuk memeriksa apakah Anda telah AWS IoT Greengrass menginstal snap.

   Contoh respons berikut menunjukkan bahwa snapd dipasang, tetapi aws-iot-greengrass bukan.

   Name              Version               Rev    Tracking         Publisher   Notes
   amazon-ssm-agent  3.0.161.0             2996   latest/stable/…  aws✓        classic
   core              16-2.48               10444  latest/stable    canonical✓  core
   core18            20200929              1932   latest/stable    canonical✓  base
   lxd               4.0.4                 18150  4.0/stable/…     canonical✓  -
   snapd             2.48+git548.g929ccfb  10526  latest/edge      canonical✓  snapd

4. Pilih salah satu opsi berikut untuk diinstal AWS IoT Greengrass snap 1.11.x.

   • Untuk instal AWS IoT Greengrass di Ubuntu, jalankan perintah berikut:

     sudo snap install aws-iot-greengrass

     Contoh respons:

     aws-iot-greengrass 1.11.5 from Amazon Web Services (aws) installed

   • Untuk bermigrasi dari versi sebelumnya ke v1.11.x atau update ke versi patch terbaru yang tersedia, jalankan perintah berikut:

     sudo snap refresh --channel=1.11.x aws-iot-greengrass

   Seperti snap lainnya, AWS IoT Greengrass snap menggunakan saluran untuk mengelola versi minor. Snap di-update secara otomatis ke versi terbaru saluran saat ini yang tersedia. Misalnya, jika Anda menentukan--channel=1.11.x, AWS IoT Greengrass snap Anda diperbarui ke v1.11.5.

   Anda dapat menjalankan snap info aws-iot-greengrass untuk mendapatkan daftar saluran yang tersedia untuk AWS IoT Greengrass.

   Contoh respons:

   name:      aws-iot-greengrass
   summary:   AWS supported software that extends cloud capabilities to local devices.
   publisher: Amazon Web Services (aws✓)
   store-url: https://snapcraft.io/aws-iot-greengrass
   contact:   https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass
   license:   Proprietary
   description: |
     AWS IoT Greengrass seamlessly extends AWS onto edge devices so they can act locally on the data
     they generate, while still using the cloud for management, analytics, and durable storage.
     AWS IoT Greenrgrass snap v1.11.0 enables you to run a limited version of AWS IoT Greengrass with
     all necessary dependencies in a containerized environment.
     The AWS IoT Greengrass snap doesn't support connectors and machine learning (ML) inference.
     By downloading this software you agree to the Greengrass Core Software License Agreement
     (https://s3-us-west-2.amazonaws.com/greengrass-release-license/greengrass-license-v1.pdf).
     For more information, see Run AWS IoT Greengrass in a snap
     (https://docs.aws.amazon.com/greengrass/latest/developerguide/install-ggc.html#gg-snap-support) in
     the AWS IoT Greengrass Developer.
     If you need help, try the AWS IoT Greengrass tag on AWS re:Post
     (https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass) or connect with an AWS IQ expert
     (https://iq.aws.amazon.com/services/aws/greengrass).
   snap-id: SRDuhPJGj4XPxFNNZQKOTvURAp0wxKnd
   channels:
     latest/stable:    1.11.3 2021-06-15 (59) 111MB -
     latest/candidate: 1.11.3 2021-06-14 (59) 111MB -
     latest/beta:      1.11.3 2021-06-14 (59) 111MB -
     latest/edge:      1.11.3 2021-06-14 (59) 111MB -
     1.11.x/stable:    1.11.3 2021-06-15 (59) 111MB -
     1.11.x/candidate: 1.11.3 2021-06-15 (59) 111MB -
     1.11.x/beta:      1.11.3 2021-06-15 (59) 111MB -
     1.11.x/edge:      1.11.3 2021-06-15 (59) 111MB -

5. Untuk mengakses sumber daya spesifik yang dibutuhkan fungsi Lambda Anda, Anda dapat terhubung ke antarmuka tambahan.

   Jalankan perintah berikut untuk mendapatkan daftar AWS IoT Greengrass antarmuka yang didukung snap:

   snap connections aws-iot-greengrass

   Contoh respons:

   Interface                Plug                                                Slot                 Notes
   camera                   aws-iot-greengrass:camera                           -                    -
   dvb                      aws-iot-greengrass:dvb                              -                    -
   gpio                     aws-iot-greengrass:gpio                             -                    -
   gpio-memory-control      aws-iot-greengrass:gpio-memory-control              -                    -
   greengrass-support       aws-iot-greengrass:greengrass-support-no-container  :greengrass-support  -
   hardware-observe         aws-iot-greengrass:hardware-observe                 :hardware-observe    manual
   hardware-random-control  aws-iot-greengrass:hardware-random-control          -                    -
   home                     aws-iot-greengrass:home-for-greengrassd             -                    -
   home                     aws-iot-greengrass:home-for-hooks                   :home                manual
   hugepages-control        aws-iot-greengrass:hugepages-control                :hugepages-control   manual
   i2c                      aws-iot-greengrass:i2c                              -                    -
   iio                      aws-iot-greengrass:iio                              -                    -
   joystick                 aws-iot-greengrass:joystick                         -                    -
   log-observe              aws-iot-greengrass:log-observe                      :log-observe         manual
   mount-observe            aws-iot-greengrass:mount-observe                    :mount-observe       manual
   network                  aws-iot-greengrass:network                          :network             -
   network-bind             aws-iot-greengrass:network-bind                     :network-bind        -
   network-control          aws-iot-greengrass:network-control                  :network-control     -
   opengl                   aws-iot-greengrass:opengl                           :opengl              -
   optical-drive            aws-iot-greengrass:optical-drive                    :optical-drive       -
   process-control          aws-iot-greengrass:process-control                  :process-control     -
   raw-usb                  aws-iot-greengrass:raw-usb                          -                    -
   removable-media          aws-iot-greengrass:removable-media                  -                    -
   serial-port              aws-iot-greengrass:serial-port                      -                    -
   spi                      aws-iot-greengrass:spi                              -                    -
   system-observe           aws-iot-greengrass:system-observe                   :system-observe      -

   Jika Anda melihat tanda hubung (-) di kolom Slot, antarmuka yang sesuai tidak terhubung.

6. Ikuti Menginstal perangkat lunak AWS IoT Greengrass Core untuk membuat AWS IoT sesuatu, grup Greengrass, sumber daya keamanan yang memungkinkan komunikasi aman AWS IoT dengan, dan AWS IoT Greengrass file konfigurasi perangkat lunak Core. File konfigurasi,config.json, berisi konfigurasi khusus untuk inti Greengrass Anda, seperti lokasi file sertifikat dan titik akhir data perangkat. AWS IoT

   catatan

   Jika Anda mengunduh file ke perangkat lain, ikuti langkah ini untuk mentransfer file ke perangkat AWS IoT Greengrass inti.

7. Untuk AWS IoT Greengrass snap, pastikan bahwa Anda meng-update file config.json, seperti yang ditunjukkan dalam berikut:

   • Ganti setiap instance CertificateID dengan ID sertifikat atas nama sertifikat dan file kunci.

   • Jika Anda mengunduh sertifikat CA root Amazon yang berbeda dari Amazon Root CA 1, ganti setiap instance AmazonRootCa1.PEM dengan nama file CA root Amazon.

   {
     ...
     "crypto" : {
       "principals" : {
         "SecretsManager" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.keyy"
         },
         "IoTCertificate" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.key",
           "certificatePath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-certificate.pem.crt"
         }
       },
       "caPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/AmazonRootCA1.pem"
     },
     "writeDirectory": "/var/snap/aws-iot-greengrass/current/ggc-write-directory",
     "pidFileDirectory": "/var/snap/aws-iot-greengrass/current/pidFileDirectory"
   }

8. Jalankan perintah berikut untuk menambahkan AWS IoT Greengrass sertifikat dan file konfigurasi:

   sudo snap set aws-iot-greengrass gg-certs=/home/ubuntu/my-certs

1. Jalankan perintah berikut untuk memulai AWS IoT Greengrass daemon:

   sudo snap start aws-iot-greengrass

   Contoh respons:

   Started.

   catatan

   Jika Anda mendapatkan kesalahan, Anda dapat menggunakan perintah snap run untuk pesan kesalahan terperinci. Untuk informasi pemecahan masalah selengkapnya, lihat error: tidak dapat melakukan tugas-tugas berikut: - Jalankan perintah layanan “start” untuk layanan ["greengrassd"] dari snap "aws-iot-greengrass" ([start snap. aws-iot-greengrass.greengrassd.service] gagal dengan status keluar 1: Job for snap. aws-iot-greengrass.greengrassd.service gagal karena proses kontrol keluar dengan kode kesalahan. Lihat “snap status systemctl. aws-iot-greengrass.greengrassd.service” dan “journalctl -xe” untuk detailnya.).

2. Jalankan perintah berikut untuk mengonfirmasi bahwa daemon sedang berjalan:

   snap services aws-iot-greengrass.greengrassd

   Contoh respons:

   Service                         Startup   Current  Notes
   aws-iot-greengrass.greengrassd  disabled  active   -

3. Ikuti Modul 3 (bagian 1): Lambda berfungsi pada AWS IoT Greengrass untuk membuat dan men-deploy fungsi Hello World Lambda. Namun, sebelum Anda men-deploy fungsi Lambda, selesaikan langkah berikutnya.

4. Pastikan bahwa fungsi Lambda Anda menjalankan sebagai pengguna snap_daemon dan dalam mode tanpa kontainer. Untuk update pengaturan grup Greengrass Anda, lakukan hal berikut di AWS IoT Greengrass konsol:

   1. Masuk ke AWS IoT Greengrass konsol.

   2. Di panel navigasi AWS IoT konsol, di bawah Kelola, perluas perangkat Greengrass, lalu pilih Grup (V1).

   3. Di bawah Grup Greengrass, pilih grup target.

   4. Pada halaman konfigurasi grup, di panel navigasi, pilih tab Fungsi Lambda.

   5. Di bawah lingkungan runtime fungsi Lambda default, pilih Edit, dan lakukan hal berikut:

      1. Untuk pengguna dan grup sistem default, pilih ID pengguna lain/ID grup, lalu masukkan 584788 untuk ID pengguna sistem (nomor) dan ID grup sistem (nomor).

      2. Untuk kontainerisasi fungsi Lambda Default, pilih Tanpa kontainer.

      3. Pilih Simpan.

Untuk mengarsip instalasi saat ini dan menginstal versi baru

1. Mengunduh AWS IoT Greengrass perangkat lunak Core paket instalasi yang ingin Anda tingkatkan.

2. Salin paket ke perangkat core tujuan. Untuk petunjuk yang menunjukkan bagaimana transfer file, lihat langkah ini.

   catatan

   Anda menyalin sertifikat Anda saat ini, kunci, dan file konfigurasi untuk instalasi baru nanti.

   Jalankan perintah dalam langkah-langkah berikut di terminal perangkat core Anda.

3. Pastikan bahwa Greengrass daemon dihentikan pada perangkat core.

   1. Untuk memeriksa apakah daemon sedang berjalan:

      ps aux | grep -E 'greengrass.*daemon'

      Jika output berisi root entri untuk /greengrass/ggc/packages/ggc-version/bin/daemon, maka daemon sedang berjalan.

      catatan

      Prosedur ini ditulis dengan asumsi bahwa AWS IoT Greengrass perangkat lunak Core diinstal di /greengrass direktori.

   2. Untuk menghentikan daemon:

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

4. Pindahkan direktori root Greengrass saat ini ke direktori yang berbeda.

   sudo mv /greengrass /greengrass_backup

5. Untar perangkat lunak baru pada perangkat core. Ganti arsitektur os dan versi placeholder dalam perintah.

   sudo tar –zxvf greengrass-os-architecture-version.tar.gz –C /

6. Salin sertifikat, kunci, dan file konfigurasi yang diarsipkan ke instalasi baru.

   sudo cp /greengrass_backup/certs/* /greengrass/certs
   sudo cp /greengrass_backup/config/* /greengrass/config

7. Mulai ulang daemon:

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

Untuk memulihkan instalasi yang diarsipkan

1. Hentikan daemon.

2. Hapus direktori /greengrass baru.

3. Pindahkan /greengrass_backup direktori kembali ke /greengrass.

4. Mulai daemon.