Configuración y uso del cliente 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 Snowball EdgeBúsqueda de la versión del cliente de Snowball EdgeObtención de credencialesIniciar un servicio en un dispositivo de la familia SnowDetener un servicio en un dispositivo de la familia SnowVisualización y descarga de registrosVisualización del estado del dispositivoVisualización del estado de los serviciosVisualización del estado de las funcionesConfiguración de servidores de tiempoValidar etiquetas NFCActualización MTU del tamaño

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 Snowball Edge

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

Descarga e instalación del cliente de Snowball Edge

Puede descargar el cliente de Snowball Edge desde AWS Snowball Edge Recursos. 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 /snowball-client-linux-build_number/bin carpetas y extrae allí los archivos.

  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. /snowball-client-linux-build_number/binAñádala a la variable de PATH entorno $ 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 del shell.

macOS

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

  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. /snowball-client-mac-build_number/binAñádala a la variable de PATH entorno $ 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 del shell.

Windows

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

Configuración de un perfil para el cliente Snowball Edge

Cada vez que ejecuta un comando para el cliente Snowball Edge, proporciona el archivo de manifiesto, el código de desbloqueo y la dirección IP del dispositivo de la familia Snow. 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 del dispositivo de la familia Snow) como perfil. Tras la configuración, puede utilizar los comandos del cliente Snowball Edge sin tener que introducir manualmente estos valores para cada comando incluyendo el nombre del perfil en el comando. Tras configurar el cliente de Snowball Edge, la información se guarda en formato de texto sin formato JSON en. home directory/.aws/snowball/config/snowball-edge.config Asegúrese de que su entorno esté configurado para permitirle 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 línea de comandos de su sistema operativo. El valor del profile-name parámetro es el nombre del perfil. La proporcionará en el futuro cuando ejecute comandos del cliente de Snowball Edge.

    
snowballEdge configure --profile profile-name

  2. El cliente de Snowball Edge le solicitará cada parámetro. Cuando se le solicite, introduzca la información de su entorno y del dispositivo de la familia Snow.

    nota

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

    ejemplo salida 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 del archivo de manifiesto es correcto. 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, inclúyalo --profile profile-name antes de la sintaxis del comando.

Si utiliza varios dispositivos independientes de la familia Snow, puede crear un perfil para cada uno. Para crear otro perfil, vuelva a ejecutar el configure comando, proporcione un valor diferente para el --profile parámetro y proporcione 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 su entorno esté configurado para permitirle acceder a este archivo para leer y escribir.

  2. Edite el archivo según sea necesario. Por ejemplo, para cambiar la dirección IP del dispositivo de la familia Snow 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 su entorno esté configurado para permitirle acceder a este archivo para leer y escribir.

  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 version comando para ver la versión del cliente de 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

Obtener las credenciales de un dispositivo de la familia Snow

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 (IAMusuarios) y roles, y para autenticar sus solicitudes cuando utilice AWS CLI o con un. AWS SDK 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 IAM permiso en. Nube de AWS

nota

Si lo usa AWS CLI con Snowball Edge, debe usar estas credenciales al configurar el. CLI Para obtener información sobre cómo configurar las credenciales para el AWS CLI, consulte Configuración de 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 Salida
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Iniciar un servicio en un dispositivo de la familia Snow

Los dispositivos Snowball Edge admiten varios servicios. Estos incluyen las instancias de cómputo, 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, Amazon EC2 AWS STS, y IAM se inician de forma predeterminada y no se pueden detener ni reiniciar. Sin embargo, la NFS interfaz, Snow Device Management, se AWS IoT Greengrass puede iniciar utilizando su ID de servicio con el start-service comando. 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 dispositivo de la familia Snow.


snowballEdge start-service --profile profile-name --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn
ejemplo salida del start-service comando
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 dispositivo de la familia Snow

Para detener la ejecución de un servicio en un dispositivo de la familia Snow, puede usar el stop-service comando.

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

aviso

Se pueden producir pérdidas de datos si el servicio Network File System (NFS) se detiene antes de que los datos restantes guardados en el búfer se escriban en el dispositivo. Para obtener más información sobre el uso del NFS servicio, consulte. Gestión de la NFS interfaz en los dispositivos de la familia Snow

nota

Al detener el almacenamiento compatible con Amazon S3 en dispositivos Snow Family, se deshabilita el acceso a los datos almacenados en los buckets de S3 del dispositivo o el clúster. El acceso se restaura cuando se vuelve a iniciar el almacenamiento compatible con Amazon S3 en los dispositivos Snow Family. Para los dispositivos con almacenamiento compatible con Amazon S3 en dispositivos Snow Family, 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 salida del stop-service comando
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 los dispositivos de la familia Snow

Cuando transfiere datos entre su centro de datos local y un dispositivo de la familia Snow, 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 JSON formato. Esta lista indica el tamaño de los registros en bytes, el tamaño ARN de los registros, el identificador de servicio de los registros y el tipo de registros.

    Uso

    snowballEdge list-logs --profile profile-name
    ejemplo salida del list-logs comando
    {
  "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 dispositivo en una ruta específica. CUSTOMERlos registros se guardan en este .zip formato y puede extraer este tipo de registro para ver su contenido. SUPPORTlos registros están cifrados y solo pueden ser leídos por ellos 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 salida del get-log comando
    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 salida del get-support-logs comando
    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 dispositivo de la familia Snow

Puede determinar el estado y el estado general de los dispositivos de la familia Snow con el describe-device comando.

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

                            {
  "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 los dispositivos de la familia Snow

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 salida del list-services comando
    {
  "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: para el almacenamiento compatible con Amazon S3 en dispositivos Snow Family, este estado indica que uno o más discos o dispositivos del clúster están inactivos. El almacenamiento compatible con Amazon S3 en dispositivos Snow Family funciona ininterrumpidamente, pero debe recuperar o reemplazar el dispositivo afectado antes de que se pierda el cuó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 salida del describe-service comando
    
{
  "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 Salida de servicio de almacenamiento compatible con Amazon S3 en dispositivos Snow Family

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

    
{
  "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 los dispositivos de la familia Snow

Para ver el estado de las funciones disponibles en un dispositivo de la familia Snow, 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 salida del describe-features comando

{
  "RemoteManagementState" : String
}

Configuración de servidores horarios para los dispositivos de la familia Snow

Puede utilizar los comandos del cliente Snowball Edge para ver la configuración actual del Network Time Protocol (NTP) y elegir un servidor o un par para proporcionar la hora. Puede utilizar los comandos del cliente Snowball Edge cuando el dispositivo esté bloqueado o desbloqueado.

Es su responsabilidad proporcionar un servidor NTP horario seguro. Para configurar los servidores NTP horarios a los que se conecta el dispositivo, utilice el update-time-servers comando.

Comprobación de las fuentes horarias de los dispositivos de la familia Snow

Para ver a qué fuentes NTP horarias está conectado actualmente el dispositivo, usa el describe-time-sources comando.

snowballEdge describe-time-sources --profile profile-name
ejemplo salida del describe-time-sources comando
{
  "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 DNS nombre o la dirección IP de la fuente horaria.

  • 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 NTP horaria 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 NTP tiempo 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 el dispositivo de la familia Snow para que utilice un NTP servidor o un parNTP.

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

El update-time-servers comando anulará la configuración anterior del servidor NTP horario.

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

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

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 NFC validación, consulteValidación de etiquetas NFC.

Uso

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

Actualización MTU del tamaño

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

nota

El MTU tamaño 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 MTU tamaños actuales de esas interfaces. Para obtener más información, consulte Visualización del estado de un dispositivo de la familia Snow.

Puede utilizar los describe-virtual-network-interface comandos descibe-direct-network-interface y para recuperar los MTU tamaños 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"
    }
}