Pemecahan Masalah AWS IoT Greengrass V2

Gunakan informasi dan solusi pemecahan masalah di bagian ini untuk membantu menyelesaikan masalah. AWS IoT Greengrass Version 2

Tampilan AWS IoT Greengrass Perangkat lunak inti dan log komponen

Perangkat lunak AWS IoT Greengrass Core menulis log ke sistem file lokal yang dapat Anda gunakan untuk melihat informasi real-time tentang perangkat inti. Anda juga dapat mengonfigurasi perangkat inti untuk menulis CloudWatch log ke Log, sehingga Anda dapat memecahkan masalah perangkat inti dari jarak jauh. Log ini dapat membantu Anda mengidentifikasi masalah dengan komponen, penerapan, dan perangkat inti. Untuk informasi selengkapnya, lihat Memantau AWS IoT Greengrass log.

AWS IoT Greengrass Masalah perangkat lunak inti

Memecahkan masalah perangkat lunak AWS IoT Greengrass inti.

ThrottlingException dari ListDeployments API

ThrottlingExceptiondari ListDeployments API: Anda mungkin melihat ini ketika Anda memiliki sejumlah besar penerapan di akun.

Untuk mengatasi ini, lakukan salah satu hal berikut:

Tidak dapat mengatur perangkat inti

Jika penginstal perangkat lunak AWS IoT Greengrass Core gagal dan Anda tidak dapat mengatur perangkat inti, Anda mungkin perlu menghapus instalasi perangkat lunak dan mencoba lagi. Untuk informasi selengkapnya, lihat Copot pemasangan AWS IoT Greengrass Perangkat lunak inti.

Tidak dapat memulai AWS IoT Greengrass Perangkat lunak inti sebagai layanan sistem

Jika perangkat lunak AWS IoT Greengrass Core gagal memulai, periksa log layanan sistem untuk mengidentifikasi masalah. Salah satu masalah umum adalah di mana Java tidak tersedia pada variabel lingkungan PATH (Linux) atau variabel sistem PATH (Windows).

Tidak dapat mengatur inti sebagai layanan sistem

Anda mungkin melihat kesalahan ini ketika penginstal perangkat lunak AWS IoT Greengrass Core gagal diatur AWS IoT Greengrass sebagai layanan sistem. Pada perangkat Linux, kesalahan ini biasanya terjadi jika perangkat inti tidak memiliki sistem init systemd. Penginstal dapat berhasil mengatur perangkat lunak AWS IoT Greengrass Core bahkan jika gagal mengatur layanan sistem.

Lakukan salah satu tindakan berikut:

Tidak dapat terhubung ke AWS IoT Core

Anda mungkin melihat kesalahan ini ketika perangkat lunak AWS IoT Greengrass Core tidak dapat terhubung AWS IoT Core untuk mengambil pekerjaan penerapan, misalnya. Lakukan hal-hal berikut:

Kesalahan kehabisan memori

Kesalahan ini biasanya terjadi jika perangkat Anda tidak memiliki memori yang cukup untuk mengalokasikan objek di tumpukan Java. Pada perangkat dengan memori terbatas, Anda mungkin perlu menentukan ukuran tumpukan maksimum untuk mengontrol alokasi memori. Untuk informasi selengkapnya, lihat Kontrol alokasi memori dengan opsi JVM.

Tidak dapat menginstal Greengrass CLI

Anda mungkin melihat pesan konsol berikut saat menggunakan --deploy-dev-tools argumen dalam perintah instalasi untuk AWS IoT Greengrass Core.

Thing group exists, it could have existing deployment and devices, hence NOT creating deployment for Greengrass first party dev tools, please manually create a deployment if you wish to

Hal ini terjadi ketika komponen Greengrass CLI tidak diinstal karena perangkat inti Anda adalah anggota dari grup objek yang memiliki deployment yang ada. Jika Anda melihat pesan ini, Anda dapat secara manual menyebarkan komponen Greengrass CLI (aws.greengrass.Cli) ke perangkat untuk menginstal Greengrass CLI. Untuk informasi selengkapnya, lihat Instal Greengrass CLI.

Root pengguna tidak diizinkan untuk mengeksekusi

Anda mungkin melihat kesalahan ini ketika pengguna yang menjalankan perangkat lunak AWS IoT Greengrass Core (biasanyaroot) tidak memiliki izin untuk menjalankan sudo dengan pengguna dan grup apa pun. Untuk pengguna sistem ggc_user default, kesalahan ini terlihat seperti berikut:

Sorry, user root is not allowed to execute <command> as ggc_user:ggc_group.

Periksa bahwa file /etc/sudoers Anda memberikan izin pengguna untuk menjalankan sudo sebagai kelompok lain. Izin untuk pengguna di /etc/sudoers seharusnya terlihat seperti contoh berikut.

root    ALL=(ALL:ALL) ALL

com.aws.greengrass.lifecyclemanager. GenericExternalService: Tidak dapat menentukan user/group untuk menjalankan dengan

Anda mungkin melihat kesalahan ini ketika perangkat inti mencoba menjalankan komponen, dan inti Greengrass tidak menentukan pengguna sistem default yang akan digunakan untuk menjalankan komponen.

Untuk memperbaiki masalah ini, konfigurasikan inti Greengrass untuk menentukan pengguna sistem default yang menjalankan komponen. Untuk informasi selengkapnya, lihat Konfigurasikan pengguna yang menjalankan komponen dan Konfigurasikan pengguna komponen default.

Gagal memetakan segmen dari objek bersama: operasi tidak diizinkan

Anda mungkin melihat kesalahan ini ketika perangkat lunak AWS IoT Greengrass Inti gagal memulai karena /tmp folder dipasang dengan noexec izin. Pustaka AWS Common Runtime (CRT) menggunakan /tmp folder secara default.

Lakukan salah satu tindakan berikut:

Gagal mengatur layanan Windows

Anda mungkin melihat kesalahan ini jika Anda menginstal perangkat lunak AWS IoT Greengrass Core pada perangkat Microsoft Windows 2016. Perangkat lunak AWS IoT Greengrass Core tidak didukung pada Windows 2016, untuk daftar sistem operasi yang didukung, lihatPlatform yang didukung.

Jika Anda harus menggunakan Windows 2016, Anda dapat melakukan hal berikut:

com.aws.greengrass.util.exceptions. TLSAuthException: Gagal mendapatkan manajer kepercayaan

Anda mungkin melihat kesalahan ini saat menginstal perangkat lunak AWS IoT Greengrass Core tanpa file root certificate authority (CA).

2022-06-05T10:00:39.556Z [INFO] (main) com.aws.greengrass.lifecyclemanager.Kernel: service-loaded. {serviceName=DeploymentService}
2022-06-05T10:00:39.943Z [WARN] (main) com.aws.greengrass.componentmanager.ClientConfigurationUtils: configure-greengrass-mutual-auth. Error during configure greengrass client mutual auth. {}
com.aws.greengrass.util.exceptions.TLSAuthException: Failed to get trust manager

Periksa apakah Anda menentukan file CA root yang valid dengan rootCaPath parameter dalam file konfigurasi yang Anda berikan kepada penginstal. Untuk informasi selengkapnya, lihat Instal perangkat lunak AWS IoT Greengrass Core.

com.aws.greengrass.deployment. IotJobsHelper: Tidak ada koneksi yang tersedia selama berlangganan topik deskripsi Iot Jobs. Akan mencoba lagi di suatu saat

Anda mungkin melihat pesan peringatan ini ketika perangkat inti tidak dapat terhubung AWS IoT Core untuk berlangganan pemberitahuan pekerjaan penerapan. Lakukan hal-hal berikut:

software.amazon.awssdk.services.iam.model. IamException: Token keamanan yang disertakan dalam permintaan tidak valid

Anda mungkin melihat kesalahan ini saat menginstal perangkat lunak AWS IoT Greengrass Core dengan penyediaan otomatis, dan penginstal menggunakan token AWS sesi yang tidak valid. Lakukan hal-hal berikut:

Anda juga dapat menginstal perangkat lunak AWS IoT Greengrass Core tanpa memberikan AWS kredensyal. Untuk informasi selengkapnya, lihat Instal perangkat lunak AWS IoT Greengrass Core dengan penyediaan sumber daya manual atau Instal perangkat lunak AWS IoT Greengrass Core dengan penyediaan AWS IoT armada.

software.amazon.awssdk.services.iot.model. IotException: Pengguna: < pengguna > tidak berwenang untuk melakukan: iot: GetPolicy

Anda mungkin melihat kesalahan ini saat menginstal perangkat lunak AWS IoT Greengrass Core dengan penyediaan otomatis, dan penginstal menggunakan AWS kredensyal yang tidak memiliki izin yang diperlukan. Untuk informasi selengkapnya tentang izin yang diperlukan, lihatKebijakan IAM minimal untuk penginstal untuk menyediakan sumber daya.

Periksa izin untuk identitas IAM kredensil, dan berikan identitas IAM izin yang diperlukan yang hilang.

Kesalahan: com.aws.greengrass.shadowmanager.sync.model. FullShadowSyncRequest: Tidak dapat menjalankan permintaan cloud shadow get

Anda mungkin melihat kesalahan ini saat menggunakan komponen pengelola bayangan untuk menyinkronkan bayangan perangkat dengan AWS IoT Core. Kode status HTTP 403 menunjukkan bahwa kesalahan ini terjadi karena AWS IoT kebijakan perangkat inti tidak memberikan izin untuk memanggilGetThingShadow.

com.aws.greengrass.shadowmanager.sync.model.FullShadowSyncRequest: Could not execute cloud shadow get request. {thing name=MyGreengrassCore, shadow name=MyShadow}
2021-07-14T21:09:02.456Z [ERROR] (pool-2-thread-109) com.aws.greengrass.shadowmanager.sync.SyncHandler: sync. Skipping sync request. {thing name=MyGreengrassCore, shadow name=MyShadow}
com.aws.greengrass.shadowmanager.exception.SkipSyncRequestException: software.amazon.awssdk.services.iotdataplane.model.IotDataPlaneException: null (Service: IotDataPlane, Status Code: 403, Request ID: f6e713ba-1b01-414c-7b78-5beb3f3ad8f6, Extended Request ID: null)

Untuk menyinkronkan bayangan lokal dengan AWS IoT Core, AWS IoT kebijakan perangkat inti harus memberikan izin berikut:

Periksa AWS IoT kebijakan perangkat inti, dan tambahkan izin yang diperlukan yang tidak ada. Untuk informasi selengkapnya, lihat berikut ini:

Operasi aws.greengrass# operasi tidak didukung oleh < Greengrass >

Anda mungkin melihat kesalahan ini saat menggunakan operasi komunikasi antarproses (IPC) dalam komponen Greengrass kustom, dan komponen yang AWS disediakan yang diperlukan tidak diinstal pada perangkat inti.

Untuk memperbaiki masalah ini, tambahkan komponen yang diperlukan sebagai dependensi dalam resep komponen Anda, sehingga perangkat lunak AWS IoT Greengrass Core menginstal komponen yang diperlukan saat Anda menerapkan komponen Anda.

java.io. FileNotFoundException: < stream-manager-store-root-dir /stream_manager_metadata_store > (Izin ditolak)

Anda mungkin melihat kesalahan ini di file log pengelola aliran (aws.greengrass.StreamManager.log) saat mengonfigurasi pengelola aliran untuk menggunakan folder root yang tidak ada atau memiliki izin yang benar. Untuk informasi selengkapnya tentang cara mengonfigurasi folder ini, lihat konfigurasi manajer aliran.

com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: Kunci pribadi atau sertifikat dengan < label label > tidak ada

Kesalahan ini terjadi ketika komponen penyedia PKCS #11 tidak dapat menemukan atau memuat kunci pribadi atau sertifikat yang Anda tentukan saat Anda mengonfigurasi perangkat lunak AWS IoT Greengrass Core untuk menggunakan modul keamanan perangkat keras (HSM). Lakukan hal-hal berikut:

Periksa dokumentasi untuk HSM Anda untuk mempelajari cara menanyakan detail tentang token keamanan di HSM. Jika Anda perlu mengubah slot, label objek, atau ID objek untuk token keamanan, periksa dokumentasi untuk HSM Anda untuk mempelajari cara melakukannya.

software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Pengguna: < pengguna > tidak berwenang untuk melakukan: secretsmanager: GetSecretValue on resource: arn < >

Kesalahan ini dapat terjadi ketika Anda menggunakan komponen manajer rahasia untuk menyebarkan AWS Secrets Manager rahasia. Jika IAM role pertukaran token perangkat inti tidak memberikan izin untuk mendapatkan rahasia, deployment itu gagal dan log Greengrass mencakup kesalahan ini.

software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Akses ke KMS tidak diperbolehkan

Kesalahan ini dapat terjadi ketika Anda menggunakan komponen manajer rahasia untuk menyebarkan AWS Secrets Manager rahasia yang dienkripsi oleh kunci. AWS Key Management Service Jika peran IAM pertukaran token perangkat inti tidak memberikan izin untuk mendekripsi rahasia, penerapan gagal dan log Greengrass menyertakan kesalahan ini.

Untuk memperbaiki masalah, tambahkan kms:Decrypt izin ke peran pertukaran token perangkat inti. Untuk informasi selengkapnya, lihat berikut ini:

java.lang. NoClassDefFoundError: com/aws/greengrass/security/CryptoKeySpi

Anda mungkin melihat kesalahan ini ketika mencoba menginstal perangkat lunak AWS IoT Greengrass Core dengan keamanan perangkat keras dan Anda menggunakan versi inti Greengrass sebelumnya yang tidak mendukung integrasi keamanan perangkat keras. Untuk menggunakan integrasi keamanan perangkat keras, Anda harus menggunakan Greengrass nucleus v2.5.3 atau yang lebih baru.

com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: CKR_OPERATION_NOT_INITIALIZED

Anda mungkin melihat kesalahan ini saat menggunakan pustaka TPM2 saat menjalankan AWS IoT Greengrass Core sebagai layanan sistem.

Kesalahan ini menunjukkan bahwa Anda perlu menambahkan variabel lingkungan yang menyediakan lokasi penyimpanan PKCS #11 di file layanan systemd AWS IoT Greengrass Core.

Untuk informasi selengkapnya, lihat bagian Persyaratan pada dokumentasi Penyedia PKCS #11 komponen.

Perangkat inti Greengrass terjebak di nukleus v2.12.3

Jika perangkat inti Greengrass Anda tidak akan merevisi penerapan Anda dari nucleus versi 2.12.3, Anda mungkin perlu mengunduh dan mengganti file dengan Greengrass nucleus versi 2.12.2. Greengrass.jar Lakukan hal-hal berikut:

Masalah template systemd Greengrass nucleus v2.14.0

Anda mungkin mengalami masalah ini jika Anda menginstal Greengrass nucleus v2.14.0 pada perangkat Linux dengan templat layanan systemd defaultnya. Lakukan hal-hal berikut:

AWS IoT Greengrass masalah cloud

Gunakan informasi berikut untuk memecahkan masalah dengan AWS IoT Greengrass konsol dan API. Setiap entri sesuai dengan pesan kesalahan yang mungkin Anda lihat ketika Anda melakukan tindakan.

Terjadi kesalahan (AccessDeniedException) saat memanggil CreateComponentVersion operasi: User: arn:aws:iam: < :123456789012: user/ username is not authorized to perform: null >

Anda mungkin melihat kesalahan ini saat membuat versi komponen dari AWS IoT Greengrass konsol atau dengan CreateComponentVersionoperasi.

Kesalahan ini menunjukkan bahwa resep Anda bukan JSON atau YAML yang valid. Periksa sintaks resep Anda, perbaiki masalah sintaks, dan coba lagi. Anda dapat menggunakan pemeriksa sintaks JSON atau YAML online untuk mengidentifikasi masalah sintaks dalam resep Anda.

Input Tidak Valid: Mengalami kesalahan berikut di Artefak: {<s3 ArtifactUri > = Sumber daya artefak tertentu tidak dapat diakses}

Anda mungkin melihat kesalahan ini saat membuat versi komponen dari AWS IoT Greengrass konsol atau dengan CreateComponentVersionoperasi. Kesalahan ini menunjukkan bahwa artefak S3 dalam resep komponen tidak valid.

Lakukan hal-hal berikut:

Status penyebaran TIDAK AKTIF

Anda mungkin mendapatkan status INACTIVE penerapan saat memanggil ListDeploymentsAPI tanpa AWS IoT kebijakan dependen yang diperlukan. Anda harus memiliki izin yang diperlukan untuk mendapatkan status penerapan yang akurat. Anda dapat menemukan tindakan dependen dengan melihat di Tindakan yang ditentukan oleh AWS IoT Greengrass V2 dan mengikuti izin yang diperlukanListDeployments. Tanpa AWS IoT izin dependen yang diperlukan, Anda masih akan melihat status penerapan tetapi Anda mungkin melihat status penerapan yang tidak akurat. INACTIVE

CreateDeployment mengembalikan respons sukses tetapi GetDeployment mengembalikan kesalahan 404

Anda mungkin melihat masalah ini saat memanggil CreateDeploymentoperasi untuk diterapkan ke grup AWS IoT sesuatu atau benda. CreateDeploymentPanggilan mengembalikan kode 200 status dengan ID penerapan yang valid. Namun, saat Anda menelepon GetDeploymentdengan ID penerapan itu, Anda menerima ResourceNotFoundException kesalahan. AWS IoT Greengrass Konsol menampilkan halaman “Deployment not found” untuk URL penerapan. Penerapan sebelumnya untuk target mungkin juga menunjukkan INACTIVE status tanpa penggantian.

Masalah ini dapat terjadi ketika beberapa CreateDeployment permintaan menargetkan AWS IoT hal yang sama pada saat yang bersamaan. Kondisi balapan dapat menyebabkan cloud gagal merekam penyebaran. Perangkat inti masih menerima dan menerapkan penerapan melalui bayangan AWS IoT perangkat, tetapi layanan AWS IoT Greengrass cloud tidak memiliki catatan tentangnya. Setelah masalah ini terjadi, ini mungkin juga memengaruhi penerapan berikutnya ke target yang sama.

Lakukan hal berikut untuk mengatasi dan mencegah masalah ini:

Masalah deployment perangkat inti

Memecahkan masalah penerapan pada perangkat inti Greengrass. Setiap entri sesuai dengan pesan log yang mungkin Anda lihat di perangkat inti Anda.

Kesalahan: com.aws.greengrass.componentmanager.exceptions. PackageDownloadException: Gagal mengunduh artefak

Anda mungkin melihat kesalahan ini ketika perangkat lunak AWS IoT Greengrass Core gagal mengunduh artefak komponen saat perangkat inti menerapkan penerapan. Deployment gagal sebagai akibat dari kesalahan ini.

Ketika Anda menerima kesalahan ini, log juga mencakup jejak tumpukan yang dapat Anda gunakan untuk mengidentifikasi masalah tertentu. Masing-masing entri berikut sesuai dengan pesan yang mungkin Anda lihat di jejak tumpukan pesan kesalahan Failed to download artifact.

Software.amazon.awssdk.services.s3.model.s3Exception: null (Layanan: S3, Kode Status: 403, ID Permintaan: null,...)

PackageDownloadException Kesalahan mungkin termasuk jejak tumpukan ini dalam kasus berikut:

Software.amazon.awssdk.services.s3.model.s3Exception: Akses Ditolak (Layanan: S3, Kode Status: 403, ID Permintaan: RequeStyD < >

PackageDownloadException Kesalahan mungkin termasuk jejak tumpukan ini ketika perangkat inti tidak memiliki izin untuk memanggils3:GetBucketLocation. Pesan kesalahan juga menyertakan pesan berikut.

reason: Failed to determine S3 bucket location

Periksa apakah peran pertukaran token perangkat inti memungkinkan s3:GetBucketLocation bucket S3 tempat artefak tersedia.

Kesalahan: com.aws.greengrass.componentmanager.exceptions. ArtifactChecksumMismatchException: Pemeriksaan integritas untuk artefak yang diunduh gagal. Mungkin karena korupsi berkas.

Anda mungkin melihat kesalahan ini ketika perangkat lunak AWS IoT Greengrass Core gagal mengunduh artefak komponen saat perangkat inti menerapkan penerapan. Penerapan gagal karena checksum file artefak yang diunduh tidak cocok dengan checksum yang AWS IoT Greengrass dihitung saat Anda membuat komponen.

Lakukan hal-hal berikut:

Kesalahan: com.aws.greengrass.componentmanager.exceptions. NoAvailableComponentVersionException: Gagal menegosiasikan > versi < nama komponen dengan cloud dan tidak ada versi lokal yang berlaku yang memenuhi persyaratan persyaratan < >

Anda mungkin melihat kesalahan ini bila perangkat inti tidak dapat menemukan versi komponen yang memenuhi persyaratan penyebaran untuk perangkat inti tersebut. Perangkat inti memeriksa komponen dalam AWS IoT Greengrass layanan dan perangkat lokal. Pesan kesalahan mencakup target setiap penyebaran dan persyaratan versi penyebaran untuk komponen. Target deployment dapat berupa objek, grup objek, atau LOCAL_DEPLOYMENT, yang mewakili deployment lokal pada perangkat inti.

Masalah ini dapat terjadi pada kasus berikut:

Untuk mengatasi masalah ini, revisi penyebaran dengan menyertakan versi komponen yang kompatibel atau hapus yang tidak kompatibel. Untuk informasi selengkapnya tentang cara merevisi penyebaran cloud, lihat Revisi deployment. Untuk informasi selengkapnya tentang cara merevisi deployment lokal, lihat perintah AWS IoT Greengrass Buat CLI deployment.

software.amazon.awssdk.services.greengrassv2data.model. ResourceNotFoundException: Versi terbaru < Component componentName > tidak mengklaim kompatibilitas < inti DevicePlatform > platform

Anda mungkin melihat kesalahan ini saat menerapkan komponen ke perangkat inti, dan komponen tersebut tidak mencantumkan platform yang kompatibel dengan platform perangkat inti. Lakukan salah satu tindakan berikut:

com.aws.greengrass.componentmanager.exceptions. PackagingException: Penerapan mencoba memperbarui nukleus dari versi AWS.greengrass.Nucleus- ke < versi > AWS.GreenGrass.Nucleus- tetapi tidak ada komponen tipe inti yang disertakan sebagai komponen target < >

Anda mungkin melihat kesalahan ini saat menerapkan komponen yang bergantung pada inti Greengrass, dan perangkat inti menjalankan versi inti Greengrass sebelumnya daripada versi minor terbaru yang tersedia. Kesalahan ini terjadi karena perangkat lunak AWS IoT Greengrass Core mencoba memperbarui komponen secara otomatis ke versi terbaru yang kompatibel. Namun, perangkat lunak AWS IoT Greengrass Core mencegah inti Greengrass memperbarui ke versi minor baru, karena AWS beberapa komponen yang disediakan bergantung pada versi minor tertentu dari inti Greengrass. Untuk informasi selengkapnya, lihat Perilaku pembaruan inti Greengrass.

Anda harus merevisi penerapan untuk menentukan versi inti Greengrass yang ingin Anda gunakan. Lakukan salah satu tindakan berikut:

Kesalahan: com.aws.greengrass.deployment.exceptions. DeploymentException: Tidak dapat memproses penerapan. Direktori peluncuran Greengrass tidak disiapkan atau Greengrass tidak disiapkan sebagai layanan sistem

Anda mungkin melihat kesalahan ini saat memindahkan perangkat Greengrass dari satu grup hal ke grup lainnya, lalu kembali ke grup asli dengan penerapan yang memerlukan Greengrass untuk memulai ulang.

Untuk mengatasi masalah ini, buat ulang direktori peluncuran untuk perangkat. Kami juga sangat menyarankan untuk meningkatkan ke versi 2.9.6 atau yang lebih baru dari inti Greengrass.

Berikut ini adalah skrip Linux untuk membuat ulang direktori peluncuran. Simpan skrip dalam file bernamafix_directory.sh.

#!/bin/bash

set -e

GG_ROOT=$1
GG_VERSION=$2

CURRENT="$GG_ROOT/alts/current"

if [ ! -L "$CURRENT" ]; then
  mkdir -p $GG_ROOT/alts/directory_fix
  echo "Relinking $GG_ROOT/alts/directory_fix to $CURRENT"
  ln -sf $GG_ROOT/alts/directory_fix $CURRENT
fi

TARGET=$(readlink $CURRENT)

if [[ ! -d "$TARGET" ]]; then
  echo "Creating directory: $TARGET"
  mkdir -p "$TARGET"
fi

DISTRO_LINK="$TARGET/distro"
DISTRO="$GG_ROOT/packages/artifacts-unarchived/aws.greengrass.Nucleus/$GG_VERSION/aws.greengrass.nucleus/"
echo "Relinking Nucleus artifacts to $DISTRO_LINK"
ln -sf $DISTRO $DISTRO_LINK

Untuk menjalankan skrip, jalankan perintah berikut:

[root@ip-172-31-27-165 ~]# ./fix_directory.sh /greengrass/v2 2.9.5
Relinking /greengrass/v2/alts/directory_fix to /greengrass/v2/alts/current
Relinking Nucleus artifacts to /greengrass/v2/alts/directory_fix/distro

Info: com.aws.greengrass.deployment.exceptions. RetryableDeploymentDocumentDownloadException: Greengrass Cloud Service mengembalikan kesalahan saat mendapatkan konfigurasi penerapan penuh

Anda mungkin melihat kesalahan ini ketika perangkat inti menerima dokumen deployment yang besar, yang merupakan dokumen deployment yang lebih besar dari 7 KB (untuk deployment yang menargetkan objek) atau 31 KB (untuk deployment yang menargetkan grup objek). Untuk mengambil dokumen penerapan besar, AWS IoT kebijakan perangkat inti harus mengizinkan izin tersebut. greengrass:GetDeploymentConfiguration Kesalahan ini dapat terjadi ketika perangkat inti tidak memiliki izin ini. Ketika kesalahan ini terjadi, deployment tersebut mencoba ulang tanpa batas waktu, dan statusnya Dalam proses (IN_PROGRESS).

Untuk mengatasi masalah ini, tambahkan greengrass:GetDeploymentConfiguration izin ke AWS IoT kebijakan perangkat inti. Untuk informasi selengkapnya, lihat Memperbarui AWS IoT kebijakan perangkat inti.

Peringatkan: com.aws.greengrass.deployment. DeploymentService: Gagal mendapatkan hierarki grup benda

Anda mungkin melihat peringatan ini saat perangkat inti menerima penerapan dan AWS IoT kebijakan perangkat inti tidak mengizinkan greengrass:ListThingGroupsForCoreDevice izin tersebut. Saat Anda membuat penerapan, perangkat inti menggunakan izin ini untuk mengidentifikasi grup benda dan menghapus komponen untuk grup apa pun dari mana Anda menghapus perangkat inti. Jika perangkat inti menjalankan Greengrass nucleus v2.5.0, penerapan gagal. Jika perangkat inti menjalankan Greengrass nucleus v2.5.1 atau yang lebih baru, penerapan berlangsung tetapi tidak menghapus komponen. Untuk informasi selengkapnya tentang perilaku penghapusan grup benda, lihatMenyebarkan AWS IoT Greengrass komponen ke perangkat.

Untuk memperbarui perilaku perangkat inti untuk menghapus komponen untuk grup benda tempat Anda menghapus perangkat inti, tambahkan greengrass:ListThingGroupsForCoreDevice izin ke AWS IoT kebijakan perangkat inti. Untuk informasi selengkapnya, lihat Memperbarui AWS IoT kebijakan perangkat inti.

Info: com.aws.greengrass.deployment. DeploymentDocumentDownloader: Memanggil Greengrass cloud untuk mendapatkan konfigurasi penerapan penuh

Anda mungkin melihat pesan informasi ini dicetak beberapa kali tanpa kesalahan, karena perangkat inti mencatat kesalahan di tingkat log DEBUG. Masalah ini dapat terjadi ketika perangkat inti menerima dokumen deployment yang besar. Ketika kesalahan ini terjadi, deployment ini mencoba ulang tanpa batas waktu, dan statusnya Dalam proses (IN_PROGRESS). Untuk informasi selengkapnya tentang cara mengatasi masalah ini, lihat entri pemecahan masalah ini.

Disebabkan oleh: software.amazon.awssdk.services.greengrassv2data.model. GreengrassV2DataException: null (Layanan: GreenGrassV2Data, Kode Status: 403, ID Permintaan: < > some_request_id, ID Permintaan Diperpanjang: null)

Anda mungkin melihat kesalahan ini ketika API dataplane tidak memiliki iot:Connect izin. Jika Anda tidak memiliki kebijakan yang benar, Anda akan menerimaGreengrassV2DataException: 403. Untuk membuat kebijakan izin, ikuti petunjuk berikut:Buat AWS IoT kebijakan.

Masalah komponen perangkat inti

Memecahkan masalah komponen Greengrass pada perangkat inti.

Peringatkan: > '<perintah' tidak dikenali sebagai perintah internal atau eksternal

Anda mungkin melihat kesalahan ini di log komponen Greengrass ketika AWS IoT Greengrass perangkat lunak Core gagal menjalankan perintah dalam skrip siklus hidup komponen. Status komponen menjadi BROKEN sebagai akibat dari kesalahan ini. Kesalahan ini dapat terjadi jika pengguna sistem yang menjalankan komponen, sepertiggc_user, tidak dapat menemukan perintah yang dapat dieksekusi di folder di PATH.

Pada perangkat Windows, periksa apakah folder yang berisi executable ada di PATH untuk pengguna sistem yang menjalankan komponen. Jika hilang dariPATH, lakukan salah satu hal berikut:

Skrip Python tidak mencatat pesan

Perangkat inti Greengrass mengumpulkan log yang dapat Anda gunakan untuk mengidentifikasi masalah dengan komponen. Jika pesan stdout dan stderr skrip Python Anda tidak muncul di log komponen Anda, Anda mungkin perlu menyiram buffer atau menonaktifkan buffer untuk stream output standar ini di Python. Lakukan salah satu langkah berikut ini:

Untuk informasi selengkapnya tentang cara memverifikasi bahwa skrip Python mengeluarkan pesan log, lihat Memantau AWS IoT Greengrass log.

Konfigurasi komponen tidak diperbarui saat mengubah konfigurasi default

Saat Anda mengubah DefaultConfiguration resep komponen, konfigurasi default baru tidak akan menggantikan konfigurasi komponen yang ada selama penerapan. Untuk menerapkan konfigurasi default baru, Anda harus mengatur ulang konfigurasi komponen ke pengaturan defaultnya. Saat Anda menerapkan komponen, tentukan satu string kosong sebagai pembaruan reset.

awsiot.greengrasscoreipc.model. UnauthorizedError

Anda mungkin melihat kesalahan ini di log komponen Greengrass ketika komponen tidak memiliki izin untuk melakukan operasi IPC pada sumber daya. Untuk memberikan izin komponen untuk memanggil operasi IPC, tentukan kebijakan otorisasi IPC dalam konfigurasi komponen. Untuk informasi selengkapnya, lihat Otorisasi komponen untuk melakukan operasi IPC.

com.aws.greengrass.authorization.exceptions. AuthorizationException: ID kebijakan duplikat "<id" untuk prinsipal > "<>ComponentList”

Anda mungkin melihat kesalahan ini jika beberapa kebijakan otorisasi IPC, termasuk di semua komponen pada perangkat inti, menggunakan ID kebijakan yang sama.

Periksa kebijakan otorisasi IPC komponen Anda, perbaiki duplikat apa pun, dan coba lagi. Untuk membuat ID kebijakan unik, sebaiknya Anda menggabungkan nama komponen, nama layanan IPC, dan penghitung. Untuk informasi selengkapnya, lihat Otorisasi komponen untuk melakukan operasi IPC.

com.aws.greengrass.tes. CredentialRequestHandler: Kesalahan dalam mengambil AwsCredentials dari TES (HTTP 400)

Anda mungkin melihat kesalahan ini ketika perangkat inti tidak bisa mendapatkan AWS kredensyal dari layanan pertukaran token. Kode status HTTP 400 menunjukkan bahwa kesalahan ini terjadi karena peran IAM pertukaran token perangkat inti tidak ada atau tidak memiliki hubungan kepercayaan yang memungkinkan penyedia AWS IoT kredensyal untuk mengasumsikan itu.

Lakukan hal-hal berikut:

com.aws.greengrass.tes. CredentialRequestHandler: Kesalahan dalam mengambil AwsCredentials dari TES (HTTP 403)

Anda mungkin melihat kesalahan ini ketika perangkat inti tidak bisa mendapatkan AWS kredensyal dari layanan pertukaran token. Kode status HTTP 403 menunjukkan bahwa kesalahan ini terjadi karena AWS IoT kebijakan perangkat inti tidak memberikan iot:AssumeRoleWithCertificate izin untuk alias AWS IoT peran perangkat inti.

Tinjau AWS IoT kebijakan perangkat inti, dan tambahkan iot:AssumeRoleWithCertificate izin untuk alias AWS IoT peran perangkat inti. Pesan kesalahan menyertakan alias AWS IoT peran perangkat inti saat ini. Untuk informasi selengkapnya tentang izin ini dan cara memperbarui AWS IoT kebijakan perangkat inti, lihat AWS IoT Kebijakan minimal untuk perangkat AWS IoT Greengrass V2 inti danMemperbarui AWS IoT kebijakan perangkat inti.

com.aws.greengrass.tes. CredentialsProviderError: Tidak dapat memuat kredensyal dari penyedia mana pun

Anda mungkin melihat kesalahan ini ketika komponen mencoba meminta AWS kredensyal dan tidak dapat terhubung ke layanan pertukaran token.

Lakukan hal-hal berikut:

Kesalahan yang diterima saat mencoba mengambil metadata ECS: Tidak dapat terhubung ke URL titik akhir: "token” < ExchangeServiceEndpoint >

Anda mungkin melihat kesalahan ini ketika komponen tidak menjalankan layanan pertukaran token dan komponen mencoba meminta AWS kredensyal.

Lakukan hal-hal berikut:

CopyFrom: < ConfigurationPath > sudah menjadi wadah, bukan daun

Anda mungkin melihat kesalahan ini ketika Anda mengubah nilai konfigurasi dari tipe kontainer (daftar atau objek) ke tipe non-kontainer (string, angka, atau Boolean). Lakukan hal-hal berikut:

Kemudian, Anda dapat mengatur nilai konfigurasi itu ke string, angka, atau Boolean.

com.aws.greengrass.componentmanager.plugins.docker.exceptions. DockerLoginException: Kesalahan saat masuk ke registri menggunakan kredensil - 'Rintisan menerima data buruk. '

Anda mungkin melihat kesalahan ini di log inti Greengrass saat komponen pengelola aplikasi Docker mencoba mengunduh image Docker dari repositori pribadi di Amazon Elastic Container Registry (Amazon ECR). Kesalahan ini terjadi jika Anda menggunakan wincred Docker credential helper (). docker-credential-wincred Akibatnya, Amazon ECR tidak dapat menyimpan kredensyal login.

Ambil salah satu tindakan berikut:

java.io.IOException: Tidak dapat menjalankan program “cmd”...: [LogonUser] Kata sandi untuk akun ini telah kedaluwarsa.

Anda mungkin melihat kesalahan ini pada perangkat inti Windows ketika pengguna sistem yang menjalankan proses komponen, sepertiggc_user, memiliki kata sandi yang kedaluwarsa. Akibatnya, perangkat lunak AWS IoT Greengrass Core tidak dapat menjalankan proses komponen sebagai pengguna sistem tersebut.

aws.greengrass. StreamManager: Instan melebihi minimum atau maksimum instan

Saat Anda memutakhirkan manajer aliran v2.0.7 ke versi antara v2.0.8 dan v2.0.11, Anda mungkin melihat kesalahan berikut di log komponen pengelola aliran jika komponen gagal memulai.

2021-07-16T00:54:58.568Z [INFO] (Copier) aws.greengrass.StreamManager: stdout. Caused by: com.fasterxml.jackson.databind.JsonMappingException: Instant exceeds minimum or maximum instant (through reference chain: com.amazonaws.iot.greengrass.streammanager.export.PersistedSuccessExportStatesV1["lastExportTime"]). {scriptName=services.aws.greengrass.StreamManager.lifecycle.startup.script, serviceName=aws.greengrass.StreamManager, currentState=STARTING}
2021-07-16T00:54:58.579Z [INFO] (Copier) aws.greengrass.StreamManager: stdout. Caused by: java.time.DateTimeException: Instant exceeds minimum or maximum instant. {scriptName=services.aws.greengrass.StreamManager.lifecycle.startup.script, serviceName=aws.greengrass.StreamManager, currentState=STARTING}

Jika Anda menerapkan manajer aliran v2.0.7 dan Anda ingin meningkatkan ke versi yang lebih baru, Anda harus meningkatkan ke manajer streaming v2.0.12 secara langsung. Untuk informasi selengkapnya tentang komponen manajer aliran, lihatManajer pengaliran.

Masalah komponen fungsi Lambda perangkat inti

Memecahkan masalah komponen fungsi Lambda pada perangkat inti.

Subsistem cgroup berikut tidak dipasang: perangkat, memori

Anda mungkin melihat kesalahan ini saat menjalankan fungsi Lambda dalam kontainer dalam kasus berikut:

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

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

ipc_client.py:64, Kesalahan HTTP 400:Permintaan Buruk, B'tidak ada langganan untuk label-or-lambda-arn sumber dan label-or-lambda-arn < > < >

Anda mungkin melihat kesalahan ini saat menjalankan fungsi Lambda V1, yang menggunakan AWS IoT Greengrass Core SDK, pada perangkat inti V2 tanpa menentukan langganan di komponen router langganan lama. Untuk memperbaiki masalah ini, gunakan dan konfigurasikan router langganan lama untuk menentukan langganan yang diperlukan. Untuk informasi selengkapnya, lihat Impor fungsi Lambda V1.

Versi komponen dihentikan

Anda mungkin melihat pemberitahuan di Personal Health Dashboard (PHD) ketika versi komponen pada perangkat inti Anda dihentikan. Versi komponen mengirimkan pemberitahuan ini ke PHD Anda dalam waktu 60 menit setelah dihentikan.

Untuk melihat penerapan mana yang perlu Anda revisi, lakukan hal berikut menggunakan: AWS Command Line Interface

Masalah Antarmuka Baris Perintah Greengrass

Memecahkan masalah dengan CLI Greengrass.

java.lang. RuntimeException: Tidak dapat membuat klien ipc

Anda mungkin melihat kesalahan ini saat menjalankan perintah Greengrass CLI dan Anda menentukan folder root yang berbeda dari tempat perangkat lunak Core diinstal. AWS IoT Greengrass

Lakukan salah satu hal berikut untuk mengatur jalur root, dan ganti /greengrass/v2 dengan jalur ke instalasi perangkat lunak AWS IoT Greengrass Core Anda:

AWS Command Line Interface masalah

Memecahkan AWS CLI masalah untuk. AWS IoT Greengrass V2

Kesalahan: Pilihan tidak valid: 'greengrassv2'

Anda mungkin melihat kesalahan ini ketika Anda menjalankan AWS IoT Greengrass V2 perintah dengan AWS CLI (misalnya,aws greengrassv2 list-core-devices).

Kesalahan ini menunjukkan bahwa Anda memiliki versi AWS CLI yang tidak mendukung AWS IoT Greengrass V2. Untuk menggunakannya AWS IoT Greengrass V2 AWS CLI, Anda harus memiliki salah satu versi berikut atau yang lebih baru:

aws --version

Untuk mengatasi masalah ini, perbarui AWS CLI ke versi yang lebih baru yang mendukung AWS IoT Greengrass V2. Untuk informasi selengkapnya, lihat Menginstal, memperbarui, dan mencopot instalasi AWS CLI di Panduan Pengguna AWS Command Line Interface .