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 de resultados.

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

Cada vez que ejecute un comando para el cliente de Snowball Edge, debe proporcionar el archivo de manifiesto, el código de desbloqueo y una dirección IP. Puede obtener los dos primeros en la administración de trabajos Consola de administración de la familia de productos Snow de AWS o en la administración de trabajos. API 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 conexión como un perfil. Tras la configuración, puede utilizar otros comandos del cliente de Snowball Edge sin tener que escribir manualmente estos valores para un trabajo determinado. 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-.config

El punto de conexión es la dirección IP, a la que se añade https://. Puede localizar la dirección IP del dispositivo en la AWS Snowcone pantalla del AWS Snowcone dispositivoLCD. Cuando el AWS Snowcone dispositivo se conecta a la red por primera vez, obtiene automáticamente una dirección DHCP IP, si hay un DHCP servidor disponible. Si desea utilizar una dirección IP diferente, puede cambiarla desde la LCD pantalla. Para obtener más información, consulte Uso de AWS los servicios en AWS Snowcone.

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

Configuration will be stored at home directory\.aws\snowball\config\snowball-.config
Snowcone  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. Para obtener más información sobre varios AWS CLI perfiles, consulte Perfiles con nombre en la Guía del AWS Command Line Interface usuario.

Obtener su código QR para su NFC validación

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

Uso

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

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

Desbloquear un dispositivo AWS Snowcone

Para desbloquear un AWS Snowcone dispositivo independiente, ejecute el snowballEdge unlock-device comando. Estos comandos autentican su acceso al AWS Snowcone dispositivo.

Al ejecutar uno de estos comandos de desbloqueo, puede introducir manualmente la ruta al archivo de manifiesto, el código de desbloqueo de 29 caracteres y la dirección IP del dispositivo independiente. Este proceso puede resultar tedioso, por lo que le recomendamos que configure en su lugar el cliente de Snowball Edge. Si ya ha configurado el cliente de Snowball Edge, solo tiene que introducir el comando propiamente dicho sin la ruta al manifiesto, el código de desbloqueo ni la dirección IP.

Uso (cliente de Snowball Edge configurado)

snowballEdge unlock-device

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

Actualización de un dispositivo Snowcone

Los siguientes comandos pueden utilizarse para descargar e instalar actualizaciones de un dispositivo Snowcone. Para obtener información sobre los procedimientos que utilizan estos comandos, consulte Actualización de un dispositivo Snowcone .

snowballEdge check-for-updates: devuelve información sobre la versión del software de Snowball disponible en la nube, así como la versión actual instalada en el dispositivo.

Uso (cliente de Snowball Edge configurado)

snowballEdge check-for-updates

Latest version: 102
Installed version: 101

snowballEdge describe-device-software: devuelve la versión actual del software 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:

Uso (cliente de Snowball Edge configurado)

snowballEdge describe-device-software

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

snowballEdge download-updates: inicia la descarga de las actualizaciones de software más recientes para el dispositivo Snowcone.

Uso (cliente de Snowball Edge configurado)

snowballEdge download-updates

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

snowballEdge install-updates: inicia la instalación de las actualizaciones de software más recientes para el dispositivo Snowcone que ya se habían descargado.

Uso (cliente de Snowball Edge configurado)

snowballEdge install-updates

Installation started.

snowballEdge reboot-device: reinicia el dispositivo.

Uso (cliente de Snowball Edge configurado)

snowballEdge reboot-device

Rebooting device now.

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

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

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 de Snowball Edge configurado)

snowballEdge describe-auto-update-strategies

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

Con los comandos snowballEdge list-access-keys y snowballEdge get-secret-access-key, puede obtener sus credenciales locales. Los usa para autenticar sus solicitudes cuando usa o con un. AWS CLI AWS SDK Estas credenciales están asociadas exclusivamente con un único trabajo de Snowcone y solo se pueden utilizar en el dispositivo. El dispositivo no tiene ningún permiso AWS Identity and Access Management (IAM) en el Nube de AWS.

Para obtener más información, consulte AWS las credenciales y el uso de Amazon EC2 Endpoint.

Uso (cliente de Snowball Edge configurado)

snowballEdge list-access-keys

{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Uso (cliente de Snowball Edge configurado)

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

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

Inicio de un servicio en su dispositivo Snowcone

Snowcone admite varios servicios, incluidas las instancias de procesamiento, la interfaz de NFS archivosEC2, Amazon y. AWS DataSync Puede iniciar estos servicios con el comando snowballEdge start-service. 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 enlazar al servicio que va a iniciar. Para obtener más información, consulte Creación de una interfaz de red virtual.

Uso (cliente de Snowball Edge configurado)

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

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

Detención de un servicio en su dispositivo Snowcone

Para detener un servicio que se está ejecutando en su dispositivo Snowcone, puede usar el comando snowballEdge stop-service. Los EC2 servicios de Amazon no se pueden detener.

Uso (cliente de Snowball Edge configurado)

snowballEdge stop-service --service-id service_id

Stopping the AWS service on your Snowball . 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 dispositivo Snowcone, utilice la NFS interfaz o. AWS DataSync Si desbloquea el dispositivo Snowcone con otra dirección IP, se genera un certificado nuevo y el antiguo ya no se puede utilizar con el punto de conexión. Puede obtener un nuevo certificado actualizado para el dispositivo Snowcone mediante el comando get-certificate.

Es posible obtener un listado de estos certificados y descargarlos desde su dispositivo Snowcone con los siguientes comandos:

AWS Snowcone Registros

Al transferir datos entre el centro de datos en las instalaciones y un dispositivo Snowcone, 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:

Obtención del estado de los dispositivos

Puede determinar el estado y la situación general de sus dispositivos Snowcone con los siguientes comandos del cliente de Snowball Edge:

Obtención del estado de los servicios

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

Lanzando el AWS DataSync AMI

Lánzalo AWS DataSync AMI en Snowcone.

Uso (cliente de Snowball Edge configurado)

AWS DataSync debe lanzarse con el tipo de snc1.medium instancia. El lanzamiento DataSync con un tipo de instancia diferente puede provocar una operación inestable y una posible pérdida de datos. Utilice el comando describe-images para buscar la imagen desde la que se va a lanzar una instancia. El resultado es similar al siguiente.

{
  "ImageId": "s.ami-0c046f119de4f752f",
  "Public": false,
  "State": "AVAILABLE",
  "BlockDeviceMappings": [
    {
      "DeviceName": "/dev/sda",
      "Ebs": {
        "DeleteOnTermination": true,
        "Iops": 0,
        "SnapshotId": "s.snap-0d7558ce444ab09bf",
        "VolumeSize": 20,
        "VolumeType": "sbp1"
      }
    }
  ],
  "Description": "AWS DataSync AMI for online data transfer",
  "EnaSupport": false,
  "Name": "scn-datasync-ami",
  "RootDeviceName": "/dev/sda"
}

aws ec2 describe-instances --endpoint http://${snowcone_ip}:8008

{
    "Reservations": [
        {
            "Instances": [
                {
                    "AmiLaunchIndex": 0,
                    "ImageId": "s.image id",
                    "InstanceId": "s.instance id",
                    "InstanceType": "snc1.medium",
                    "LaunchTime": "2020-03-06T18:58:36.609Z",
                    "PrivateIpAddress": "ip address",
                    "State": {
                        "Code": 16,
                        "Name": "running"
                    },
                    "BlockDeviceMappings": [
                        {
                            "DeviceName": "/dev/sda",
                            "Ebs": {
                                "AttachTime": "2020-03-06T19:14:21.336Z",
                                "DeleteOnTermination": true,
                                "Status": "attached",
                                "VolumeId": "s.volume id"
                            }
                        }
                    ],
                    "EbsOptimized": false,
                    "EnaSupport": false,
                    "RootDeviceName": "/dev/sda",
                    "SecurityGroups": [
                        {
                            "GroupName": "default",
                            "GroupId": "s.security group id"
                        }
                    ],
                    "SourceDestCheck": false,
                    "CpuOptions": {
                        "CoreCount": 2,
                        "ThreadsPerCore": 1
                    }
                }
            ],
            "ReservationId": "s.r-80c8ee6b041b29eb4"
        },
    ]
}

Ejecución de la instancia.

aws ec2 run-instances --image-id s.ami id \--instance-type snc1.medium --endpoint http://${snowcone_ip}:8008

{
    "Instances": [
        {
            "AmiLaunchIndex": 0,
            "ImageId": "s.ami-0623310b494365cc5",
            "InstanceId": "s.i-80c8ee6b041b29eb4",
            "InstanceType": "snc1.medium",
            "State": {
                "Code": 0,
                "Name": "pending"
            },
            "EbsOptimized": false,
            "EnaSupport": false,
            "RootDeviceName": "/dev/sda",
            "SecurityGroups": [
                {
                    "GroupName": "default",
                    "GroupId": "s.sg-80c8ee6b041b29eb4"
                }
            ],
            "SourceDestCheck": false,
            "CpuOptions": {
                "CoreCount": 2,
                "ThreadsPerCore": 1
            }
        }
    ],
    "ReservationId": "s.r-80c8ee6b041b29eb4"
}

Iniciar NFS y restringir el acceso

Comience NFS con el snowballEdge start-service comando. Para obtener el identificador de NFS servicio del servicio, puede usar el snowballEdge list-services comando.

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. Puede restringir el acceso a los recursos compartidos de archivos y a los datos de sus buckets de Amazon S3 y ver qué restricciones existen actualmente. Para ello, asigne CIDR bloques a los hosts permitidos que puedan acceder a su recurso compartido de archivos y a los depósitos de S3 al iniciar el NFS servicio.

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

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 NFS recursos compartidos cuando NFS está en ejecución

Puede restringir el acceso a los archivos compartidos y a los datos de sus buckets de Amazon S3 una vez que haya empezadoNFS. Puede ver las restricciones que están vigentes actualmente y asignar diferentes restricciones de acceso a cada bucket. Para ello, debe asignar CIDR bloques a los hosts que pueden acceder a su recurso compartido de archivos y a los depósitos de S3 al iniciar el servicio. NFS El siguiente comando es un ejemplo.

Uso (cliente de 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 el comando describe-service.

 snowballEdge describe-service --service-id nfs

Obtención de la ruta de exportación de un bucket de Amazon S3

No hay ningún comando específico de Snowcone para obtener la ruta de exportación de un bucket de Amazon S3. El formato de la ruta de exportación tiene el aspecto siguiente.

/buckets/bucket-name.

Habilitar la depuración por parte de operadores locales AWS

Uso (cliente de Snowball Edge configurado)

snowballEdge enable-local-aws-operator-debugging

Desactivación de la depuración por parte de operadores locales AWS

Uso (cliente de Snowball Edge configurado)

snowballEdge disable-local-aws-operator-debugging

Creación de una interfaz de red directa

Uso (cliente de Snowball Edge configurado)

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]

Obtención de información sobre una interfaz de red directa

Uso (cliente de Snowball Edge configurado)

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

Actualización de una interfaz de red directa

Uso (cliente de Snowball Edge configurado)

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

Uso (cliente de Snowball Edge configurado)

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

Comprobación del estado de las características

Para ver el estado de las funciones disponibles en su dispositivo AWS Snow Device Management, incluidas las que le permiten gestionar el dispositivo Snowcone y los AWS servicios locales de forma remota, utilice el describe-features comando.

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

Uso (cliente de Snowball Edge configurado)

snowballEdge describe-features 
--manifest-file manifest.bin path 
--unlock-code unlock-code 
--endpoint https://device-local-ip:9091

Ejemplo de salida

{
  "RemoteManagementState" : String
}
            

Cambio del estado de las características

Para cambiar el estado de las funciones disponibles en el AWS Snowcone dispositivo, usa el set-features comando. Para activar o desactivar AWS Snow Device Management, lo que le permite gestionar su dispositivo Snowcone y los AWS servicios locales de forma remota, utilice el --remote-management-state parámetro. El dispositivo debe estar desbloqueado antes de ejecutar este comando.

Puede configurar Snow Device Management en los siguientes estados:

Uso (cliente de Snowball Edge configurado)

snowballEdge set-features
--remote-management-state INSTALLED_AUTOSTART
--manifest-file ./JID2bf11d5a-fict-414a-b5b1-3bf7e6a6e83d_manifest.bin
--unlock-code 73bb0-f8ke1-69a4a-f4288-4f88d
--endpoint https://10.0.0.25

Ejemplo de salida

{
  "RemoteManagementState" : "INSTALLED_AUTOSTART"
}
            

Configuración de servidores de tiempo

Puede configurar un servidor externo de protocolo de tiempo de red (Network Time ProtocolNTP). Puede utilizar los NTP CLI comandos cuando el dispositivo esté bloqueado o desbloqueado. Se necesitan el manifiesto y el código de desbloqueo. Puede configurarlos con el comando snowballEdge configure o con las opciones --manifest-file y --unlock-code. Ten en cuenta que puedes usarlos tanto snowballEdge CLI en AWS Snowcone Edge como en. AWS Snowcone

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 CLI comando.

Uso

snowballEdge update-time-servers time.google.com

Updating time servers now.

Comprobación de las fuentes de tiempo

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

Uso

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

Una fuente NTP horaria 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.