Configuración y uso del cliente de Snowball Edge - AWS Snowball Edge Guía para desarrolladores
Descarga e instalación del cliente de Snowball EdgeConfiguración de un perfil para el cliente de Snowball EdgeBúsqueda de la versión del cliente de Snowball EdgeObtención de credencialesInicio de un servicio en un Snowball EdgeDetener un servicio en un Snowball EdgeConsulta y descarga de registrosVisualización del estado del dispositivoVisualización del estado de los serviciosVisualización del estado de las característicasConfiguración de servidores de tiempoValidación de etiquetas NFCActualización del tamaño de MTU

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.

Configuración y uso del cliente de Snowball Edge

El cliente de Snowball Edge es una herramienta de interfaz de línea de comandos (CLI) AWS que se puede utilizar para trabajar con un Snowball Edge o un clúster de Snowball Edge. Puede usar el cliente para desbloquear un Snowball Edge o un clúster de dispositivos, configurar Snowball Edge, iniciar y detener servicios en los dispositivos y transferir datos a o desde los dispositivos. El cliente de Snowball Edge es compatible con equipos con sistemas operativos Linux, macOS y Windows.

Descarga e instalación del cliente de Snowball Edge

Puede descargar el cliente de Snowball Edge desde Recursos de AWS Snowball Edge. En esa página encontrará el paquete de instalación para su sistema operativo.

Instale y configure el cliente según las instrucciones que se indican a continuación.

Linux
nota

El cliente de Snowball Edge solo se admite en distribuciones Linux de 64 bits.

  1. Extraiga el archivo snowball-client-linux.tar.gz. Crea la estructura de carpetas de /snowball-client-linux-build_number/bin y extrae los archivos en ella.

  2. Ejecute los siguientes comandos para configurar las carpetas.

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

  3. Agregue /snowball-client-linux-build_number/bin a la variable de entorno $PATH del sistema operativo para ejecutar los comandos del cliente de Snowball Edge desde cualquier directorio. Para obtener más información, consulte la documentación del sistema operativo del dispositivo o el intérprete de comandos.

macOS

  1. Extraiga el archivo snowball-client-mac.tar.gz. Crea la estructura de carpetas de /snowball-client-linux-build_number/bin y extrae los archivos en ella.

  2. Ejecute los siguientes comandos para configurar las carpetas.

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

  3. Agregue /snowball-client-mac-build_number/bin a la variable de entorno $PATH del sistema operativo para ejecutar los comandos del cliente de Snowball Edge desde cualquier directorio. Para obtener más información, consulte la documentación del sistema operativo del dispositivo o el intérprete de comandos.

Windows

El cliente está empaquetado como un archivo Microsoft Software Installer (MSI). Abra el archivo y siga las peticiones del asistente de instalación. Una vez que el cliente se ha instalado, puede ejecutarlo desde cualquier directorio sin necesidad de preparación adicional.

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

Cada vez que ejecuta un comando para el cliente de Snowball Edge, proporciona el archivo de manifiesto, el código de desbloqueo y la dirección IP de Snowball Edge. En lugar de proporcionarlos cada vez que ejecute un comando, puede usar el configure comando para almacenar la ruta al archivo de manifiesto, el código de desbloqueo de 29 caracteres y el punto final (la dirección IP de Snowball Edge) como perfil. Después de la configuración, puede utilizar los comandos del cliente de Snowball Edge sin tener que escribir manualmente estos valores para cada comando al incluir el nombre del perfil en el comando. Después de configurar el cliente de Snowball Edge, la información se guarda en un formato JSON de texto no cifrado en home directory/.aws/snowball/config/snowball-edge.config. Asegúrese de que el entorno esté configurado para que le permita crear este archivo.

importante

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

También se puede utilizar AWS OpsHub para crear un perfil. Los perfiles creados en AWS OpsHub están disponibles para su uso con el cliente Snowball Edge y los perfiles creados en AWS OpsHub están disponibles para su uso con el cliente Snowball Edge. Para obtener más información, consulte Administración de perfiles.

Para crear un perfil

  1. Introduzca el comando en la interfaz de la línea de comandos del sistema operativo. El valor del parámetro profile-name es el nombre del perfil. Lo proporcionará en el futuro cuando ejecute comandos del cliente de Snowball Edge.

    
snowballEdge configure --profile profile-name

  2. El cliente de Snowball Edge le pedirá cada parámetro. Cuando se le pida, introduzca la información de su entorno y de Snowball Edge.

    nota

    El valor del endpoint parámetro es la dirección IP de Snowball Edge, precedida por. https:// Puede localizar la dirección IP del dispositivo Snowball Edge en la pantalla LCD de la parte frontal del dispositivo.

    ejemplo resultado del comando configure
    
Configuration will stored at home directory\.aws\snowball\config\snowball-edge.config
Snowball Edge Manifest Path: /Path/to/manifest/file
Unlock Code: 29 character unlock code
Default Endpoint: https://192.0.2.0

    El cliente de Snowball Edge comprobará que el código de desbloqueo es correcto para el archivo de manifiesto. Si no coinciden, el comando se detiene y no crea el perfil. Compruebe el código de desbloqueo y el archivo de manifiesto y vuelva a ejecutar el comando.

Para usar el perfil, incluya --profile profile-name antes de la sintaxis del comando.

Si utiliza varios Snowball Edge independientes, puede crear un perfil para cada uno. Para crear otro perfil, vuelva a ejecutar el comando configure, proporcione un valor diferente para el parámetro --profile e indique la información para otro dispositivo.

ejemplo Archivo snowball-edge.config de ejemplo

En este ejemplo se muestra un archivo de perfil que contiene tres perfiles: SnowDevice1profile, SnowDevice2profile y 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":[]
    }
}

Para editar o eliminar perfiles, edite el archivo de perfil en un editor de texto.

Para editar un perfil

  1. En un editor de texto, abra snowball-edge.config en home directory\.aws\snowball\config.

    nota

    Asegúrese de que el entorno esté configurado para que le permita acceso de lectura y escritura en este archivo.

  2. Edite el archivo según sea necesario. Por ejemplo, para cambiar la dirección IP del Snowball Edge asociado al perfil, cambie la defaultEndpoint entrada.

  3. Guarde y cierre el archivo.

Para eliminar un perfil

  1. Con un editor de texto, abra snowball-edge.config en home directory\.aws\snowball\config.

    nota

    Asegúrese de que el entorno esté configurado para que le permita acceso de lectura y escritura en este archivo.

  2. Elimine la línea que contiene el nombre del perfil, las llaves { } que hay a continuación del nombre del perfil y el contenido de esas llaves.

  3. Guarde y cierre el archivo.

Búsqueda de la versión del cliente de Snowball Edge

Utilice el comando version para ver la versión del cliente de la interfaz de línea de comandos (CLI) de Snowball Edge.

Uso


    snowballEdge version

Ejemplo de salida


    Snowball Edge client version: 1.2.0  Build 661

Obtención de credenciales para Snowball Edge

Con los snowballEdge get-secret-access-key comandos snowballEdge list-access-keys y, puede obtener las credenciales del usuario administrador de su cuenta Cuenta de AWS de Snowball Edge. Puede utilizar estas credenciales para crear AWS Identity and Access Management (usuarios de IAM) y funciones, y para autenticar sus solicitudes cuando utilice AWS CLI o utilice un SDK. AWS Estas credenciales están asociadas exclusivamente a un único trabajo de Snowball Edge y solo se pueden utilizar en el dispositivo o el clúster de dispositivos. El dispositivo o los dispositivos no tienen ningún permiso de IAM en la Nube de AWS.

nota

Si lo utiliza AWS CLI con Snowball Edge, debe utilizar estas credenciales al configurar la CLI. Para obtener información sobre cómo configurar las credenciales para la AWS CLI, consulte Configuración de la AWS CLI en la Guía del AWS Command Line Interface usuario.

Uso (cliente de Snowball Edge configurado)

snowballEdge list-access-keys
ejemplo Salida
{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Uso (cliente de 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

Inicio de un servicio en un Snowball Edge

Los dispositivos Snowball Edge admiten varios servicios. Estas incluyen las instancias informáticas, la interfaz del sistema de archivos de red (NFS), la administración de dispositivos Snow y. AWS IoT Greengrass El servicio de adaptador Amazon S3 EC2 AWS STS, Amazon e IAM se inician de forma predeterminada y no se pueden detener ni reiniciar. Sin embargo, la interfaz NFS, Snow Device Management, se AWS IoT Greengrass puede iniciar utilizando su ID de servicio con el comando. start-service Para obtener el ID de servicio para cada servicio, puede usar el comando list-services.

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


snowballEdge start-service --profile profile-name --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn
ejemplo resultado del comando start-service
Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Detener un servicio en un Snowball Edge

Para detener un servicio que se ejecuta en un Snowball Edge, puede utilizar el stop-service comando.

El adaptador Amazon S3 EC2 AWS STS, Amazon y los servicios de IAM no se pueden detener.

aviso

Puede producirse pérdida de datos si el servicio de sistema de archivos de red (NFS) se detiene antes de que se escriban en el dispositivo los datos que aún están en el búfer. Para obtener más información sobre el uso del servicio NFS, consulte Administración de la interfaz NFS en Snowball Edge.

nota

Al detener el almacenamiento compatible con Amazon S3 en el servicio Snowball Edge, se inhabilita el acceso a los datos almacenados en los depósitos de S3 del dispositivo o el clúster. El acceso se restablece cuando se vuelve a iniciar el almacenamiento compatible con Amazon S3 en Snowball Edge. En el caso de los dispositivos con almacenamiento compatible con Amazon S3 en Snowball Edge, se recomienda iniciar el servicio después de encender el dispositivo Snowball Edge. Consulte Configuración de Snowball Edge en esta guía. 


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

Visualización y descarga de registros de Snowball Edge

Al transferir datos entre el centro de datos en las instalaciones y un dispositivo Snowball Edge, se generan registros 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

    snowballEdge list-logs --profile profile-name
    ejemplo resultado del comando list-logs
    {
  "Logs" : [ {
    "LogArn" : "arn:aws:snowball-device:::log/s3-storage-JIEXAMPLE2f-1234-4953-a7c4-dfEXAMPLE709",
    "LogType" : "SUPPORT",
    "ServiceId" : "s3",
    "EstimatedSizeBytes" : 53132614
  }, {
    "LogArn" : "arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709",
    "LogType" : "CUSTOMER",
    "ServiceId" : "fileinterface",
    "EstimatedSizeBytes" : 4446
  }]
}

  • get-log: descarga una copia de un registro específico del dispositivo Snowball Edge en el dispositivo en una ruta especificada. Los registros CUSTOMER se guardan en formato .zip y puede extraer este tipo de registro para ver el contenido. Los registros SUPPORT están cifrados y solo los puede leer AWS Support. Puede especificar un nombre y una ruta para el registro.

    Uso

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

  • get-support-logs: descarga una copia de todos los registros de tipo SUPPORT del dispositivo Snowball Edge en la ruta especificada de su servicio.

    Uso

    snowballEdge get-support-logs --profile profile-name
    ejemplo resultado del comando get-support-logs
    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.

Visualización del estado de un Snowball Edge

Puede determinar el estado y el estado general de Snowball Edge con el describe-device comando.

snowballEdge describe-device --profile profile-name
ejemplo resultado del comando describe-device

                            {
  "DeviceId": "JID-EXAMPLE12345-123-456-7-890",
  "UnlockStatus": {
    "State": "UNLOCKED"
  },
  "ActiveNetworkInterface": {
    "IpAddress": "192.0.2.0"
  },
  "PhysicalNetworkInterfaces": [
    {
      "PhysicalNetworkInterfaceId": "s.ni-EXAMPLEd9ecbf03e3",
      "PhysicalConnectorType": "RJ45",
      "IpAddressAssignment": "STATIC",
      "IpAddress": "0.0.0.0",
      "Netmask": "0.0.0.0",
      "DefaultGateway": "192.0.2.1",
      "MacAddress": "EX:AM:PL:E0:12:34"
    },
    {
      "PhysicalNetworkInterfaceId": "s.ni-EXAMPLE4c3840068f",
      "PhysicalConnectorType": "QSFP",
      "IpAddressAssignment": "STATIC",
      "IpAddress": "0.0.0.0",
      "Netmask": "0.0.0.0",
      "DefaultGateway": "192.0.2.2",
      "MacAddress": "EX:AM:PL:E0:56:78"
    },
    {
      "PhysicalNetworkInterfaceId": "s.ni-EXAMPLE0a3a6499fd",
      "PhysicalConnectorType": "SFP_PLUS",
      "IpAddressAssignment": "DHCP",
      "IpAddress": "192.168.1.231",
      "Netmask": "255.255.255.0",
      "DefaultGateway": "192.0.2.3",
      "MacAddress": "EX:AM:PL:E0:90:12"
    }
  ]
}

Visualización del estado de los servicios que se ejecutan en Snowball Edge

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

  • list-services

    Uso

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

  • 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.

    • DEGRADED— En el caso del almacenamiento compatible con Amazon S3 en Snowball Edge, este estado indica que uno o varios discos o dispositivos del clúster están inactivos. El almacenamiento compatible con Amazon S3 en el servicio Snowball Edge funciona ininterrumpidamente, pero debe recuperar o sustituir el dispositivo afectado antes de que se pierda el quórum del clúster para minimizar el riesgo de pérdida de datos. Consulte Información general de la agrupación en clústeres en esta guía.

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

    Uso

    snowballEdge describe-service --profile profile-name --service-id service-id
    ejemplo resultado del comando describe-service
    
{
  "ServiceId": "s3",
  "Status": {
    "State": "ACTIVE"
  },
  "Storage": {
    "TotalSpaceBytes": 99608745492480,
    "FreeSpaceBytes": 99608744468480
  },
  "Endpoints": [
    {
      "Protocol": "http",
      "Port": 8080,
      "Host": "192.0.2.0"
    },
    {
      "Protocol": "https",
      "Port": 8443,
      "Host": "192.0.2.0",
      "CertificateAssociation": {
        "CertificateArn": "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
      }
    }
  ]
}
    ejemplo Almacenamiento compatible con Amazon S3 en la salida del servicio Snowball Edge

    El comando describe-service proporciona el siguiente resultado para el valor s3-snow del parámetro service-id.

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

Visualización del estado de las funciones de Snowball Edge

Para ver el estado de las funciones disponibles en un Snowball Edge, utilice el describe-features comando.

RemoteManagementState: indica el estado de Snow Device Management y devuelve uno de los siguientes estados:

  • INSTALLED_ONLY: la característica está instalada pero no habilitada.

  • INSTALLED_AUTOSTART— La función está habilitada y el dispositivo intentará conectarse a ella Región de AWS cuando esté encendida.

  • NOT_INSTALLED: el dispositivo no admite la característica o ya estaba sobre el terreno antes de su lanzamiento.

Uso


snowballEdge describe-features --profile profile-name
ejemplo resultado del comando describe-features

{
  "RemoteManagementState" : String
}

Configuración de servidores de tiempo para Snowball Edge

Puede utilizar los comandos del cliente de Snowball Edge para ver la configuración actual del protocolo de tiempo de red (NTP) y elegir un servidor o un par para proporcionar la hora. Puede usar los comandos del cliente de Snowball Edge tanto cuando el dispositivo está bloqueado como cuando está desbloqueado.

Es su responsabilidad proporcionar un servidor de tiempo NTP seguro. Para establecer a qué servidores de tiempo NTP se conecta el dispositivo, utilice el comando update-time-servers.

Comprobación de las fuentes horarias de Snowball Edge

Para ver a qué orígenes de tiempo NTP está conectado el dispositivo actualmente, utilice el comando describe-time-sources.

snowballEdge describe-time-sources --profile profile-name
ejemplo resultado del comando describe-time-sources
{
  "Sources" : [ {
    "Address" : "172.31.2.71",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "172.31.3.203",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "172.31.0.178",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "172.31.3.178",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "216.239.35.12",
    "State" : "CURRENT",
    "Type" : "SERVER",
    "Stratum" : 1
  } ]
}

El comando describe-time-sources devuelve una lista de los estados de las fuentes de tiempo. Cada estado de la fuente de tiempo contiene los campos Address, State, Type y Stratum. A continuación se explican los significados de estos campos.

  • Address: el nombre DNS o la dirección IP de la fuente de tiempo.

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

    • CURRENT: la fuente de tiempo 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 de tiempo.

    • UNACCEPTABLE: una fuente de tiempo no válida en la que el algoritmo de combinación ha resultado ser inexacto o presenta demasiada variabilidad.

  • Type: una fuente de tiempo NTP puede ser un servidor o un par. Los servidores se pueden configurar mediante el comando update-time-servers. 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 stratum de la fuente. Stratum 1 indica una fuente con un reloj de referencia conectado localmente. Una fuente que está sincronizada con una fuente del stratum 1 está en el stratum 2. Una fuente que está sincronizada con una fuente del stratum 2 está en el stratum 3, y así sucesivamente.

Una fuente de tiempo NTP puede ser un servidor o un par. El usuario puede configurar un servidor con el comando update-time-servers, mientras que un par solo pueden ser otros dispositivos Snowball Edge del clúster. En el ejemplo de salida, se llama a describe-time-sources en un dispositivo Snowball Edge que está en un clúster de 5. La salida contiene 4 pares y 1 servidor. Los pares tienen un stratum de 10, mientras que el servidor tiene un stratum de 1; por tanto, se selecciona el servidor como la fuente de tiempo actual.

Actualización de los servidores de tiempo

Utilice el update-time-servers comando y la dirección del servidor horario para configurar Snowball Edge de forma que utilice un servidor NTP o un par para NTP.

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

El comando update-time-servers anulará la configuración anterior de los servidores de tiempo NTP.

ejemplo resultado del comando update-time-servers
Updating time servers now.

Obtención de un código QR para validar las etiquetas NFC de Snowball Edge

Puede utilizar este comando para generar un código QR específico del dispositivo para su uso con la aplicación AWS Snowball Edge Verification. Para obtener más información sobre la validación por NFC, consulte Validació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

Actualización del tamaño de MTU

Utilice el update-mtu-size comando para modificar el tamaño en bytes de la unidad máxima de transmisión (MTU) de una interfaz física de un dispositivo Snowball Edge. Todas las interfaces de red virtual y las interfaces de red directa asociadas a esta interfaz de red física se configurarán con el mismo tamaño de MTU.

nota

El tamaño de MTU mínimo es de 1500 bytes y el tamaño máximo es de 9216 bytes.

Puede usar el describe-device comando para recuperar la interfaz de red física IDs y los tamaños actuales de MTU de esas interfaces. Para obtener más información, consulte Visualización del estado de un Snowball Edge.

Puede utilizar los comandos descibe-direct-network-interface y describe-virtual-network-interface para recuperar los tamaños de MTU actuales de esas interfaces.

Uso

snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes
ejemplo de salida de 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"
    }
}