Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengkonfigurasi dan menggunakan Snowball Edge Client
Snowball Edge Client adalah alat antarmuka baris perintah (CLI) AWS yang dapat Anda gunakan untuk bekerja dengan Snowball Edge atau sekelompok Snowball Edge. Anda dapat menggunakan klien untuk membuka Snowball Edge atau sekelompok perangkat, mengatur Snowball Edge, memulai dan menghentikan layanan di perangkat, dan mentransfer data ke atau dari perangkat. Klien Snowball Edge kompatibel dengan komputer yang berjalan di sistem operasi Linux, macOS, dan Windows.
**Topics**
+ [Mengunduh dan menginstal Klien Snowball Edge](#download-the-client)
+ [Mengkonfigurasi profil untuk Klien Snowball Edge](#client-configuration)
+ [Menemukan versi klien Snowball Edge](#cli-version)
+ [Mendapatkan kredensi untuk Snowball Edge](#client-credentials)
+ [Memulai layanan di Snowball Edge](#edge-start-service)
+ [Menghentikan layanan di Snowball Edge](#edge-stop-service)
+ [Melihat dan mengunduh log dari Snowball Edge](#logs)
+ [Melihat status Snowball Edge](#client-status)
+ [Melihat status layanan yang berjalan di Snowball Edge](#client-service-status)
+ [Melihat status fitur Snowball Edge](#snowball-edge-describe-features)
+ [Mengatur server waktu untuk Snowball Edge](#client-set-ntp)
+ [Mendapatkan kode QR untuk memvalidasi tag NFC Snowball Edge](#client-qr-code)
+ [Memperbarui ukuran MTU](#update-mtu-size)
## Mengunduh dan menginstal Klien Snowball Edge
[Anda dapat mengunduh Klien Snowball Edge dari AWS Snowball Edge Sumber Daya.](https://aws.amazon.com/snowball/resources/) Pada halaman tersebut, Anda dapat menemukan paket instalasi untuk sistem operasi Anda.
Instal dan konfigurasikan klien sesuai dengan instruksi di bawah ini.
------
#### [ Linux ]
**catatan**
Klien Snowball Edge hanya didukung pada distribusi Linux 64-bit.
1. Ekstrak file `snowball-client-linux.tar.gz`. Ini menciptakan struktur `/snowball-client-linux-build_number/bin` folder dan mengekstrak file di sana.
1. Jalankan perintah berikut untuk mengkonfigurasi folder.
```
chmod u+x snowball-client-linux-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-linux-build_number/jre/bin/java
```
1. Tambahkan `/snowball-client-linux-build_number/bin` ke variabel lingkungan \$1PATH sistem operasi Anda untuk menjalankan perintah Snowball Edge Client dari direktori mana pun. Untuk informasi selengkapnya, lihat dokumentasi untuk sistem operasi perangkat atau shell Anda.
------
#### [ macOS ]
1. Ekstrak file `snowball-client-mac.tar.gz`. Ini menciptakan struktur `/snowball-client-linux-build_number/bin` folder dan mengekstrak file di sana.
1. Jalankan perintah berikut untuk mengkonfigurasi folder.
```
chmod u+x snowball-client-mac-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-mac-build_number/jre/bin/java
```
1. Tambahkan `/snowball-client-mac-build_number/bin` ke variabel lingkungan \$1PATH sistem operasi Anda untuk menjalankan perintah Snowball Edge Client dari direktori mana pun. Untuk informasi selengkapnya, lihat dokumentasi untuk sistem operasi perangkat atau shell Anda.
------
#### [ Windows ]
Klien dikemas sebagai file Microsoft Software Installer (MSI). Buka file dan ikuti petunjuk di wizard instalasi. Ketika klien telah diinstal, Anda dapat menjalankannya dari direktori apa pun tanpa persiapan tambahan.
------
## Mengkonfigurasi profil untuk Klien Snowball Edge
Setiap kali Anda menjalankan perintah untuk Snowball Edge Client, Anda memberikan file manifes, kode buka kunci, dan alamat IP Snowball Edge. Alih-alih menyediakan ini setiap kali Anda menjalankan perintah, Anda dapat menggunakan `configure` perintah untuk menyimpan jalur ke file manifes, kode buka kunci 29 karakter, dan titik akhir (alamat IP dari Snowball Edge) sebagai profil. Setelah konfigurasi, Anda dapat menggunakan perintah Snowball Edge Client tanpa harus memasukkan nilai-nilai ini secara manual untuk setiap perintah dengan memasukkan nama profil dengan perintah. Setelah Anda mengkonfigurasi Snowball Edge Client, informasi disimpan dalam format JSON plaintext ke. `home directory/.aws/snowball/config/snowball-edge.config` Pastikan lingkungan Anda dikonfigurasi untuk memungkinkan Anda membuat file ini.
**penting**
Siapa pun yang dapat mengakses file konfigurasi dapat mengakses data pada perangkat Snowball Edge atau klaster Anda. Mengelola kontrol akses lokal untuk file ini adalah salah satu tanggung jawab administratif Anda.
Anda juga dapat menggunakan AWS OpsHub untuk membuat profil. Profil yang dibuat AWS OpsHub tersedia untuk digunakan dengan Snowball Edge Client dan profil yang dibuat tersedia untuk digunakan dengan Snowball Edge Client. AWS OpsHub Untuk informasi selengkapnya, lihat [Mengelola profil](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-device.html#manage-profile).
**Untuk membuat profil**
1. Masukkan perintah di antarmuka baris perintah untuk sistem operasi Anda. Nilai `profile-name` parameter adalah nama profil. Anda akan menyediakannya di masa depan saat menjalankan perintah Snowball Edge Client.
```
snowballEdge configure --profile profile-name
```
1. Klien Snowball Edge akan meminta Anda untuk setiap parameter. Saat diminta, masukkan informasi untuk lingkungan Anda dan Snowball Edge.
**catatan**
Nilai `endpoint` parameter adalah alamat IP dari Snowball Edge, diawali oleh. `https://` Anda dapat menemukan alamat IP untuk perangkat Snowball Edge di layar LCD di bagian depan perangkat.
**Example output dari `configure` perintah**
```
Configuration will stored at home directory\.aws\snowball\config\snowball-edge.config
Snowball Edge Manifest Path: /Path/to/manifest/file
Unlock Code: 29 character unlock code
Default Endpoint: https://192.0.2.0
```
Klien Snowball Edge akan memeriksa apakah kode buka kunci sudah benar untuk file manifes. Jika tidak cocok, perintah berhenti dan tidak membuat profil. Periksa kode buka kunci dan file manifes dan jalankan perintah lagi.
Untuk menggunakan profil, sertakan `--profile profile-name` setelah sintaks perintah.
Jika Anda menggunakan beberapa Snowball Edge mandiri, Anda dapat membuat profil untuk masing-masing. Untuk membuat profil lain, jalankan `configure` perintah lagi, berikan nilai yang berbeda untuk `--profile` prameter, dan berikan informasi untuk perangkat lain.
**Example Contoh file `snowball-edge.config`**
Contoh ini menunjukkan file profil yang berisi tiga profil—`SnowDevice1profile`,`SnowDevice2profile`, dan`SnowDevice3profile`.
```
{"version":1,"profiles":
{
"SnowDevice1profile":
{
"name":"SnowDevice1profile",
"jobId":"JID12345678-136f-45b4-b5c2-847db8adc749",
"unlockCode":"db223-12345-dbe46-44557-c7cc2",
"manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-136f-45b4-b5c2-847db8adc749_manifest-1670622989203.bin",
"defaultEndpoint":"https://10.16.0.1",
"isCluster":false,
"deviceIps":[]
},
},
"SnowDevice2profile":
{
"name":"SnowDevice2profile",
"jobId":"JID12345678-fdb2-436a-a4ff-7c510dec1bae",
"unlockCode":"b893b-54321-0f65c-6c5e1-7f748",
"manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-fdb2-436a-a4ff-7c510dec1bae_manifest-1670623746908.bin",
"defaultEndpoint":"https://10.16.0.2",
"isCluster":false,
"deviceIps":[]
},
"SnowDevice3profile":
{
"name":"SnowDevice3profile",
"jobId":"JID12345678-c384-4a5e-becd-ab5f38888463",
"unlockCode":"64c89-13524-4d054-13d93-c1b80",
"manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-c384-4a5e-becd-ab5f38888463_manifest-1670623999136.bin",
"defaultEndpoint":"https://10.16.0.3",
"isCluster":false,
"deviceIps":[]
}
}
```
Untuk mengedit atau menghapus profil, edit file profil dalam editor teks.
**Untuk mengedit profil**
1. Dalam editor teks, buka `snowball-edge.config` dari`home directory\.aws\snowball\config`.
**catatan**
Pastikan lingkungan Anda dikonfigurasi untuk memungkinkan Anda mengakses membaca dan menulis file ini.
1. Edit file seperlunya. Misalnya, untuk mengubah alamat IP Snowball Edge yang terkait dengan profil, ubah entri. `defaultEndpoint`
1. Simpan dan tutup file .
**Untuk menghapus profil**
1. Menggunakan editor teks, buka `snowball-edge.config` dari`home directory\.aws\snowball\config`.
**catatan**
Pastikan lingkungan Anda dikonfigurasi untuk memungkinkan Anda mengakses membaca dan menulis file ini.
1. Hapus baris yang berisi nama profil, tanda kurung keriting `{` `}` yang mengikuti nama profil, dan konten dalam tanda kurung tersebut.
1. Simpan dan tutup file .
## Menemukan versi klien Snowball Edge
Gunakan `version` perintah untuk melihat versi klien antarmuka baris perintah Snowball Edge (CLI).
**Penggunaan**
```
snowballEdge version
```
**Contoh keluaran**
```
Snowball Edge client version: 1.2.0 Build 661
```
## Mendapatkan kredensi untuk Snowball Edge
Dengan menggunakan `snowballEdge get-secret-access-key` perintah `snowballEdge list-access-keys` dan, Anda bisa mendapatkan kredensi pengguna admin Anda di Akun AWS Snowball Edge. Anda dapat menggunakan kredensil ini untuk membuat AWS Identity and Access Management (pengguna IAM) dan peran, dan untuk mengautentikasi permintaan Anda saat menggunakan AWS CLI atau dengan SDK. AWS Kredensial ini hanya terkait dengan tugas individu untuk Snowball Edge, dan Anda dapat menggunakannya hanya pada perangkat atau klaster perangkat. Perangkat atau perangkat yang tidak memiliki izin IAM apa pun di AWS Cloud.
**catatan**
Jika Anda menggunakan AWS CLI with the Snowball Edge, Anda harus menggunakan kredensil ini saat Anda mengonfigurasi CLI. *Untuk informasi tentang mengonfigurasi kredensialnya AWS CLI, lihat [Mengonfigurasi AWS CLI dalam Panduan Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration).AWS Command Line Interface *
**Penggunaan (klien Snowball Edge yang dikonfigurasi)**
```
snowballEdge list-access-keys
```
**Example Output**
```
{
"AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}
```
**Penggunaan (klien Snowball Edge yang dikonfigurasi)**
```
snowballEdge get-secret-access-key --access-key-id Access Key
```
**Example Output**
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
## Memulai layanan di Snowball Edge
Perangkat Snowball Edge mendukung berbagai layanan. Ini termasuk instance komputasi, antarmuka Network File System (NFS), Snowball Edge Device Management, dan. AWS IoT Greengrass Layanan adaptor Amazon S3 EC2, Amazon AWS STS, dan IAM dimulai secara default dan tidak dapat dihentikan atau dimulai ulang. Namun, antarmuka NFS, Snowball Edge Device Management, AWS IoT Greengrass dan dapat dimulai dengan menggunakan ID layanannya dengan `start-service` perintah. Untuk mendapatkan ID layanan untuk setiap layanan, Anda dapat menggunakan perintah `list-services`.
Sebelum Anda menjalankan perintah ini, buat antarmuka jaringan virtual tunggal untuk mengikat ke layanan yang Anda mulai. Untuk informasi selengkapnya, lihat [Membuat Antarmuka Jaringan Virtual di Tepi Snowball](using-ec2-edge-client.md#ec2-edge-create-vnic).
```
snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn --profile profile-name
```
**Example output dari `start-service` perintah**
```
Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.
```
## Menghentikan layanan di Snowball Edge
Untuk menghentikan layanan yang berjalan di Snowball Edge, Anda dapat menggunakan perintah. `stop-service`
Adaptor Amazon S3 EC2, Amazon AWS STS, dan layanan IAM tidak dapat dihentikan.
**Awas**
Kehilangan data dapat terjadi jika layanan Network File System (NFS) dihentikan sebelum data buffer yang tersisa ditulis ke perangkat. Untuk informasi selengkapnya tentang penggunaan layanan NFS, lihat[Mengelola antarmuka NFS di Snowball Edge](shared-using-nfs.md).
**catatan**
Menghentikan penyimpanan yang kompatibel dengan Amazon S3 pada layanan Snowball Edge menonaktifkan akses ke data yang disimpan di bucket S3 di perangkat atau cluster. Akses dipulihkan saat penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge dimulai lagi. Untuk perangkat yang diaktifkan dengan penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge, disarankan untuk memulai layanan setelah perangkat Snowball Edge dinyalakan. Lihat [Menyiapkan Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/s3compatible-on-snow.html#setting-up-s3-on-snow-cluster) di panduan ini.
```
snowballEdge stop-service --service-id service_id --profile profile-name
```
**Example output dari `stop-service` perintah**
```
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.
```
## Melihat dan mengunduh log dari Snowball Edge
Saat Anda mentransfer data antara pusat data on-premise dan Snowball Edge, log akan dibuat secara otomatis. Jika Anda mengalami kesalahan tak terduga selama transfer data ke perangkat, Anda dapat menggunakan perintah berikut untuk menyimpan salinan log ke server lokal Anda.
Ada tiga perintah yang terkait dengan log:
+ `list-logs` – Menghasilkan daftar log dalam format JSON. Daftar ini melaporkan ukuran log dalam byte, ARN untuk log, ID layanan untuk log, dan jenis log.
**Penggunaan**
```
snowballEdge list-logs --profile profile-name
```
**Example output dari `list-logs` perintah**
```
{
"Logs" : [ {
"LogArn" : "arn:aws:snowball-device:::log/s3-storage-JIEXAMPLE2f-1234-4953-a7c4-dfEXAMPLE709",
"LogType" : "SUPPORT",
"ServiceId" : "s3",
"EstimatedSizeBytes" : 53132614
}, {
"LogArn" : "arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709",
"LogType" : "CUSTOMER",
"ServiceId" : "fileinterface",
"EstimatedSizeBytes" : 4446
}]
}
```
+ `get-log`— Mengunduh salinan log tertentu dari Snowball Edge ke perangkat Anda di jalur yang ditentukan. `CUSTOMER`log disimpan dalam `.zip` format, dan Anda dapat mengekstrak jenis log ini untuk melihat isinya. `SUPPORT`log dienkripsi dan hanya dapat dibaca oleh. AWS Dukungan Anda memiliki opsi untuk menentukan nama dan jalur untuk log.
**Penggunaan**
```
snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709 --profile profile-name
```
**Example output dari `get-log` perintah**
```
Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin
```
+ `get-support-logs` – Mengunduh salinan semua tipe Download salinan semua log jenis `SUPPORT` dari Snowball Edge ke layanan Anda di jalur yang ditentukan.
**Penggunaan**
```
snowballEdge get-support-logs --profile profile-name
```
**Example output dari `get-support-logs` perintah**
```
Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
```
**penting**
`CUSTOMER` mungkin berisi informasi sensitif tentang data Anda sendiri. Untuk melindungi informasi yang berpotensi sensitif ini, kami sangat merekomendasikan agar Anda menghapus log ini setelah selesai dengannya.
## Melihat status Snowball Edge
Anda dapat menentukan status dan kesehatan umum Snowball Edge dengan perintah. `describe-device`
```
snowballEdge describe-device --profile profile-name
```
**Example output dari `describe-device` perintah**
```
{
"DeviceId": "JID-EXAMPLE12345-123-456-7-890",
"UnlockStatus": {
"State": "UNLOCKED"
},
"ActiveNetworkInterface": {
"IpAddress": "192.0.2.0"
},
"PhysicalNetworkInterfaces": [
{
"PhysicalNetworkInterfaceId": "s.ni-EXAMPLEd9ecbf03e3",
"PhysicalConnectorType": "RJ45",
"IpAddressAssignment": "STATIC",
"IpAddress": "0.0.0.0",
"Netmask": "0.0.0.0",
"DefaultGateway": "192.0.2.1",
"MacAddress": "EX:AM:PL:E0:12:34"
},
{
"PhysicalNetworkInterfaceId": "s.ni-EXAMPLE4c3840068f",
"PhysicalConnectorType": "QSFP",
"IpAddressAssignment": "STATIC",
"IpAddress": "0.0.0.0",
"Netmask": "0.0.0.0",
"DefaultGateway": "192.0.2.2",
"MacAddress": "EX:AM:PL:E0:56:78"
},
{
"PhysicalNetworkInterfaceId": "s.ni-EXAMPLE0a3a6499fd",
"PhysicalConnectorType": "SFP_PLUS",
"IpAddressAssignment": "DHCP",
"IpAddress": "192.168.1.231",
"Netmask": "255.255.255.0",
"DefaultGateway": "192.0.2.3",
"MacAddress": "EX:AM:PL:E0:90:12"
}
]
}
```
## Melihat status layanan yang berjalan di Snowball Edge
Anda dapat menentukan status dan kondisi umum layanan yang berjalan pada perangkat Snowball Edge dengan perangkat `describe-service`. Anda dapat menjalankan perintah `list-services` terlebih dahulu untuk melihat layanan apa yang sedang berjalan.
+ `list-services`
**Penggunaan**
```
snowballEdge list-services --profile profile-name
```
**Example output dari `list-services` perintah**
```
{
"ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}
```
+ `describe-service`
Perintah ini menghasilkan nilai status untuk layanan. Hal ini juga mencakup informasi status yang mungkin membantu dalam menyelesaikan masalah yang Anda hadapi dengan layanan. Status tersebut adalah sebagai berikut.
+ `ACTIVE` – Layanan sedang berjalan dan tersedia untuk digunakan.
+ `ACTIVATING` – Layanan dimulai, namun belum tersedia untuk digunakan.
+ `DEACTIVATING` – Layanan sedang dalam proses mematikan.
+ `DEGRADED`— Untuk penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge, status ini menunjukkan satu atau lebih disk atau perangkat dalam cluster sedang down. Penyimpanan yang kompatibel dengan Amazon S3 pada layanan Snowball Edge berjalan tanpa gangguan, tetapi Anda harus memulihkan atau mengganti perangkat yang terpengaruh sebelum kuorum cluster hilang untuk meminimalkan risiko kehilangan data. Lihat [ikhtisar pengelompokan](https://docs.aws.amazon.com/snowball/latest/developer-guide/ClusterOverview.html) dalam panduan ini.
+ `INACTIVE` – Layanan tidak berjalan dan tidak tersedia untuk digunakan.
**Penggunaan**
```
snowballEdge describe-service --service-id service-id --profile profile-name
```
**Example output dari `describe-service` perintah**
```
{
"ServiceId": "s3",
"Status": {
"State": "ACTIVE"
},
"Storage": {
"TotalSpaceBytes": 99608745492480,
"FreeSpaceBytes": 99608744468480
},
"Endpoints": [
{
"Protocol": "http",
"Port": 8080,
"Host": "192.0.2.0"
},
{
"Protocol": "https",
"Port": 8443,
"Host": "192.0.2.0",
"CertificateAssociation": {
"CertificateArn": "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
}
}
]
}
```
**Example Penyimpanan yang kompatibel dengan Amazon S3 pada output layanan Snowball Edge**
`describe-service`Perintah memberikan output berikut untuk *s3-snow* nilai `service-id` parameter.
```
{
"ServiceId" : "s3-snow",
"Autostart" : false,
"Status" : {
"State" : "ACTIVE"
},
"ServiceCapacities" : [ {
"Name" : "S3 Storage",
"Unit" : "Byte",
"Used" : 640303104,
"Available" : 219571981512
} ],
"Endpoints" : [ {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.123",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.202",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.63",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.243",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.220",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.55",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.213",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.144",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.143",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.224",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2",
"Status" : {
"State" : "ACTIVE"
}
} ]
}
```
## Melihat status fitur Snowball Edge
Untuk daftar status fitur yang tersedia di Snowball Edge gunakan perintah. `describe-features`
`RemoteManagementState`menunjukkan status Snowball Edge Device Management dan mengembalikan salah satu status berikut:
+ `INSTALLED_ONLY`— Fitur ini diinstal tetapi tidak diaktifkan.
+ `INSTALLED_AUTOSTART`— Fitur ini diaktifkan dan perangkat akan mencoba untuk terhubung ke nya Wilayah AWS ketika dinyalakan.
+ `NOT_INSTALLED`— Perangkat tidak mendukung fitur atau sudah di lapangan sebelum diluncurkan.
**Penggunaan**
```
snowballEdge describe-features --profile profile-name
```
**Example output dari `describe-features` perintah**
```
{
"RemoteManagementState" : String
}
```
## Mengatur server waktu untuk Snowball Edge
Anda dapat menggunakan perintah Snowball Edge Client untuk melihat konfigurasi Network Time Protocol (NTP) saat ini dan memilih server atau peer untuk menyediakan waktu. Anda dapat menggunakan perintah Snowball Edge Client saat perangkat dalam status terkunci dan tidak terkunci.
Anda bertanggung jawab untuk menyediakan server waktu NTP yang aman. Untuk mengatur server waktu NTP mana yang terhubung dengan perangkat, gunakan perintah. `update-time-servers`
### Memeriksa sumber waktu Snowball Edge
Untuk melihat sumber waktu NTP mana perangkat saat ini terhubung, gunakan perintah. `describe-time-sources`
```
snowballEdge describe-time-sources --profile profile-name
```
**Example output dari `describe-time-sources` perintah**
```
{
"Sources" : [ {
"Address" : "172.31.2.71",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "172.31.3.203",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "172.31.0.178",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "172.31.3.178",
"State" : "LOST",
"Type" : "PEER",
"Stratum" : 10
}, {
"Address" : "216.239.35.12",
"State" : "CURRENT",
"Type" : "SERVER",
"Stratum" : 1
} ]
}
```
`describe-time-sources`Perintah mengembalikan daftar status sumber waktu. Setiap status sumber kali berisi`Address`,`State`,`Type`, dan `Stratum` bidang. Berikut ini adalah arti dari bidang-bidang ini.
+ `Address`— Nama DNS/alamat IP dari sumber waktu.
+ `State`— Status koneksi saat ini antara perangkat dan sumber waktu itu. Ada lima kemungkinan keadaan:.
+ `CURRENT`— Sumber waktu saat ini sedang digunakan untuk menyinkronkan waktu.
+ `COMBINED`— Sumber waktu digabungkan dengan sumber saat ini.
+ `EXCLUDED`— Sumber waktu dikecualikan oleh algoritma penggabungan.
+ `LOST`— Koneksi dengan sumber waktu telah terputus.
+ `UNACCEPTABLE`— Sumber waktu yang tidak valid di mana algoritma penggabungan telah dianggap sebagai falseticker atau memiliki terlalu banyak variabilitas.
+ `Type`— Sumber waktu NTP dapat berupa server atau rekan. Server dapat diatur oleh `update-time-servers` perintah. Peer hanya dapat berupa perangkat Snowball Edge Edge lainnya di cluster dan secara otomatis diatur saat cluster dikaitkan.
+ `Stratum`Bidang ini menunjukkan strata sumbernya. Stratum 1 menunjukkan sumber dengan jam referensi yang terpasang secara lokal. Sumber yang disinkronkan ke sumber strata 1 berada di strata 2. Sumber yang disinkronkan ke sumber strata 2 berada di strata 3, dan seterusnya..
Sumber waktu NTP dapat berupa server atau rekan. Server dapat diatur oleh pengguna dengan `update-time-servers` perintah, sedangkan peer hanya bisa menjadi perangkat Snowball Edge Edge lainnya di cluster. Dalam contoh output, `describe-time-sources` disebut pada Snowball Edge Edge yang berada dalam cluster 5. Outputnya berisi 4 peer dan 1 server. Rekan memiliki strata 10 sedangkan server memiliki strata 1; oleh karena itu, server dipilih untuk menjadi sumber waktu saat ini.
### Memperbarui server waktu
Gunakan `update-time-servers` perintah dan alamat server waktu untuk mengkonfigurasi Snowball Edge untuk menggunakan server NTP atau peer untuk NTP.
```
snowballEdge update-time-servers time-server-address --profile profile-name
```
**catatan**
`update-time-servers`Perintah akan mengganti pengaturan server waktu NTP sebelumnya.
**Example output dari `update-time-servers` perintah**
```
Updating time servers now.
```
## Mendapatkan kode QR untuk memvalidasi tag NFC Snowball Edge
Anda dapat menggunakan perintah ini untuk menghasilkan kode QR khusus perangkat untuk digunakan dengan AWS Snowball Edge Verification App. Untuk informasi selengkapnya tentang validasi NFC, lihat [Memvalidasi Tag NFC](data-protection.md#nfc-validation).
**Penggunaan**
```
snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png --profile profile-name
```
**Example Output**
```
QR code is saved to ~/downloads/snowball-qr-code.png
```
## Memperbarui ukuran MTU
Gunakan `update-mtu-size` perintah untuk memodifikasi ukuran dalam byte unit transmisi maksimum (MTU) dari antarmuka fisik perangkat Snowball Edge. Semua antarmuka jaringan virtual dan antarmuka jaringan langsung yang terkait dengan antarmuka jaringan fisik ini akan dikonfigurasi dengan ukuran MTU yang sama.
**catatan**
Ukuran MTU minimum adalah 1500 byte dan ukuran maksimum adalah 9216 byte.
Anda dapat menggunakan `describe-device` perintah untuk mengambil antarmuka jaringan fisik IDs dan ukuran MTU saat ini dari antarmuka tersebut. Untuk informasi selengkapnya, lihat [Melihat status Snowball Edge](#client-status).
Anda dapat menggunakan `describe-virtual-network-interface` perintah `descibe-direct-network-interface` and untuk mengambil ukuran MTU saat ini dari antarmuka tersebut.
**Penggunaan**
```
snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes --profile profile-name
```
**Example dari `update-mtu-size` output**
```
{
"PhysicalNetworkInterface": {
"PhysicalNetworkInterfaceId": "s.ni-8c1f891d7f5b87cfe",
"PhysicalConnectorType": "SFP_PLUS",
"IpAddressAssignment": "DHCP",
"IpAddress": "192.0.2.0",
"Netmask": "255.255.255.0",
"DefaultGateway": "192.0.2.255",
"MacAddress": "8A:2r:5G:9p:6Q:4s",
"MtuSize": "5743"
}
}
```