Pemecahan masalah AWS IoT Greengrass V2 - AWS IoT Greengrass
Lihat perangkat lunak AWS IoT Greengrass inti dan log komponenAWS IoT Greengrass Masalah perangkat lunak intiAWS IoT Greengrass masalah cloudMasalah deployment perangkat intiMasalah komponen perangkat intiMasalah komponen fungsi Lambda perangkat intiVersi komponen dihentikanMasalah CLI GreengrassAWS CLI masalah

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemecahan masalah AWS IoT Greengrass V2

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

Topik

Lihat perangkat lunak AWS IoT Greengrass 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.

Topik

Tidak dapat mengatur perangkat inti

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

Tidak dapat memulai perangkat lunak AWS IoT Greengrass 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. Installer dapat berhasil mengatur perangkat lunak AWS IoT Greengrass Core bahkan jika gagal untuk mengatur layanan sistem.

Lakukan salah satu hal berikut:

  • Konfigurasikan dan jalankan perangkat lunak AWS IoT Greengrass Core sebagai layanan sistem. Anda harus mengkonfigurasi perangkat lunak sebagai layanan sistem untuk menggunakan semua fitur AWS IoT Greengrass. Anda dapat menginstal systemd atau menggunakan sistem init yang berbeda. Untuk informasi selengkapnya, lihat Konfigurasikan inti Greengrass sebagai layanan sistem.

  • Jalankan perangkat lunak AWS IoT Greengrass inti tanpa layanan sistem. Anda dapat menjalankan perangkat lunak menggunakan skrip loader yang disiapkan penginstal di folder root Greengrass. Untuk informasi selengkapnya, lihat Jalankan perangkat lunak inti AWS IoT Greengrass tanpa layanan sistem.

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:

  • Periksa apakah perangkat inti Anda dapat terhubung ke internet dan AWS IoT Core. Untuk informasi selengkapnya tentang AWS IoT Core titik akhir yang terhubung dengan perangkat Anda, lihatKonfigurasikan perangkat lunak AWS IoT Greengrass Inti.

  • Periksa apakah perangkat inti Anda AWS IoT menggunakan sertifikat yang memungkinkaniot:Connect,, iot:Publishiot:Receive, dan iot:Subscribe izin.

  • Jika perangkat inti Anda menggunakan proksi jaringan, periksa apakah perangkat inti Anda memiliki peran perangkat dan apakah perannya memungkinkan izin iot:Connect, iot:Publish, iot:Receive, dan iot:Subscribe.

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.

User root is not allowed to execute

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: Could not determine user/group to run with

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. Lihat informasi yang lebih lengkap di Konfigurasikan pengguna yang menjalankan komponen dan Konfigurasikan pengguna komponen default.

Failed to map segment from shared object: operation not permitted

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 hal berikut:

  • Jalankan perintah berikut untuk memasang kembali /tmp folder dengan exec izin dan coba lagi.

    sudo mount -o remount,exec /tmp

  • Jika Anda menjalankan Greengrass nucleus v2.5.0 atau yang lebih baru, Anda dapat menyetel opsi JVM untuk mengubah folder yang digunakan pustaka CRT. AWS Anda dapat menentukan jvmOptions parameter dalam konfigurasi komponen inti Greengrass dalam penerapan atau saat Anda menginstal perangkat lunak Core. AWS IoT Greengrass Ganti /path/to/use dengan path ke folder yang dapat digunakan perpustakaan CRT. AWS 

    {
  "jvmOptions": "-Daws.crt.lib.dir=\"/path/to/use\""
}

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:

  1. Buka zip arsip instalasi AWS IoT Greengrass Core yang diunduh

  2. Di Greengrass direktori buka bin/greengrass.xml.template file.

  3. Tambahkan <autoRefresh> tag ke akhir file tepat sebelum </service> tag.

      </log>
  <autoRefresh>false</autoRefresh>
</service>

com.aws.greengrass.util.exceptions.TLSAuthException: Failed to get trust manager

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 inti AWS IoT Greengrass.

com.aws.greengrass.deployment.IotJobsHelper: No connection available during subscribing to Iot Jobs descriptions topic. Will retry in sometime

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

  • Periksa apakah perangkat inti terhubung ke internet dan dapat mencapai titik akhir AWS IoT data yang Anda konfigurasikan. Untuk informasi selengkapnya tentang titik akhir yang digunakan perangkat inti, lihatIzinkan lalu lintas perangkat melalui proxy atau firewall.

  • Periksa log Greengrass untuk kesalahan lain yang mengungkapkan akar penyebab lainnya.

software.amazon.awssdk.services.iam.model.IamException: The security token included in the request is invalid

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:

  • Jika Anda menggunakan kredensil keamanan sementara, periksa apakah token sesi sudah benar dan Anda menyalin dan menempelkan token sesi lengkap.

  • Jika Anda menggunakan kredensil keamanan jangka panjang, periksa apakah perangkat tidak memiliki token sesi dari waktu di mana Anda sebelumnya menggunakan kredensil sementara. Lakukan hal-hal berikut:

    1. Jalankan perintah berikut untuk menghapus variabel lingkungan token sesi.

      Linux or Unix
      unset AWS_SESSION_TOKEN
      Windows Command Prompt (CMD)
      set AWS_SESSION_TOKEN=
      PowerShell
      Remove-Item Env:\AWS_SESSION_TOKEN

    2. Periksa apakah file AWS kredensialnya,~/.aws/credentials, berisi token sesi,. aws_session_token Jika demikian, hapus baris itu dari file.

      aws_session_token = AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4Olgk

Anda juga dapat menginstal perangkat lunak AWS IoT Greengrass Core tanpa memberikan AWS kredensional. 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: User: <user> is not authorized to perform: iot:GetPolicy

Anda mungkin melihat kesalahan ini saat menginstal perangkat lunak AWS IoT Greengrass Core dengan penyediaan otomatis, dan penginstal menggunakan AWS kredensil 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.

Error: com.aws.greengrass.shadowmanager.sync.model.FullShadowSyncRequest: Could not execute cloud shadow get request

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:

  • iot:GetThingShadow

  • iot:UpdateThingShadow

  • iot:DeleteThingShadow

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

Operation aws.greengrass#<operation> is not supported by 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 (Permission denied)

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: Private key or certificate with label <label> does not exist

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 apakah kunci pribadi dan sertifikat disimpan di HSM menggunakan slot, PIN pengguna, dan label objek yang Anda konfigurasikan perangkat lunak AWS IoT Greengrass Core untuk digunakan.

  • Periksa apakah kunci pribadi dan sertifikat menggunakan label objek yang sama di HSM.

  • Jika HSM Anda mendukung ID objek, periksa apakah kunci pribadi dan sertifikat menggunakan ID objek yang sama di HSM.

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: User: <user> is not authorized to perform: 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.

Untuk mengotorisasi perangkat inti untuk mengunduh rahasia

  1. Tambahkan izin secretsmanager:GetSecretValue ke peran pertukaran token perangkat inti. Contoh pernyataan kebijakan berikut memberikan izin untuk mendapatkan nilai rahasia.

    {
    "Effect": "Allow",
    "Action": [
        "secretsmanager:GetSecretValue"
    ],
    "Resource": [
        "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
    ]
}

    Untuk informasi selengkapnya, lihat Otorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

  2. Terapkan kembali deployment ke perangkat inti. Lakukan salah satu hal berikut:

    • Revisi deployment tanpa perubahan apa pun. Perangkat inti mencoba untuk mengunduh rahasia lagi ketika menerima deployment yang direvisi. Untuk informasi selengkapnya, lihat Revisi deployment.

    • Mulai ulang perangkat lunak AWS IoT Greengrass Core untuk mencoba lagi penyebaran. Lihat informasi yang lebih lengkap di Jalankan perangkat lunak inti AWS IoT Greengrass

    Deployment berhasil jika secret manager berhasil mengunduh rahasia tersebut.

software.amazon.awssdk.services.secretsmanager.model.SecretsManagerException: Access to KMS is not allowed

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 ini, tambahkan kms:Decrypt izin ke peran pertukaran token perangkat inti. Untuk informasi selengkapnya, lihat hal berikut:

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.

Greengrass core device stuck on nucleus 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:

  1. Pada perangkat inti Greengrass Anda, jalankan perintah berikut untuk menghentikan perangkat lunak Greengrass Core.

    Linux or Unix
    sudo systemctl stop greengrass
    Windows Command Prompt (CMD)
    sc stop "greengrass"
    PowerShell
    Stop-Service -Name "greengrass"

  2. Di perangkat inti Anda, unduh AWS IoT Greengrass perangkat lunak ke file bernamagreengrass-2.12.2.zip.

    Linux or Unix
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-2.12.2.zip > greengrass-2.12.2.zip
    Windows Command Prompt (CMD)
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-2.12.2.zip > greengrass-2.12.2.zip
    PowerShell
    iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-2.12.2.zip -OutFile greengrass-2.12.2.zip

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

    Linux or Unix
    unzip greengrass-2.12.2.zip -d GreengrassInstaller && rm greengrass-2.12.2.zip
    Windows Command Prompt (CMD)
    mkdir GreengrassInstaller && tar -xf greengrass-2.12.2.zip -C GreengrassInstaller && del greengrass-2.12.2.zip
    PowerShell
    Expand-Archive -Path greengrass-2.12.2.zip -DestinationPath .\\GreengrassInstaller
rm greengrass-2.12.2.zip

  4. Jalankan perintah berikut untuk mengganti file JAR Greengrass versi 2.12.3 nukleus dengan file JAR Greengrass versi nukleus 2.12.2.

    Linux or Unix
    sudo cp ./GreengrassInstaller/lib/Greengrass.jar /greengrass/v2/packages/artifacts-unarchived/aws.greengrass.Nucleus/2.12.3/aws.greengrass.nucleus/lib
    Windows Command Prompt (CMD)
    robocopy ./GreengrassInstaller/lib/Greengrass.jar /greengrass/v2/packages/artifacts-unarchived/aws.greengrass.Nucleus/2.12.3/aws.greengrass.nucleus/lib /E
    PowerShell
    cp -Path ./GreengrassInstaller/lib/Greengrass.jar -Destination /greengrass/v2/packages/artifacts-unarchived/aws.greengrass.Nucleus/2.12.3/aws.greengrass.nucleus/lib

  5. Jalankan perintah berikut untuk memulai perangkat lunak Greengrass Core.

    Linux or Unix
    sudo systemctl start greengrass
    Windows Command Prompt (CMD)
    sc start "greengrass"
    PowerShell
    Start-Service -Name "greengrass"

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.

An error occurred (AccessDeniedException) when calling the CreateComponentVersion operation: 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.

Invalid Input: Encountered following errors in Artifacts: {<s3ArtifactUri> = Specified artifact resource cannot be accessed}

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:

  • Periksa apakah bucket S3 berada di tempat yang sama Wilayah AWS di mana Anda membuat komponen. AWS IoT Greengrass tidak mendukung permintaan lintas wilayah untuk artefak komponen.

  • Periksa apakah URI artefak adalah URL objek S3 yang valid, dan periksa artefak yang ada di URL objek S3 tersebut.

  • Periksa apakah Anda Akun AWS memiliki izin untuk mengakses artefak di URL objek S3-nya.

INACTIVE deployment status

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

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.

Topik

Error: com.aws.greengrass.componentmanager.exceptions.PackageDownloadException: Failed to download artifact

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 (Service: S3, Status Code: 403, Request ID: null, ...)

PackageDownloadException Kesalahan mungkin termasuk jejak tumpukan ini dalam kasus berikut:

  • Artefak komponen tidak tersedia di URL objek S3 yang Anda tentukan dalam resep komponen. Pastikan Anda mengunggah artefak ke bucket S3 dan URI artefak cocok dengan URL objek S3 dari artefak di bucket.

  • Peran pertukaran token perangkat inti tidak mengizinkan perangkat lunak AWS IoT Greengrass Core mengunduh artefak komponen dari URL objek S3 yang Anda tentukan dalam resep komponen. Periksa apakah peran pertukaran token memungkinkan s3:GetObject URL objek S3 tempat artefak tersedia.

software.amazon.awssdk.services.s3.model.S3Exception: Access Denied (Service: S3, Status Code: 403, Request ID: <requestID>

PackageDownloadException Kesalahan mungkin termasuk jejak tumpukan ini ketika perangkat inti tidak memiliki izin untuk menelepons3: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.

Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption.

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:

  • Periksa apakah file artefak berubah dalam bucket S3 tempat Anda meng-hosting-nya. Jika file berubah sejak Anda membuat komponen, pulihkan ke versi sebelumnya yang diharapkan perangkat inti. Jika Anda tidak dapat memulihkan file ke versi sebelumnya, atau jika Anda ingin menggunakan versi baru dari file itu, buat versi baru dari komponen dengan file artefak.

  • Periksa koneksi internet perangkat inti Anda. Kesalahan ini dapat terjadi jika file artefak rusak saat mengunduh. Buat deployment baru dan coba lagi.

Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component <name> version with cloud and no local applicable version satisfying requirement <requirements>

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 pada 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:

  • Perangkat inti adalah target dari beberapa penyebaran yang memiliki persyaratan versi komponen yang bertentangan. Sebagai contoh, perangkat inti tersebut mungkin menjadi target dari beberapa deployment yang mencakup komponen com.example.HelloWorld, di mana satu deployment memerlukan versi 1.0.0 dan yang lain memerlukan versi 1.0.1. Tidak mungkin memiliki komponen yang memenuhi kedua persyaratan tersebut, sehingga deployment itu gagal.

  • Versi komponen tidak ada di AWS IoT Greengrass layanan atau di perangkat lokal. Komponen mungkin telah dihapus, misalnya.

  • Ada versi komponen yang memenuhi persyaratan versi, tetapi tidak ada yang kompatibel dengan platform perangkat inti.

  • AWS IoT Kebijakan perangkat inti tidak memberikan greengrass:ResolveComponentCandidates izin. Cari Status Code: 403 di log kesalahan untuk mengidentifikasi masalah ini. Untuk mengatasi masalah ini, tambahkan izin greengrass:ResolveComponentCandidates ke kebijakan perangkat inti AWS IoT . Untuk informasi selengkapnya, lihat Kebijakan AWS IoT minimal untuk perangkat inti AWS IoT Greengrass V2.

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: The latest version of Component <componentName> doesn't claim platform <coreDevicePlatform> compatibility

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 hal berikut:

  • Jika komponennya adalah komponen Greengrass kustom, Anda dapat memperbarui komponen agar kompatibel dengan perangkat inti. Tambahkan manifes baru yang cocok dengan platform perangkat inti, atau perbarui manifes yang ada agar sesuai dengan platform perangkat inti. Untuk informasi selengkapnya, lihat AWS IoT Greengrass referensi resep komponen.

  • Jika komponen disediakan oleh AWS, periksa apakah versi lain dari komponen tersebut kompatibel dengan perangkat inti. Jika tidak ada versi yang kompatibel, hubungi kami untuk AWS re:Postmenggunakan AWS IoT Greengrass tag, atau kontak AWS Support.

com.aws.greengrass.componentmanager.exceptions.PackagingException: The deployment attempts to update the nucleus from aws.greengrass.Nucleus-<version> to aws.greengrass.Nucleus-<version> but no component of type nucleus was included as target component

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 hal berikut:

  • Merevisi penerapan untuk menentukan versi inti Greengrass yang saat ini dijalankan perangkat inti.

  • Merevisi penerapan untuk menentukan versi minor selanjutnya dari inti Greengrass. Jika Anda memilih opsi ini, Anda juga harus memperbarui versi semua komponen yang AWS disediakan yang bergantung pada versi minor tertentu dari inti Greengrass. Untuk informasi selengkapnya, lihat Komponen yang disediakan oleh AWS.

Error: com.aws.greengrass.deployment.exceptions.DeploymentException: Unable to process deployment. Greengrass launch directory is not set up or Greengrass is not set up as a system service

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 returned an error when getting full deployment configuration

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.

Warn: com.aws.greengrass.deployment.DeploymentService: Failed to get thing group hierarchy

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, lihatDeploy komponen AWS IoT Greengrass 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: Calling Greengrass cloud to get full deployment configuration

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.

Caused by: software.amazon.awssdk.services.greengrassv2data.model.GreengrassV2DataException: null (Service: GreengrassV2Data, Status Code: 403, Request ID: <some_request_id>, Extended Request ID: 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.

Warn: '<command>' is not recognized as an internal or external command

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:

  • Tambahkan folder executable ke variabel PATH sistem, yang tersedia untuk semua pengguna. Kemudian, restart komponen.

    Jika Anda menjalankan Greengrass nucleus 2.5.0, setelah Anda memperbarui PATH variabel sistem, Anda harus memulai ulang perangkat lunak Core untuk menjalankan komponen AWS IoT Greengrass dengan yang diperbarui. PATH Jika perangkat lunak AWS IoT Greengrass Core tidak menggunakan yang diperbarui PATH setelah Anda memulai ulang perangkat lunak, restart perangkat dan coba lagi. Untuk informasi selengkapnya, lihat Jalankan perangkat lunak inti AWS IoT Greengrass.

  • Tambahkan folder executable ke variabel PATH pengguna untuk pengguna sistem yang menjalankan komponen.

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:

  • Jalankan Python dengan -u untuk menonaktifkan buffering pada stdout dan stderr.

    Linux or Unix
    python3 -u hello_world.py
    Windows
    py -3 -u hello_world.py

  • Gunakan Setenv dalam resep komponen Anda untuk mengatur variabel lingkungan PYTHONUNBUFFERED pada string tak kosong. Variabel lingkungan ini menonaktifkan buffering pada stdout dan stderr.

  • Siram buffer untuk pengaliran stdout atau stderr. Lakukan salah satu hal berikut:

    • Siram pesan ketika Anda mencetak.

      import sys

print('Hello, error!', file=sys.stderr, flush=True)

    • Siram pesan setelah Anda mencetak. Anda dapat mengirim beberapa pesan sebelum Anda menyiram stream.

      import sys

print('Hello, error!', file=sys.stderr)
sys.stderr.flush()

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.

Console
Setel ulang jalur
[""]
AWS CLI

Perintah berikut membuat penyebaran ke perangkat inti.

aws greengrassv2 create-deployment --cli-input-json file://reset-configuration-deployment.json

reset-configuration-deployment.jsonFile berisi dokumen JSON berikut.

{
  "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
  "deploymentName": "Deployment for MyGreengrassCore",
  "components": {
    "com.example.HelloWorld": {
      "componentVersion": "1.0.0",
      "configurationUpdate": {,
        "reset": [""]
      }
    }
  }
}
Greengrass CLI

Perintah Greengrass CLI berikut membuat penerapan lokal pada perangkat inti.

sudo greengrass-cli deployment create \
  --recipeDir recipes \
  --artifactDir artifacts \
  --merge "com.example.HelloWorld=1.0.0" \
  --update-config reset-configuration-deployment.json

reset-configuration-deployment.jsonFile berisi dokumen JSON berikut.

{
  "com.example.HelloWorld": {
    "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.

Tip

Jika Anda mengubah resep DefaultConfiguration dalam komponen, Anda harus mengatur ulang konfigurasi komponen ke konfigurasi default yang baru. Saat Anda menerapkan komponen, tentukan satu string kosong sebagai pembaruan reset. Untuk informasi selengkapnya, lihat Konfigurasi komponen tidak diperbarui saat mengubah konfigurasi default.

com.aws.greengrass.authorization.exceptions.AuthorizationException: Duplicate policy ID "<id>" for principal "<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.

Tip

Jika Anda mengubah resep DefaultConfiguration dalam komponen, Anda harus mengatur ulang konfigurasi komponen ke konfigurasi default yang baru. Saat Anda menerapkan komponen, tentukan satu string kosong sebagai pembaruan reset. Untuk informasi selengkapnya, lihat Konfigurasi komponen tidak diperbarui saat mengubah konfigurasi default.

com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 400)

Anda mungkin melihat kesalahan ini ketika perangkat inti tidak bisa mendapatkan AWS kredensil 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 kredensional untuk mengasumsikan itu.

Lakukan hal-hal berikut:

  1. Identifikasi peran pertukaran token yang digunakan perangkat inti. Pesan kesalahan mencakup alias AWS IoT peran perangkat inti, yang menunjuk ke peran pertukaran token. Jalankan perintah berikut di komputer pengembangan Anda, dan ganti MyGreengrassCoreTokenExchangeRoleAliasdengan nama alias AWS IoT peran dari pesan kesalahan.

    aws iot describe-role-alias --role-alias MyGreengrassCoreTokenExchangeRoleAlias

    Tanggapan tersebut mencakup Nama Sumber Daya Amazon (ARN) dari peran IAM pertukaran token.

    {
  "roleAliasDescription": {
    "roleAlias": "MyGreengrassCoreTokenExchangeRoleAlias",
    "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/MyGreengrassCoreTokenExchangeRoleAlias",
    "roleArn": "arn:aws:iam::123456789012:role/MyGreengrassV2TokenExchangeRole",
    "owner": "123456789012",
    "credentialDurationSeconds": 3600,
    "creationDate": "2021-02-05T16:46:18.042000-08:00",
    "lastModifiedDate": "2021-02-05T16:46:18.042000-08:00"
  }
}

  2. Periksa apakah peran itu ada. Jalankan perintah berikut, dan ganti MyGreengrassV2 TokenExchangeRole dengan nama peran pertukaran token.

    aws iam get-role --role-name MyGreengrassV2TokenExchangeRole

    Jika perintah mengembalikan NoSuchEntity kesalahan, peran tidak ada, dan Anda harus membuatnya. Untuk informasi selengkapnya tentang cara membuat dan mengonfigurasi peran ini, lihatOtorisasi perangkat inti untuk berinteraksi dengan AWS layanan.

  3. Periksa apakah peran tersebut memiliki hubungan kepercayaan yang memungkinkan penyedia AWS IoT kredensional untuk mengasumsikannya. Tanggapan dari langkah sebelumnya berisiAssumeRolePolicyDocument, yang mendefinisikan hubungan kepercayaan peran. Peran harus mendefinisikan hubungan kepercayaan yang memungkinkan credentials.iot.amazonaws.com untuk mengasumsikan itu. Dokumen ini akan terlihat mirip dengan contoh berikut.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "credentials.iot.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

    Jika hubungan kepercayaan peran tidak memungkinkan credentials.iot.amazonaws.com untuk mengasumsikan itu, Anda harus menambahkan hubungan kepercayaan ini ke peran tersebut. Untuk informasi selengkapnya, lihat Memodifikasi peran dalam Panduan AWS Identity and Access Management Pengguna.

com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 403)

Anda mungkin melihat kesalahan ini ketika perangkat inti tidak bisa mendapatkan AWS kredensil 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 Kebijakan AWS IoT minimal untuk perangkat inti AWS IoT Greengrass V2 danMemperbarui AWS IoT kebijakan perangkat inti.

com.aws.greengrass.tes.CredentialsProviderError: Could not load credentials from any providers

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

Lakukan hal-hal berikut:

  • Periksa apakah komponen mendeklarasikan ketergantungan pada komponen layanan pertukaran token,. aws.greengrass.TokenExchangeService Jika tidak, tambahkan ketergantungan dan gunakan kembali komponen.

  • Jika komponen berjalan di docker, pastikan Anda menerapkan pengaturan jaringan dan variabel lingkungan yang tepat, sesuai dengan. Gunakan AWS kredensil dalam komponen wadah Docker (Linux)

  • Jika komponen ditulis dalam NodeJS, atur dns. setDefaultResultPerintah untukipv4first.

  • Periksa /etc/hosts entri yang dimulai dengan ::1 dan berisilocalhost. Hapus entri untuk melihat apakah itu menyebabkan komponen terhubung ke layanan pertukaran token di alamat yang salah.

Received error when attempting to retrieve ECS metadata: Could not connect to the endpoint URL: "<tokenExchangeServiceEndpoint>"

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

Lakukan hal-hal berikut:

  • Periksa apakah komponen mendeklarasikan ketergantungan pada komponen layanan pertukaran token,. aws.greengrass.TokenExchangeService Jika tidak, tambahkan ketergantungan dan gunakan kembali komponen.

  • Periksa apakah komponen menggunakan AWS kredensional dalam siklus hidupnyainstall. AWS IoT Greengrass tidak menjamin ketersediaan layanan pertukaran token selama install siklus hidup. Perbarui komponen untuk memindahkan kode yang menggunakan AWS kredensil ke dalam run siklus hidup startup atau, lalu gunakan kembali komponen.

copyFrom: <configurationPath> is already a container, not a leaf

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:

  1. Periksa resep komponen untuk melihat apakah konfigurasi defaultnya menetapkan nilai konfigurasi itu ke daftar atau objek. Jika demikian, hapus atau ubah nilai konfigurasi itu.

  2. Buat penerapan untuk mengatur ulang nilai konfigurasi itu ke nilai defaultnya. Lihat informasi yang lebih lengkap di Buat deployment dan Perbarui konfigurasi komponen.

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

com.aws.greengrass.componentmanager.plugins.docker.exceptions.DockerLoginException: Error logging into the registry using credentials - 'The stub received bad data.'

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 kredensil login.

Ambil salah satu tindakan berikut:

  • Jika Anda tidak menggunakan pembantu kredenal wincred Docker, hapus docker-credential-wincred program dari perangkat inti.

  • Jika Anda menggunakan pembantu kredenal wincred Docker, lakukan hal berikut:

    1. Ganti nama docker-credential-wincred program pada perangkat inti. Ganti wincred dengan nama baru untuk pembantu kredenal Windows Docker. Misalnya, Anda dapat mengganti namanya menjadidocker-credential-wincredreal.

    2. Perbarui credsStore opsi di file konfigurasi Docker (.docker/config.json) untuk menggunakan nama baru untuk pembantu kredensi Windows Docker. Misalnya, jika Anda mengganti nama program menjadidocker-credential-wincredreal, perbarui credsStore opsi kewincredreal.

      {
  "credsStore": "wincredreal"
}

java.io.IOException: Cannot run program "cmd" ...: [LogonUser] The password for this account has expired.

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.

Untuk memperbarui kata sandi pengguna sistem Greengrass

  1. Jalankan perintah berikut sebagai administrator untuk mengatur kata sandi pengguna. Ganti ggc_user dengan pengguna sistem, dan ganti kata sandi dengan kata sandi yang akan disetel.

    net user ggc_user password

  2. Gunakan PsExec utilitas untuk menyimpan kata sandi baru pengguna di instance Credential Manager untuk LocalSystem akun tersebut. Ganti kata sandi dengan kata sandi pengguna yang Anda tetapkan.

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

Bergantung pada konfigurasi Windows Anda, kata sandi pengguna mungkin diatur untuk kedaluwarsa pada tanggal di masa mendatang. Untuk memastikan aplikasi Greengrass Anda terus beroperasi, lacak kapan kata sandi kedaluwarsa, dan perbarui sebelum kedaluwarsa. Anda juga dapat mengatur kata sandi pengguna agar tidak pernah kedaluwarsa.

  • Untuk memeriksa kapan pengguna dan kata sandinya kedaluwarsa, jalankan perintah berikut.

    net user ggc_user | findstr /C:expires

  • Untuk mengatur kata sandi pengguna agar tidak pernah kedaluwarsa, jalankan perintah berikut.

    wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

  • Jika Anda menggunakan Windows 10 atau yang lebih baru di mana wmicperintah tidak digunakan lagi, jalankan perintah berikut. PowerShell 

    Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

aws.greengrass.StreamManager: Instant exceeds minimum or maximum instant

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 pengelola aliran, lihatManajer pengaliran.

Masalah komponen fungsi Lambda perangkat inti

Memecahkan masalah komponen fungsi Lambda pada perangkat inti.

The following cgroup subsystems are not mounted: devices, memory

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

  • Perangkat inti tidak mengaktifkan cgroup v1 untuk memori atau cgroup perangkat.

  • Perangkat inti telah mengaktifkan cgroups v2. Fungsi Greengrass Lambda membutuhkan cgroups v1, dan cgroups v1 dan v2 saling eksklusif.

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

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0
Tip

Pada Raspberry Pi, edit /boot/cmdline.txt file untuk mengatur parameter kernel perangkat.

ipc_client.py:64,HTTP Error 400:Bad Request, b'No subscription exists for the source <label-or-lambda-arn> and subject <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

  1. Jalankan perintah berikut untuk mendapatkan daftar perangkat inti Anda.

    aws greengrassv2 list-core-devices

  2. Jalankan perintah berikut untuk mengambil status komponen pada setiap perangkat inti dari Langkah 1. Ganti coreDeviceName dengan nama setiap perangkat inti untuk kueri.

    aws greengrassv2 list-installed-components --core-device-thing-name coreDeviceName

  3. Kumpulkan perangkat inti dengan versi komponen yang dihentikan yang diinstal dari langkah sebelumnya.

  4. Jalankan perintah berikut untuk mengambil status semua pekerjaan penerapan untuk setiap perangkat inti dari Langkah 3. Ganti coreDeviceName dengan nama perangkat inti untuk kueri.

    aws greengrassv2 list-effective-deployments --core-device-thing-name coreDeviceName

    Tanggapan berisi daftar tugas deployment untuk perangkat inti. Anda dapat merevisi penerapan untuk memilih versi komponen lain. Untuk informasi selengkapnya tentang cara merevisi penerapan, lihat Merevisi penerapan.

Masalah Antarmuka Baris Perintah Greengrass

Memecahkan masalah dengan CLI Greengrass.

java.lang.RuntimeException: Unable to create ipc client

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:

  • Atur GGC_ROOT_PATH variabel lingkungan ke /greengrass/v2.

  • Tambahkan --ggcRootPath /greengrass/v2 argumen ke perintah Anda seperti yang ditunjukkan pada contoh berikut.

    greengrass-cli --ggcRootPath /greengrass/v2 <command> <subcommand> [arguments]

AWS Command Line Interface masalah

Memecahkan AWS CLI masalah untuk. AWS IoT Greengrass V2

Error: Invalid choice: '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:

  • Versi AWS CLI V1 minimum: v1.18.197

  • Versi AWS CLI V2 minimum: v2.1.11

Tip

Anda dapat menjalankan perintah berikut untuk memeriksa versi AWS CLI yang Anda miliki.

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 .