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 Snowball Edge o un cluster di Snowball Edge. Puoi utilizzare il client per sbloccare uno Snowball Edge o un cluster di dispositivi, configurare Snowball Edge, 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.
**Topics**
+ [
## Scaricamento e installazione del client Snowball Edge
](#download-the-client)
+ [
## Configurazione di un profilo per il client Snowball Edge
](#client-configuration)
+ [
## Ricerca della versione client Snowball Edge
](#cli-version)
+ [
## Ottenere le credenziali per uno Snowball Edge
](#client-credentials)
+ [
## Avvio di un servizio su Snowball Edge
](#edge-start-service)
+ [
## Interruzione di un servizio su Snowball Edge
](#edge-stop-service)
+ [
## Visualizzazione e download dei log da Snowball Edge
](#logs)
+ [
## Visualizzazione dello stato di uno Snowball Edge
](#client-status)
+ [
## Visualizzazione dello stato dei servizi in esecuzione su Snowball Edge
](#client-service-status)
+ [
## Visualizzazione dello stato delle funzionalità di Snowball Edge
](#snowball-edge-describe-features)
+ [
## Impostazione dei time server per Snowball Edge
](#client-set-ntp)
+ [
## Ottenere un codice QR per convalidare i tag NFC di Snowball Edge
](#client-qr-code)
+ [
## Aggiornamento delle dimensioni MTU
](#update-mtu-size)
## Scaricamento e installazione del client Snowball Edge
[È possibile scaricare il client Snowball Edge da AWS Snowball Edge Resources.](https://aws.amazon.com/snowball/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.
1. 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
```
1. `/snowball-client-linux-build_number/bin`Aggiungila alla variabile di ambiente \$1PATH 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.
1. 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
```
1. `/snowball-client-mac-build_number/bin`Aggiungila alla variabile di ambiente \$1PATH 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 è confezionato 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 di Snowball Edge. Invece di fornirli ogni volta che si esegue un comando, è possibile utilizzare il `configure` comando per memorizzare il percorso del file manifest, il codice di sblocco di 29 caratteri e l'endpoint (l'indirizzo IP di Snowball Edge) 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 JSON di testo 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 utilizzarli 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](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-device.html#manage-profile) 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
```
1. Il client Snowball Edge richiederà all'utente di specificare ogni parametro. Quando richiesto, inserisci le informazioni relative al tuo ambiente e a Snowball Edge.
**Nota**
Il valore del `endpoint` parametro è l'indirizzo IP di Snowball Edge, preceduto da. `https://` È possibile individuare l'indirizzo IP del dispositivo Snowball Edge sullo schermo LCD sulla parte anteriore del dispositivo.
**Example 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, includi `--profile profile-name` dopo la sintassi del comando.
Se utilizzi più Snowball Edge autonomi, puoi creare un profilo per ognuno di essi. 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.
**Example Esempio di file `snowball-edge.config`**
Questo esempio mostra un file di profilo contenente tre profili: `SnowDevice1profile``SnowDevice2profile`, 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` da`home directory\.aws\snowball\config`.
**Nota**
Assicurati che il tuo ambiente sia configurato per consentirti di accedere per leggere e scrivere questo file.
1. Modifica il file in base alle esigenze. Ad esempio, per modificare l'indirizzo IP di Snowball Edge associato al profilo, modifica la `defaultEndpoint` voce.
1. Salva e chiudi il file.
**Per eliminare un profilo**
1. Utilizzando un editor di testo, apri `snowball-edge.config` da`home directory\.aws\snowball\config`.
**Nota**
Assicurati che il tuo ambiente sia configurato per consentirti di accedere per leggere e scrivere questo file.
1. Elimina la riga che contiene il nome del profilo, le parentesi curve `{` `}` che seguono il nome del profilo e il contenuto tra quelle parentesi.
1. 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 uno Snowball Edge
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 (utenti IAM) e ruoli e per autenticare le tue richieste quando usi AWS CLI o con un SDK. AWS 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 autorizzazioni IAM in. Cloud AWS
**Nota**
Se utilizzi Snowball Edge, devi usare queste credenziali quando configuri la CLI. AWS CLI *Per informazioni sulla configurazione delle credenziali per AWS CLI, consulta [Configuring](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration) the nella Guida per l'utente. AWS CLIAWS Command Line Interface *
**Utilizzo (client Snowball Edge configurato)**
```
snowballEdge list-access-keys
```
**Example Output**
```
{
"AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}
```
**Utilizzo (client Snowball Edge configurato)**
```
snowballEdge get-secret-access-key --access-key-id Access Key
```
**Example Output**
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
## Avvio di un servizio su Snowball Edge
I dispositivi Snowball Edge supportano più servizi. Questi includono istanze di calcolo, l'interfaccia Network File System (NFS), Snowball Edge Device Management e. AWS IoT Greengrass Il servizio adattatore Amazon S3 EC2 AWS STS, Amazon e IAM vengono avviati per impostazione predefinita e non possono essere interrotti o riavviati. Tuttavia, l'interfaccia NFS, Snowball Edge Device Management, AWS IoT Greengrass può essere avviata utilizzando il relativo ID di servizio con `start-service` il comando. 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 Snowball Edge](using-ec2-edge-client.md#ec2-edge-create-vnic).
```
snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn --profile profile-name
```
**Example output del comando `start-service`**
```
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 Snowball Edge
Per interrompere l'esecuzione di un servizio su Snowball Edge, puoi usare il `stop-service` comando.
L'adattatore Amazon S3 EC2, AWS STS Amazon e i servizi IAM 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 servizio NFS, vedere. [Gestione dell'interfaccia NFS su Snowball Edge](shared-using-nfs.md)
**Nota**
L'interruzione dello storage compatibile con Amazon S3 sul servizio Snowball Edge 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 su Snowball Edge viene riavviato. Per i dispositivi dotati di storage compatibile con Amazon S3 su Snowball Edge, si consiglia di avviare il servizio dopo l'accensione del dispositivo Snowball Edge. Vedi [Configurazione di Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/s3compatible-on-snow.html#setting-up-s3-on-snow-cluster) in questa guida.
```
snowballEdge stop-service --service-id service_id --profile profile-name
```
**Example 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 da Snowball Edge
Quando trasferisci dati tra il data center locale e uno Snowball Edge, 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 segnala le dimensioni dei log in byte, l'ARN per i log, l'ID servizio per i log e il tipo di log.
**Utilizzo**
```
snowballEdge list-logs --profile profile-name
```
**Example 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. `CUSTOMER`i log vengono salvati nel `.zip` formato ed è possibile estrarre questo tipo di log per visualizzarne il contenuto. `SUPPORT`i registri sono crittografati e possono essere letti solo da. Supporto AWSÈ possibile specificare un nome e un percorso per il log.
**Utilizzo**
```
snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709 --profile profile-name
```
**Example 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
```
**Example 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 uno Snowball Edge
È possibile determinare lo stato e lo stato generale di Snowball Edge con il `describe-device` comando.
```
snowballEdge describe-device --profile profile-name
```
**Example output del comando `describe-device`**
```
{
"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 su Snowball Edge
È 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
```
**Example 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 su Snowball Edge, questo stato indica che uno o più dischi o dispositivi del cluster non sono attivi. Lo storage compatibile con Amazon S3 sul servizio Snowball Edge 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. [Consulta la panoramica sul clustering in questa guida.](https://docs.aws.amazon.com/snowball/latest/developer-guide/ClusterOverview.html)
+ `INACTIVE`: il servizio non è in esecuzione e non è disponibile per l'uso.
**Utilizzo**
```
snowballEdge describe-service --service-id service-id --profile profile-name
```
**Example 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"
}
}
]
}
```
**Example Storage compatibile con Amazon S3 sull'output del servizio Snowball Edge**
Il `describe-service` comando fornisce il seguente output per il *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à di Snowball Edge
Per elencare lo stato delle funzionalità disponibili su Snowball Edge, usa il `describe-features` comando.
`RemoteManagementState`indica lo stato di Snowball Edge Device Management e restituisce uno dei seguenti stati:
+ `INSTALLED_ONLY`— La funzionalità è installata ma non abilitata.
+ `INSTALLED_AUTOSTART`— La funzione è abilitata e il dispositivo tenterà di connettersi ad essa Regione AWS quando viene acceso.
+ `NOT_INSTALLED`— Il dispositivo non supporta la funzionalità o era già presente sul campo prima del lancio.
**Utilizzo**
```
snowballEdge describe-features --profile profile-name
```
**Example uscita del `describe-features` comando**
```
{
"RemoteManagementState" : String
}
```
## Impostazione dei time server per Snowball Edge
È possibile utilizzare i comandi del client Snowball Edge per visualizzare la configurazione NTP (Network Time Protocol) corrente 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 time server NTP sicuro. Per impostare a quali time server NTP si connette il dispositivo, usa il `update-time-servers` comando.
### Controllo delle sorgenti temporali di Snowball Edge
Per vedere a quali sorgenti orarie NTP è attualmente connesso il dispositivo, usa il `describe-time-sources` comando.
```
snowballEdge describe-time-sources --profile profile-name
```
**Example output del comando `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 di origine temporale. Ogni stato dell'origine temporale contiene i `Stratum` campi `Address` `State``Type`,, e. Di seguito sono riportati i significati di questi campi.
+ `Address`— Il nome DNS/indirizzo IP della sorgente temporale.
+ `State`— Lo stato attuale della connessione tra il dispositivo e quella fonte di tempo. 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`— Una fonte di tempo NTP 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 del 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 di tempo NTP 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 Snowball Edge per l'utilizzo di un server o peer NTP per NTP.
```
snowballEdge update-time-servers time-server-address --profile profile-name
```
**Nota**
Il `update-time-servers` comando sostituirà le precedenti impostazioni dei time server NTP.
**Example output del comando `update-time-servers`**
```
Updating time servers now.
```
## Ottenere un codice QR per convalidare i tag NFC di Snowball Edge
Puoi utilizzare questo comando per generare un codice QR specifico del dispositivo da utilizzare con l'app di verifica. AWS Snowball Edge Per ulteriori informazioni sulla convalida NFC, consulta. [Convalida dei tag NFC](data-protection.md#nfc-validation)
**Utilizzo**
```
snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png --profile profile-name
```
**Example Output**
```
QR code is saved to ~/downloads/snowball-qr-code.png
```
## Aggiornamento delle dimensioni MTU
Utilizzate il `update-mtu-size` comando per modificare la dimensione in byte dell'unità di trasmissione massima (MTU) di un'interfaccia fisica di un dispositivo Snowball Edge. Tutte le interfacce di rete virtuali e le interfacce di rete dirette associate a questa interfaccia di rete fisica verranno configurate con le stesse dimensioni MTU.
**Nota**
La dimensione minima dell'MTU è di 1500 byte e la dimensione massima è di 9216 byte.
È possibile utilizzare il `describe-device` comando per recuperare l'interfaccia di rete fisica IDs e le dimensioni MTU correnti di tali interfacce. Per ulteriori informazioni, consulta [Visualizzazione dello stato di uno Snowball Edge](#client-status).
È possibile utilizzare i `describe-virtual-network-interface` comandi `descibe-direct-network-interface` and per recuperare le dimensioni MTU correnti di tali interfacce.
**Utilizzo**
```
snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes --profile profile-name
```
**Example di `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"
}
}
```