Configuration et utilisation du client Snowball Edge - AWS Snowball Edge Guide du développeur
Téléchargement et installation du client Snowball EdgeConfiguration d'un profil pour le client Snowball EdgeTrouver la version du client Snowball EdgeObtention des informations d'identificationDémarrage d'un service sur un appareil Snow FamilyArrêt d'un service sur un appareil Snow FamilyAffichage et téléchargement des journauxAffichage de l'état de l'appareilAffichage de l'état des servicesAffichage de l'état des fonctionnalitésConfiguration des serveurs temporelsValidation des balises NFCMettre à jour MTU la taille

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration et utilisation du client Snowball Edge

Le client Snowball Edge est un outil d'interface de ligne de commande (CLI) AWS que vous pouvez utiliser pour travailler avec un appareil Snow Family ou un cluster d'appareils Snow Family. Vous pouvez utiliser le client pour déverrouiller un appareil Snow Family ou un groupe d'appareils, configurer des appareils Snow Family, démarrer et arrêter des services sur des appareils et transférer des données vers ou depuis des appareils. Le client Snowball Edge est compatible avec les ordinateurs fonctionnant sous les systèmes d'exploitation Linux, macOS et Windows.

Téléchargement et installation du client Snowball Edge

Vous pouvez télécharger et installer le client Snowball Edge depuis AWS Snowball Edge Resources. Sur cette page, vous trouverez le package d'installation correspondant à votre système d'exploitation.

L'exécution du client Snowball Edge sur votre appareil peut vous obliger à configurer les variables d'environnement du système d'exploitation de votre appareil :

  • Microsoft Windows — Le client est empaqueté sous forme de fichier Microsoft Software Installer (MSI). Ouvrez le fichier et suivez les instructions de l'assistant d'installation. Une fois le client installé, vous pouvez l'exécuter depuis n'importe quel répertoire sans préparation supplémentaire.

  • Linux — Le client Snowball Edge n'est pris en charge que sur les distributions Linux 64 bits. Lorsque vous extrayez le snowball-client-linux.tar.gz fichier, il crée la structure du /snowball-client-linux-build_number/bin dossier et extrait les fichiers qui s'y trouvent. Le client Snowball Edge doit être exécuté depuis le ~/snowball-client-linux-build_number/bin/ répertoire. Ajoutez ce chemin à la variable d'PATHenvironnement $ de votre système d'exploitation pour exécuter les commandes du client Snowball Edge depuis n'importe quel répertoire. Pour plus d'informations, consultez la documentation du système d'exploitation de votre appareil ou de votre shell.

  • macOS — Lorsque vous extrayez le snowball-client-mac.tar.gz fichier, la structure du /snowball-client-linux-build_number/bin dossier est créée et les fichiers y sont extraits. Le client Snowball Edge doit être exécuté depuis le ~/snowball-client-linux-build_number/bin/ répertoire. Ajoutez ce chemin à la variable d'PATHenvironnement $ de votre système d'exploitation pour exécuter les commandes du client Snowball Edge depuis n'importe quel répertoire. Pour plus d'informations, consultez la documentation du système d'exploitation de votre appareil ou de votre shell.

Configuration d'un profil pour le client Snowball Edge

Chaque fois que vous exécutez une commande pour le client Snowball Edge, vous fournissez votre fichier manifeste, le code de déverrouillage et l'adresse IP de l'appareil Snow Family. Au lieu de les fournir chaque fois que vous exécutez une commande, vous pouvez utiliser la configure commande pour stocker le chemin du fichier manifeste, le code de déverrouillage à 29 caractères et le point de terminaison (l'adresse IP de l'appareil Snow Family) sous forme de profil. Après la configuration, vous pouvez utiliser les commandes du client Snowball Edge sans avoir à saisir manuellement ces valeurs pour chaque commande en incluant le nom du profil dans la commande. Après avoir configuré le client Snowball Edge, les informations sont enregistrées au format texte brut JSON dans. home directory/.aws/snowball/config/snowball-edge.config Assurez-vous que votre environnement est configuré pour vous permettre de créer ce fichier.

Important

Toute personne ayant accès au fichier de configuration peut accéder aux données de vos appareils ou clusters Snowball Edge. Dans la cadre de vos responsabilités administratives, vous devez gérer le contrôle d'accès local pour ce fichier.

Vous pouvez également l'utiliser AWS OpsHub pour créer un profil. AWS OpsHub Les profils créés dans peuvent être utilisés avec le client Snowball Edge et les profils créés dans peuvent AWS OpsHub être utilisés avec le client Snowball Edge. Pour plus d'informations, consultez la section Gestion des profils.

Pour créer un profil

  1. Entrez la commande dans l'interface de ligne de commande de votre système d'exploitation. La valeur du profile-name paramètre est le nom du profil. Vous le fournirez à l'avenir lors de l'exécution des commandes du client Snowball Edge.

    
snowballEdge configure --profile profile-name

  2. Le client Snowball Edge vous demandera de saisir chaque paramètre. Lorsque vous y êtes invité, entrez les informations relatives à votre environnement et à l'appareil Snow Family.

    Note

    La valeur du endpoint paramètre est l'adresse IP de l'appareil de la famille Snow, préfacée parhttps://. Vous pouvez trouver l'adresse IP de l'appareil Snowball Edge sur l'LCDécran situé à l'avant de l'appareil.

    Exemple sortie de configure commande
    
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

    Le client Snowball Edge vérifiera que le code de déverrouillage est correct pour le fichier manifeste. S'ils ne correspondent pas, la commande s'arrête et ne crée pas le profil. Vérifiez le code de déverrouillage et le fichier manifeste, puis réexécutez la commande.

Pour utiliser le profil, incluez-le --profile profile-name avant la syntaxe de la commande.

Si vous utilisez plusieurs appareils Snow Family autonomes, vous pouvez créer un profil pour chacun d'eux. Pour créer un autre profil, réexécutez la configure commande, entrez une valeur différente pour le --profile paramètre et fournissez les informations pour un autre appareil.

Exemple de fichier snowball-edge.config

Cet exemple montre un fichier de profil contenant trois profils : SnowDevice1profileSnowDevice2profile, etSnowDevice3profile.


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

Pour modifier ou supprimer des profils, modifiez le fichier de profil dans un éditeur de texte.

Pour modifier un profil

  1. Dans un éditeur de texte, ouvrez snowball-edge.config depuishome directory\.aws\snowball\config.

    Note

    Assurez-vous que votre environnement est configuré pour vous permettre d'accéder à ce fichier en lecture et en écriture.

  2. Modifiez le fichier si nécessaire. Par exemple, pour modifier l'adresse IP de l'appareil Snow Family associé au profil, modifiez l'defaultEndpointentrée.

  3. Enregistrez et fermez le fichier .

Pour supprimer un profil

  1. À l'aide d'un éditeur de texte, ouvrez snowball-edge.config depuishome directory\.aws\snowball\config.

    Note

    Assurez-vous que votre environnement est configuré pour vous permettre d'accéder à ce fichier en lecture et en écriture.

  2. Supprimez la ligne qui contient le nom du profil, les crochets { } qui suivent le nom du profil et le contenu entre ces crochets.

  3. Enregistrez et fermez le fichier .

Trouver la version du client Snowball Edge

Utilisez la version commande pour voir la version du client d'interface de ligne de commande Snowball Edge (CLI).

Utilisation


    snowballEdge version

Exemple de sortie


    Snowball Edge client version: 1.2.0  Build 661

Obtenir les informations d'identification d'un appareil Snow Family

À l'aide snowballEdge list-access-keys des snowballEdge get-secret-access-key commandes et, vous pouvez obtenir les informations d'identification de l'utilisateur administrateur de votre Compte AWS Snowball Edge. Vous pouvez utiliser ces informations d'identification pour créer AWS Identity and Access Management (des IAM utilisateurs) et des rôles, et pour authentifier vos demandes lorsque vous utilisez le AWS CLI ou avec un AWS SDK. Ces informations d'identification ne sont associées qu'à une tâche individuelle pour Snowball Edge, et vous ne pouvez les utiliser que sur l'appareil ou le cluster d'appareils. Le ou les appareils ne disposent d'aucune IAM autorisation dans le AWS Cloud.

Note

Si vous utilisez le AWS CLI avec le Snowball Edge, vous devez utiliser ces informations d'identification lorsque vous configurez le. CLI Pour plus d'informations sur la configuration des informations d'identification pour le AWS CLI, voir Configuration du AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

Utilisation (client Snowball Edge configuré)

snowballEdge list-access-keys
Exemple Sortie
{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Utilisation (client Snowball Edge configuré)

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

Démarrage d'un service sur un appareil Snow Family

Les appareils Snowball Edge prennent en charge plusieurs services. Il s'agit notamment des instances de calcul, de l'interface Network File System (NFS), de la gestion des périphériques Snow et AWS IoT Greengrass. Le service d'adaptateur Amazon S3, Amazon EC2 AWS STS, est démarré par défaut et ne peut être ni arrêté ni redémarré. IAM Cependant, l'NFSinterface, Snow Device Management, AWS IoT Greengrass peut être démarrée en utilisant son identifiant de service avec la start-service commande. Pour obtenir l'ID de service pour chaque service, vous pouvez utiliser la commande list-services.

Avant d'exécuter cette commande, créez une interface réseau virtuelle unique à associer au service que vous démarrez. Pour plus d’informations, consultez Création d'une interface réseau virtuelle sur un appareil de la famille Snow.


snowballEdge start-service --profile profile-name --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn
Exemple sortie de start-service commande
Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Arrêt d'un service sur un appareil Snow Family

Pour arrêter un service en cours d'exécution sur un appareil de la famille Snow, vous pouvez utiliser la stop-service commande.

L'adaptateur Amazon S3 EC2 AWS STS, Amazon et les IAM services ne peuvent pas être arrêtés.

Avertissement

Une perte de données peut se produire si le service Network File System (NFS) est arrêté avant que les données restantes mises en mémoire tampon ne soient écrites sur le périphérique. Pour plus d'informations sur l'utilisation du NFS service, consultezGestion de l'NFSinterface sur les appareils Snow Family.

Note

L'arrêt du service de stockage compatible Amazon S3 sur les appareils de la famille Snow désactive l'accès aux données stockées dans vos compartiments S3 sur l'appareil ou le cluster. L'accès est rétabli lorsque le stockage compatible Amazon S3 sur les appareils Snow Family est redémarré. Pour les appareils dotés d'un stockage compatible Amazon S3 sur les appareils Snow Family, il est recommandé de démarrer le service une fois l'appareil Snowball Edge allumé. Consultez la section Configuration de Snowball Edge dans ce guide. 


snowballEdge stop-service --profile profile-name --service-id service_id
Exemple sortie de stop-service commande
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Affichage et téléchargement des journaux depuis les appareils Snow Family

Lorsque vous transférez des données entre votre centre de données sur site et un appareil Snow Family, des journaux sont automatiquement générés. Si vous rencontrez des erreurs inattendues lors du transfert de données vers l'appareil, vous pouvez utiliser les commandes suivantes pour enregistrer une copie de vos journaux sur votre serveur local.

Il existe trois commandes associées aux journaux :

  • list-logs— Renvoie une liste de journaux au JSON format. Cette liste indique la taille des journaux en octets, le ARN nom des journaux, l'ID de service des journaux et le type de journaux.

    Utilisation

    snowballEdge list-logs --profile profile-name
    Exemple sortie de la list-logs commande
    {
  "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— Télécharge une copie d'un journal spécifique depuis le Snowball Edge sur votre appareil en suivant un chemin spécifié. CUSTOMERles journaux sont enregistrés au .zip format, et vous pouvez extraire ce type de journal pour en afficher le contenu. SUPPORTles journaux sont cryptés et ne peuvent être lus que par AWS Support. Vous pouvez spécifier un nom et un chemin pour le journal.

    Utilisation

    snowballEdge get-log --profile profile-name --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709
    Exemple sortie de get-log commande
    Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin

  • get-support-logs— Télécharge une copie de tous les SUPPORT types de journaux du Snowball Edge vers votre service selon un chemin spécifié.

    Utilisation

    snowballEdge get-support-logs --profile profile-name
    Exemple sortie de get-support-logs commande
    Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
Important

Le type CUSTOMER peut contenir des informations sensibles sur vos propres données. Pour protéger ces informations potentiellement sensibles, nous vous recommandons fortement de supprimer ces journaux une fois que vous avez terminé.

Affichage de l'état d'un appareil Snow Family

Vous pouvez déterminer l'état et l'état général des appareils de la gamme Snow à l'aide de describe-device cette commande.

snowballEdge describe-device --profile profile-name
Exemple sortie de describe-device commande

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

Affichage de l'état des services exécutés sur les appareils Snow Family

Vous pouvez déterminer l'état et l'état général des services exécutés sur les appareils Snowball Edge à l'aide de la describe-service commande. Vous pouvez commencer par exécuter la commande list-services pour voir quels services sont en cours d'exécution.

  • list-services

    Utilisation

    snowballEdge list-services --profile profile-name
    Exemple sortie de list-services commande
    {
  "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}

  • describe-service

    Cette commande renvoie une valeur de statut pour un service. Elle inclut également des informations d'état, qui peuvent être utiles pour résoudre les problèmes liés au service. Ces états sont les suivants.

    • ACTIVE – Le service s'exécute et peut être utilisé.

    • ACTIVATING – Le service est en cours de démarrage, mais il ne peut pas encore être utilisé.

    • DEACTIVATING – Le service est en cours d'arrêt.

    • DEGRADED— Pour le stockage compatible Amazon S3 sur les appareils de la famille Snow, cet état indique qu'un ou plusieurs disques ou appareils du cluster sont hors service. Le service de stockage compatible Amazon S3 sur les appareils de la famille Snow fonctionne sans interruption, mais vous devez récupérer ou remplacer l'appareil concerné avant que le quorum du cluster ne soit perdu afin de minimiser le risque de perte de données. Consultez la section Présentation du clustering dans ce guide.

    • INACTIVE – Le service ne s'exécute pas et ne peut pas être utilisé.

    Utilisation

    snowballEdge describe-service --profile profile-name --service-id service-id
    Exemple sortie de describe-service commande
    
{
  "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"
      }
    }
  ]
}
    Exemple Sortie du service de stockage compatible avec Amazon S3 sur les appareils de la famille Snow

    La describe-service commande fournit le résultat suivant pour s3-snow valeur du service-id paramètre.

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

Affichage de l'état des fonctionnalités des appareils Snow Family

Pour répertorier l'état des fonctionnalités disponibles sur un appareil de la gamme Snow, utilisez la describe-features commande.

RemoteManagementStateindique l'état de Snow Device Management et renvoie l'un des états suivants :

  • INSTALLED_ONLY— La fonctionnalité est installée mais n'est pas activée.

  • INSTALLED_AUTOSTART— La fonctionnalité est activée et l'appareil tente de s'y connecter Région AWS lorsqu'il est allumé.

  • NOT_INSTALLED— L'appareil ne prend pas en charge cette fonctionnalité ou était déjà sur le terrain avant son lancement.

Utilisation


snowballEdge describe-features --profile profile-name
Exemple sortie de describe-features commande

{
  "RemoteManagementState" : String
}

Configuration de serveurs temporels pour les appareils Snow Family

Vous pouvez utiliser les commandes du client Snowball Edge pour afficher la configuration actuelle du Network Time Protocol (NTP) et choisir un serveur ou un homologue pour indiquer l'heure. Vous pouvez utiliser les commandes du client Snowball Edge lorsque l'appareil est à la fois verrouillé et déverrouillé.

Il est de votre responsabilité de fournir un serveur de NTP temps sécurisé. Pour définir les serveurs NTP horaires auxquels l'appareil se connecte, utilisez la update-time-servers commande.

Vérification des sources horaires des appareils Snow Family

Pour voir à quelles sources NTP temporelles l'appareil est actuellement connecté, utilisez la describe-time-sources commande.

snowballEdge describe-time-sources --profile profile-name
Exemple sortie de describe-time-sources commande
{
  "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
  } ]
}

La describe-time-sources commande renvoie une liste des états des sources temporelles. Chaque fois que l'état de la source contient les Stratum champs Address StateType,, et. Voici la signification de ces champs.

  • Address— Le DNS nom/adresse IP de la source de temps.

  • State— L'état actuel de la connexion entre l'appareil et cette source de temps. Il y a cinq états possibles :.

    • CURRENT— La source de temps est actuellement utilisée pour synchroniser l'heure.

    • COMBINED— La source temporelle est combinée à la source actuelle.

    • EXCLUDED— La source de temps est exclue par l'algorithme de combinaison.

    • LOST— La connexion avec la source horaire a été perdue.

    • UNACCEPTABLE— Une source de temps non valide pour laquelle l'algorithme de combinaison a été considéré comme faux ou comme présentant une trop grande variabilité.

  • Type— Une source de NTP temps peut être un serveur ou un pair. Les serveurs peuvent être définis par la update-time-servers commande. Les homologues ne peuvent être que d'autres appareils Snowball Edge du cluster et sont automatiquement configurés lorsque le cluster est associé.

  • Stratum— Ce champ indique la strate de la source. La strate 1 indique une source avec une horloge de référence attachée localement. Une source synchronisée avec une source de strate 1 se trouve dans la strate 2. Une source synchronisée avec une source de strate 2 se trouve dans la strate 3, et ainsi de suite.

Une source de NTP temps peut être un serveur ou un pair. Un serveur peut être défini par l'utilisateur à l'aide de la update-time-servers commande, alors qu'un homologue ne peut être que les autres appareils Snowball Edge du cluster. Dans l'exemple de sortie, describe-time-sources est appelé sur un Snowball Edge appartenant à un cluster de 5. La sortie contient 4 pairs et 1 serveur. Les pairs ont une strate de 10 tandis que le serveur a une strate de 1 ; par conséquent, le serveur est sélectionné pour être la source de temps actuelle.

Mise à jour des serveurs temporels

Utilisez la update-time-servers commande et l'adresse du serveur de temps pour configurer l'appareil de la famille Snow afin qu'il utilise un NTP serveur ou un homologue pourNTP.

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

La update-time-servers commande remplacera les paramètres précédents des serveurs NTP temporels.

Exemple sortie de update-time-servers commande
Updating time servers now.

Obtenir un code QR pour valider les tags Snowball Edge NFC

Vous pouvez utiliser cette commande pour générer code QR spécifique à un appareil avec l'application de vérification AWS Snowball Edge. Pour plus d'informations sur NFC la validation, consultezValidation des balises NFC.

Utilisation

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

Mettre à jour MTU la taille

Utilisez la update-mtu-size commande pour modifier la taille en octets de l'unité de transmission maximale (MTU) d'une interface physique d'un appareil de la famille Snow. Toutes les interfaces réseau virtuelles et les interfaces réseau directes associées à cette interface réseau physique seront configurées avec la même MTU taille.

Note

La MTU taille minimale est de 1 500 octets et la taille maximale est de 9 216 octets.

Vous pouvez utiliser la describe-device commande pour récupérer l'interface réseau physique IDs et les MTU tailles actuelles de ces interfaces. Pour plus d’informations, consultez Affichage de l'état d'un appareil Snow Family.

Vous pouvez utiliser les describe-virtual-network-interface commandes descibe-direct-network-interface et pour récupérer les MTU tailles actuelles de ces interfaces.

Utilisation

snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes
Exemple de update-mtu-size sortie

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