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

Pemecahan Masalah AWS Systems Manager Distributor

Informasi berikut dapat membantu Anda memecahkan masalah yang mungkin terjadi saat Anda menggunakan Distributor, kemampuan AWS Systems Manager.

Paket yang salah dengan nama yang sama telah diinstal

Masalah: Anda telah menginstal paket, tetapi Distributor menginstal paket yang berbeda sebagai gantinya.

Penyebab: Selama instalasi, Systems Manager menemukan paket AWS dipublikasikan sebagai hasil sebelum paket eksternal yang ditetapkan pengguna. Jika nama paket yang ditentukan pengguna Anda sama dengan nama paket yang AWS dipublikasikan, AWS paket diinstal alih-alih paket Anda.

Solusi: Untuk menghindari masalah ini, beri nama paket Anda sesuatu yang berbeda dari nama untuk paket yang AWS diterbitkan.

Kesalahan: Gagal mengambil manifes: Tidak dapat menemukan versi terbaru paket

Masalah: Anda menerima pesan kesalahan seperti berikut ini.

Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package 
arn:aws:ssm:::package/package-name status code: 400, request id: guid

Penyebab: Anda menggunakan versi SSM Agent dengan Distributor yang lebih awal dari versi 2.3.274.0.

Solusi: Perbarui versi SSM Agent ke versi 2.3.274.0 atau yang lebih baru. Untuk informasi selengkapnya, lihat Memperbarui SSM Agent penggunaan Run Command atau Panduan: Memperbarui secara otomatis SSM Agent dengan AWS CLI.

Kesalahan: Gagal mengambil manifes: Pengecualian validasi

Masalah: Anda menerima pesan kesalahan seperti berikut ini.

Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name

Penyebab: Anda menggunakan versi SSM Agent dengan Distributor yang lebih awal dari versi 2.3.274.0.

Solusi: Perbarui versi SSM Agent ke versi 2.3.274.0 atau yang lebih baru. Untuk informasi selengkapnya, lihat Memperbarui SSM Agent penggunaan Run Command atau Panduan: Memperbarui secara otomatis SSM Agent dengan AWS CLI.

Paket tidak didukung (paket tidak memiliki tindakan instalasi)

Masalah: Anda menerima pesan kesalahan seperti berikut ini.

Package is not supported (package is missing install action)

Penyebab: Struktur direktori paket tidak benar.

Solusi: Jangan zip direktori induk yang berisi perangkat lunak dan skrip yang diperlukan. Sebaliknya, buat file .zip semua isi yang diperlukan secara langsung di jalur absolut. Untuk memverifikasi file .zip dibuat dengan benar, unzip direktori platform target dan tinjau struktur direktori. Sebagai contoh, jalur absolut skrip instal harus /ExamplePackage_targetPlatform/install.sh.

Kesalahan: Gagal mengunduh manifes: Dokumen dengan nama tidak ada

Masalah: Anda menerima pesan kesalahan seperti berikut ini.

Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.

Penyebab: Distributor tidak dapat menemukan paket dengan nama paket saat membagikan Distributor paket dari akun lain.

Solusi: Saat berbagi paket dari akun lain, gunakan Amazon Resource Name (ARN) lengkap untuk paket dan bukan hanya namanya.

Unggahan gagal.

Masalah: Anda menerima pesan kesalahan seperti berikut ini.

Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.

Penyebab: Nama paket perangkat lunak Anda termasuk spasi. Misalnya, Hello World.msi akan gagal mengunggah.