Comandi per il client Snowball Edge

Di seguito sono disponibili informazioni sui comandi del client Snowball Edge, inclusi esempi di utilizzo e output di esempio.

Configurazione di un profilo per il client Snowball Edge

Ogni volta che esegui un comando per il client Snowball Edge, fornisci il file manifest, il codice di sblocco e un indirizzo IP. I primi due di questi possono essere ottenuti dalla Console di gestione della famiglia di servizi AWS Snow direzione API del lavoro. Per ulteriori informazioni su come ottenere il manifest e il codice di sblocco, consulta Ottenimento delle credenziali.

Puoi usare il comando snowballEdge configure per memorizzare il percorso al manifest, il codice di sblocco di 29 caratteri e l'endpoint come un profilo. Dopo la configurazione, è possibile utilizzare altri comandi del client Snowball Edge senza dover inserire manualmente questi valori per un particolare lavoro. Dopo aver configurato il client Snowball Edge, le informazioni vengono salvate in formato testo JSON normale in. home directory/.aws/snowball/config/snowball-.config

L'endpoint è l'indirizzo IP, a cui viene aggiunto https://. È possibile individuare l'indirizzo IP del AWS Snowcone dispositivo sul display del dispositivo. AWS Snowcone LCD Quando il AWS Snowcone dispositivo viene connesso alla rete per la prima volta, ottiene automaticamente un indirizzo DHCP IP, se è disponibile un DHCP server. Se desideri utilizzare un indirizzo IP diverso, puoi modificarlo dal LCD display. Per ulteriori informazioni, consulta Utilizzo AWS dei servizi su AWS Snowcone.

Utilizzo

Puoi usare questo comando in due modi: inline o quando richiesto. Questo esempio di utilizzo mostra il metodo a richiesta.

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

Puoi avere più profili se hai più lavori contemporaneamente. Per ulteriori informazioni su più AWS CLI profili, consulta Named Profiles nella Guida AWS Command Line Interface per l'utente.

Ottenere il codice QR per la NFC convalida

Puoi utilizzare questo comando per generare un codice QR specifico per il dispositivo da utilizzare con l'app di verifica. AWS Snowcone È possibile scaricare questa app dall'App Store di Apple o da Google Play. Per ulteriori informazioni sulla NFC convalida, consulta. Convalida dei tag NFC

Utilizzo

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

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

Sblocco di un dispositivo AWS Snowcone

Per sbloccare un AWS Snowcone dispositivo autonomo, esegui il comando. snowballEdge unlock-device Questi comandi autenticano l'accesso al AWS Snowcone dispositivo.

Quando esegui uno di questi comandi di sblocco, puoi inserire manualmente il percorso del file manifest, il codice di sblocco di 29 caratteri e l'indirizzo IP del tuo dispositivo autonomo. Questo processo può diventare noioso, quindi consigliamo di configurare invece il client Snowball Edge. Se hai già configurato il client Snowball Edge, devi solo inserire il comando stesso senza il percorso del manifesto, il codice di sblocco o l'indirizzo IP.

Utilizzo (client Snowball Edge configurato)

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.

Aggiornamento di uno Snowcone

Usa i seguenti comandi per scaricare e installare gli aggiornamenti per il tuo dispositivo Snowcone. Per le procedure che utilizzano questi comandi, consulta Aggiornamento di uno Snowcone .

snowballEdge check-for-updates— Restituisce informazioni sulla versione del software Snowball disponibile nel cloud e sulla versione corrente installata sul dispositivo.

Utilizzo (client Snowball Edge configurato)

snowballEdge check-for-updates

Latest version: 102
Installed version: 101

snowballEdge describe-device-software— Restituisce la versione corrente del software del dispositivo. Inoltre, se l'aggiornamento è in fase di download, viene anche visualizzato lo stato del download. Se l'aggiornamento del software è in corso, vengono inoltre visualizzati la versione del manifest di aggiornamento e lo stato dell'installazione. Di seguito è riportato un elenco dei possibili risultati.

Utilizzo (client Snowball Edge configurato)

snowballEdge describe-device-software

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

snowballEdge download-updates— Inizia a scaricare gli ultimi aggiornamenti software per il tuo dispositivo Snowcone.

Utilizzo (client Snowball Edge configurato)

snowballEdge download-updates

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

snowballEdge install-updates— Inizia l'installazione degli aggiornamenti software più recenti per il tuo dispositivo Snowcone che erano già stati scaricati.

Utilizzo (client Snowball Edge configurato)

snowballEdge install-updates

Installation started.

snowballEdge reboot-device— Riavvia il dispositivo.

Utilizzo (client Snowball Edge configurato)

snowballEdge reboot-device

Rebooting device now.

snowballEdge configure-auto-update-strategies— Configura una strategia di aggiornamento automatico.

Utilizzo (client Snowball Edge configurato)

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— Restituisce qualsiasi strategia di aggiornamento automatico attualmente configurata.

Utilizzo (client Snowball Edge configurato)

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;
]}

Ottenimento delle credenziali

Utilizzando i comandi snowballEdge list-access-keys e snowballEdge get-secret-access-key puoi ottenere le credenziali locali. Li usi per autenticare le tue richieste quando usi AWS CLI o con un. AWS SDK Queste credenziali sono associate solo a un singolo job per Snowcone e possono essere utilizzate solo sul dispositivo. Il dispositivo non dispone di alcuna autorizzazione AWS Identity and Access Management (IAM) in. Cloud AWS

Per ulteriori informazioni, consulta AWS le credenziali e l'utilizzo di Amazon EC2 Endpoint.

Utilizzo (client Snowball Edge configurato)

snowballEdge list-access-keys

{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Utilizzo (client Snowball Edge configurato)

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

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

Avvio di un servizio sul dispositivo Snowcone

Snowcone supporta diversi servizi, tra cui istanze di calcolo, NFS interfaccia di file, Amazon e. EC2 AWS DataSyncÈ possibile avviare questi servizi con il comando. snowballEdge start-service Per ottenere l'ID servizio per ogni servizio, puoi utilizzare il comando snowballEdge list-services.

Prima di eseguire questo comando, crea una singola interfaccia di rete virtuale da associare al servizio che intendi avviare. Per ulteriori informazioni, consulta Creazione di un'interfaccia di rete virtuale.

Utilizzo (client Snowball Edge configurato)

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.

Interruzione di un servizio sul dispositivo Snowcone

Per interrompere l'esecuzione di un servizio sul tuo dispositivo Snowcone, puoi usare il snowballEdge stop-service comando. I EC2 servizi Amazon non possono essere interrotti.

Utilizzo (client Snowball Edge configurato)

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.

Ottenere il certificato per il trasferimento dati

Per trasferire dati su un dispositivo Snowcone, usa l'NFSinterfaccia o. AWS DataSync Se sblocchi il dispositivo Snowcone con un indirizzo IP diverso, viene generato un nuovo certificato e il vecchio certificato non è più valido per l'uso con l'endpoint. È possibile ottenere nuovamente il nuovo certificato aggiornato dal dispositivo Snowcone utilizzando il get-certificate comando.

Puoi elencare questi certificati e scaricarli dal tuo dispositivo Snowcone con i seguenti comandi:

AWS Snowcone Registri

Quando trasferisci dati tra il data center locale e un dispositivo Snowcone, i log vengono generati automaticamente. Se si verificano errori imprevisti durante il trasferimento dei dati nel dispositivo, puoi utilizzare i comandi seguenti per salvare una copia dei log nel server locale.

Esistono tre comandi correlati ai log:

Ottenere lo stato del dispositivo

È possibile determinare lo stato e lo stato generale del dispositivo Snowcone con i seguenti comandi del client Snowball Edge:

Ottenere lo stato dei servizi

È possibile determinare lo stato e lo stato generale dei servizi in esecuzione su un dispositivo Snowcone utilizzando il describe-service comando. Puoi eseguire innanzitutto il comando list-services per vedere quali servizi sono in esecuzione.

Avvio di AWS DataSync AMI

Avvia AWS DataSync AMI su Snowcone.

Utilizzo (client Snowball Edge configurato)

AWS DataSync deve essere avviato con il tipo di snc1.medium istanza. L'avvio DataSync con un tipo di istanza diverso può causare un'operazione instabile e una potenziale perdita di dati. Utilizzate il describe-images comando per trovare l'immagine da cui avviare un'istanza. L'output sarà simile al seguente.

{
  "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"
        },
    ]
}

Eseguite l'istanza.

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

Avvio NFS e limitazione dell'accesso

Inizia NFS con il snowballEdge start-service comando. Per ottenere l'ID del NFS servizio, è possibile utilizzare il snowballEdge list-services comando.

Prima di eseguire questo comando, crea una singola interfaccia di rete virtuale da associare al servizio che intendi avviare. Per ulteriori informazioni, consulta Creazione di un'interfaccia di rete virtuale. Puoi limitare l'accesso alle tue condivisioni di file e ai dati nei tuoi bucket Amazon S3 e vedere quali restrizioni sono attualmente in vigore. Puoi farlo allocando CIDR blocchi per host autorizzati che possono accedere alla tua condivisione di file e ai bucket S3 all'avvio del servizio. NFS

Utilizzo (client Snowball Edge configurato)

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.

Limitazione dell'accesso alle NFS condivisioni quando NFS è in esecuzione

Puoi limitare l'accesso alle tue condivisioni di file e ai dati nei bucket Amazon S3 dopo aver iniziato. NFS Puoi vedere quali restrizioni sono attualmente in vigore e assegnare a ciascun bucket restrizioni di accesso diverse. Puoi farlo allocando CIDR blocchi per gli host che possono accedere alla tua condivisione di file e ai bucket S3 all'avvio del servizio. NFS Il seguente è un comando di esempio.

Utilizzo (client Snowball Edge configurato)

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

Per visualizzare le restrizioni attuali, usa il describe-service comando.

 snowballEdge describe-service --service-id nfs

Ottenere il percorso di esportazione per un bucket Amazon S3

Non esiste un comando Snowcone specifico per ottenere il percorso di esportazione di un bucket Amazon S3. Il formato del percorso di esportazione è simile al seguente.

/buckets/bucket-name.

Abilitazione del debug AWS degli operatori locali

Utilizzo (client Snowball Edge configurato)

snowballEdge enable-local-aws-operator-debugging

Disattivazione del debug degli operatori locali AWS

Utilizzo (client Snowball Edge configurato)

snowballEdge disable-local-aws-operator-debugging

Creazione di un'interfaccia di rete diretta

Utilizzo (client Snowball Edge configurato)

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]

Ottenere informazioni su un'interfaccia di rete diretta

Utilizzo (client Snowball Edge configurato)

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

Aggiornamento di un'interfaccia di rete diretta

Utilizzo (client Snowball Edge configurato)

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]

Eliminazione di un'interfaccia di rete diretta

Utilizzo (client Snowball Edge configurato)

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

Verifica dello stato della funzionalità

Per elencare lo stato delle funzionalità disponibili sul dispositivo AWS Snow Device Management, tra cui quelle che consentono di gestire il dispositivo Snowcone e AWS i servizi locali da remoto, utilizza il comando. describe-features

RemoteManagementStateindica lo stato di Snow Device Management e restituisce uno dei seguenti stati:

Utilizzo (client Snowball Edge configurato)

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

Esempio di Output

{
  "RemoteManagementState" : String
}
            

Modifica dello stato delle funzionalità

Per modificare lo stato delle funzionalità disponibili sul tuo AWS Snowcone dispositivo, usa il set-features comando. Per abilitare o disabilitare AWS Snow Device Management, che consente di gestire il dispositivo Snowcone e AWS i servizi locali da remoto, utilizza il parametro. --remote-management-state Il dispositivo deve essere sbloccato prima di eseguire questo comando.

È possibile impostare Snow Device Management sui seguenti stati:

Utilizzo (client Snowball Edge configurato)

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

Esempio di Output

{
  "RemoteManagementState" : "INSTALLED_AUTOSTART"
}
            

Impostazione dei time server

È possibile configurare un server Network Time Protocol (NTP) esterno. È possibile utilizzare i NTP CLI comandi quando il dispositivo è sia bloccato che sbloccato. Il codice manifest e il codice di sblocco sono obbligatori. È possibile impostarli con il snowballEdge configure comando o utilizzando le --unlock-code opzioni --manifest-file and. Nota che puoi usare sia snowballEdge CLI su AWS Snowcone Edge che AWS Snowcone.

È tua responsabilità fornire un NTP time server sicuro. Per impostare a quali server NTP orari si connette il dispositivo, usa il update-time-servers CLI comando.

Utilizzo

snowballEdge update-time-servers time.google.com

Updating time servers now.

Controllo delle sorgenti temporali

Per vedere a quali sorgenti NTP orarie è attualmente connesso il dispositivo, usa il comando describe-time-sources Snowball EdgeCLI.

Utilizzo

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
  } ]
}

Il describe-time-sources comando restituisce un elenco di stati dell'origine dell'ora. Ogni stato dell'origine temporale contiene i Stratum campi Address StateType,, e. Di seguito sono riportati i significati di questi campi.

Una fonte NTP temporale può essere un server o un peer. Un server può essere impostato dall'utente con il update-time-servers comando, mentre un peer può essere costituito solo da altri dispositivi Snowball Edge del cluster. Nell'output di esempio, describe-time-sources viene chiamato su uno Snowball Edge che si trova in un cluster di 5. L'output contiene 4 peer e 1 server. I peer hanno uno strato di 10 mentre il server ha uno strato di 1; pertanto, il server viene selezionato come fonte di tempo corrente.