Configurazione e utilizzo del client Snowball Edge - AWS Snowball Edge Guida per gli sviluppatori
Scaricamento e installazione del client Snowball EdgeConfigurazione di un profilo per il client Snowball EdgeRicerca della versione client Snowball EdgeOttenere le credenzialiAvvio di un servizio su un dispositivo Snow FamilyInterruzione di un servizio su un dispositivo Snow FamilyVisualizzazione e download dei logVisualizzazione dello stato del dispositivoVisualizzazione dello stato dei serviziVisualizzazione dello stato delle funzionalitàImpostazione dei server temporaliConvalida dei tag NFCAggiornamento delle dimensioni MTU

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione e utilizzo del client Snowball Edge

Lo Snowball Edge Client è uno strumento di interfaccia a riga di comando (CLI) AWS che puoi utilizzare per lavorare con un dispositivo Snow Family o un cluster di dispositivi Snow Family. Puoi utilizzare il client per sbloccare un dispositivo o un cluster di dispositivi Snow Family, configurare i dispositivi Snow Family, avviare e interrompere i servizi sui dispositivi e trasferire dati da o verso i dispositivi. Il client Snowball Edge è compatibile con i computer che eseguono sistemi operativi Linux, macOS e Windows.

Scaricamento e installazione del client Snowball Edge

È possibile scaricare il client Snowball Edge da AWS Snowball Edge Resources. In quella pagina puoi trovare il pacchetto di installazione per il tuo sistema operativo.

Installa e configura il client seguendo le istruzioni riportate di seguito.

Linux
Nota

Il client Snowball Edge è supportato solo su distribuzioni Linux a 64 bit.

  1. Estrarre il file snowball-client-linux.tar.gz. Crea la struttura delle /snowball-client-linux-build_number/bin cartelle e vi estrae i file.

  2. Esegui i seguenti comandi per configurare le cartelle.

    
  chmod u+x snowball-client-linux-build_number/bin/snowballEdge
  
    
  chmod u+x snowball-client-linux-build_number/jre/bin/java

  3. /snowball-client-linux-build_number/binAggiungila alla variabile di PATH ambiente $ del sistema operativo per eseguire i comandi del client Snowball Edge da qualsiasi directory. Per ulteriori informazioni, consulta la documentazione del sistema operativo del dispositivo o della shell.

macOS

  1. Estrarre il file snowball-client-mac.tar.gz. Crea la struttura delle /snowball-client-linux-build_number/bin cartelle e vi estrae i file.

  2. Esegui i seguenti comandi per configurare le cartelle.

    
  chmod u+x snowball-client-mac-build_number/bin/snowballEdge
  
    
  chmod u+x snowball-client-mac-build_number/jre/bin/java

  3. /snowball-client-mac-build_number/binAggiungila alla variabile di PATH ambiente $ del sistema operativo per eseguire i comandi del client Snowball Edge da qualsiasi directory. Per ulteriori informazioni, consulta la documentazione del sistema operativo del dispositivo o della shell.

Windows

Il client è impacchettato come file Microsoft Software Installer (MSI). Apri il file e segui le istruzioni della procedura guidata di installazione. Una volta installato il client, è possibile eseguirlo da qualsiasi directory senza alcuna preparazione aggiuntiva.

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 l'indirizzo IP del dispositivo Snow Family. Invece di fornirli ogni volta che esegui un comando, puoi utilizzare il configure comando per memorizzare il percorso del file manifest, il codice di sblocco di 29 caratteri e l'endpoint (l'indirizzo IP del dispositivo Snow Family) come profilo. Dopo la configurazione, è possibile utilizzare i comandi del client Snowball Edge senza dover inserire manualmente questi valori per ogni comando, includendo il nome del profilo nel comando. Dopo aver configurato il client Snowball Edge, le informazioni vengono salvate in formato testo JSON normale in. home directory/.aws/snowball/config/snowball-edge.config Assicurati che l'ambiente sia configurato per consentirti di creare questo file.

Importante

Chiunque possa accedere al file di configurazione può accedere ai dati sui dispositivi o sui cluster Snowball Edge. La gestione del controllo dell'accesso locale per questo file è una delle responsabilità amministrative.

Puoi anche usarli AWS OpsHub per creare un profilo. I profili creati in AWS OpsHub possono essere utilizzati con il client Snowball Edge, mentre i profili creati in AWS OpsHub possono essere utilizzati con lo Snowball Edge Client. Per ulteriori informazioni, consulta Gestione dei profili.

Per creare un profilo

  1. Immettete il comando nell'interfaccia a riga di comando del sistema operativo in uso. Il valore del profile-name parametro è il nome del profilo. Lo fornirai in futuro quando eseguirai i comandi del client Snowball Edge.

    
snowballEdge configure --profile profile-name

  2. Il client Snowball Edge richiederà all'utente di specificare ogni parametro. Quando richiesto, inserisci le informazioni relative al tuo ambiente e al dispositivo Snow Family.

    Nota

    Il valore del endpoint parametro è l'indirizzo IP del dispositivo Snow Family, preceduto da. https:// È possibile individuare l'indirizzo IP del dispositivo Snowball Edge sullo LCD schermo nella parte anteriore del dispositivo.

    Esempio uscita del comando configure
    
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

    Il client Snowball Edge verificherà che il codice di sblocco sia corretto per il file manifest. Se non corrispondono, il comando si interrompe e non crea il profilo. Controlla il codice di sblocco e il file manifest ed esegui nuovamente il comando.

Per utilizzare il profilo, --profile profile-name includi prima della sintassi del comando.

Se utilizzi più dispositivi Snow Family autonomi, puoi creare un profilo per ciascuno. Per creare un altro profilo, esegui nuovamente il configure comando, fornisci un valore diverso per il --profile parametro e fornisci le informazioni per un altro dispositivo.

Esempio di file snowball-edge.config

Questo esempio mostra un file di profilo contenente tre profili: SnowDevice1profileSnowDevice2profile, e. 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":[]
    }
}

Per modificare o eliminare i profili, modificate il file di profilo in un editor di testo.

Per modificare un profilo

  1. In un editor di testo, apri snowball-edge.config dahome directory\.aws\snowball\config.

    Nota

    Assicurati che il tuo ambiente sia configurato per consentirti di accedere per leggere e scrivere questo file.

  2. Modifica il file in base alle esigenze. Ad esempio, per modificare l'indirizzo IP del dispositivo Snow Family associato al profilo, modifica la defaultEndpoint voce.

  3. Salva e chiudi il file.

Per eliminare un profilo

  1. Utilizzando un editor di testo, apri snowball-edge.config dahome directory\.aws\snowball\config.

    Nota

    Assicurati che il tuo ambiente sia configurato per consentirti di accedere per leggere e scrivere questo file.

  2. Elimina la riga che contiene il nome del profilo, le parentesi curve { } che seguono il nome del profilo e il contenuto tra quelle parentesi.

  3. Salva e chiudi il file.

Ricerca della versione client Snowball Edge

Utilizzate il version comando per visualizzare la versione del client Snowball Edge Command Line Interface (CLI).

Utilizzo


    snowballEdge version

Output di esempio


    Snowball Edge client version: 1.2.0  Build 661

Ottenere le credenziali per un dispositivo Snow Family

Utilizzando i snowballEdge get-secret-access-key comandi snowballEdge list-access-keys and, puoi ottenere le credenziali dell'utente amministratore del tuo account Account AWS su Snowball Edge. Puoi utilizzare queste credenziali per creare AWS Identity and Access Management (IAMutenti) e ruoli e per autenticare le tue richieste quando usi o con un. AWS CLI AWS SDK Queste credenziali sono associate solo a un singolo job per Snowball Edge e possono essere utilizzate solo sul dispositivo o sul cluster di dispositivi. Il dispositivo o i dispositivi non dispongono di alcuna IAM autorizzazione in. Cloud AWS

Nota

Se utilizzi il AWS CLI con Snowball Edge, devi utilizzare queste credenziali quando configuri il. CLI Per informazioni sulla configurazione delle credenziali per AWS CLI, consulta Configurazione di nella Guida per l' AWS CLIutente.AWS Command Line Interface

Utilizzo (client Snowball Edge configurato)

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

Utilizzo (client Snowball Edge configurato)

snowballEdge get-secret-access-key --access-key-id Access Key
Esempio Output
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Avvio di un servizio su un dispositivo Snow Family

I dispositivi Snowball Edge supportano più servizi. Questi includono istanze di calcolo, l'interfaccia Network File System (NFS), Snow Device Management e. AWS IoT Greengrass Il servizio adattatore Amazon S3EC2, Amazon AWS STS, è avviato per impostazione predefinita e IAM non può essere interrotto o riavviato. Tuttavia, l'NFSinterfaccia, Snow Device Management, AWS IoT Greengrass può essere avviata utilizzando il relativo ID di servizio con il comando. start-service Per ottenere l'ID servizio per ogni servizio, puoi utilizzare il comando 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 su un dispositivo Snow Family.


snowballEdge start-service --profile profile-name --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn
Esempio uscita del start-service comando
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 su un dispositivo Snow Family

Per interrompere un servizio in esecuzione su un dispositivo Snow Family, puoi usare il stop-service comando.

L'adattatore Amazon S3EC2, AWS STS Amazon e i IAM servizi non possono essere interrotti.

avvertimento

La perdita di dati può verificarsi se il servizio Network File System (NFS) viene interrotto prima che i dati rimanenti nel buffer vengano scritti sul dispositivo. Per ulteriori informazioni sull'utilizzo del NFS servizio, vedereGestione dell'NFSinterfaccia sui dispositivi Snow Family.

Nota

L'interruzione del servizio di archiviazione compatibile con Amazon S3 sui dispositivi Snow Family disabilita l'accesso ai dati archiviati nei bucket S3 sul dispositivo o sul cluster. L'accesso viene ripristinato quando lo storage compatibile con Amazon S3 sui dispositivi Snow Family viene riavviato. Per i dispositivi dotati di storage compatibile con Amazon S3 sui dispositivi Snow Family, si consiglia di avviare il servizio dopo l'accensione del dispositivo Snowball Edge. Vedi Configurazione di Snowball Edge in questa guida. 


snowballEdge stop-service --profile profile-name --service-id service_id
Esempio output del comando stop-service
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Visualizzazione e download dei log dai dispositivi Snow Family

Quando trasferisci dati tra il data center locale e un dispositivo Snow Family, 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:

  • list-logs— Restituisce un elenco di log in formato. JSON Questo elenco riporta la dimensione dei log in byte, la ARN dimensione dei log, l'ID del servizio per i log e il tipo di log.

    Utilizzo

    snowballEdge list-logs --profile profile-name
    Esempio output del comando list-logs
    {
  "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— Scarica una copia di un registro specifico da Snowball Edge sul dispositivo in un percorso specificato. CUSTOMERi log vengono salvati nel .zip formato ed è possibile estrarre questo tipo di log per visualizzarne il contenuto. SUPPORTi registri sono crittografati e possono essere letti solo da. AWS SupportÈ possibile specificare un nome e un percorso per il log.

    Utilizzo

    snowballEdge get-log --profile profile-name --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709
    Esempio output del comando get-log
    Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin

  • get-support-logs— Scarica una copia di tutti i SUPPORT tipi di log da Snowball Edge al servizio in un percorso specificato.

    Utilizzo

    snowballEdge get-support-logs --profile profile-name
    Esempio output del comando get-support-logs
    Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
Importante

Il tipo CUSTOMER potrebbe contenere informazioni riservate sui propri dati. Per proteggere queste informazioni potenzialmente riservate, ti consigliamo di eliminare questi log quando non servono più.

Visualizzazione dello stato di un dispositivo Snow Family

È possibile determinare lo stato e lo stato generale dei dispositivi Snow Family con il describe-device comando.

snowballEdge describe-device --profile profile-name
Esempio uscita del describe-device comando

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

Visualizzazione dello stato dei servizi in esecuzione sui dispositivi Snow Family

È possibile determinare lo stato e lo stato generale dei servizi in esecuzione sui dispositivi Snowball Edge con il describe-service comando. Puoi eseguire innanzitutto il comando list-services per vedere quali servizi sono in esecuzione.

  • list-services

    Utilizzo

    snowballEdge list-services --profile profile-name
    Esempio output del comando list-services
    {
  "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}

  • describe-service

    Questo comando restituisce un valore di stato per un servizio. Include anche informazioni sullo stato che possono essere utili per la risoluzione dei problemi rilevati con il servizio. Gli stati sono riportati di seguito.

    • ACTIVE: il servizio è in esecuzione e disponibile per l'uso.

    • ACTIVATING: il servizio è in fase di avvio, ma non è ancora disponibile per l'uso.

    • DEACTIVATING: il servizio è in fase di chiusura.

    • DEGRADED— Per lo storage compatibile con Amazon S3 sui dispositivi Snow Family, questo stato indica che uno o più dischi o dispositivi del cluster non sono attivi. Il servizio di storage compatibile con Amazon S3 sui dispositivi Snow Family funziona senza interruzioni, ma è necessario ripristinare o sostituire il dispositivo interessato prima che il quorum del cluster vada perso per ridurre al minimo il rischio di perdita di dati. Vedi la panoramica sul clustering in questa guida.

    • INACTIVE: il servizio non è in esecuzione e non è disponibile per l'uso.

    Utilizzo

    snowballEdge describe-service --profile profile-name --service-id service-id
    Esempio output del comando describe-service
    
{
  "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"
      }
    }
  ]
}
    Esempio Output del servizio di storage compatibile con Amazon S3 sui dispositivi Snow Family

    Il describe-service comando fornisce il seguente output per s3-snow valore del service-id parametro.

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

Visualizzazione dello stato delle funzionalità dei dispositivi Snow Family

Per elencare lo stato delle funzionalità disponibili su un dispositivo Snow Family usa il describe-features comando.

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

  • INSTALLED_ONLY— La funzione è installata ma non abilitata.

  • INSTALLED_AUTOSTART— La funzionalità è abilitata e il dispositivo tenterà di Regione AWS connettersi all'accensione.

  • NOT_INSTALLED— Il dispositivo non supporta la funzionalità o era già presente sul campo prima del lancio.

Utilizzo


snowballEdge describe-features --profile profile-name
Esempio uscita del describe-features comando

{
  "RemoteManagementState" : String
}

Impostazione dei time server per i dispositivi Snow Family

È possibile utilizzare i comandi del client Snowball Edge per visualizzare la configurazione corrente del Network Time Protocol (NTP) e scegliere un server o un peer per fornire l'ora. È possibile utilizzare i comandi del client Snowball Edge quando il dispositivo è bloccato e sbloccato.

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

Controllo delle sorgenti temporali dei dispositivi Snow Family

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

snowballEdge describe-time-sources --profile profile-name
Esempio output del describe-time-sources comando
{
  "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 di origine temporale. Ogni stato dell'origine temporale contiene i Stratum campi Address StateType,, e. Di seguito sono riportati i significati di questi campi.

  • Address— Il DNS nome/indirizzo IP della fonte temporale.

  • State— Lo stato attuale della connessione tra il dispositivo e quella fonte di orario. Esistono cinque stati possibili:.

    • CURRENT- La fonte dell'ora è attualmente utilizzata per sincronizzare l'ora.

    • COMBINED— La fonte dell'ora è combinata con la fonte corrente.

    • EXCLUDED— L'origine temporale è esclusa dall'algoritmo di combinazione.

    • LOST— La connessione con la fonte dell'ora è stata interrotta.

    • UNACCEPTABLE— Una fonte temporale non valida in cui l'algoritmo di combinazione è stato considerato un falso indicatore o presenta troppa variabilità.

  • Type— Un'origine NTP temporale può essere un server o un peer. I server possono essere impostati tramite il update-time-servers comando. I peer possono essere solo altri dispositivi Snowball Edge nel cluster e vengono configurati automaticamente quando il cluster viene associato.

  • Stratum— Questo campo mostra lo strato della sorgente. Stratum 1 indica una sorgente con un orologio di riferimento collegato localmente. Una sorgente sincronizzata con una sorgente dello strato 1 si trova nello strato 2. Una sorgente sincronizzata con una sorgente di strato 2 si trova allo strato 3 e così via..

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.

Aggiornamento dei time server

Usa il update-time-servers comando e l'indirizzo del time server per configurare il dispositivo Snow Family per cui utilizzare un NTP server o un peer. NTP

snowballEdge update-time-servers --profile profile-name time-server-address
Nota

Il update-time-servers comando sovrascriverà le precedenti impostazioni dei NTP time server.

Esempio output del comando update-time-servers
Updating time servers now.

Ottenere un codice QR per convalidare i tag NFC Snowball Edge

È possibile usare questo comando per generare un codice QR specifico per il dispositivo da utilizzare con l'Edge Verification App di AWS Snowball . Per ulteriori informazioni sulla NFC convalida, vedere. Convalida dei tag NFC

Utilizzo

snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png
Esempio Output
QR code is saved to ~/downloads/snowball-qr-code.png

Aggiornamento delle dimensioni MTU

Usa il update-mtu-size comando per modificare la dimensione in byte dell'unità di trasmissione massima (MTU) di un'interfaccia fisica di un dispositivo Snow Family. Tutte le interfacce di rete virtuali e le interfacce di rete dirette associate a questa interfaccia di rete fisica verranno configurate con le stesse MTU dimensioni.

Nota

La MTU dimensione minima è 1500 byte e la dimensione massima è 9216 byte.

È possibile utilizzare il describe-device comando per recuperare l'interfaccia di rete fisica IDs e le MTU dimensioni correnti di tali interfacce. Per ulteriori informazioni, consulta Visualizzazione dello stato di un dispositivo Snow Family.

È possibile utilizzare i describe-virtual-network-interface comandi descibe-direct-network-interface and per recuperare le MTU dimensioni correnti di tali interfacce.

Utilizzo

snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes
Esempio di output update-mtu-size

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