Perintah untuk Klien Snowball Edge

Berikut ini, Anda dapat menemukan informasi tentang perintah klien Snowball Edge, termasuk contoh penggunaan dan output sampel.

Mengonfigurasi Profil untuk Klien Snowball Edge

Setiap kali Anda menjalankan perintah untuk klien Snowball Edge, Anda memberikan file manifes Anda, membuka kunci kode, dan alamat IP. Anda bisa mendapatkan dua yang pertama dari ini dari Konsol Manajemen AWS Snow Family atau manajemen pekerjaanAPI. Untuk informasi selengkapnya tentang mendapatkan manifes dan membuka kunci kode, lihat Mendapatkankan Kredensial.

Anda memiliki opsi menggunakan perintah snowballEdge configure untuk menyimpan jalur ke manifes, kode buka kunci 29-karakter dan titik akhir sebagai profil. Setelah konfigurasi, Anda dapat menggunakan perintah klien Snowball Edge lainnya tanpa harus secara manual memasukkan nilai-nilai ini untuk tugas tertentu. Setelah Anda mengkonfigurasi klien Snowball Edge, informasi disimpan dalam format JSON plaintext ke. home directory/.aws/snowball/config/snowball-.config

Titik akhir adalah alamat IP, dengan https:// ditambahkan ke dalamnya. Anda dapat menemukan alamat IP untuk AWS Snowcone perangkat pada LCD tampilan AWS Snowcone perangkat. Ketika AWS Snowcone perangkat terhubung ke jaringan Anda untuk pertama kalinya, secara otomatis mendapatkan alamat DHCP IP, jika DHCP server tersedia. Jika Anda ingin menggunakan alamat IP yang berbeda, Anda dapat mengubahnya dari LCD tampilan. Untuk informasi selengkapnya, lihat Menggunakan AWS Layanan di AWS Snowcone.

Penggunaan

Anda dapat menggunakan perintah ini dengan dua cara: inline, atau saat diminta. Contoh penggunaan ini menunjukkan metode yang diminta.

snowballEdge configure

Configuration will be stored at home directory\.aws\snowball\config\snowball-.config
Snowcone  Manifest Path: Path/to/manifest/file
Unlock Code: 29 character unlock code
Default Endpoint: https://192.0.2.0

Anda dapat memiliki beberapa profil jika Anda memiliki beberapa tugas sekaligus. Untuk informasi selengkapnya tentang beberapa AWS CLI profil, lihat Profil Bernama di Panduan AWS Command Line Interface Pengguna.

Mendapatkan Kode QR Anda untuk Validasi NFC

Anda dapat menggunakan perintah ini untuk menghasilkan kode QR khusus perangkat untuk digunakan dengan AWS Snowcone Verification App. Anda dapat mengunduh aplikasi ini dari Apple App Store atau Google Play Store. Untuk informasi selengkapnya tentang NFC validasi, lihatMemvalidasi Tag NFC.

Penggunaan

snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png

QR code is saved to ~/downloads/snowball-qr-code.png

Membuka Kunci Perangkat AWS Snowcone

Untuk membuka kunci AWS Snowcone perangkat mandiri, jalankan snowballEdge unlock-device perintah. Perintah ini mengautentikasi akses Anda ke AWS Snowcone perangkat.

Saat Anda menjalankan salah satu perintah pembuka kunci ini, Anda dapat secara manual memasukkan jalur ke file manifes, kode buka 29-karakter, dan alamat IP untuk perangkat mandiri Anda. Proses ini bisa menjadi membosankan, jadi kami rekomendasikan Anda mengonfigurasi klien Snowball Edge Anda sebagai gantinya. Jika Anda telah mengonfigurasi klien Snowball Edge, maka Anda hanya perlu memasukkan perintah itu sendiri tanpa jalur ke manifes, kode buka kunci, atau alamat IP.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge unlock-device

Your AWS Snowcone device is unlocking. You may determine the unlock state of your device using the describe-device command. Your AWS Snowcone device will be available for use when it is in the UNLOCKED state.

Memperbarui Snowcone

Gunakan perintah berikut untuk mengunduh dan menginstal pembaruan untuk perangkat Snowcone Anda. Untuk prosedur yang menggunakan perintah ini, lihat Memperbarui Snowcone .

snowballEdge check-for-updates – Menghasilkan informasi versi tentang perangkat lunak Snowball tersedia yang di cloud, dan versi saat ini yang diinstal pada perangkat.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge check-for-updates

Latest version: 102
Installed version: 101

snowballEdge describe-device-software – Menghasilkan versi perangkat lunak saat ini untuk perangkat. Selain itu, jika pembaruan sedang diunduh, status unduhan juga ditampilkan. Jika pembaruan perangkat lunak sedang berlangsung, versi manifes pembaruan, dan status instalasi juga ditampilkan. Berikut ini adalah daftar kemungkinan output:

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge describe-device-software

Installed version: 101
Installing version: 102
Install State: Downloading

snowballEdge download-updates— Mulai mengunduh pembaruan perangkat lunak terbaru untuk perangkat Snowcone Anda.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge download-updates

Download started. Run describe-device-software API for additional information.

snowballEdge install-updates— Mulai menginstal pembaruan perangkat lunak terbaru untuk perangkat Snowcone Anda yang sudah diunduh.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge install-updates

Installation started.

snowballEdge reboot-device – Reboot perangkat.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge reboot-device

Rebooting device now.

snowballEdge configure-auto-update-strategies – Mengonfigurasi strategi pembaruan otomatis.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge configure-auto-update-strategy --auto-check autoCheck [--auto-check-frequency
autoCheckFreq] --auto-download autoDownload
[--auto-download-frequency autoDownloadFreq]
--auto-install autoInstall
[--auto-install-frequency autoInstallFreq]
--auto-reboot autoReboot [--endpoint
endpoint]

Successfully configured auto update strategy. Run describe-auto-update-strategies for additional information.

snowballEdge describe-auto-update-strategies – Menghasilkan strategi pembaruan otomatis yang saat ini dikonfigurasi.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge describe-auto-update-strategies

auto-update-strategy {[
auto-check:true,
auto-check-frequency: "0 0 * * FRI", // CRON Expression String, Every Friday at midnight
auto-download:true,
auto-download-frequency: "0 0 * * SAT", // CRON Expression String, Every Saturday at
midnight
auto-install:true,
auto-install-frequency: "0 13 * * Sun", // CRON Expression String, Every Saturday at
midnight
auto-reboot: false;
]}

Mendapatkankan Kredensial

Menggunakan perintah snowballEdge list-access-keys dan snowballEdge get-secret-access-key, Anda bisa mendapatkan kredensial lokal Anda. Anda menggunakan ini untuk mengautentikasi permintaan Anda saat menggunakan AWS CLI atau dengan AWS SDK. Kredensial ini hanya terkait dengan tugas individu untuk Snowcone, dan Anda dapat menggunakannya hanya pada perangkat. Perangkat tidak memiliki izin AWS Identity and Access Management (IAM) apa pun di file. AWS Cloud

Untuk informasi selengkapnya, lihat AWS kredensil dan menggunakan Amazon EC2 Endpoint.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge list-access-keys

{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge get-secret-access-key --access-key-id Access Key

[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Memulai Layanan di Perangkat Snowcone Anda

Snowcone mendukung beberapa layanan, termasuk instance komputasi, NFS antarmuka file, Amazon, dan. EC2 AWS DataSync Anda dapat memulai layanan ini dengan perintah snowballEdge start-service. Untuk mendapatkan ID layanan untuk setiap layanan, Anda dapat menggunakan perintah snowballEdge 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.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn

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 Perangkat Snowcone Anda

Untuk menghentikan layanan yang berjalan di perangkat Snowcone Anda, Anda dapat menggunakan perintah. snowballEdge stop-service EC2Layanan Amazon tidak dapat dihentikan.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge stop-service --service-id service_id

Stopping the AWS service on your Snowball . You can determine the status of the AWS service using the describe-service command.

Mendapatkan Sertifikat Anda untuk Mentransfer Data

Untuk mentransfer data ke perangkat Snowcone, gunakan NFS antarmuka atau. AWS DataSync Jika Anda membuka perangkat Snowcone dengan alamat IP yang berbeda, sertifikat baru yang dihasilkan dan sertifikat lama tidak berlaku lagi untuk digunakan dengan titik akhir. Anda bisa mendapatkan sertifikat baru yang diperbarui dari perangkat Snowcone lagi menggunakan perintah. get-certificate

Anda dapat mencantumkan sertifikat ini dan mengunduhnya dari perangkat Snowcone Anda dengan perintah berikut:

AWS Snowcone Log

Saat Anda mentransfer data antara pusat data on-premise dan Snowcone, 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:

Mendapatkan Status Perangkat

Anda dapat menentukan status dan kondisi umum perangkat Snowcone Anda dengan perintah klien Snowball Edge berikut:

Mendapatkan Status Layanan

Anda dapat menentukan status dan kondisi umum layanan yang berjalan pada perangkat Snowcone dengan menggunakan perintah describe-service. Anda dapat menjalankan perintah list-services terlebih dahulu untuk melihat layanan apa yang sedang berjalan.

Meluncurkan AWS DataSync AMI

Luncurkan AWS DataSync AMI on Snowcone.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

AWS DataSync harus diluncurkan dengan tipe snc1.medium instance. Peluncuran DataSync dengan jenis instans yang berbeda dapat mengakibatkan operasi yang tidak stabil dan potensi kehilangan data. Gunakan perintah describe-images untuk menemukan gambar tempat untuk meluncurkan instans. Output akan terlihat seperti berikut ini.

{
  "ImageId": "s.ami-0c046f119de4f752f",
  "Public": false,
  "State": "AVAILABLE",
  "BlockDeviceMappings": [
    {
      "DeviceName": "/dev/sda",
      "Ebs": {
        "DeleteOnTermination": true,
        "Iops": 0,
        "SnapshotId": "s.snap-0d7558ce444ab09bf",
        "VolumeSize": 20,
        "VolumeType": "sbp1"
      }
    }
  ],
  "Description": "AWS DataSync AMI for online data transfer",
  "EnaSupport": false,
  "Name": "scn-datasync-ami",
  "RootDeviceName": "/dev/sda"
}

aws ec2 describe-instances --endpoint http://${snowcone_ip}:8008

{
    "Reservations": [
        {
            "Instances": [
                {
                    "AmiLaunchIndex": 0,
                    "ImageId": "s.image id",
                    "InstanceId": "s.instance id",
                    "InstanceType": "snc1.medium",
                    "LaunchTime": "2020-03-06T18:58:36.609Z",
                    "PrivateIpAddress": "ip address",
                    "State": {
                        "Code": 16,
                        "Name": "running"
                    },
                    "BlockDeviceMappings": [
                        {
                            "DeviceName": "/dev/sda",
                            "Ebs": {
                                "AttachTime": "2020-03-06T19:14:21.336Z",
                                "DeleteOnTermination": true,
                                "Status": "attached",
                                "VolumeId": "s.volume id"
                            }
                        }
                    ],
                    "EbsOptimized": false,
                    "EnaSupport": false,
                    "RootDeviceName": "/dev/sda",
                    "SecurityGroups": [
                        {
                            "GroupName": "default",
                            "GroupId": "s.security group id"
                        }
                    ],
                    "SourceDestCheck": false,
                    "CpuOptions": {
                        "CoreCount": 2,
                        "ThreadsPerCore": 1
                    }
                }
            ],
            "ReservationId": "s.r-80c8ee6b041b29eb4"
        },
    ]
}

Jalankan instans.

aws ec2 run-instances --image-id s.ami id \--instance-type snc1.medium --endpoint http://${snowcone_ip}:8008

{
    "Instances": [
        {
            "AmiLaunchIndex": 0,
            "ImageId": "s.ami-0623310b494365cc5",
            "InstanceId": "s.i-80c8ee6b041b29eb4",
            "InstanceType": "snc1.medium",
            "State": {
                "Code": 0,
                "Name": "pending"
            },
            "EbsOptimized": false,
            "EnaSupport": false,
            "RootDeviceName": "/dev/sda",
            "SecurityGroups": [
                {
                    "GroupName": "default",
                    "GroupId": "s.sg-80c8ee6b041b29eb4"
                }
            ],
            "SourceDestCheck": false,
            "CpuOptions": {
                "CoreCount": 2,
                "ThreadsPerCore": 1
            }
        }
    ],
    "ReservationId": "s.r-80c8ee6b041b29eb4"
}

Memulai NFS dan Membatasi Akses

Mulailah NFS dengan snowballEdge start-service perintah. Untuk mendapatkan ID layanan untuk NFS layanan ini, Anda dapat menggunakan snowballEdge list-services perintah.

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. Anda dapat membatasi akses ke berbagi file dan data Anda dalam bucket Amazon S3 Anda dan melihat pembatasan apa yang saat ini di tempat. Anda melakukan ini dengan mengalokasikan CIDR blok untuk host yang diizinkan yang dapat mengakses file share dan S3 bucket ketika Anda memulai layanan. NFS

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge start-service --service-id nfs --virtual-network-interface-arns arn:aws:snowball-device:::interface/s.ni-12345fgh45678j --service-configuration AllowedHosts=ip address-1/32,ip address-2/24

Starting the service on your Snowball Edge. You can determine the status of the service using the describe-service command.

Membatasi Akses ke NFS Saham Saat NFS Berjalan

Anda dapat membatasi akses berbagi file dan data di bucket Amazon S3 Anda setelah Anda memulai. NFS Anda dapat melihat pembatasan apa yang saat ini ada, dan memberikan batasan akses yang berbeda pada setiap bucket. Anda melakukan ini dengan mengalokasikan CIDR blok untuk host yang dapat mengakses file share dan S3 bucket ketika Anda memulai layanan. NFS Berikut adalah contoh perintah tersebut.

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge start-service \
    --service-id nfs \
    --virtual-network-interface-arns virtual-network-interface-arn --service-configuration AllowedHosts=ip-address-1/32,ip-address-1/24

Untuk melihat pembatasan saat ini, gunakan perintah describe-service.

 snowballEdge describe-service --service-id nfs

Mendapatkan Jalur Ekspor untuk Bucket Amazon S3

Tidak ada perintah Snowcone khusus untuk mendapatkan jalur ekspor bucket Amazon S3. Format jalur ekspor terlihat seperti berikut ini.

/buckets/bucket-name.

Mengaktifkan Debugging AWS Operator Lokal

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge enable-local-aws-operator-debugging

Menonaktifkan Debugging Operator Lokal AWS

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge disable-local-aws-operator-debugging

Membuat Antarmuka Jaringan Langsung

Penggunaan (klien Snowball Edge yang dikonfigurasi)

create-direct-network-interface [--endpoint endpoint] [--instance-id instanceId] [--mac macAddress]
                                [--manifest-file manifestFile] [--physical-network-interface-id physicalNetworkInterfaceId] 
                                [--profile profile] [--unlock-code unlockCode] [--vlan vlanId]

Mendapatkan Informasi Tentang Antarmuka Jaringan Langsung

Penggunaan (klien Snowball Edge yang dikonfigurasi)

describe-direct-network-interfaces [--endpoint endpoint] [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode]

Memperbarui Antarmuka Jaringan Langsung

Penggunaan (klien Snowball Edge yang dikonfigurasi)

update-direct-network-interface [--direct-network-interface-arn directNetworkInterfaceArn] [--endpoint endpoint] 
                                [--mac macAddress]
                                [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode] 
                                [--vlan vlanId] [--attach-instance-id instanceId | --detach]

Menghapus Antarmuka Jaringan Langsung

Penggunaan (klien Snowball Edge yang dikonfigurasi)

delete-direct-network-interface [--direct-network-interface-arn directNetworkInterfaceArn] [--endpoint endpoint] 
                                [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode]                                 

Memeriksa status fitur

Untuk mencantumkan status fitur yang tersedia di perangkat Anda, termasuk AWS Snow Device Management, yang memungkinkan Anda mengelola perangkat Snowcone dan AWS layanan lokal dari jarak jauh, gunakan perintah. describe-features

RemoteManagementStatemenunjukkan status Manajemen Perangkat Salju dan mengembalikan salah satu status berikut:

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge describe-features 
--manifest-file manifest.bin path 
--unlock-code unlock-code 
--endpoint https://device-local-ip:9091

Contoh Keluaran

{
  "RemoteManagementState" : String
}
            

Mengubah status fitur

Untuk mengubah status fitur yang tersedia di AWS Snowcone perangkat Anda, gunakan set-features perintah. Untuk mengaktifkan atau menonaktifkan AWS Snow Device Management, yang memungkinkan Anda mengelola perangkat Snowcone dan AWS layanan lokal dari jarak jauh, gunakan parameter. --remote-management-state Perangkat harus dibuka kuncinya sebelum Anda menjalankan perintah ini.

Anda dapat mengatur Manajemen Perangkat Salju ke status berikut:

Penggunaan (klien Snowball Edge yang dikonfigurasi)

snowballEdge set-features
--remote-management-state INSTALLED_AUTOSTART
--manifest-file ./JID2bf11d5a-fict-414a-b5b1-3bf7e6a6e83d_manifest.bin
--unlock-code 73bb0-f8ke1-69a4a-f4288-4f88d
--endpoint https://10.0.0.25

Contoh Keluaran

{
  "RemoteManagementState" : "INSTALLED_AUTOSTART"
}
            

Mengatur Server Waktu

Anda dapat mengatur server Network Time Protocol (NTP) eksternal. Anda dapat menggunakan NTP CLI perintah saat perangkat dalam status terkunci dan tidak terkunci. Kode manifes dan buka kunci diperlukan. Anda dapat mengatur ini baik dengan snowballEdge configure perintah atau dengan menggunakan --unlock-code opsi --manifest-file dan. Perhatikan bahwa Anda dapat menggunakan snowballEdge CLI di AWS Snowcone Edge dan AWS Snowcone.

Adalah tanggung jawab Anda untuk menyediakan server NTP waktu yang aman. Untuk mengatur server NTP waktu mana perangkat terhubung, gunakan update-time-servers CLI perintah.

Penggunaan

snowballEdge update-time-servers time.google.com

Updating time servers now.

Memeriksa Sumber Waktu

Untuk melihat sumber NTP waktu mana perangkat saat ini terhubung, gunakan perintah describe-time-sources Snowball EdgeCLI.

Penggunaan

snowballEdge describe-time-sources

{
  "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.

Sumber NTP waktu 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.