Comandos para o Snowball Edge Client

A seguir, você encontrará informações sobre os comandos do Snowball Edge Client, incluindo exemplos de uso e exemplos de saídas.

Configurar um perfil para o Snowball Edge Client

Toda vez que você executar um comando para o Snowball Edge Client, forneça o arquivo manifesto, código de desbloqueio e um endereço IP. Você pode obter os dois primeiros na API de gerenciamento de tarefas Console de Gerenciamento da família AWS Snow ou na API de gerenciamento de tarefas. Para obter mais informações sobre como obter o código de manifesto e de desbloqueio, consulte Como obter as credenciais.

Você tem a opção de usar o comando snowballEdge configure para armazenar o caminho até o manifesto, o código de desbloqueio de 29 caracteres e o endpoint como um perfil. Após a configuração, será possível usar outros comandos do Snowball Edge Client sem precisar inserir manualmente esses valores para um trabalho específico. Depois de configurar o Snowball Edge Client, as informações serão salvas em um formato JSON de texto simples em home directory/.aws/snowball/config/snowball-.config.

O endpoint é o endereço IP, com https:// adicionado a ele. Você pode localizar o endereço IP do AWS Snowcone dispositivo na tela LCD do AWS Snowcone dispositivo. Quando o AWS Snowcone é conectado à rede pela primeira vez, ele recebe automaticamente um endereço IP DHCP, se um servidor DHCP estiver disponível. Se quiser usar um endereço IP diferente, é possível alterá-lo na tela LCD. Para ter mais informações, consulte Usando AWS serviços em AWS Snowcone.

Uso

Você pode usar esse comando de duas formas: em linha ou quando solicitado. Este exemplo de uso mostra o método solicitado.

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

Você pode ter vários perfis se tiver vários trabalhos ao mesmo tempo. Para obter mais informações sobre vários AWS CLI perfis, consulte Perfis nomeados no Guia AWS Command Line Interface do usuário.

Obter o código QR para validação NFC

Você pode usar esse comando para gerar um código QR específico do dispositivo para uso com o aplicativo de verificação do AWS Snowcone . O download pode ser feito na App Store da Apple ou na loja Google Play. Para obter mais informações sobre validação de NFC, consulte Validação de tags NFC.

Uso

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

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

Desbloqueando um dispositivo AWS Snowcone

Para desbloquear um AWS Snowcone dispositivo independente, execute o snowballEdge unlock-device comando. Esses comandos autenticam seu acesso ao AWS Snowcone dispositivo.

Ao executar um desses comandos de desbloqueio, você pode inserir manualmente o caminho para o arquivo manifesto, o código de desbloqueio de 29 caracteres e o endereço IP do seu dispositivo independente. Esse processo pode ser entediante, então recomendamos que você configure seu Snowball Edge Client em vez disso. Se você já configurou o Snowball Edge Client, só precisa inserir o comando em si sem o caminho para o manifesto, o código de desbloqueio ou o endereço IP.

Uso (Snowball Edge Client 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.

Atualizando um Snowcone

Use os comandos a seguir baixar e instalar atualizações em seu dispositivo Snowcone. Para obter os procedimentos que usam esses comandos, consulte Atualizando um Snowcone .

snowballEdge check-for-updates: retorna informações sobre a versão do software Snowball disponível na nuvem e a versão atual instalada no dispositivo.

Uso (Snowball Edge Client configurado)

snowballEdge check-for-updates

Latest version: 102
Installed version: 101

snowballEdge describe-device-software: retorna a versão atual do software do dispositivo. Além disso, se a atualização estiver sendo obtida por download, o estado do download também será exibido. Se uma atualização de software estiver em andamento, o manifesto de atualização da versão e o estado da instalação também serão exibidos. Uma lista das saídas possíveis é mostrada a seguir:

Uso (Snowball Edge Client configurado)

snowballEdge describe-device-software

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

snowballEdge download-updates: inicia o download das atualizações mais recentes do Snowcone.

Uso (Snowball Edge Client configurado)

snowballEdge download-updates

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

snowballEdge install-updates: inicia a instalação das atualizações mais recentes do Snowcone que já foram obtidas por download.

Uso (Snowball Edge Client configurado)

snowballEdge install-updates

Installation started.

snowballEdge reboot-device: reinicia o dispositivo.

Uso (Snowball Edge Client configurado)

snowballEdge reboot-device

Rebooting device now.

snowballEdge configure-auto-update-strategies: configura uma estratégia de atualização automática.

Uso (Snowball Edge Client 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: retorna qualquer estratégia de atualização automática configurada atualmente.

Uso (Snowball Edge Client 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;
]}

Como obter as credenciais

Ao usar os comandos snowballEdge list-access-keys e snowballEdge get-secret-access-key, você pode obter suas credenciais locais. Você os usa para autenticar suas solicitações ao usar o AWS CLI ou com um AWS SDK. Essas credenciais só estão associadas a um trabalho individual para o Snowcone, e você pode usá-las apenas no dispositivo. O dispositivo não tem nenhuma permissão AWS Identity and Access Management (IAM) na Nuvem AWS.

Para obter mais informações, consulte Credenciais da AWS e Uso do endpoint do Amazon EC2.

Uso (Snowball Edge Client configurado)

snowballEdge list-access-keys

{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Uso (Snowball Edge Client configurado)

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

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

Iniciando um serviço em seu dispositivo Snowcone

O Snowcone oferece suporte a vários serviços, incluindo instâncias de computação, interface de arquivos NFS, Amazon EC2 e. AWS DataSync Você pode iniciar esses serviços com o comando snowballEdge start-service. Para obter o ID de serviço para cada serviço, use o comando snowballEdge list-services.

Antes de executar esse comando, crie uma única interface de rede virtual para vincular ao serviço que está iniciando. Para ter mais informações, consulte Criação de uma interface de rede virtual.

Uso (Snowball Edge Client 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.

Interrupção de um serviço em seu dispositivo Snowcone

Para interromper um serviço em execução no Snowcone, use o comando snowballEdge stop-service. Os serviços do Amazon EC2 não podem ser interrompidos.

Uso (Snowball Edge Client 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.

Obter certificado para transferência de dados

Para transferir dados para um dispositivo Snowcone, use a interface NFS ou. AWS DataSync Se você desbloquear seu dispositivo Snowcone com um endereço IP diferente, um novo certificado será gerado e o certificado antigo não ficará mais válido para usar com o endpoint. Obtenha o certificado novo e atualizado do Snowcone novamente usando o comando get-certificate.

Você pode listar esses certificados e fazer download deles no seu dispositivo Snowcone usando os seguintes comandos:

AWS Snowcone Registros

Quando você transferir dados entre o datacenter on-premises e um dispositivo Snowcone, os logs são gerados automaticamente. Se forem encontrados erros inesperados durante a transferência de dados para o dispositivo, use os comandos a seguir para salvar uma cópia dos logs no servidor local.

Há três comandos relacionados a logs:

Ver status do dispositivo

Você pode determinar o status e a integridade geral do seu dispositivo Snowcone usando os seguintes comandos do Snowball Edge Client:

Ver status do serviço

Você pode determinar o status e a integridade geral dos serviços que funcionam em um dispositivo Snowcone usando o comando describe-service. Você pode primeiro executar o comando list-services para ver quais serviços estão em execução.

Lançamento da AWS DataSync AMI

Inicie a AWS DataSync AMI no Snowcone.

Uso (Snowball Edge Client configurado)

AWS DataSync deve ser executado com o tipo de snc1.medium instância. A execução DataSync com um tipo de instância diferente pode resultar em uma operação instável e em uma possível perda de dados. Use o comando describe-images para encontrar a imagem a partir da qual iniciar uma instância. A saída é semelhante à seguinte.

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

Execute a instância.

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

Iniciando o NFS e restringindo o acesso

Inicie o NFS com o comando snowballEdge start-service. Para obter o ID de serviço para cada serviço, use o comando snowballEdge list-services.

Antes de executar esse comando, crie uma única interface de rede virtual para vincular ao serviço que está iniciando. Para ter mais informações, consulte Criação de uma interface de rede virtual. Você pode restringir o acesso aos seus compartilhamentos de arquivos e dados em seus buckets do Amazon S3 e ver quais restrições estão em vigor no momento. Você faz isso alocando blocos CIDR para hosts permitidos que podem acessar seu compartilhamento de arquivos e buckets do S3 quando você inicia o serviço NFS.

Uso (Snowball Edge Client 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.

Restringindo o acesso aos compartilhamentos NFS quando o NFS está em execução

Você pode restringir o acesso aos seus compartilhamentos de arquivos e dados em seus buckets do Amazon S3 depois de iniciar o NFS. Você pode ver quais restrições estão em vigor no momento e atribuir restrições de acesso diferentes a cada bucket. Você faz isso alocando blocos CIDR para hosts que podem acessar seu compartilhamento de arquivos e buckets S3 quando você inicia o serviço NFS. O comando a seguir é um exemplo.

Uso (Snowball Edge Client 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 as restrições atuais, use o comando describe-service.

 snowballEdge describe-service --service-id nfs

Obtenção do caminho de exportação para um bucket do Amazon S3

Não há um comando do Snowcone específico para obter o caminho de exportação de um bucket do Amazon S3. O formato do caminho de exportação é semelhante ao seguinte.

/buckets/bucket-name.

Habilitando a AWS depuração do operador local

Uso (Snowball Edge Client configurado)

snowballEdge enable-local-aws-operator-debugging

Desativando a depuração AWS do operador local

Uso (Snowball Edge Client configurado)

snowballEdge disable-local-aws-operator-debugging

Criando uma interface de rede direta

Uso (Snowball Edge Client 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]

Obtendo informações sobre uma interface de rede direta

Uso (Snowball Edge Client configurado)

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

Atualizando uma interface de rede direta

Uso (Snowball Edge Client 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]

Excluindo uma interface de rede direta

Uso (Snowball Edge Client configurado)

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

Verificação do status do atributo

Para listar o status dos recursos disponíveis em seu dispositivo AWS Snow Device Management, inclusive os que permitem gerenciar seu dispositivo Snowcone e AWS serviços locais remotamente, use o comando. describe-features

RemoteManagementState: indica o status do Snow Device Management e retorna um dos seguintes estados:

Uso (Snowball Edge Client configurado)

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

Exemplos de resultado

{
  "RemoteManagementState" : String
}
            

Alterar status do atributo

Para alterar o status dos recursos disponíveis no seu AWS Snowcone dispositivo, use o set-features comando. Para ativar ou desativar AWS Snow Device Management, o que permite gerenciar seu dispositivo Snowcone e AWS serviços locais remotamente, use o parâmetro. --remote-management-state O dispositivo deve estar desbloqueado antes de você executar esse comando.

Você pode definir o Snow Device Management para os seguintes estados:

Uso (Snowball Edge Client 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

Exemplos de resultado

{
  "RemoteManagementState" : "INSTALLED_AUTOSTART"
}
            

Configurando servidores de horário

Você pode configurar um servidor NTP (Network Time Protocol). Você pode usar os comandos NTP CLI quando o dispositivo está nos estados bloqueado e desbloqueado. O manifesto e o código de desbloqueio são obrigatórios. Você pode defini-las com o comando snowballEdge configure ou usando as opções --unlock-code e --manifest-file. Observe que você pode usar a snowballEdge CLI no AWS Snowcone Edge e. AWS Snowcone

É sua responsabilidade fornecer um servidor de horário NTP seguro. Para definir a quais servidores de horário NTP o dispositivo se conecta, use o comando do CLI update-time-servers.

Uso

snowballEdge update-time-servers time.google.com

Updating time servers now.

Verificando fontes de tempo

Para ver a quais fontes de horário de NTP o dispositivo está conectado atualmente, use o comando do CLI describe-time-sources para o Snowball Edge.

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

O comando describe-time-sources retorna uma lista dos estados da fonte de tempo. Cada estado da fonte de tempo contém os campos Address, State, Type e Stratum A seguir estão os significados desses campos.

Uma fonte de horário NTP pode ser um servidor ou um peer. Um servidor pode ser configurado pelo usuário com o comandoupdate-time-servers, enquanto um par só pode ser outros dispositivos Snowball Edge no cluster. No exemplo de saída, describe-time-sources é chamado em um Snowball Edge que está em um cluster de 5. A saída contém 4 pares e 1 servidor. Os pares têm um estrato de 10, enquanto o servidor tem um estrato de 1; portanto, o servidor é selecionado para ser a fonte de horário atual.