Mengkonfigurasi dan menggunakan Snowball Edge Client - AWS Snowball Edge Panduan Pengembang
Mengunduh dan menginstal Klien Snowball EdgeMengkonfigurasi profil untuk Klien Snowball EdgeMenemukan versi klien Snowball EdgeMendapatkan kredensiMemulai layanan di Snowball EdgeMenghentikan layanan di Snowball EdgeMelihat dan mengunduh logMelihat status perangkatMelihat status layananMelihat status fiturMengatur server waktuMemvalidasi tag NFCMemperbarui ukuran MTU

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.

Mengunduh dan menginstal Klien Snowball Edge

Anda dapat mengunduh Klien Snowball Edge dari AWS Snowball Edge Sumber Daya. 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.

  2. 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

  3. Tambahkan /snowball-client-linux-build_number/bin ke variabel lingkungan $PATH 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.

  2. 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

  3. Tambahkan /snowball-client-mac-build_number/bin ke variabel lingkungan $PATH 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.

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

  2. 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.

    contoh 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 sebelum 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.

contoh Contoh file snowball-edge.config

Contoh ini menunjukkan file profil yang berisi tiga profil—SnowDevice1profile,SnowDevice2profile, danSnowDevice3profile.


{"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 darihome directory\.aws\snowball\config.

    catatan

    Pastikan lingkungan Anda dikonfigurasi untuk memungkinkan Anda mengakses membaca dan menulis file ini.

  2. Edit file seperlunya. Misalnya, untuk mengubah alamat IP Snowball Edge yang terkait dengan profil, ubah entri. defaultEndpoint

  3. Simpan dan tutup file .

Untuk menghapus profil

  1. Menggunakan editor teks, buka snowball-edge.config darihome directory\.aws\snowball\config.

    catatan

    Pastikan lingkungan Anda dikonfigurasi untuk memungkinkan Anda mengakses membaca dan menulis file ini.

  2. Hapus baris yang berisi nama profil, tanda kurung keriting { } yang mengikuti nama profil, dan konten dalam tanda kurung tersebut.

  3. 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.AWS Command Line Interface

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge list-access-keys
contoh Output
{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge get-secret-access-key --access-key-id Access Key
contoh 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), Snow 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, Snow Device Management, dan AWS IoT Greengrass 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.


snowballEdge start-service --profile profile-name --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn
contoh 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, lihatMengelola antarmuka NFS di Snowball Edge.

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 di panduan ini. 


snowballEdge stop-service --profile profile-name --service-id service_id
contoh 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
    contoh 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. CUSTOMERlog disimpan dalam .zip format, dan Anda dapat mengekstrak jenis log ini untuk melihat isinya. SUPPORTlog dienkripsi dan hanya dapat dibaca oleh. AWS Dukungan Anda memiliki opsi untuk menentukan nama dan jalur untuk log.

    Penggunaan

    snowballEdge get-log --profile profile-name --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709
    contoh 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
    contoh 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
contoh 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
    contoh 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 dalam panduan ini.

    • INACTIVE – Layanan tidak berjalan dan tidak tersedia untuk digunakan.

    Penggunaan

    snowballEdge describe-service --profile profile-name --service-id service-id
    contoh 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"
      }
    }
  ]
}
    contoh Penyimpanan yang kompatibel dengan Amazon S3 pada output layanan Snowball Edge

    describe-servicePerintah 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

RemoteManagementStatemenunjukkan status Manajemen Perangkat Salju 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 berada di lapangan sebelum diluncurkan.

Penggunaan


snowballEdge describe-features --profile profile-name
contoh 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
contoh 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-sourcesPerintah mengembalikan daftar status sumber waktu. Setiap status sumber kali berisiAddress,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 menjadi perangkat Snowball Edge lainnya di cluster dan secara otomatis diatur ketika cluster dikaitkan.

  • StratumBidang 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 lainnya di cluster. Dalam contoh output, describe-time-sources disebut pada Snowball 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 --profile profile-name time-server-address
catatan

update-time-serversPerintah akan mengganti pengaturan server waktu NTP sebelumnya.

contoh 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.

Penggunaan

snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png
contoh 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.

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
contoh 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"
    }
}