Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Konfiguration und Verwendung des Snowball Edge-Clients
Der Snowball Edge-Client ist ein Befehlszeilenschnittstellentool (CLI) AWS , mit dem Sie mit einem Snowball Edge oder einem Snowball Edge-Cluster arbeiten können. Sie können den Client verwenden, um einen Snowball Edge oder einen Gerätecluster zu entsperren, Snowball Edge einzurichten, Dienste auf Geräten zu starten und zu beenden und Daten zu oder von Geräten zu übertragen. Der Snowball Edge-Client ist mit Computern kompatibel, die unter Linux-, MacOS- und Windows-Betriebssystemen ausgeführt werden.
**Topics**
+ [Den Snowball Edge-Client herunterladen und installieren](#download-the-client)
+ [Konfiguration eines Profils für den Snowball Edge-Client](#client-configuration)
+ [Snowball Edge-Clientversion finden](#cli-version)
+ [Anmeldeinformationen für einen Snowball Edge abrufen](#client-credentials)
+ [Einen Dienst auf einem Snowball Edge starten](#edge-start-service)
+ [Beenden eines Dienstes auf einem Snowball Edge](#edge-stop-service)
+ [Protokolle von Snowball Edge anzeigen und herunterladen](#logs)
+ [Status eines Snowball Edge anzeigen](#client-status)
+ [Status von Diensten anzeigen, die auf Snowball Edge ausgeführt werden](#client-service-status)
+ [Status der Funktionen von Snowball Edge anzeigen](#snowball-edge-describe-features)
+ [Zeitserver für Snowball Edge einrichten](#client-set-ntp)
+ [Einen QR-Code zur Validierung von Snowball Edge NFC-Tags erhalten](#client-qr-code)
+ [Die MTU-Größe wird aktualisiert](#update-mtu-size)
## Den Snowball Edge-Client herunterladen und installieren
Sie können den Snowball Edge-Client unter [AWS Snowball Edge Ressourcen](https://aws.amazon.com/snowball/resources/) herunterladen. Auf dieser Seite finden Sie das Installationspaket für Ihr Betriebssystem.
Installieren und konfigurieren Sie den Client gemäß den nachstehenden Anweisungen.
------
#### [ Linux ]
**Anmerkung**
Der Snowball Edge-Client wird nur auf 64-Bit-Linux-Distributionen unterstützt.
1. Extrahieren Sie die `snowball-client-linux.tar.gz`-Datei. Er erstellt die `/snowball-client-linux-build_number/bin` Ordnerstruktur und extrahiert die Dateien dort.
1. Führen Sie die folgenden Befehle aus, um die Ordner zu konfigurieren.
```
chmod u+x snowball-client-linux-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-linux-build_number/jre/bin/java
```
1. Fügen Sie `/snowball-client-linux-build_number/bin` die Umgebungsvariable \$1PATH Ihres Betriebssystems hinzu, um Snowball Edge-Client-Befehle von einem beliebigen Verzeichnis aus auszuführen. Weitere Informationen finden Sie in der Dokumentation zum Betriebssystem Ihres Geräts oder Ihrer Shell.
------
#### [ macOS ]
1. Extrahieren Sie die `snowball-client-mac.tar.gz`-Datei. Es erstellt die `/snowball-client-linux-build_number/bin` Ordnerstruktur und extrahiert die Dateien dort.
1. Führen Sie die folgenden Befehle aus, um die Ordner zu konfigurieren.
```
chmod u+x snowball-client-mac-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-mac-build_number/jre/bin/java
```
1. Fügen Sie `/snowball-client-mac-build_number/bin` die Umgebungsvariable \$1PATH Ihres Betriebssystems hinzu, um Snowball Edge-Client-Befehle von einem beliebigen Verzeichnis aus auszuführen. Weitere Informationen finden Sie in der Dokumentation zum Betriebssystem Ihres Geräts oder Ihrer Shell.
------
#### [ Windows ]
Der Client ist als Microsoft Software Installer (MSI) -Datei gepackt. Öffnen Sie die Datei und folgen Sie den Anweisungen des Installationsassistenten. Wenn der Client installiert wurde, können Sie ihn ohne zusätzliche Vorbereitung von jedem Verzeichnis aus ausführen.
------
## Konfiguration eines Profils für den Snowball Edge-Client
Jedes Mal, wenn Sie einen Befehl für den Snowball Edge-Client ausführen, geben Sie Ihre Manifestdatei, den Entsperrcode und die IP-Adresse von Snowball Edge an. Anstatt diese bei jeder Ausführung eines Befehls anzugeben, können Sie den `configure` Befehl verwenden, um den Pfad zur Manifestdatei, den 29-stelligen Entsperrcode und den Endpunkt (die IP-Adresse von Snowball Edge) als Profil zu speichern. Nach der Konfiguration können Sie Snowball Edge Client-Befehle verwenden, ohne diese Werte für jeden Befehl manuell eingeben zu müssen, indem Sie den Profilnamen in den Befehl aufnehmen. Nachdem Sie den Snowball Edge-Client konfiguriert haben, werden die Informationen in einem Klartext-JSON-Format unter gespeichert. `home directory/.aws/snowball/config/snowball-edge.config` Stellen Sie sicher, dass Ihre Umgebung so konfiguriert ist, dass Sie diese Datei erstellen können.
**Wichtig**
Jeder, der auf die Konfigurationsdatei zugreifen kann, kann auf die Daten auf Ihren Snowball Edge-Geräten oder -Clustern zugreifen. Zu Ihren administrativen Verantwortlichkeiten zählt auch die Verwaltung der lokalen Zugriffssteuerung für diese Datei.
Sie können es auch verwenden AWS OpsHub , um ein Profil zu erstellen. In AWS OpsHub erstellte Profile können mit dem Snowball Edge-Client verwendet AWS OpsHub werden, und die in erstellten Profile können mit dem Snowball Edge-Client verwendet werden. Weitere Informationen finden Sie unter Profile [verwalten](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-device.html#manage-profile).
**So erstellen Sie ein Profil**
1. Geben Sie den Befehl in der Befehlszeilenschnittstelle Ihres Betriebssystems ein. Der Wert des `profile-name` Parameters ist der Name des Profils. Sie werden es in future bereitstellen, wenn Sie Snowball Edge Client-Befehle ausführen.
```
snowballEdge configure --profile profile-name
```
1. Der Snowball Edge-Client fordert Sie zur Eingabe jedes Parameters auf. Wenn Sie dazu aufgefordert werden, geben Sie die Informationen für Ihre Umgebung und Snowball Edge ein.
**Anmerkung**
Der Wert des `endpoint` Parameters ist die IP-Adresse von Snowball Edge mit dem Präfix. `https://` Sie können die IP-Adresse für das Snowball Edge-Gerät auf dem LCD-Bildschirm an der Vorderseite des Geräts finden.
**Example Ausgabe des Befehls `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
```
Der Snowball Edge-Client überprüft, ob der Entsperrcode für die Manifestdatei korrekt ist. Wenn sie nicht übereinstimmen, wird der Befehl beendet und das Profil wird nicht erstellt. Überprüfen Sie den Entsperrcode und die Manifestdatei und führen Sie den Befehl erneut aus.
Um das Profil zu verwenden, fügen Sie es `--profile profile-name` nach der Befehlssyntax ein.
Wenn Sie mehrere eigenständige Snowball Edge verwenden, können Sie für jeden ein Profil erstellen. Um ein anderes Profil zu erstellen, führen Sie den `configure` Befehl erneut aus, geben Sie einen anderen Wert für den `--profile` Parameter und die Informationen für ein anderes Gerät ein.
**Example `snowball-edge.config`-Beispieldatei**
Dieses Beispiel zeigt eine Profildatei mit drei Profilen— `SnowDevice1profile``SnowDevice2profile`, und`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":[]
}
}
```
Um Profile zu bearbeiten oder zu löschen, bearbeiten Sie die Profildatei in einem Texteditor.
**So bearbeiten Sie ein Profil**
1. Öffnen Sie in einem Texteditor `snowball-edge.config` von`home directory\.aws\snowball\config`.
**Anmerkung**
Stellen Sie sicher, dass Ihre Umgebung so konfiguriert ist, dass Sie auf diese Datei zugreifen und sie lesen und schreiben können.
1. Bearbeiten Sie die Datei nach Bedarf. Um beispielsweise die IP-Adresse des Snowball Edge zu ändern, der dem Profil zugeordnet ist, ändern Sie den `defaultEndpoint` Eintrag.
1. Speichern und schließen Sie die Datei.
**So löschen Sie ein Profil**
1. Öffnen Sie mit einem Texteditor `snowball-edge.config` von`home directory\.aws\snowball\config`.
**Anmerkung**
Stellen Sie sicher, dass Ihre Umgebung so konfiguriert ist, dass Sie auf diese Datei zugreifen und sie lesen und schreiben können.
1. Löschen Sie die Zeile, die den Profilnamen, die geschweiften Klammern `{``}`, die auf den Profilnamen folgen, und den Inhalt innerhalb dieser Klammern enthält.
1. Speichern und schließen Sie die Datei.
## Snowball Edge-Clientversion finden
Verwenden Sie den `version` Befehl, um die Version des Snowball Edge-Clients für die Befehlszeilenschnittstelle (CLI) anzuzeigen.
**Usage**
```
snowballEdge version
```
**Beispielausgabe**
```
Snowball Edge client version: 1.2.0 Build 661
```
## Anmeldeinformationen für einen Snowball Edge abrufen
Mit den `snowballEdge get-secret-access-key` Befehlen `snowballEdge list-access-keys` und können Sie die Anmeldeinformationen des Admin-Benutzers AWS-Konto auf Ihrem Snowball Edge abrufen. Sie können diese Anmeldeinformationen verwenden, um AWS Identity and Access Management (IAM-Benutzer) und Rollen zu erstellen und Ihre Anfragen zu authentifizieren, wenn Sie das AWS CLI oder mit einem SDK verwenden. AWS Diese Anmeldeinformationen sind nur mit einem einzelnen Auftrag für Snowball Edge verknüpft, und Sie können sie nur auf dem Gerät oder Gerätecluster verwenden. Das Gerät oder die Geräte haben keine IAM-Berechtigungen in der. AWS Cloud
**Anmerkung**
Wenn Sie den AWS CLI mit Snowball Edge verwenden, müssen Sie diese Anmeldeinformationen bei der Konfiguration der CLI verwenden. Informationen zur Konfiguration der AWS CLI Anmeldeinformationen für finden Sie unter [Konfiguration von AWS CLI im AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration) *Benutzerhandbuch*.
**Verwendung (konfigurierter Snowball Edge-Client)**
```
snowballEdge list-access-keys
```
**Example Output**
```
{
"AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}
```
**Verwendung (konfigurierter Snowball Edge-Client)**
```
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
```
## Einen Dienst auf einem Snowball Edge starten
Snowball Edge-Geräte unterstützen mehrere Dienste. Dazu gehören Recheninstanzen, die NFS-Schnittstelle (Network File System), Snowball Edge Device Management und. AWS IoT Greengrass Der Amazon S3 S3-Adapterservice EC2 AWS STS, Amazon und IAM werden standardmäßig gestartet und können nicht gestoppt oder neu gestartet werden. Die NFS-Schnittstelle, Snowball Edge Device Management, AWS IoT Greengrass kann jedoch mithilfe ihrer Dienst-ID mit dem `start-service` Befehl gestartet werden. Um die Service-ID für den jeweiligen Service zu erhalten, können Sie den Befehl `list-services` verwenden.
Bevor Sie diesen Befehl ausführen, erstellen Sie eine einzige virtuelle Netzwerkschnittstelle, die Sie an den Service bindet, den Sie gerade starten. Weitere Informationen finden Sie unter [Erstellen einer virtuellen Netzwerkschnittstelle auf einem 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 Ausgabe des Befehls `start-service`**
```
Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.
```
## Beenden eines Dienstes auf einem Snowball Edge
Um einen Dienst zu beenden, der auf einem Snowball Edge ausgeführt wird, können Sie den `stop-service` Befehl verwenden.
Der Amazon S3 S3-Adapter EC2 AWS STS, Amazon und die IAM-Dienste können nicht gestoppt werden.
**Warnung**
Datenverlust kann auftreten, wenn der Network File System (NFS) -Service gestoppt wird, bevor die verbleibenden gepufferten Daten auf das Gerät geschrieben werden. Weitere Informationen zur Verwendung des NFS-Dienstes finden Sie unter. [Verwaltung der NFS-Schnittstelle auf Snowball Edge](shared-using-nfs.md)
**Anmerkung**
Wenn Sie den Amazon S3 S3-kompatiblen Speicher auf dem Snowball Edge-Service beenden, wird der Zugriff auf die in Ihren S3-Buckets auf dem Gerät oder Cluster gespeicherten Daten deaktiviert. Der Zugriff wird wiederhergestellt, wenn der Amazon S3 S3-kompatible Speicher auf Snowball Edge erneut gestartet wird. Für Geräte, die mit Amazon S3 S3-kompatiblem Speicher auf Snowball Edge aktiviert sind, wird empfohlen, den Service nach dem Einschalten des Snowball Edge-Geräts zu starten. Weitere Informationen finden Sie in diesem Handbuch unter [Einrichtung von Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/s3compatible-on-snow.html#setting-up-s3-on-snow-cluster).
```
snowballEdge stop-service --service-id service_id --profile profile-name
```
**Example Ausgabe des Befehls `stop-service`**
```
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.
```
## Protokolle von Snowball Edge anzeigen und herunterladen
Wenn Sie Daten zwischen Ihrem lokalen Rechenzentrum und einem Snowball Edge übertragen, werden automatisch Protokolle generiert. Sollten während der Datenübertragung auf das Gerät unerwartete Fehler auftreten, können Sie mit den folgenden Befehlen eine Kopie der Protokolle auf Ihrem lokalen Server speichern.
Im Zusammenhang mit Protokollen gibt es drei verschiedene Befehle:
+ `list-logs`— Gibt eine Liste von Protokollen im JSON-Format zurück. In dieser Liste sind die Größe der Protokolle in Byte, die ARNs und die Service-ID für die Protokolle sowie die Art der Protokolle enthalten.
**Usage**
```
snowballEdge list-logs --profile profile-name
```
**Example Ausgabe des `list-logs` Befehls**
```
{
"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`— Lädt eine Kopie eines bestimmten Protokolls von Snowball Edge unter einem angegebenen Pfad auf Ihr Gerät herunter. `CUSTOMER`Protokolle werden in diesem `.zip` Format gespeichert, und Sie können diesen Protokolltyp extrahieren, um seinen Inhalt anzuzeigen. `SUPPORT`Protokolle sind verschlüsselt und können nur von gelesen werden AWS Support. Sie haben die Möglichkeit, einen Namen und einen Pfad für das Protokoll anzugeben.
**Usage**
```
snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709 --profile profile-name
```
**Example Ausgabe des `get-log` Befehls**
```
Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin
```
+ `get-support-logs`— Lädt eine Kopie aller `SUPPORT` Protokolltypen von Snowball Edge unter einem angegebenen Pfad auf Ihren Service herunter.
**Usage**
```
snowballEdge get-support-logs --profile profile-name
```
**Example Ausgabe des Befehls `get-support-logs`**
```
Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
```
**Wichtig**
`CUSTOMER`-Protokolle enthalten möglicherweise vertrauliche Informationen über Ihre Daten. Um solche potenziell sensiblen Daten zu schützen, empfehlen wir dringend, diese Protokolle zu löschen, sobald Sie sie nicht mehr verwenden.
## Status eines Snowball Edge anzeigen
Mit dem `describe-device` Befehl können Sie den Status und den allgemeinen Zustand von Snowball Edge ermitteln.
```
snowballEdge describe-device --profile profile-name
```
**Example Ausgabe des Befehls `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"
}
]
}
```
## Status von Diensten anzeigen, die auf Snowball Edge ausgeführt werden
Mit dem `describe-service` Befehl können Sie den Status und den allgemeinen Zustand der Dienste ermitteln, die auf Snowball Edge-Geräten ausgeführt werden. Sie können zunächst den `list-services`-Befehl ausführen, um zu sehen, welche Services ausgeführt werden.
+ `list-services`
**Usage**
```
snowballEdge list-services --profile profile-name
```
**Example Ausgabe des Befehls `list-services`**
```
{
"ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}
```
+ `describe-service`
Dieser Befehl gibt einen Statuswert für einen Service zurück. Er enthält außerdem Statusinformationen, die Ihnen bei der Lösung von Problemen mit dem Service behilflich sein können. Diese Statuswerte lauten wie folgt.
+ `ACTIVE` – Der Service wird ausgeführt und steht zur Verfügung.
+ `ACTIVATING` – Der Service wird gestartet, steht aber noch nicht zur Verfügung.
+ `DEACTIVATING` – Der Service wird gerade heruntergefahren.
+ `DEGRADED`— Für Amazon S3 S3-kompatiblen Speicher auf Snowball Edge bedeutet dieser Status, dass eine oder mehrere Festplatten oder Geräte im Cluster ausgefallen sind. Der Amazon S3 S3-kompatible Speicher auf dem Snowball Edge-Service läuft ununterbrochen, aber Sie sollten das betroffene Gerät wiederherstellen oder austauschen, bevor das Cluster-Quorum verloren geht, um das Risiko eines Datenverlusts zu minimieren. Weitere Informationen finden Sie in [diesem Handbuch im Überblick über Clustering](https://docs.aws.amazon.com/snowball/latest/developer-guide/ClusterOverview.html).
+ `INACTIVE` – Der Service wird nicht ausgeführt und steht nicht zur Verfügung.
**Usage**
```
snowballEdge describe-service --service-id service-id --profile profile-name
```
**Example Ausgabe des Befehls `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 Amazon S3 S3-kompatibler Speicher auf der Snowball Edge-Serviceausgabe**
Der `describe-service` Befehl liefert die folgende Ausgabe für den *s3-snow* Wert des `service-id` Parameters.
```
{
"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"
}
} ]
}
```
## Status der Funktionen von Snowball Edge anzeigen
Verwenden Sie den `describe-features` Befehl, um den Status der auf einem Snowball Edge verfügbaren Funktionen aufzulisten.
`RemoteManagementState`zeigt den Status von Snowball Edge Device Management an und gibt einen der folgenden Zustände zurück:
+ `INSTALLED_ONLY`— Die Funktion ist installiert, aber nicht aktiviert.
+ `INSTALLED_AUTOSTART`— Die Funktion ist aktiviert und das Gerät versucht, eine Verbindung zu ihr herzustellen AWS-Region , wenn es eingeschaltet ist.
+ `NOT_INSTALLED`— Das Gerät unterstützt die Funktion nicht oder war vor der Markteinführung bereits im Einsatz.
**Usage**
```
snowballEdge describe-features --profile profile-name
```
**Example Ausgabe des `describe-features` Befehls**
```
{
"RemoteManagementState" : String
}
```
## Zeitserver für Snowball Edge einrichten
Sie können Snowball Edge-Client-Befehle verwenden, um die aktuelle NTP-Konfiguration (Network Time Protocol) anzuzeigen und einen Server oder Peer für die Bereitstellung von Zeit auszuwählen. Sie können die Snowball Edge Client-Befehle verwenden, wenn sich das Gerät sowohl im gesperrten als auch im entsperrten Zustand befindet.
Es liegt in Ihrer Verantwortung, einen sicheren NTP-Zeitserver bereitzustellen. Verwenden Sie den Befehl, um festzulegen, mit welchen NTP-Zeitservern das Gerät eine Verbindung herstellt. `update-time-servers`
### Überprüfen der Zeitquellen von Snowball Edge
Verwenden Sie den `describe-time-sources` Befehl, um zu sehen, mit welchen NTP-Zeitquellen das Gerät derzeit verbunden ist.
```
snowballEdge describe-time-sources --profile profile-name
```
**Example Ausgabe des Befehls `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
} ]
}
```
Der `describe-time-sources` Befehl gibt eine Liste von Zeitquellenzuständen zurück. Jeder Zeitquellenstatus enthält die `Stratum` Felder `Address` `State``Type`,, und. Im Folgenden sind die Bedeutungen dieser Felder aufgeführt.
+ `Address`— Der DNS-Name/die IP-Adresse der Zeitquelle.
+ `State`— Der aktuelle Verbindungsstatus zwischen dem Gerät und dieser Zeitquelle. Es gibt fünf mögliche Zustände:.
+ `CURRENT`— Die Zeitquelle wird derzeit verwendet, um die Zeit zu synchronisieren.
+ `COMBINED`— Die Zeitquelle wird mit der aktuellen Quelle kombiniert.
+ `EXCLUDED`— Die Zeitquelle wird durch den Kombinationsalgorithmus ausgeschlossen.
+ `LOST`— Die Verbindung mit der Zeitquelle wurde unterbrochen.
+ `UNACCEPTABLE`— Eine ungültige Zeitquelle, bei der der Kombinationsalgorithmus entweder als Falseticker oder als zu stark variabel eingestuft wurde.
+ `Type`— Eine NTP-Zeitquelle kann entweder ein Server oder ein Peer sein. Server können mit dem `update-time-servers` Befehl festgelegt werden. Peers können nur andere Snowball Edge Edge-Geräte im Cluster sein und werden automatisch eingerichtet, wenn der Cluster verknüpft wird.
+ `Stratum`— Dieses Feld zeigt die Schicht der Quelle. Stratum 1 weist auf eine Quelle mit einer lokal angeschlossenen Referenzuhr hin. Eine Quelle, die mit einer Stratum-1-Quelle synchronisiert ist, befindet sich in Stratum 2. Eine Quelle, die mit einer Stratum-2-Quelle synchronisiert ist, befindet sich in Stratum 3 usw.
Eine NTP-Zeitquelle kann entweder ein Server oder ein Peer sein. Ein Server kann vom Benutzer mit dem `update-time-servers` Befehl eingerichtet werden, wohingegen ein Peer nur andere Snowball Edge Edge-Geräte im Cluster sein kann. In der Beispielausgabe `describe-time-sources` wird auf einem Snowball Edge Edge aufgerufen, der sich in einem Cluster von 5 befindet. Die Ausgabe enthält 4 Peers und 1 Server. Die Peers haben eine Schicht von 10, während der Server eine Schicht von 1 hat. Daher wird der Server als aktuelle Zeitquelle ausgewählt.
### Zeitserver werden aktualisiert
Verwenden Sie den `update-time-servers` Befehl und die Adresse des Zeitservers, um Snowball Edge für die Verwendung eines NTP-Servers oder -Peers für NTP zu konfigurieren.
```
snowballEdge update-time-servers time-server-address --profile profile-name
```
**Anmerkung**
Der `update-time-servers` Befehl überschreibt die vorherigen NTP-Zeitserver-Einstellungen.
**Example Ausgabe des Befehls `update-time-servers`**
```
Updating time servers now.
```
## Einen QR-Code zur Validierung von Snowball Edge NFC-Tags erhalten
Mit diesem Befehl können Sie einen gerätespezifischen QR-Code für die Verwendung mit der AWS Snowball Edge Verifizierungs-App generieren. Weitere Informationen zur NFC-Validierung finden Sie unter. [Validieren von NFC-Tags](data-protection.md#nfc-validation)
**Usage**
```
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
```
## Die MTU-Größe wird aktualisiert
Verwenden Sie den `update-mtu-size` Befehl, um die Größe der MTU (Maximum Transmission Unit) einer physikalischen Schnittstelle eines Snowball Edge-Geräts in Byte zu ändern. Alle virtuellen Netzwerkschnittstellen und direkten Netzwerkschnittstellen, die dieser physischen Netzwerkschnittstelle zugeordnet sind, werden mit derselben MTU-Größe konfiguriert.
**Anmerkung**
Die minimale MTU-Größe beträgt 1500 Byte und die maximale Größe beträgt 9216 Byte.
Sie können den `describe-device` Befehl verwenden, um die physische Netzwerkschnittstelle IDs und die aktuellen MTU-Größen dieser Schnittstellen abzurufen. Weitere Informationen finden Sie unter [Status eines Snowball Edge anzeigen](#client-status).
Sie können die `describe-virtual-network-interface` Befehle `descibe-direct-network-interface` und verwenden, um die aktuellen MTU-Größen dieser Schnittstellen abzurufen.
**Usage**
```
snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes --profile profile-name
```
**Example der Ausgabe `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"
}
}
```