Comandos para el cliente de Snowball Edge - Guía para desarrolladores de AWS Snowball Edge

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Comandos para el cliente de Snowball Edge

A continuación, encontrará información sobre los comandos del cliente de Snowball Edge, incluidos ejemplos de uso y resultados de ejemplo.

Configuración de un perfil para el cliente de Snowball Edge

Cada vez que ejecutas un comando para el cliente de Snowball Edge, proporcionas el archivo de manifiesto, el código de desbloqueo y una dirección IP. Puede obtener los dos primeros de estos en laConsola de administración de la familia de productos Snow de AWSo la API de administración de trabajos. Para obtener más información sobre cómo obtener el manifiesto y el código de desbloqueo, consulte Obtención de credenciales.

Si lo desea, puede utilizar el comando snowballEdge configure para almacenar la ruta al manifiesto, el código de desbloqueo de 29 caracteres y el punto de enlace como un perfil. Tras la configuración, puede usar otros comandos de cliente de Snowball Edge sin tener que introducir manualmente estos valores para un trabajo en particular. Después de configurar el cliente de Snowball Edge, la información se guarda en un formato JSON de texto sin formato parahome directory/.aws/snowball/config/snowball-edge.config.

El punto de enlace es la dirección IP, a la que se añade https://. Puede localizar la dirección IP delAWS Snowball Edgedispositivo en laAWS Snowball Edgepantalla LCD del dispositivo. Cuando elAWS Snowball Edgese conecta a la red por primera vez, obtiene automáticamente una dirección IP DHCP, si hay un servidor DHCP disponible. Si desea utilizar otra dirección IP, puede cambiarla en la pantalla LCD. Para obtener más información, consulte Usar un dispositivo AWS Snowball Edge.

importante

Cualquier persona que pueda acceder al archivo de configuración puede acceder a los datos de tus dispositivos o clústeres Snowball Edge. La administración del control de acceso local para este archivo es una de sus responsabilidades administrativas.

Uso

Puede utilizar este comando de dos formas: insertado o cuando se le solicite. Este ejemplo de uso muestra el método cuando se le solicite.

snowballEdge configure

ejemplo Output

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

Puede tener varios perfiles si tiene varios trabajos a la vez, o si desea poder administrar un clúster desde diferentes puntos de enlace. Para obtener más información acerca de variosAWS CLIperfiles, consultePerfiles con nombreen elAWS Command Line InterfaceGuía del usuario de.

Obtención del código QR para validación por NFC

Puede utilizar este comando para generar un código QR específico para el dispositivo para su uso con la aplicación AWS Snowball Edge Verification. Puedes descargar esta aplicación desde Apple App Store o Google Play Store. Para obtener más información sobre la validación de NFC, consulteValidación de etiquetas NFC.

Uso

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

ejemplo Output

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

Desbloquear dispositivos Snowball Edge

Para desbloquear unAWS Snowball Edge, ejecute elsnowballEdge unlock-devicecomando. Para obtener el ID de servicio para cada servicio, puede usar el comando snowballEdge unlock-cluster. Estos comandos autentican el acceso alAWS Snowball EdgeDispositivo.

nota

Para desbloquear los dispositivos asociados con su trabajo, los dispositivos deben estar en el sitio, enchufados a la alimentación y a la red y encendidos. Además, la pantalla LCD en la parte frontal delAWS Snowball Edgedebe indicar que el dispositivo está listo para usarlo.

Uso (cliente Snowball Edge configurado)

snowballEdge unlock-device

ejemplo Entrada de desbloqueo de un solo dispositivo

snowballEdge unlock-device

ejemplo Salida de desbloqueo de un solo dispositivo

Your Snowball Edge device is unlocking. You may determine the unlock state of your device using the describe-device command. Your Snowball Edge device will be available for use when it is in the UNLOCKED state.

Uso del clúster

Al desbloquear un clúster, debe proporcionar el punto de enlace de uno de los nodos y todas las direcciones IP de los demás dispositivos del clúster.

snowballEdge unlock-cluster --endpoint https://192.0.2.0 --manifest-file Path/to/manifest/file --unlock-code 01234-abcde-ABCDE-01234 --device-ip-addresses 192.0.2.0 192.0.2.1 192.0.2.2 192.0.2.3 192.0.2.4

ejemplo Salida de desbloqueo de un clúster

Your Snowball Edge Cluster is unlocking. You may determine the unlock state of your cluster using the describe-device command. Your Snowball Edge Cluster will be available for use when your Snowball Edge devices are in the UNLOCKED state.

Actualización de Snowball Edge

Usa los siguientes comandos para descargar e instalar actualizaciones para tu dispositivo Snowball Edge. Para obtener información sobre los procedimientos que utilizan estos comandos, consulte Actualización de software en unAWS SnowballBorde.

snowballEdge check-for-updates— Devuelve información sobre la versión del software Snowball Edge disponible en la nube y la versión actual instalada en el dispositivo.

Uso (cliente Snowball Edge configurado)

snowballEdge check-for-updates

ejemplo Output

Latest version: 102 Installed version: 101

snowballEdge describe-device-software— Devuelve la versión de software actual del dispositivo. Además, si la actualización se está descargando, también se muestra el estado de la descarga. Si hay una actualización de software en curso, también se muestra el manifiesto de la versión de la actualización y el estado de la instalación. A continuación, se muestra una lista de las posibles salidas:

  • NA— No hay actualizaciones de software en curso actualmente.

  • Downloading— Se está descargando nuevo software.

  • Installing— Se está instalando un nuevo software.

  • Requires Reboot— Se ha instalado un nuevo software y es necesario reiniciar el dispositivo.

    aviso

    Se recomienda encarecidamente suspender todas las actividades del dispositivo antes de reiniciarlo. El reinicio de un dispositivo detiene la ejecución de instancias, interrumpe cualquier escritura en los depósitos de Amazon S3 en el dispositivo y detiene cualquier operación de escritura desde la interfaz de archivos sin borrar la memoria caché. Todos estos procesos pueden ocasionar pérdida de datos.

Uso (cliente Snowball Edge configurado)

snowballEdge describe-device-software

ejemplo Output

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

snowballEdge download-updates— Comienza a descargar las actualizaciones de software más recientes para tu Snowball Edge.

Uso (cliente Snowball Edge configurado)

snowballEdge download-updates

ejemplo Output

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

snowballEdge install-updates— Comienza a instalar las actualizaciones de software más recientes para tu Snowball Edge que ya se han descargado.

Uso (cliente Snowball Edge configurado)

snowballEdge install-updates

ejemplo Output

Installation started.

snowballEdge reboot-device— Reinicia el dispositivo.

aviso

Se recomienda encarecidamente suspender todas las actividades del dispositivo antes de reiniciarlo. El reinicio de un dispositivo detiene la ejecución de instancias, interrumpe cualquier escritura en los depósitos de Amazon S3 en el dispositivo y detiene cualquier operación de escritura desde la interfaz de archivos sin borrar la memoria caché. Todos estos procesos pueden ocasionar pérdida de datos.

Uso (cliente Snowball Edge configurado)

snowballEdge reboot-device

ejemplo Output

Rebooting device now.

snowballEdge configure-auto-update-strategies— Configura una estrategia de actualización automática.

Uso (cliente Snowball Edge configurado)

snowballEdge configure-auto-update-strategy --auto-check autoCheck [--auto-check-frequency autoCheckFreq] --auto-download autoDownload [--auto-download-frequency autoDownloadFreq] --auto-install autoInstall [--auto-install-frequency autoInstallFreq] --auto-reboot autoReboot [--endpoint endpoint]

ejemplo Output

Successfully configured auto update strategy. Run describe-auto-update-strategies for additional information.

snowballEdge describe-auto-update-strategies— Devuelve cualquier estrategia de actualización automática configurada actualmente.

Uso (cliente Snowball Edge configurado)

snowballEdge describe-auto-update-strategies

ejemplo Output

auto-update-strategy {[ auto-check:true, auto-check-frequency: "0 0 * * FRI", // CRON Expression String, Every Friday at midnight auto-download:true, auto-download-frequency: "0 0 * * SAT", // CRON Expression String, Every Saturday at midnight auto-install:true, auto-install-frequency: "0 13 * * Sun", // CRON Expression String, Every Saturday at midnight auto-reboot: false; ]}

Obtención de credenciales

Uso desnowballEdge list-access-keysysnowballEdge get-secret-access-key, puede obtener las credenciales del usuario administrador de suCuenta de AWSen Snowball Edge. Puede usar estas credenciales para crearAWS Identity and Access Management(IAM) y para autenticar sus solicitudes al usar elAWS CLIo con unAWSSDK. Estas credenciales solo están asociadas a un trabajo individual para Snowball Edge y solo puede usarlas en el dispositivo o el clúster de dispositivos. El dispositivo o los dispositivos no tienen ningún permiso de IAM en laNube de AWS.

nota

Si utiliza AWS CLI con el dispositivo Snowball Edge, debe utilizar estas credenciales al configurar CLI. Para obtener información acerca de cómo configurar las credenciales paraAWS CLI, consulteConfiguración deAWS CLIen elAWS Command Line InterfaceGuía del usuario de.

Uso (cliente Snowball Edge configurado)

snowballEdge list-access-keys

ejemplo Output

{ "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ] }

Uso (cliente Snowball Edge configurado)

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

ejemplo Output

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

Cómo iniciar un servicio en Snowball Edge

Los dispositivos Snowball Edge admiten varios servicios, además de Amazon S3. Estos incluyen las instancias informáticas, la interfaz de archivos,AWS Systems ManageryAWS IoT Greengrass. Amazon S3 y Amazon EC2 están siempre activados de forma predeterminada y no se pueden detener ni reiniciar con el cliente de Snowball Edge. Sin embargo, la interfaz de archivos, Systems Manager yAWS IoT Greengrassse puede iniciar con elsnowballEdge start-servicecomando. Para obtener el ID de servicio para cada servicio, puede usar el comando snowballEdge list-services.

Antes de ejecutar este comando, cree una interfaz de red virtual única para vincular al servicio que va a iniciar. Para obtener más información, consulte Creación de una interfaz de red virtual.

Uso (cliente Snowball Edge configurado)

snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn

ejemplo Output

Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Detener un servicio en su Snowball Edge

Para detener la ejecución de un servicio en tu Snowball Edge, puedes usar lasnowballEdge stop-servicecomando.

Amazon S3, Amazon EC2,AWS STSy los servicios de IAM no se pueden detener.

aviso

La pérdida de datos puede ocurrir si la interfaz de archivos se detiene antes de que se escriban los datos restantes en el búfer en el dispositivo. Para obtener más información acerca del uso de la interfaz de archivos, consulte Transferencia de archivos a AWS Snowball Edge mediante la interfaz de archivos.

Uso (cliente Snowball Edge configurado)

snowballEdge stop-service --service-id service_id

ejemplo Output

Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Obtención de su certificado para la transferencia de datos

Para transferir datos a un Snowball Edge, utilice la interfaz de Amazon S3. Para usar la interfaz S3 a través del protocolo HTTPS, debe proporcionar un certificado. Los certificados los genera cada dispositivo Snowball Edge. Si desbloqueas tu dispositivo Snowball Edge con una dirección IP diferente, se genera un nuevo certificado y el certificado antiguo ya no es válido para usarlo con el punto final. Puede volver a obtener el certificado nuevo y actualizado de Snowball Edge con laget-certificatecomando.

Puedes enumerar estos certificados y descargarlos desde tu dispositivo Snowball Edge con los siguientes comandos:

  • list-certificates: muestra los nombres de recursos de Amazon (ARN) para los certificados que están disponibles para su uso.

    Uso (cliente Snowball Edge configurado)

    snowballEdge list-certificates

    ejemplo Output

    { "Certificates" : [ { "CertificateArn" : "arn:aws:snowball-device:::certificate/78EXAMPLE516EXAMPLEf538EXAMPLEa7", "SubjectAlternativeNames" : [ "192.0.2.0" ] } ] }
  • get-certificate: obtiene un certificado específico, en función del ARN proporcionado.

    Uso (cliente Snowball Edge configurado)

    snowballEdge get-certificate --certificate-arn arn:aws:snowball-device:::certificate/78EXAMPLE516EXAMPLEf538EXAMPLEa7

    ejemplo Output

    -----BEGIN CERTIFICATE----- Certificate -----END CERTIFICATE-----

    Para obtener información acerca de cómo configurar su certificado, consulteEspecificación de la interfaz S3 comoAWS CLIPunto de enlace.

Inicio de NFS y restricción del acceso

importante

No inicie el servicio de NFS si va a utilizar Amazon Elastic Block Store (Amazon EBS). La primera vez que se inicia NFS, todo el almacenamiento se asigna a NFS. No es posible reasignar el almacenamiento de NFS a Amazon EBS, aunque se detenga el servicio de NFS.

nota

Puede proporcionar bloques de CIDR para rangos de IP que puedan montar los recursos compartidos NFS expuestos por el dispositivo. Por ejemplo, 10.0.0.0/16. Si no proporciona bloques de CIDR permitidos, se denegarán todas las solicitudes de montaje.

Tenga en cuenta que los datos transferidos a través de NFS no se cifran en tránsito.

Además de los hosts permitidos por los bloques CIDR, Snowcone no proporciona un mecanismo de autenticación o autorización para los recursos compartidos de NFS.

Inicie NFS con elsnowballEdge start-servicecomando. Para obtener el ID de servicio para el servicio NFS, puede usar lasnowballEdge list-servicescomando.

Antes de ejecutar este comando, cree una interfaz de red virtual única para vincular al servicio que va a iniciar. Para obtener más información, consulteCreación de una interfaz de red virtual. Puede restringir el acceso a sus datos y recursos compartidos de archivos en sus depósitos de Amazon S3 y ver qué restricciones existen actualmente. Para ello, asigne bloques de CIDR para hosts permitidos que puedan acceder a su recurso compartido de archivos y depósitos de S3 cuando inicie el servicio NFS.

Uso (cliente Snowball Edge configurado)

snowballEdge start-service --service-id nfs --virtual-network-interface-arns arn:aws:snowball-device:::interface/s.ni-12345fgh45678j --service-configuration AllowedHosts=ip address-1/32,ip address-2/24

ejemplo Ejemplo de resultados

Starting the service on your Snowball Edge. You can determine the status of the service using the describe-service command.

Restringir el acceso a los recursos compartidos de NFS cuando se ejecuta NFS

Puede restringir el acceso a sus datos y recursos compartidos de archivos en sus depósitos de Amazon S3 después de haber iniciado NFS. Puedes ver qué restricciones están vigentes actualmente y asignar a cada depósito restricciones de acceso diferentes. Para ello, asigne bloques de CIDR a los hosts que pueden acceder al recurso compartido de archivos y a los depósitos de S3 cuando inicia el servicio NFS. El siguiente comando es un ejemplo.

Uso (cliente Snowball Edge configurado)

snowballEdge start-service \ --service-id nfs \ --virtual-network-interface-arns virtual-network-interface-arn --service-configuration AllowedHosts=ip-address-1/32,ip-address-1/24

Para ver las restricciones actuales, utilice ladescribe-servicecomando.

snowballEdge describe-service --service-id nfs

AWS Snowball EdgeRegistros de

Cuando transfieres datos entre tu centro de datos local y un Snowball Edge, los registros se generan automáticamente. Si detecta errores inesperados durante la transferencia de datos al dispositivo, puede utilizar los siguientes comandos para guardar una copia de los registros en el servidor local.

Existen tres comandos relacionados con los registros:

  • list-logs— Devuelve una lista de registros en formato JSON. Esta lista informa sobre el tamaño de los registros en bytes, el ARN de los registros, el ID de servicio de los registros y el tipo de registros.

    Uso (cliente Snowball Edge configurado)

    snowballEdge list-logs

    ejemplo Output

    { "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: descarga una copia de un registro específico de Snowball Edge a su servidor en una ruta especificada.CUSTOMERlos registros se guardan en el.zipy puede extraer este tipo de registro para ver su contenido.SUPPORTlos registros están cifrados y solo pueden ser leídos porAWS Supportingenieros. Puede especificar un nombre y una ruta para el registro.

    Uso (cliente Snowball Edge configurado)

    snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709

    ejemplo Output

    Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin
  • get-support-logs— Descarga una copia de todos losSUPPORTtipo de registros de Snowball Edge a tu servicio en una ruta especificada.

    Uso (cliente Snowball Edge configurado)

    Cliente Snowball Edge

    snowballEdge get-support-logs

    ejemplo Output

    Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
importante

El tipo CUSTOMER puede contener información confidencial sobre sus propios datos. Para proteger esta información potencialmente confidencial, recomendamos encarecidamente eliminar estos registros una vez que haya terminado con ellos.

Obtención del estado de los dispositivos

Puede determinar el estado y el estado general de sus dispositivos Snowball Edge con los siguientes comandos de cliente de Snowball Edge:

  • describe-device

    Uso (cliente Snowball Edge configurado)

    snowballEdge describe-device

    ejemplo Output

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

    Uso (cliente Snowball Edge configurado)

    snowballEdge describe-cluster

    ejemplo Output

    { "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5", "Devices" : [ { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.0" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.1" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.2" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.3" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.4" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } } ] }

Obtención del estado de los servicios

Puede determinar el estado y el estado general de los servicios que se ejecutan en los dispositivos Snowball Edge con ladescribe-servicecomando. Puede ejecutar primero el comando list-services para ver qué servicios están ejecutándose.

  • list-services

    Uso (cliente Snowball Edge configurado)

    snowballEdge list-services

    ejemplo Output

    { "ServiceIds" : [ “greengrass”, "fileinterface", "s3", "ec2" ] }
  • describe-service

    Este comando devuelve un valor de estado para un servicio. Incluye información de estado que podría ser útil para resolver problemas que se detecten en el servicio. Los estados son los siguientes.

    • ACTIVE: el servicio se está ejecutando y se puede usar.

    • ACTIVATING: el servicio se está iniciando pero aún no se puede usar.

    • DEACTIVATING: el servicio está cerrándose.

    • INACTIVE: el servicio no se está ejecutando y no se puede usar.

    Uso (cliente Snowball Edge configurado)

    snowballEdge describe-service --service-id service-id

    ejemplo Output

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

Eliminación de un nodo de un clúster

Ladisassociate-deviceelimina un nodo de un clúster de Snowball Edge. Si desea sustituir un nodo en mal estado, utilice este comando. Para obtener más información acerca de los clústeres , consulte Uso de un clúster de AWS Snowball Edge.

importante

Utilice el comando disassociate-device solo cuando vaya a eliminar un nodo en mal estado. Este comando falla y devuelve un error si intenta eliminar un nodo en buen estado.

No utilice este comando para eliminar un nodo que se ha apagado o desconectado de la red por accidente y, por lo tanto, no se encuentra disponible temporalmente para el resto del clúster. Los nodos eliminados con este comando no se pueden agregar a ningún clúster y se deben devolver aAWS.

Si un nodo se apagó o desconectó accidentalmente de la red, vuelva a conectar el nodo a la alimentación y a la red y utilice elassociate-devicecomando. No puede utilizar el comando disassociate-device para desasociar un nodo si está encendido y en buen estado.

Uso (cliente Snowball Edge configurado)

snowballEdge disassociate-device --device-id Job ID for the Device

ejemplo Output

Disassociating your Snowball Edge device from the cluster. Your Snowball Edge device will be disassociated from the cluster when it is in the "DISASSOCIATED" state. You can use the describe-cluster command to determine the state of your cluster.

Adición de un nodo a un clúster

Laassociate-deviceagrega un nodo a un grupo de dispositivos Snowball Edge. Si apagas un nodo, pasa de estar desbloqueado a estar bloqueado. Para desbloquear ese nodo, puede utilizar este comando. Utilice este comando para reemplazar un nodo no disponible por un nodo nuevo que haya pedido como reemplazo. Para obtener más información acerca de los clústeres , consulte Uso de un clúster de AWS Snowball Edge.

Uso (cliente Snowball Edge configurado)

snowballEdge associate-device --device-ip-address IP Address

ejemplo Output

Associating your Snowball Edge device with the cluster. Your Snowball Edge device will be associated with the cluster when it is in the ASSOCIATED state. You can use the describe-cluster command to determine the state of your cluster.

Creación de etiquetas para su dispositivo

Agrega o sobrescribe las etiquetas especificadas en su dispositivo. Puede crear un máximo de 50 etiquetas. Cada etiqueta se compone de un par clave-valor El valor es opcional.

nota

No incluya información confidencial en sus etiquetas.

Uso (cliente Snowball Edge configurado)

snowballEdge create-tags --tag Key=Name,Value=user-test --tag Key=Stage,Value=beta

Para obtener más información, ejecute el comando describe-tags.

ejemplo Output

Tag(s) [Key=Name,Value=test, Key=Stage,Value=beta] created.

Eliminación de etiquetas de su dispositivo

Ladelete-tagsborra las etiquetas especificadas del dispositivo Snowball Edge.

Uso (cliente Snowball Edge configurado)

snowballEdge delete-tags --tag Key=Stage,Value=beta Tag(s) [Key=Stage,Value=beta] deleted.

Para obtener más información, ejecute el comando describe-tags.

nota

Si desea eliminar varias etiquetas a la vez, puede especificar varios pares clave-valor, como el siguiente:

delete-tags --tag Key=Name,Value=test --tag Key=Stage,Value=Beta

Si especifica una clave de etiqueta sin un valor de etiqueta, se eliminará cualquier etiqueta con esta clave independientemente de su valor. Si especifica una clave de etiqueta con una cadena vacía como valor de etiqueta, solo se eliminarán las etiquetas que tengan una cadena vacía como valor.

Descripción de etiquetas en su dispositivo

Ladescribe-tagsdescribe las etiquetas del dispositivo Snowball Edge.

Uso (cliente Snowball Edge configurado)

snowballEdge describe-tags

Para obtener más información, ejecute el comando describe-tags.

ejemplo Output

{ "Tags" : [ { "Key" : "Name", "Value" : "user-test" }, { "Key" : "Stage", "Value" : "beta" } ] }

Creación de una interfaz de red directa

  • create-direct-network-interface — Crea una interfaz de red directa (DNI). Crea una interfaz de red directa para utilizarla con las instancias informáticas de Amazon EC2 en su dispositivo. Puede encontrar las interfaces de red directas disponibles en su dispositivo mediante eldescribe-direct-network-interfacescomando.

Uso (cliente Snowball Edge configurado)

snowballEdge create-direct-network-interface [--endpoint endpoint] [--instance-id instanceId] [--mac macAddress] [--manifest-file manifestFile] [--physical-network-interface-id physicalNetworkInterfaceId] [--profile profile] [--unlock-code unlockCode] [--vlan vlanId]

Obtener información sobre una interfaz de red directa

  • describe-direct-network-interface — Obtiene las interfaces de red directas del dispositivo. Se puede usar una interfaz de red directa para configurar las redes para las instancias y los servicios informáticos de Amazon EC2 en su dispositivo. Puede crear una nueva interfaz de red directa mediante elcreate-direct-network-interfacecomando.

Uso (cliente Snowball Edge configurado)

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

Actualización de una interfaz de red directa

  • update-direct-network-interface — Actualiza una interfaz de red directa. Utilice este comando para actualizar una interfaz de red directa que se utilizará con las instancias informáticas de Amazon EC2 en su dispositivo. Puede encontrar las interfaces de red directas que están disponibles en su dispositivo mediante eldescribe-direct-networkcomando -interfaces. Cuando modifica una interfaz de red que está conectada a una instancia de Amazon EC2, la interfaz se desconectará primero.

Uso (cliente Snowball Edge configurado)

snowballEdge update-direct-network-interface [--direct-network-interface-arn directNetworkInterfaceArn] [--endpoint endpoint] [--mac macAddress] [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode] [--vlan vlanId] [--attach-instance-id instanceId | --detach]

Eliminación de una interfaz de red directa

  • delete-direct-network-interface: elimina una interfaz de red directa que ya no está en uso. Para eliminar una interfaz de red directa asociada a la instancia informática de Amazon EC2, primero debe desasociar la interfaz de red directa de la instancia.

Uso (cliente Snowball Edge configurado)

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

Configuración de servidores de tiempo

Puede configurar un servidor de Network Time Protocol (NTP). Puede usar los comandos de la CLI de NTP cuando el dispositivo está tanto en estado bloqueado como desbloqueado. El manifiesto y el código de desbloqueo son obligatorios. Puedes configurarlos con la opciónsnowballEdge configureo mediante el comando--manifest-filey--unlock-codeopciones. Tenga en cuenta que puede usar elsnowballEdgeCLI en ambosAWS SnowconeEdge yAWS Snowcone.

Es su responsabilidad proporcionar un servidor de tiempo NTP seguro. Para configurar los servidores de tiempo NTP a los que se conecta el dispositivo, utilice laupdate-time-serversCommand.

nota

Laupdate-time-serversanulará la configuración anterior de los servidores horarios NTP.

Tipos de dispositivos NTP y versiones de software compatibles

NTP no está disponible en ningún tipo de dispositivo informático y de almacenamiento de la versión 2. Sin embargo, los tipos de dispositivos de almacenamiento y computación Snowball Edge versión 3 con software versión 77 o posterior admiten NTP. Para comprobar si NTP está habilitado, utilice el comando de la CLI de Snowball Edgedescribe-time-sources.

Uso

snowballEdge update-time-servers time.google.com

ejemplo Ejemplo de resultados

Updating time servers now.

Comprobación de fuentes de tiempo

Para ver a qué fuentes de tiempo NTP está conectado actualmente el dispositivo, utilice ladescribe-time-sourcesCommand de Snowball Edge.

Uso

snowballEdge describe-time-sources

ejemplo Ejemplo de resultados

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

Ladescribe-time-sourcesdevuelve una lista de estados de fuente de tiempo. Cada vez que el estado de origen contiene elAddress,State,TypeyStratum. Los siguientes son los significados de estos campos.

  • Address— El nombre DNS/ dirección IP de la fuente horaria.

  • State— El estado actual de la conexión entre el dispositivo y esa fuente horaria. Hay cinco estados posibles:.

    • CURRENT— La fuente horaria se está utilizando actualmente para sincronizar la hora.

    • COMBINED— La fuente de tiempo se combina con la fuente actual.

    • EXCLUDED— El algoritmo de combinación excluye la fuente de tiempo.

    • LOST— Se ha perdido la conexión con la fuente horaria.

    • UNACCEPTABLE— Una fuente de tiempo no válida en la que el algoritmo de combinación ha considerado que es una etiqueta falsa o tiene demasiada variabilidad.

  • Type— Una fuente de tiempo NTP puede ser un servidor o un par. Los servidores se pueden configurar mediante elupdate-time-serverscomando. Los pares solo pueden ser otros dispositivos Snowball Edge del clúster y se configuran automáticamente cuando se asocia el clúster.

  • Stratum: este campo muestra el estrato de la fuente. El estrato 1 indica una fuente con un reloj de referencia conectado localmente. Una fuente que está sincronizada con una fuente del estrato 1 está en el estrato 2. Una fuente que está sincronizada con una fuente del estrato 2 está en el estrato 3, y así sucesivamente.

Una fuente de tiempo NTP puede ser un servidor o un par. El usuario puede configurar un servidor con elupdate-time-servers, mientras que un par solo puede ser otro dispositivo Snowball Edge del clúster. En el resultado del ejemplo,describe-time-sourcesse invoca en un Snowball Edge que está en un grupo de 5. La salida contiene 4 pares y 1 servidor. Los pares tienen un estrato de 10, mientras que el servidor tiene un estrato de 1; por lo tanto, el servidor se selecciona para que sea la fuente de tiempo actual.