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

# Mengunduh pembaruan ke perangkat Snowball Edge
<a name="download-updates"></a>

Ada dua cara Anda dapat mengunduh pembaruan untuk Snowball Edge:
+ Anda dapat memicu pembaruan manual kapan saja menggunakan perintah Klien Snowball Edge tertentu.
+ Anda dapat secara terprogram menentukan waktu untuk secara otomatis memperbarui perangkat.

Prosedur berikut menguraikan proses mengunduh pembaruan secara manual. Untuk informasi tentang memperbarui perangkat Snowball Edge Anda secara otomatis, lihat `configure-auto-update-strategy` di [Memperbarui Tepi Bola Salju](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#update-client-commands).

**catatan**  
Jika perangkat Anda tidak memiliki akses ke internet, Anda dapat mengunduh file pembaruan menggunakan [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html)API. Kemudian arahkan ke lokasi file lokal saat Anda memanggil `download-updates` menggunakan `uri` parameter, seperti pada contoh berikut.  

```
snowballEdge download-updates --uri {{file:///tmp/local-update}}
```
Untuk sistem operasi Windows, format nilai `uri` parameter sebagai berikut:  

```
snowballEdge download-updates --uri file:/{{C:/path/to/local-update}}
```

**Untuk memeriksa dan mengunduh pembaruan perangkat lunak Snowball Edge untuk perangkat mandiri**

1. Buka jendela terminal, dan pastikan bahwa perangkat Snowball Edge dibuka menggunakan perintah `describe-device`. Jika perangkat terkunci, gunakan perintah `unlock-device` untuk membukanya. Untuk informasi lebih lanjut, lihat [Membuka Kunci Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).

1. Saat perangkat dibuka, jalankan perintah `snowballEdge check-for-updates`. Perintah ini mengembalikan versi terbaru dari perangkat lunak Snowball Edge yang tersedia, dan juga versi saat ini yang diinstal pada perangkat.

1. Jika perangkat lunak di perangkat Anda kedaluwarsa, jalankan perintah `snowballEdge download-updates`.
**catatan**  
Jika perangkat Anda tidak terhubung ke internet, unduh file pembaruan terlebih dahulu menggunakan [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html)API. Kemudian jalankan `snowballEdge download-updates` perintah menggunakan `uri` parameter dengan jalur lokal ke file yang Anda unduh, seperti pada contoh berikut.  

   ```
   snowballEdge download-updates --uri {{file:///tmp/local-update}}
   ```
Untuk sistem operasi Windows, format nilai `uri` parameter sebagai berikut:  

   ```
   snowballEdge download-updates --uri file:/{{C:/path/to/local-update}}
   ```

1. Anda dapat memeriksa status unduhan ini dengan perintah `snowballEdge describe-device-software`. Saat pembaruan sedang diunduh, Anda menampilkan status menggunakan perintah ini.   
**Example output dari `describe-device-software` perintah**  

   ```
   Install State: Downloading
   ```

**Untuk memeriksa dan mengunduh pembaruan perangkat lunak Snowball Edge untuk kelompok perangkat**

1. Buka jendela terminal, dan pastikan bahwa semua perangkat Snowball Edge di cluster tidak terkunci menggunakan perintah. `snowballEdge describe-device` Jika perangkat terkunci, gunakan `snowballEdge unlock-cluster` perintah untuk membukanya. Untuk informasi lebih lanjut, lihat [Membuka Kunci Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).

1. Ketika semua perangkat di cluster tidak terkunci, untuk setiap perangkat di cluster, jalankan `check-for-updates` perintah. Perintah ini mengembalikan versi terbaru dari perangkat lunak Snowball Edge yang tersedia, dan juga versi saat ini yang diinstal pada perangkat.

   ```
   snowballEdge check-for-updates --unlock-code {{29-character-unlock-code}} --manifest-file {{path/to/manifest/file.bin}} --endpoint https://{{ip-address-of-snow-device}}                    
   ```
**catatan**  
Kode buka kunci dan file manifes sama untuk semua perangkat di cluster.  
**Example dari `check-for-updates` perintah**  

   ```
   {
   "InstalledVersion" : "118",
   "LatestVersion" : "119"
   }
   ```

   Jika nilai `LatestVersion` nama lebih besar dari nilai `InstalledVersion` nama, pembaruan tersedia.

1. Untuk setiap perangkat di cluster, gunakan `download-updates` perintah untuk mengunduh pembaruan.

   ```
   snowballEdge download-updates --uri {{file:///tmp/local-update}}
   ```
**catatan**  
Untuk sistem operasi Windows, format nilai `uri` parameter sebagai berikut:  

   ```
   snowballEdge download-updates --uri file:/{{C:/path/to/local-update}}
   ```

1. Untuk memeriksa status unduhan ini untuk setiap perangkat di cluster, gunakan `describe-device-software` perintah.

   ```
   snowballEdge describe-device-software --unlock-code {{29-character-unlock-code}} --manifest-file {{path/to/manifest/file.bin}} --endpoint https://{{ip-address-of-snow-device}}    
   ```  
**Example dari output dari `describe-device-software` perintah**  

   ```
   {
   "InstalledVersion" : "118",
   "InstallingVersion" : "119",
   "InstallState" : "DOWNLOADED",
   "CertificateExpiry" : "Sat Mar 30 16:47:51 UTC 2024"
   }
   ```

   Jika nilai `InstallState` namanya`DOWNLOADED`, pembaruan selesai diunduh dan tersedia untuk diinstal.