Instal perangkat lunak AWS IoT Greengrass Core dengan penyediaan sumber daya khusus

Instal runtime Java, yang dibutuhkan perangkat lunak AWS IoT Greengrass Core untuk dijalankan. Kami menyarankan Anda menggunakan Amazon Corretto atau JDK Buka versi dukungan jangka panjang. Versi 8 atau lebih tinggi diperlukan. Perintah berikut menunjukkan cara menginstal Buka JDK di perangkat Anda.

Ketika instalasi selesai, jalankan perintah berikut untuk memverifikasi bahwa Java berjalan pada perangkat Linux Anda.

java -version

Perintah mencetak versi Java yang berjalan pada perangkat. Misalnya, pada distribusi berbasis Debian, output mungkin terlihat mirip dengan sampel berikut.

openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

(Opsional) Buat pengguna dan grup sistem default yang menjalankan komponen pada perangkat. Anda juga dapat memilih untuk membiarkan penginstal perangkat lunak AWS IoT Greengrass Core membuat pengguna dan grup ini selama instalasi dengan argumen --component-default-user installer. Untuk informasi selengkapnya, lihat Argumen penginstal.

sudo useradd --system --create-home ggc_user
sudo groupadd --system ggc_group

Verifikasi bahwa pengguna yang menjalankan perangkat lunak AWS IoT Greengrass Core (biasanyaroot), memiliki izin untuk menjalankan sudo dengan pengguna dan grup apa pun.

1. Jalankan perintah berikut untuk membuka /etc/sudoers file.

   sudo visudo

2. Verifikasi bahwa izin untuk pengguna terlihat seperti contoh berikut.

   root    ALL=(ALL:ALL) ALL

(Opsional) Untuk menjalankan fungsi Lambda kontainer, Anda harus mengaktifkan cgroups v1, dan Anda harus mengaktifkan dan memasang memori dan perangkat cgroups. Jika Anda tidak berencana untuk menjalankan fungsi Lambda kontainer, Anda dapat melewati langkah ini.

Untuk mengaktifkan opsi cgroups ini, boot perangkat dengan parameter kernel Linux berikut.

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

Untuk informasi tentang melihat dan menyetel parameter kernel untuk perangkat Anda, lihat dokumentasi untuk sistem operasi dan boot loader Anda. Ikuti instruksi untuk mengatur parameter kernel secara permanen.

Instal semua dependensi lain yang diperlukan pada perangkat Anda seperti yang ditunjukkan oleh daftar persyaratan di. Persyaratan perangkat

Instal runtime Java, yang dibutuhkan perangkat lunak AWS IoT Greengrass Core untuk dijalankan. Kami menyarankan Anda menggunakan Amazon Corretto atau JDK Buka versi dukungan jangka panjang. Versi 8 atau lebih tinggi diperlukan.

Periksa apakah Java tersedia pada variabel PATHsistem, dan tambahkan jika tidak. LocalSystem Akun menjalankan perangkat lunak AWS IoT Greengrass Core, jadi Anda harus menambahkan Java ke variabel PATH sistem alih-alih variabel PATH pengguna untuk pengguna Anda. Lakukan hal-hal berikut:

1. Tekan tombol Windows untuk membuka menu mulai.

2. Ketik environment variables untuk mencari opsi sistem dari menu mulai.

3. Di hasil pencarian menu mulai, pilih Edit variabel lingkungan sistem untuk membuka jendela Properti sistem.

4. Pilih variabel Lingkungan... untuk membuka jendela Variabel Lingkungan.

5. Di bawah Variabel sistem, pilih Path, lalu pilih Edit. Di jendela variabel Edit lingkungan, Anda dapat melihat setiap jalur pada baris terpisah.

6. Periksa apakah jalur ke bin folder instalasi Java ada. Jalannya mungkin terlihat mirip dengan contoh berikut.

   C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

7. Jika bin folder instalasi Java hilang dari Path, pilih Baru untuk menambahkannya, lalu pilih OK.

Buka Windows Command Prompt (cmd.exe) sebagai administrator.

Buat pengguna default di LocalSystem akun di perangkat Windows. Ganti password dengan kata sandi yang aman.

net user /add ggc_user password

Unduh dan instal PsExecutilitas dari Microsoft pada perangkat.

Gunakan PsExec utilitas untuk menyimpan nama pengguna dan kata sandi untuk pengguna default dalam contoh Credential Manager untuk LocalSystem akun tersebut. Ganti password dengan kata sandi pengguna yang Anda tetapkan sebelumnya.

psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

Jika PsExec License Agreementterbuka, pilih Acceptuntuk menyetujui lisensi dan jalankan perintah.

Di perangkat inti Anda, unduh perangkat lunak AWS IoT Greengrass Core ke file bernamagreengrass-nucleus-latest.zip.

Dengan mengunduh perangkat lunak ini, Anda menyetujui Perjanjian Lisensi Perangkat Lunak Greengrass Core.

(Opsional) Untuk memverifikasi tanda tangan perangkat lunak inti Greengrass

1. Gunakan perintah berikut untuk memverifikasi tanda tangan artefak inti Greengrass Anda:

   Linux or Unix

   jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   Nama file mungkin terlihat berbeda tergantung pada JDK versi yang Anda instal. Ganti jdk17.0.6_10 dengan JDK versi yang Anda instal.

   "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

   PowerShell

   Nama file mungkin terlihat berbeda tergantung pada JDK versi yang Anda instal. Ganti jdk17.0.6_10 dengan JDK versi yang Anda instal.

   'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

2. jarsignerPemanggilan menghasilkan output yang menunjukkan hasil verifikasi.

   1. Jika file zip inti Greengrass ditandatangani, output berisi pernyataan berikut:

      jar verified.

   2. Jika file zip inti Greengrass tidak ditandatangani, output berisi pernyataan berikut:

      jar is unsigned.

3. Jika Anda memberikan -certs opsi Jarsigner bersama dengan -verify dan -verbose opsi, output juga menyertakan informasi sertifikat penandatangan terperinci.

Buka zip perangkat lunak AWS IoT Greengrass Core ke folder di perangkat Anda. Ganti GreengrassInstaller dengan folder yang ingin Anda gunakan.

(Opsional) Jalankan perintah berikut untuk melihat versi perangkat lunak AWS IoT Greengrass Core.

java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Periksa versi perangkat lunak AWS IoT Greengrass Inti.

java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Gunakan editor teks untuk membuat file konfigurasi bernama config.yaml yang akan disediakan ke penginstal.

Misalnya, pada sistem berbasis Linux, Anda dapat menjalankan perintah berikut untuk menggunakan GNU nano untuk membuat file.

nano GreengrassInstaller/config.yaml

Salin YAML konten berikut ke dalam file.

---
system:
  rootpath: "/greengrass/v2"
  # The following values are optional. Return them from the provisioning plugin or set them here.
  # certificateFilePath: ""
  # privateKeyPath: ""
  # rootCaPath: ""
  # thingName: ""
services:
  aws.greengrass.Nucleus:
    version: "2.13.0"
    configuration:
      # The following values are optional. Return them from the provisioning plugin or set them here.
      # awsRegion: ""
      # iotRoleAlias: ""
      # iotDataEndpoint: ""
      # iotCredEndpoint: ""
  com.example.CustomProvisioning:
    configuration:
      # You can specify configuration parameters to provide to your plugin.
      # pluginParameter: ""

Kemudian, lakukan hal berikut:

---
system:
  rootpath: "/greengrass/v2"
  # The following values are optional. Return them from the provisioning plugin or set them here.
  # certificateFilePath: ""
  # privateKeyPath: ""
  # rootCaPath: ""
  # thingName: ""
services:
  aws.greengrass.Nucleus:
    version: "2.13.0"
    configuration:
      mqtt:
        port: 443
      greengrassDataPlanePort: 443
      networkProxy:
        noProxyAddresses: "http://192.168.0.1,www.example.com"
        proxy:
          url: "http://my-proxy-server:1100"
          username: "Mary_Major"
          password: "pass@word1357"
      # The following values are optional. Return them from the provisioning plugin or set them here.
      # awsRegion: ""
      # iotRoleAlias: ""
      # iotDataEndpoint: ""
      # iotCredEndpoint: ""
  com.example.CustomProvisioning:
    configuration:
      # You can specify configuration parameters to provide to your plugin.
      # pluginParameter: ""

Jalankan pemasang. Tentukan --trusted-plugin untuk menyediakan plugin penyediaan kustom Anda, dan tentukan --init-config untuk menyediakan file konfigurasi.

Jika Anda menentukan --setup-system-service true, penginstal akan mencetak Successfully set up Nucleus as a system service jika ia mengatur dan menjalankan perangkat lunak sebagai layanan. Jika tidak, installer tersebut tidak akan menghasilkan pesan apa pun jika ia berhasil menginstal perangkat lunak tersebut.

Verifikasi instalasi dengan melihat file di folder root.

Jika penginstalan berhasil, folder akar berisi beberapa folder, seperti config, packages, dan logs.