

Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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

# Konfigurasikan perangkat Anda untuk menjalankan tes IDT
<a name="device-config-setup"></a>

Untuk mengonfigurasi perangkat Anda, Anda harus menginstal AWS IoT Greengrass dependensi, mengonfigurasi perangkat lunak AWS IoT Greengrass Core, mengonfigurasi komputer host untuk mengakses perangkat Anda, dan mengonfigurasi izin pengguna di perangkat Anda.

## Verifikasi AWS IoT Greengrass dependensi pada perangkat yang sedang diuji
<a name="install-gg-dependencies"></a>

Sebelum IDT for AWS IoT Greengrass dapat menguji perangkat Anda, pastikan Anda telah menyiapkan perangkat seperti yang dijelaskan dalam [Memulai AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-gs.html). Untuk informasi tentang platform yang didukung, lihat [Platform yang didukung](https://docs.aws.amazon.com/greengrass/latest/developerguide/what-is-gg.html#gg-platforms).

## Konfigurasikan AWS IoT Greengrass perangkat lunak
<a name="config-gg"></a>

IDT untuk AWS IoT Greengrass menguji perangkat Anda untuk kompatibilitas dengan versi tertentu. AWS IoT Greengrass IDT menyediakan dua opsi untuk pengujian AWS IoT Greengrass pada perangkat Anda:
+ Unduh dan gunakan versi [AWS IoT Greengrass perangkat lunak Core](what-is-gg.md#gg-core-download-tab). IDT menginstal perangkat lunak untuk Anda.
+ Gunakan versi perangkat lunak AWS IoT Greengrass Core yang sudah diinstal pada perangkat Anda.

**catatan**  
Setiap versi AWS IoT Greengrass memiliki versi IDT yang sesuai. Anda harus mengunduh versi IDT yang sesuai dengan versi yang AWS IoT Greengrass Anda gunakan.

Bagian berikut menjelaskan opsi ini. Anda hanya butuh mengerjakan satu.

### Opsi 1: Unduh perangkat lunak AWS IoT Greengrass Inti dan konfigurasikan AWS IoT Device Tester untuk menggunakannya
<a name="download-gg"></a>

Anda dapat mengunduh perangkat lunak AWS IoT Greengrass Inti dari halaman unduhan [Perangkat Lunak AWS IoT Greengrass Inti](what-is-gg.md#gg-core-download-tab). 

1. Temukan arsitektur dan distribusi Linux yang benar, dan kemudian memilih **Mengunduh**.

1. Salin file tar.gz ke `<device-tester-extract-location>/products/greengrass/ggc`.

**catatan**  
Jangan mengubah nama file AWS IoT Greengrass tar.gz. Jangan menempatkan beberapa file dalam direktori ini untuk sistem operasi dan arsitektur yang sama. Sebagai contoh memiliki kedua `greengrass-linux-armv7l-1.7.1.tar.gz` dan `greengrass-linux-armv7l-1.8.1.tar.gz` file dalam direktori tersebut akan menyebabkan tes gagal.

### Opsi 2: Gunakan instalasi yang ada AWS IoT Greengrass dengan AWS IoT Device Tester
<a name="existing-gg"></a>

Konfigurasikan IDT untuk menguji perangkat lunak AWS IoT Greengrass Inti yang diinstal pada perangkat Anda dengan menambahkan `greengrassLocation` atribut ke `device.json` file di `<device-tester-extract-location>/configs` folder. Contoh:

```
"greengrassLocation" : "<path-to-greengrass-on-device>"
```

Untuk informasi lebih lanjut tentang file `device.json` ini, lihat [Konfigurasikan device.json](set-config.md#device-config).

Pada perangkat Linux, lokasi default perangkat lunak AWS IoT Greengrass Core adalah`/greengrass`.

**catatan**  
Perangkat Anda harus memiliki instalasi perangkat lunak AWS IoT Greengrass Core yang belum dimulai.  
Pastikan Anda telah menambahkan `ggc_user` pengguna dan `ggc_group` pada perangkat Anda. Untuk informasi lebih lanjut, lihat [pengaturan Lingkungan untuk AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/module1.html).

## Konfigurasikan komputer host Anda untuk mengakses perangkat yang sedang diuji
<a name="configure-host"></a>

IDT berjalan pada komputer host Anda dan harus dapat menggunakan SSH untuk terhubung ke perangkat Anda. Terdapat dua pilihan untuk memungkinkan IDT untuk mendapatkan akses SSH ke perangkat Anda yang diuji:

1. Ikuti petunjuk di sini untuk membuat pasangan kunci SSH dan otorisasi kunci Anda untuk masuk ke perangkat Anda yang sedang diuji tanpa menyebutkan kata sandi.

1. Berikan nama pengguna dan kata sandi untuk setiap perangkat di file `device.json`. Untuk informasi selengkapnya, lihat [Konfigurasikan device.json](set-config.md#device-config).

Anda dapat menggunakan implementasi SSL apa pun untuk membuat kunci SSH. Petunjuk berikut menunjukkan cara menggunakan [SSH-KEYGEN](https://www.ssh.com/ssh/keygen/) atau [Pu TTYgen](https://www.ssh.com/ssh/putty/windows/puttygen) (untuk Windows). Jika Anda menggunakan implementasi SSL lain, lihat dokumentasi untuk implementasi tersebut.

IDT menggunakan kunci SSH untuk diautentikasi dengan perangkat Anda yang sedang diuji. 

**Untuk membuat kunci SSH dengan SSH-KEYGEN**

1. Buat kunci SSH

   Anda dapat menggunakan perintah **ssh-keygen** Open SSH untuk membuat pasangan kunci SSH. Jika Anda sudah memiliki pasanagn kunci SSH pada komputer host Anda, adalah praktik terbaik untuk membuat pasangan kunci SSH khusus untuk IDT. Dengan cara ini, setelah Anda menyelesaikan tes, komputer host Anda tidak dapat lagi terhubung ke perangkat Anda tanpa memasukkan kata sandi. Hal ini juga memungkinkan Anda membatasi akses ke perangkat jarak jauh hanya untuk yang membutuhkannya.
**catatan**  
Windows tidak memiliki klien SSH yang diinstal. Untuk informasi tentang cara menginstal klien SSH di Windows, lihat [Unduh Perangkat Lunak Klien SSH](https://www.ssh.com/ssh/#sec-Download-client-software).

   Perintah **ssh-keygen** meminta Anda untuk memberikan nama dan path untuk menyimpan pasangan kunci tersebut. Secara default, file pasangan kunci diberi nama `id_rsa` (kunci privat) dan `id_rsa.pub` (kunci publik). Di macOS dan Linux, lokasi default file ini adalah `~/.ssh/`. Di Windows, lokasi default untuk file ini adalah `C:\Users\<user-name>\.ssh`.

   Saat diminta, masukkan frase kunci untuk melindungi kunci SSH Anda. Untuk informasi lebih lanjut, lihat [Buat Kunci SSH Baru](https://www.ssh.com/ssh/keygen/).

1. Tambahkan kunci SSH yang diotorisasi pada perangkat Anda yang sedang diuji.

   IDT harus menggunakan kunci privat SSH Anda untuk masuk ke perangkat Anda yang sedang diuji. Untuk mengotorisasi kunci privat SSH Anda untuk masuk ke perangkat Anda yang sedang diuji, gunakan perintah **ssh-copy-id** dari komputer host Anda. Perintah ini menambahkan kunci publik Anda ke dalam file `~/.ssh/authorized_keys` pada perangkat Anda yang sedang diuji. Contoh:

   **\$1 ssh-copy-id *<remote-ssh-user>*@*<remote-device-ip>***

   Di *remote-ssh-user* mana nama pengguna yang digunakan untuk masuk ke perangkat Anda yang sedang diuji dan *remote-device-ip* merupakan alamat IP perangkat yang diuji untuk menjalankan pengujian. Contoh:

   **ssh-copy-id pi@192.168.1.5**

   Saat diminta, masukkan kata sandi untuk nama pengguna yang Anda tentukan di perintah **ssh-copy-id**.

   **ssh-copy-id** mengasumsikan kunci publik tersebut bernama `id_rsa.pub` dan disimpan di lokasi default (pada macOS dan Linux, `~/.ssh/` dan pada Windows, `C:\Users\<user-name>\.ssh`). Jika Anda memberikan kunci publik nama yang berbeda atau menyimpannya di lokasi yang berbeda, Anda harus menentukan path yang memenuhi syarat untuk kunci publik SSH Anda dengan menggunakan **-i** untuk **ssh-copy-id** (misalnya, **ssh-copy-id -i \$1/my/path/myKey.pub**). Untuk informasi lebih lanjut tentang cara membuat kunci SSH dan menyalin kunci publik, lihat [SSH-COPY-ID](https://www.ssh.com/ssh/copy-id).

**Untuk membuat kunci SSH menggunakan Pu TTYgen (hanya Windows)**

1. Pastikan Anda mempunyai server dan klien OpenSSH yang terinstal pada perangkat Anda yang sedang diuji. Untuk informasi selengkapnya, lihat [OpenSSH](https://www.openssh.com/).

1. Instal [Pu TTYgen](https://www.puttygen.com/) pada perangkat Anda yang sedang diuji.

1. Buka PuTTYgen.

1. Pilih **Buat** dan gerakkan kursor mouse Anda di dalam kotak untuk menghasilkan kunci privat.

1. Dari menu **Konversi**, pilih **Ekspor kunci OpenSSH**, dan simpan kunci privat dengan ekstensi file `.pem`.

1. Tambahkan kunci publik ke file `/home/<user>/.ssh/authorized_keys` pada perangkat yang sedang diuji.

   1. Salin teks kunci publik dari TTYgen jendela Pu.

   1. Gunakan PuTTY untuk membuat sesi pada perangkat Anda yang sedang diuji.

      1. Dari command prompt atau jendela Windows Powershell, jalankan perintah berikut:

         **C:/*<path-to-putty>*/putty.exe -ssh *<user>*@*<dut-ip-address>***

      1. Saat diminta, masukkan kata sandi perangkat Anda.

      1. Gunakan vi atau editor teks lain untuk menambahkan kunci publik ke file `/home/<user>/.ssh/authorized_keys` pada perangkat Anda yang sedang diuji.

1. Perbarui file `device.json` Anda dengan nama pengguna, alamat IP, dan path Anda ke file kunci privat yang baru saja Anda simpan di komputer host untuk setiap perangkat yang sedang diuji. Untuk informasi selengkapnya, lihat [Konfigurasikan device.json](set-config.md#device-config). Pastikan Anda memberikan path dan nama file yang lengkap untuk kunci privat dan gunakan garis miring ('/'). Misalnya, untuk path Windows `C:\DT\privatekey.pem`, gunakan `C:/DT/privatekey.pem` di file `device.json`. 

## Konfigurasikan izin pengguna di perangkat Anda
<a name="root-access"></a>

IDT melakukan operasi pada berbagai direktori dan file dalam perangkat yang diuji. Beberapa operasi ini memerlukan izin yang ditinggikan (menggunakan **sudo**). Untuk mengotomatiskan operasi ini, IDT for AWS IoT Greengrass harus dapat menjalankan perintah dengan sudo tanpa diminta kata sandi.

Ikuti langkah-langkah ini pada perangkat yang sedang diuji untuk mengizinkan akses sudo tanpa diminta memasukkan kata sandi. 

**catatan**  
`username` mengacu pada pengguna SSH yang digunakan oleh IDT untuk mengakses perangkat yang diuji.

**Tambahkan pengguna ke grup sudo.**

1. Pada perangkat yang sedang diuji, jalankan `sudo usermod -aG sudo <username>`.

1. Keluar, lalu masuk kembali agar perubahan diterapkan.

1. Untuk memverifikasi nama pengguna Anda telah berhasil ditambahkan, jalankan **sudo echo test**. Jika Anda tidak diminta untuk memasukkan kata sandi, pengguna Anda telah dikonfigurasi dengan benar.

1. Buka file `/etc/sudoers` dan tambahkan baris berikut ke akhir file:

   `<ssh-username> ALL=(ALL) NOPASSWD: ALL`

## Konfigurasikan perangkat Anda untuk mengetes fitur opsional
<a name="optional-feature-config"></a>

Topik berikut menjelaskan cara mengonfigurasi perangkat Anda untuk menjalankan tes IDT untuk fitur opsional. Ikuti langkah-langkah konfigurasi ini hanya jika Anda ingin mengetes fitur ini. Jika tidak, lanjutkan ke [Konfigurasikan pengaturan IDT untuk menjalankan rangkaian AWS IoT Greengrass kualifikasi](set-config.md).

**Topics**
+ [Verifikasi AWS IoT Greengrass dependensi pada perangkat yang sedang diuji](#install-gg-dependencies)
+ [Konfigurasikan AWS IoT Greengrass perangkat lunak](#config-gg)
+ [Konfigurasikan komputer host Anda untuk mengakses perangkat yang sedang diuji](#configure-host)
+ [Konfigurasikan izin pengguna di perangkat Anda](#root-access)
+ [Konfigurasikan perangkat Anda untuk mengetes fitur opsional](#optional-feature-config)
+ [Opsional: Mengonfigurasi wadah Docker Anda untuk IDT untuk AWS IoT Greengrass](docker-config-setup.md)
+ [Opsional: Mengonfigurasi perangkat Anda untuk kualifikasi ML](idt-ml-qualification.md)