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
**Topics**
+ [Tampilan AWS IoT Greengrass Perangkat lunak inti dan log komponen](#troubleshoot-with-logs)
+ [AWS IoT Greengrass Masalah perangkat lunak inti](#greengrass-core-issues)
+ [AWS IoT Greengrass masalah cloud](#greengrass-cloud-issues)
+ [Masalah deployment perangkat inti](#greengrass-core-deployment-issues)
+ [Masalah komponen perangkat inti](#greengrass-core-component-issues)
+ [Masalah komponen fungsi Lambda perangkat inti](#greengrass-core-lambda-function-issues)
+ [Versi komponen dihentikan](#discontinued-component-version)
+ [Masalah Antarmuka Baris Perintah Greengrass](#greengrass-cli-issues)
+ [AWS Command Line Interface masalah](#aws-cli-issues)
+ [Kode kesalahan penyebaran terperinci](troubleshooting-deployment.md)
+ [Kode status komponen terperinci](troubleshooting-component.md)
## 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](monitor-logs.md).
## AWS IoT Greengrass Masalah perangkat lunak inti
Memecahkan masalah perangkat lunak AWS IoT Greengrass inti.
**Topics**
+ [ThrottlingException dari ListDeployments API](#ThrottlingException)
+ [Tidak dapat mengatur perangkat inti](#unable-to-set-up-core-device)
+ [Tidak dapat memulai AWS IoT Greengrass Perangkat lunak inti sebagai layanan sistem](#unable-to-start-system-service)
+ [Tidak dapat mengatur inti sebagai layanan sistem](#unable-to-set-up-system-service)
+ [Tidak dapat terhubung ke AWS IoT Core](#core-error-unable-to-connect-to-aws-iot)
+ [Kesalahan kehabisan memori](#java-out-of-memory)
+ [Tidak dapat menginstal Greengrass CLI](#unable-to-install-greengrass-cli)
+ [Root pengguna tidak diizinkan untuk mengeksekusi](#user-not-allowed-to-execute)
+ [com.aws.greengrass.lifecyclemanager. GenericExternalService: Tidak dapat menentukan user/group untuk menjalankan dengan](#missing-default-run-with-user)
+ [Gagal memetakan segmen dari objek bersama: operasi tidak diizinkan](#tmp-folder-noexec)
+ [Gagal mengatur layanan Windows](#failed-to-set-up-windows-service)
+ [com.aws.greengrass.util.exceptions. TLSAuthException: Gagal mendapatkan manajer kepercayaan](#failed-to-get-trust-manager)
+ [com.aws.greengrass.deployment. IotJobsHelper: Tidak ada koneksi yang tersedia selama berlangganan topik deskripsi Iot Jobs. Akan mencoba lagi di suatu saat](#iot-jobs-no-connection-available)
+ [software.amazon.awssdk.services.iam.model. IamException: Token keamanan yang disertakan dalam permintaan tidak valid](#error-invalid-security-token)
+ [software.amazon.awssdk.services.iot.model. IotException: Pengguna: < pengguna > tidak berwenang untuk melakukan: iot: GetPolicy](#missing-automatic-provisioning-permissions)
+ [Kesalahan: com.aws.greengrass.shadowmanager.sync.model. FullShadowSyncRequest: Tidak dapat menjalankan permintaan cloud shadow get](#shadow-manager-error-could-not-execute-shadow-get-request)
+ [Operasi aws.greengrass\# operasi tidak didukung oleh < Greengrass >](#ipc-operation-not-supported)
+ [java.io. FileNotFoundException: < stream-manager-store-root-dir /stream\_manager\_metadata\_store > (Izin ditolak)](#stream-manager-store-root-folder-not-found)
+ [com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: Kunci pribadi atau sertifikat dengan < label label > tidak ada](#pkcs11-provider-error-private-key-or-certificate-does-not-exist)
+ [software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Pengguna: < pengguna > tidak berwenang untuk melakukan: secretsmanager: GetSecretValue on resource: arn < >](#secret-manager-error-not-authorized-to-perform-get-secret-value)
+ [software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Akses ke KMS tidak diperbolehkan](#secret-manager-error-no-kms-access)
+ [java.lang. NoClassDefFoundError: com/aws/greengrass/security/CryptoKeySpi](#hardware-security-incompatible-nucleus-version)
+ [com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: CKR\_OPERATION\_NOT\_INITIALIZED](#ckr-operation-not-initialized)
+ [Perangkat inti Greengrass terjebak di nukleus v2.12.3](#v2.12.3-revise-deployment)
+ [Masalah template systemd Greengrass nucleus v2.14.0](#v2.14.0-systemd-template)
### ThrottlingException dari ListDeployments API
`ThrottlingException`dari `ListDeployments` API: Anda mungkin melihat ini ketika Anda memiliki sejumlah besar penerapan di akun.
Untuk mengatasi ini, lakukan salah satu hal berikut:
+ Jika Anda menggunakan SDK, tentukan MaxResult parameter. Misalnya, untuk [JavaSDK](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/greengrassv2/model/ListDeploymentsRequest.html#maxResults) dengan nilai kecil (misalnya 5).
+ Anda dapat menggunakan [AWS Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html) untuk meminta kenaikan batas batas tarif API. `DescribeJob` Anda dapat pergi ke konsol kuota Layanan, pilih kuota AWS IoT dan nama limit adalah batas **DescribeJob throttle**. Anda dapat meningkatkannya dari 10 menjadi 50.
### 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](uninstall-greengrass-core-v2.md).
### 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](monitor-logs.md#access-system-service-logs) 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](https://en.wikipedia.org/wiki/Systemd). Penginstal dapat berhasil mengatur perangkat lunak AWS IoT Greengrass Core bahkan jika gagal mengatur layanan sistem.
Lakukan salah satu tindakan 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](https://en.wikipedia.org/wiki/Systemd) atau menggunakan sistem init yang berbeda. Untuk informasi selengkapnya, lihat [Konfigurasikan inti Greengrass sebagai layanan sistem](configure-greengrass-core-v2.md#configure-system-service).
+ 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 AWS IoT Greengrass Core tanpa layanan sistem](run-greengrass-core-v2.md#run-greengrass-core-no-system-service).
### 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, lihat[Konfigurasikan perangkat lunak AWS IoT Greengrass Inti](configure-greengrass-core-v2.md).
+ Periksa apakah perangkat inti Anda AWS IoT menggunakan sertifikat yang memungkinkan`iot:Connect`,, `iot:Publish``iot:Receive`, dan `iot:Subscribe` izin.
+ Jika perangkat inti Anda menggunakan [proksi jaringan](configure-greengrass-core-v2.md#configure-network-proxy), periksa apakah perangkat inti Anda memiliki [peran perangkat](device-service-role.md) 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](configure-greengrass-core-v2.md#jvm-tuning).
### 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](install-gg-cli.md).
### Root pengguna tidak diizinkan untuk mengeksekusi
Anda mungkin melihat kesalahan ini ketika pengguna yang menjalankan perangkat lunak AWS IoT Greengrass Core (biasanya`root`) 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 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](configure-greengrass-core-v2.md#configure-component-user) dan [Konfigurasikan pengguna komponen default](configure-greengrass-core-v2.md#configure-default-component-user).
### 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)](https://github.com/awslabs/aws-crt-java) menggunakan `/tmp` folder secara default.
Lakukan salah satu tindakan 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 mengatur opsi JVM untuk mengubah folder yang digunakan perpustakaan 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 jalur ke folder yang dapat digunakan perpustakaan AWS CRT.
```
{
"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, lihat[Platform yang didukung](greengrass-nucleus-component.md#greengrass-v2-supported-platforms).
Jika Anda harus menggunakan Windows 2016, Anda dapat melakukan hal berikut:
1. Buka zip arsip instalasi AWS IoT Greengrass Core yang diunduh
1. Di `Greengrass` direktori buka `bin/greengrass.xml.template` file.
1. Tambahkan `` tag ke akhir file tepat sebelum `` tag.
```
false
```
### 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](install-greengrass-core-v2.md).
### 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:
+ Periksa apakah perangkat inti terhubung ke internet dan dapat mencapai titik akhir AWS IoT data yang Anda konfigurasi. Untuk informasi selengkapnya tentang titik akhir yang digunakan perangkat inti, lihat[Izinkan lalu lintas perangkat melalui proxy atau firewall](allow-device-traffic.md).
+ Periksa log Greengrass untuk kesalahan lain yang mengungkapkan akar penyebab lainnya.
### 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](quick-installation.md) menggunakan token AWS sesi yang tidak valid. Lakukan hal-hal berikut:
+ Jika Anda menggunakan kredensyal keamanan sementara, periksa apakah token sesi sudah benar dan Anda menyalin dan menempelkan token sesi lengkap.
+ Jika Anda menggunakan kredensyal keamanan jangka panjang, periksa apakah perangkat tidak memiliki token sesi dari waktu di mana Anda sebelumnya menggunakan kredensyal 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
```
------
1. 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 kredensyal. Untuk informasi selengkapnya, lihat [Instal perangkat lunak AWS IoT Greengrass Core dengan penyediaan sumber daya manual](manual-installation.md) atau [Instal perangkat lunak AWS IoT Greengrass Core dengan penyediaan AWS IoT armada](fleet-provisioning.md).
### 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](quick-installation.md) menggunakan AWS kredensyal yang tidak memiliki izin yang diperlukan. Untuk informasi selengkapnya tentang izin yang diperlukan, lihat[Kebijakan IAM minimal untuk penginstal untuk menyediakan sumber daya](provision-minimal-iam-policy.md).
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](shadow-manager-component.md) untuk [menyinkronkan bayangan perangkat dengan AWS IoT Core](sync-shadows-with-iot-core.md). Kode status HTTP 403 menunjukkan bahwa kesalahan ini terjadi karena AWS IoT kebijakan perangkat inti tidak memberikan izin untuk memanggil`GetThingShadow`.
```
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 berikut ini:
+ [AWS IoT Core tindakan kebijakan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) dalam *Panduan AWS IoT Pengembang*
+ [Memperbarui AWS IoT kebijakan perangkat inti](device-auth.md#update-core-device-iot-policy)
### Operasi aws.greengrass\# operasi tidak didukung oleh < Greengrass >
Anda mungkin melihat kesalahan ini saat menggunakan [operasi komunikasi antarproses (IPC)](interprocess-communication.md) 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](component-recipe-reference.md#recipe-reference-component-dependencies), sehingga perangkat lunak AWS IoT Greengrass Core menginstal komponen yang diperlukan saat Anda menerapkan komponen Anda.
+ [Mengambil nilai rahasia](ipc-secret-manager.md) — `aws.greengrass.SecretManager`
+ [Berinteraksi dengan bayangan lokal](ipc-local-shadows.md) — `aws.greengrass.ShadowManager`
+ [Mengelola penerapan dan komponen lokal](ipc-local-deployments-components.md) — `aws.greengrass.Cli` v2.6.0 atau yang lebih baru
+ [Mengautentikasi dan mengotorisasi perangkat klien](ipc-client-device-auth.md) - `aws.greengrass.clientdevices.Auth` v2.2.0 atau yang lebih baru
### 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](stream-manager-component.md) untuk menggunakan folder root yang tidak ada atau memiliki izin yang benar. Untuk informasi selengkapnya tentang cara mengonfigurasi folder ini, lihat [konfigurasi manajer aliran](stream-manager-component.md#stream-manager-component-configuration).
### com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: Kunci pribadi atau sertifikat dengan < label label > tidak ada
Kesalahan ini terjadi ketika [komponen penyedia PKCS \#11](pkcs11-provider-component.md) 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](hardware-security.md)). 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: Pengguna: < pengguna > tidak berwenang untuk melakukan: secretsmanager: GetSecretValue on resource: arn < >
Kesalahan ini dapat terjadi ketika Anda menggunakan [komponen manajer rahasia](secret-manager-component.md) untuk menyebarkan AWS Secrets Manager rahasia. Jika [IAM role pertukaran token](device-service-role.md) 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 layanan AWS](device-service-role.md).
1. Terapkan kembali deployment ke perangkat inti. Lakukan salah satu tindakan 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](revise-deployments.md).
+ Mulai ulang perangkat lunak AWS IoT Greengrass Core untuk mencoba lagi penyebaran. Untuk informasi selengkapnya, lihat [Jalankan perangkat lunak AWS IoT Greengrass Core](run-greengrass-core-v2.md)
Deployment berhasil jika secret manager berhasil mengunduh rahasia tersebut.
### software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Akses ke KMS tidak diperbolehkan
Kesalahan ini dapat terjadi ketika Anda menggunakan [komponen manajer rahasia](secret-manager-component.md) untuk menyebarkan AWS Secrets Manager rahasia yang dienkripsi oleh kunci. AWS Key Management Service Jika [peran IAM pertukaran token](device-service-role.md) 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:
+ [Enkripsi rahasia dan dekripsi](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html) *dalam Panduan Pengguna AWS Secrets Manager *
+ [Otorisasi perangkat inti untuk berinteraksi dengan layanan AWS](device-service-role.md)
### 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](hardware-security.md) 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](pkcs11-provider-component.md) 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:
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"
```
------
1. Di perangkat inti Anda, unduh AWS IoT Greengrass perangkat lunak ke file bernama`greengrass-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
```
------
1. Buka zip perangkat lunak AWS IoT Greengrass Core ke folder di perangkat Anda. Ganti {{GreengrassInstaller}} dengan 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
```
------
1. 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
```
------
1. 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"
```
------
### 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:
1. Pada perangkat inti Greengrass Anda, jalankan perintah berikut untuk mengembalikan file layanan systemd seperti di nucleus v2.13.0 dan sebelumnya.
------
#### [ Linux or Unix ]
```
sudo sed -i 's|ExecStart=/bin/sh -c "\(.*\) >> .*/logs/loader.log 2>&1"|ExecStart=/bin/sh \1|' /etc/systemd/system/greengrass.service
```
------
1. Terapkan perubahan.
------
#### [ Linux or Unix ]
```
sudo systemctl daemon-reload
sudo systemctl restart 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.
### 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 [CreateComponentVersion](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateComponentVersion.html)operasi.
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: { = Sumber daya artefak tertentu tidak dapat diakses}
Anda mungkin melihat kesalahan ini saat membuat versi komponen dari AWS IoT Greengrass konsol atau dengan [CreateComponentVersion](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateComponentVersion.html)operasi. 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.
### Status penyebaran TIDAK AKTIF
Anda mungkin mendapatkan status `INACTIVE` penerapan saat memanggil [ListDeployments](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_ListDeployments.html)API 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](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotgreengrassv2.html#awsiotgreengrassv2-actions-as-permissions) dan mengikuti izin yang diperlukan`ListDeployments`. 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 [CreateDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateDeployment.html)operasi untuk diterapkan ke grup AWS IoT sesuatu atau benda. `CreateDeployment`Panggilan mengembalikan kode `200` status dengan ID penerapan yang valid. Namun, saat Anda menelepon [GetDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_GetDeployment.html)dengan 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:
+ Hindari mengirim `CreateDeployment` permintaan bersamaan yang menargetkan AWS IoT hal yang sama. Serialisasi permintaan penerapan Anda atau tambahkan penundaan di antara mereka untuk memastikan bahwa hanya satu `CreateDeployment` panggilan yang menargetkan hal tertentu pada satu waktu.
+ Jika masalah ini sudah memengaruhi target Anda, penerapan berikutnya mungkin terus menampilkan 404 kesalahan. Untuk mengatasi hal ini, hapus catatan penerapan basi untuk target yang terpengaruh sehingga penerapan berikutnya dapat dilanjutkan secara normal.
## 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.
**Topics**
+ [Kesalahan: com.aws.greengrass.componentmanager.exceptions. PackageDownloadException: Gagal mengunduh artefak](#core-error-failed-to-download-artifact-package-download-exception)
+ [Kesalahan: com.aws.greengrass.componentmanager.exceptions. ArtifactChecksumMismatchException: Pemeriksaan integritas untuk artefak yang diunduh gagal. Mungkin karena korupsi berkas.](#core-error-failed-to-download-artifact-checksum-mismatch-exception)
+ [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 < >](#core-error-no-available-component-version)
+ [software.amazon.awssdk.services.greengrassv2data.model. ResourceNotFoundException: Versi terbaru < Component componentName > tidak mengklaim kompatibilitas < inti DevicePlatform > platform](#deployment-error-no-platform-compatibility)
+ [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 < >](#deployment-error-nucleus-minor-version-update)
+ [Kesalahan: com.aws.greengrass.deployment.exceptions. DeploymentException: Tidak dapat memproses penerapan. Direktori peluncuran Greengrass tidak disiapkan atau Greengrass tidak disiapkan sebagai layanan sistem](#deployment-error-unable-to-process-deployment)
+ [Info: com.aws.greengrass.deployment.exceptions. RetryableDeploymentDocumentDownloadException: Greengrass Cloud Service mengembalikan kesalahan saat mendapatkan konfigurasi penerapan penuh](#core-error-getting-full-deployment-configuration)
+ [Peringatkan: com.aws.greengrass.deployment. DeploymentService: Gagal mendapatkan hierarki grup benda](#core-warning-failed-to-get-thing-group-hierarchy)
+ [Info: com.aws.greengrass.deployment. DeploymentDocumentDownloader: Memanggil Greengrass cloud untuk mendapatkan konfigurasi penerapan penuh](#core-info-repetitive-get-full-deployment-configuration)
+ [Disebabkan oleh: software.amazon.awssdk.services.greengrassv2data.model. GreengrassV2DataException: null (Layanan: GreenGrassV2Data, Kode Status: 403, ID Permintaan: < > some\_request\_id, ID Permintaan Diperpanjang: null)](#greengrassv2dataexception)
### 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`.
**Topics**
+ [Software.amazon.awssdk.services.s3.model.s3Exception: null (Layanan: S3, Kode Status: 403, ID Permintaan: null,...)](#core-error-failed-to-download-artifact-s3-permissions)
+ [Software.amazon.awssdk.services.s3.model.s3Exception: Akses Ditolak (Layanan: S3, Kode Status: 403, ID Permintaan: RequeStyD < >](#core-error-failed-to-download-artifact-get-bucket-location-403)
#### Software.amazon.awssdk.services.s3.model.s3Exception: null (Layanan: S3, Kode Status: 403, ID Permintaan: null,...)
[PackageDownloadException Kesalahan](#core-error-failed-to-download-artifact-package-download-exception) 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](device-service-role.md) 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: Akses Ditolak (Layanan: S3, Kode Status: 403, ID Permintaan: RequeStyD < >
[PackageDownloadException Kesalahan](#core-error-failed-to-download-artifact-package-download-exception) mungkin termasuk jejak tumpukan ini ketika perangkat inti tidak memiliki izin untuk memanggil`s3:GetBucketLocation`. Pesan kesalahan juga menyertakan pesan berikut.
```
reason: Failed to determine S3 bucket location
```
Periksa apakah [peran pertukaran token](device-service-role.md) 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:
+ 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.
### 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:
+ 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 [AWS IoT Kebijakan minimal untuk perangkat AWS IoT Greengrass V2 inti](device-auth.md#greengrass-core-minimal-iot-policy).
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](revise-deployments.md). Untuk informasi selengkapnya tentang cara merevisi deployment lokal, lihat perintah [AWS IoT Greengrass Buat CLI deployment](gg-cli-deployment.md#deployment-create).
### 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:
+ 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](component-recipe-reference.md).
+ Jika komponen disediakan oleh AWS, periksa apakah versi lain dari komponen kompatibel dengan perangkat inti. Jika tidak ada versi yang kompatibel, hubungi kami untuk [AWS re:Post](https://repost.aws/)menggunakan [AWS IoT Greengrass tag](https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass), atau kontak [Dukungan](https://aws.amazon.com/contact-us/).
### 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](greengrass-nucleus-component.md) 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](update-greengrass-core-v2.md#ota-update-behavior-nucleus).
Anda harus [merevisi penerapan](revise-deployments.md) untuk menentukan versi inti Greengrass yang ingin Anda gunakan. Lakukan salah satu tindakan 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](public-components.md).
### 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 bernama`fix_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](device-auth.md#update-core-device-iot-policy).
### 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](greengrass-nucleus-component.md) 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, lihat[Menyebarkan AWS IoT Greengrass komponen ke perangkat](manage-deployments.md).
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](device-auth.md#update-core-device-iot-policy).
### 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](#core-error-getting-full-deployment-configuration).
### 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 menerima`GreengrassV2DataException: 403`. Untuk membuat kebijakan izin, ikuti petunjuk berikut:[Buat AWS IoT kebijakan](fleet-provisioning-setup.md#create-iot-policy).
## Masalah komponen perangkat inti
Memecahkan masalah komponen Greengrass pada perangkat inti.
**Topics**
+ [Peringatkan: > ' "<>ComponentList”](#ipc-duplicate-authorization-policy-ids)
+ [com.aws.greengrass.tes. CredentialRequestHandler: Kesalahan dalam mengambil AwsCredentials dari TES (HTTP 400)](#token-exchange-service-credentials-http-400)
+ [com.aws.greengrass.tes. CredentialRequestHandler: Kesalahan dalam mengambil AwsCredentials dari TES (HTTP 403)](#token-exchange-service-credentials-http-403)
+ [com.aws.greengrass.tes. CredentialsProviderError: Tidak dapat memuat kredensyal dari penyedia mana pun](#token-exchange-service-credentials-provider-error)
+ [Kesalahan yang diterima saat mencoba mengambil metadata ECS: Tidak dapat terhubung ke URL titik akhir: "token” < ExchangeServiceEndpoint >](#token-exchange-service-not-running)
+ [CopyFrom: < ConfigurationPath > sudah menjadi wadah, bukan daun](#configuration-key-is-container-cannot-become-leaf)
+ [com.aws.greengrass.componentmanager.plugins.docker.exceptions. DockerLoginException: Kesalahan saat masuk ke registri menggunakan kredensil - 'Rintisan menerima data buruk. '](#docker-login-stub-received-bad-data)
+ [java.io.IOException: Tidak dapat menjalankan program “cmd”...: [LogonUser] Kata sandi untuk akun ini telah kedaluwarsa.](#windows-account-password-expired)
+ [aws.greengrass. StreamManager: Instan melebihi minimum atau maksimum instan](#stream-manager-instant-exceeds-maximun-minimum)
### Peringatkan: > '
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, seperti`ggc_user`, tidak dapat menemukan perintah yang dapat dieksekusi di folder di PATH.](https://en.wikipedia.org/wiki/PATH_(variable))
Pada perangkat Windows, periksa apakah folder yang berisi executable ada di `PATH` untuk pengguna sistem yang menjalankan komponen. Jika hilang dari`PATH`, 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 AWS IoT Greengrass Core](run-greengrass-core-v2.md).
+ 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](https://docs.python.org/3/using/cmdline.html#cmdoption-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](component-recipe-reference.md#lifecycle-setenv-definition) dalam resep komponen Anda untuk mengatur variabel lingkungan [PYTHONUNBUFFERED](https://docs.python.org/3/using/cmdline.html#envvar-PYTHONUNBUFFERED) pada string tak kosong. Variabel lingkungan ini menonaktifkan buffering pada `stdout` dan `stderr`.
+ Siram buffer untuk pengaliran `stdout` atau `stderr`. Lakukan salah satu tindakan 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](monitor-logs.md).
### 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](update-component-configurations.md#reset-configuration-update).
------
#### [ 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.json`File 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](greengrass-cli-component.md) 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.json`File 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](interprocess-communication.md#ipc-authorization-policies).
**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](update-component-configurations.md#reset-configuration-update). Untuk informasi selengkapnya, lihat [Konfigurasi komponen tidak diperbarui saat mengubah konfigurasi default](#update-component-configuration-to-default-configuration).
### com.aws.greengrass.authorization.exceptions. AuthorizationException: ID kebijakan duplikat " "<>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](interprocess-communication.md#ipc-authorization-policies).
**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](update-component-configurations.md#reset-configuration-update). Untuk informasi selengkapnya, lihat [Konfigurasi komponen tidak diperbarui saat mengubah konfigurasi default](#update-component-configuration-to-default-configuration).
### 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](interact-with-aws-services.md). Kode status HTTP 400 menunjukkan bahwa kesalahan ini terjadi karena [peran IAM pertukaran token](device-service-role.md) perangkat inti tidak ada atau tidak memiliki hubungan kepercayaan yang memungkinkan penyedia AWS IoT kredensyal 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 {{MyGreengrassCoreTokenExchangeRoleAlias}} dengan 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"
}
}
```
1. Periksa apakah peran itu ada. Jalankan perintah berikut, dan ganti {{MyGreengrassV2TokenExchangeRole}} 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, lihat[Otorisasi perangkat inti untuk berinteraksi dengan layanan AWS](device-service-role.md).
1. Periksa apakah peran tersebut memiliki hubungan kepercayaan yang memungkinkan penyedia AWS IoT kredensional untuk mengasumsikannya. Tanggapan dari langkah sebelumnya berisi`AssumeRolePolicyDocument`, 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.
------
#### [ JSON ]
****
```
{
"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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) dalam *Panduan AWS Identity and Access Management Pengguna*.
### 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](interact-with-aws-services.md). 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](device-auth.md#greengrass-core-minimal-iot-policy) dan[Memperbarui AWS IoT kebijakan perangkat inti](device-auth.md#update-core-device-iot-policy).
### 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](interact-with-aws-services.md).
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)](run-docker-container.md#docker-container-token-exchange-service)
+ [Jika komponen ditulis dalam NodeJS, atur dns.set ke. DefaultResultOrder](https://nodejs.org/docs/latest/api/dns.html#dnssetdefaultresultorderorder) **ipv4first**
+ Periksa `/etc/hosts` entri yang dimulai dengan `::1` dan berisi`localhost`. Hapus entri untuk melihat apakah itu menyebabkan komponen terhubung ke layanan pertukaran token di alamat yang salah.
### 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](interact-with-aws-services.md) dan komponen mencoba meminta AWS kredensyal.
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 kredensyal dalam siklus hidupnya`install`. AWS IoT Greengrass tidak menjamin ketersediaan layanan pertukaran token selama `install` siklus hidup. Perbarui komponen untuk memindahkan kode yang menggunakan AWS kredensyal ke dalam `run` siklus hidup `startup` atau, lalu gunakan kembali komponen.
### 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:
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.
1. Buat penerapan untuk mengatur ulang nilai konfigurasi itu ke nilai defaultnya. Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md) dan [Perbarui konfigurasi komponen](update-component-configurations.md).
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](docker-application-manager-component.md) dari repositori pribadi di Amazon Elastic Container Registry (Amazon ECR). Kesalahan ini terjadi jika Anda menggunakan `wincred` [Docker credential helper](https://github.com/docker/docker-credential-helpers) (). `docker-credential-wincred` Akibatnya, Amazon ECR tidak dapat menyimpan kredensyal 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 menjadi`docker-credential-wincredreal`.
1. 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 menjadi`docker-credential-wincredreal`, perbarui `credsStore` opsi ke`wincredreal`.
```
{
"credsStore": "{{wincredreal}}"
}
```
### 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, seperti`ggc_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 {{password}} dengan kata sandi yang akan diatur.
```
net user {{ggc_user}} {{password}}
```
1. Gunakan [PsExec utilitas](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec) untuk menyimpan kata sandi baru pengguna di instance Credential Manager untuk LocalSystem akun tersebut. Ganti {{password}} 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 [`wmic`perintah tidak digunakan lagi](https://learn.microsoft.com/en-us/windows/win32/wmisdk/wmic), jalankan perintah berikut. PowerShell
```
Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = '{{ggc_user}}'" | Set-CimInstance -Property @{PasswordExpires="False"}
```
### 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, lihat[Manajer pengaliran](stream-manager-component.md).
## Masalah komponen fungsi Lambda perangkat inti
Memecahkan masalah komponen fungsi Lambda pada perangkat inti.
**Topics**
+ [Subsistem cgroup berikut tidak dipasang: perangkat, memori](#lambda-cgroups-not-mounted)
+ [ipc\_client.py:64, Kesalahan HTTP 400:Permintaan Buruk, B'tidak ada langganan untuk label-or-lambda-arn sumber dan label-or-lambda-arn < > < >](#v1-lambda-no-subscription-exists)
### Subsistem cgroup berikut tidak dipasang: perangkat, memori
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, 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.](legacy-subscription-router-component.md) Untuk memperbaiki masalah ini, gunakan dan konfigurasikan router langganan lama untuk menentukan langganan yang diperlukan. Untuk informasi selengkapnya, lihat [Impor fungsi Lambda V1](set-up-v2-test-device.md#run-v1-lambda-functions).
## 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
```
1. 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}}
```
1. Kumpulkan perangkat inti dengan versi komponen yang dihentikan yang diinstal dari langkah sebelumnya.
1. 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/revise-deployments.html) penerapan.
## Masalah Antarmuka Baris Perintah Greengrass
[Memecahkan masalah dengan CLI Greengrass.](gg-cli.md)
**Topics**
+ [java.lang. RuntimeException: Tidak dapat membuat klien ipc](#greengrass-cli-unable-to-create-ipc-client)
### 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:
+ 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}} [arguments]
```
## AWS Command Line Interface masalah
Memecahkan AWS CLI masalah untuk. AWS IoT Greengrass V2
**Topics**
+ [Kesalahan: Pilihan tidak valid: 'greengrassv2'](#aws-cli-invalid-choice-greengrassv2)
### 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:
+ 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) di *Panduan Pengguna AWS Command Line Interface *.