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.

nota

O AWS Snowcone dispositivo usa os mesmos CLI comandos do Snowball Edge, mas não oferece suporte a comandos que se apliquem ao agrupamento.

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 no Console de Gerenciamento da família AWS Snow ou no gerenciamento de tarefasAPI. 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 cliente Snowball Edge, as informações são salvas em formato de texto simples JSON no. 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 LCD tela do AWS Snowcone dispositivo. Quando o AWS Snowcone dispositivo é conectado à sua rede pela primeira vez, ele obtém automaticamente um endereço DHCP IP, se houver um DHCP servidor disponível. Se você quiser usar um endereço IP diferente, poderá alterá-lo na LCD tela. Para obter mais informações, consulte Usando AWS serviços em AWS Snowcone.

Importante

Qualquer pessoa que possa acessar o arquivo de configuração poderá acessar os dados no seu dispositivo do Snowcone. Gerenciar o controle de acesso local a este arquivo é uma das suas responsabilidades administrativas.

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

exemplo Exemplos de resultado

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.

Obtendo seu 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 NFC validação, consulteValidação de tags NFC.

Uso

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

exemplo Exemplos de resultado

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.

nota

Para desbloquear o dispositivo associado ao seu trabalho, ele deve estar no local, ligado e conectado à rede e à alimentação. Além disso, a LCD tela na parte frontal do AWS Snowcone dispositivo deve indicar que o dispositivo está pronto para uso.

Uso (Snowball Edge Client configurado)

snowballEdge unlock-device

exemplo Desbloquear saída

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

exemplo Exemplos de resultado

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:

• NA: nenhuma atualização de software está em andamento no momento.

• Downloading: novo software está sendo obtido por download.

• Installing: novo software está sendo instalado.

• Requires Reboot: novo software foi instalado, e o dispositivo deve ser reiniciado.

  Atenção

  É altamente recomendável suspender todas as atividades no dispositivo antes de reiniciá-lo. A reinicialização de um dispositivo interrompe a execução de instâncias e interrompe qualquer gravação nos buckets do Amazon S3 no dispositivo. Todos esses processos podem resultar em perda de dados.

Uso (Snowball Edge Client configurado)

snowballEdge describe-device-software

exemplo Exemplos de resultado

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

exemplo Exemplos de resultado

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

exemplo Exemplos de resultado

Installation started.

snowballEdge reboot-device: reinicia o dispositivo.

Atenção

É altamente recomendável suspender todas as atividades no dispositivo antes de reiniciá-lo. A reinicialização de um dispositivo interrompe a execução de instâncias e interrompe qualquer gravação nos buckets do Amazon S3 no dispositivo. Todos esses processos podem resultar em perda de dados.

Uso (Snowball Edge Client configurado)

snowballEdge reboot-device

exemplo Exemplos de resultado

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]

exemplo Exemplos de resultado

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

exemplo Exemplos de resultado

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 AWS Identity and Access Management (IAM) permissão no Nuvem AWS.

Para obter mais informações, consulte AWS as credenciais e o uso do Amazon EC2 Endpoint.

nota

Se você estiver usando o AWS CLI com o Snowball, deverá usar essas credenciais ao configurar o. CLI Para obter informações sobre como configurar credenciais para oCLI, consulte Configuração rápida no Guia do AWS Command Line Interface usuário.

Uso (Snowball Edge Client configurado)

snowballEdge list-access-keys

exemplo Exemplos de resultado

{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

Uso (Snowball Edge Client configurado)

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

exemplo Exemplos de resultado

[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 NFS arquivos, 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 obter 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

exemplo Exemplos de resultado

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 EC2 serviços da Amazon não podem ser interrompidos.

Atenção

A perda de dados pode ocorrer se a interface de arquivos for interrompida antes que os dados em buffer restantes sejam gravados no dispositivo.

Uso (Snowball Edge Client configurado)

snowballEdge stop-service --service-id service_id

exemplo Exemplos de resultado

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 NFS interface 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:

• list-certificates— Lista os nomes de recursos da Amazon (ARNs) para os certificados disponíveis para uso.

  Uso (Snowball Edge Client configurado)

  snowballEdge list-certificates

  exemplo Exemplos de resultado

  {
    "Certificates" : [ {
      "CertificateArn" : "arn:aws:snowball-device:::certificate/78EXAMPLE516EXAMPLEf538EXAMPLEa7",
      "SubjectAlternativeNames" : [ "192.0.2.0" ]
    } ]
  }
                          

• get-certificate— Obtém um certificado específico, com base no ARN fornecido.

  Uso (Snowball Edge Client configurado)

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

  exemplo Exemplos de resultado

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

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:

• list-logs— Retorna uma lista de registros em JSON formato. Essa lista relata o tamanho dos registros em bytes, o ARN tamanho dos registros, o ID do serviço dos registros e o tipo de registros.

  Uso (Snowball Edge Client configurado)

  snowballEdge list-logs

  exemplo Exemplos de resultado

  {
    "Logs" : [ {
      "LogArn" : "arn:aws:snowball-device:::log/s3-storage-JIEXAMPLE2f-1234-4953-a7c4-dfEXAMPLE709",
      "LogType" : "SUPPORT",
      "ServiceId" : "datasync",
      "EstimatedSizeBytes" : 53132614
    }, {
      "LogArn" : "arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709",
      "LogType" : "CUSTOMER",
      "ServiceId" : "nfs",
      "EstimatedSizeBytes" : 4446
    }]
  }
  
  

• get-log— Faz o download de uma cópia de um registro específico do dispositivo Snowcone para o seu servidor em um caminho especificado. CUSTOMERos registros são salvos no .zip formato e você pode extrair esse tipo de registro para visualizar seu conteúdo. SUPPORTos registros são criptografados e só podem ser lidos por AWS Support engenheiros. Você tem a opção de especificar um nome e um caminho para o log.

  Uso (Snowball Edge Client configurado)

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

  exemplo Exemplos de resultado

  Logs are being saved to download/path/snowball--logs-1515EXAMPLE88.bin
  

• get-support-logs: faz download da cópia de todos os logs de tipo SUPPORT a partir do Snowcone para o seu serviço em um caminho específico.

  Uso (Snowball Edge Client configurado)

  snowballEdge get-support-logs

  exemplo Exemplos de resultado

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

Importante

Os logs de CUSTOMER podem conter informações confidenciais sobre seus próprios dados. Para proteger essas informações potencialmente confidenciais, sugerimos que você exclua esses logs assim que concluir o uso deles.

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:

• describe-device

  Uso (Snowball Edge Client configurado)

  snowballEdge describe-device

  exemplo Exemplos de resultado

  {
    "DeviceId" : "JIDbEXAMPLE-7eed-1234-ABCD-7EXAMPLE123c",
    "UnlockStatus" : {
      "State" : "UNLOCKED"
    },
    "ActiveNetworkInterface" : {
      "IpAddress" : "192.168.1.2"
    },
    "PhysicalNetworkInterfaces" : [ {
      "PhysicalNetworkInterfaceId" : "s.ni-8bEXAMPLE5EXAMPLE",
      "PhysicalConnectorType" : "RJ45",
      "IpAddressAssignment" : "DHCP",
      "IpAddress" : "192.168.1.13",
      "Netmask" : "255.255.255.0",
      "DefaultGateway" : "192.168.1.1",
      "MacAddress" : "EX:AM:PL:E0:12:34"
    }, {
      "PhysicalNetworkInterfaceId" : "s.ni-84EXAMPLE3EXAMPLE",
      "PhysicalConnectorType" : "RJ45_2",
      "IpAddressAssignment" : "STATIC",
      "IpAddress" : "0.0.0.0",
      "Netmask" : "0.0.0.0",
      "DefaultGateway" : "192.168.1.1",
      "MacAddress" : "EX:AM:PL:E0:12:34"
    }, {
      "PhysicalNetworkInterfaceId" : "s.ni-87EXAMPLE5EXAMPLE",
      "PhysicalConnectorType" : "WIFI",
      "IpAddressAssignment" : "STATIC",
      "IpAddress" : "0.0.0.0",
      "Netmask" : "0.0.0.0",
      "DefaultGateway" : "192.168.1.1",
      "MacAddress" : "EX:AM:PL:E0:12:34"
    } ],
    "DeviceCapacities" : [ {
      "Name" : "HDD Storage",
      "Unit" : "Byte",
      "Total" : 157242114048,
      "Used" : 81604378624,
      "Available" : 75637735424
    }, {
      "Name" : "SSD Storage",
      "Unit" : "Byte",
      "Total" : 0,
      "Used" : 0,
      "Available" : 0
    }, {
      "Name" : "vCPU",
      "Unit" : "Number",
      "Total" : 3,
      "Used" : 3,
      "Available" : 0
    }, {
      "Name" : "Memory",
      "Unit" : "Byte",
      "Total" : 5368709120,
      "Used" : 5368709120,
      "Available" : 0
    }, {
      "Name" : "GPU",
      "Unit" : "Number",
      "Total" : 0,
      "Used" : 0,
      "Available" : 0
    } ],
    "DeviceType" : "SNC1_HDD"
  }

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.

• list-services

  Uso (Snowball Edge Client configurado)

  snowballEdge list-services

  exemplo Exemplos de resultado

  {
    "ServiceIds" : [ "nfs", "datasync", "ec2" ]
  }
  

• describe-service

  Esse comando retorna um valor de status para um serviço. Ele também inclui informações de estado que podem ser úteis ao resolver problemas encontrados no serviço. Esses estados são os seguintes.

  • ACTIVE – o serviço está em execução e disponível para o uso.

  • ACTIVATING – o serviço está iniciando, mas ainda não está disponível para o uso.

  • DEACTIVATING – o serviço está no processo de desligamento.

  • INACTIVE – o serviço não está em execução e não está disponível para o uso.

  Uso (Snowball Edge Client configurado)

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

  exemplo Exemplos de resultado

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

Lançando o AWS DataSync AMI

Inicie o 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

exemplo Exemplos de resultado

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

exemplo Exemplos de resultado

{
    "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 NFS e restringindo o acesso

Importante

Não inicie o NFS serviço se você pretende usar o Amazon Elastic Block Store (AmazonEBS). Na primeira vez em NFS que é iniciado, todo o armazenamento é alocado paraNFS. Não é possível realocar o NFS armazenamento para a AmazonEBS, mesmo que o NFS serviço seja interrompido.

nota

O espaço de armazenamento disponível no dispositivo Snowcone não é preciso até que o NFS serviço seja iniciado.

Você pode fornecer CIDR blocos para intervalos de endereços IP que tenham permissão para montar os NFS compartilhamentos expostos pelo dispositivo. Por exemplo, 10.0.0.0/16. Se você não fornecer CIDR blocos permitidos, todas as solicitações de montagem serão negadas.

Os dados transferidos NFS não são criptografados em trânsito.

Além dos hosts permitidos por CIDR blocos, o Snowcone não fornece um mecanismo de autenticação ou autorização para os NFS compartilhamentos.

Comece NFS com o snowballEdge start-service comando. Para obter o ID do NFS serviço, você pode usar o snowballEdge list-services comando.

Antes de executar esse comando, crie uma única interface de rede virtual para vincular ao serviço que está iniciando. Para obter 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 CIDR blocos 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

exemplo Exemplos de resultado

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

Restringindo o acesso aos NFS compartilhamentos quando 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 começar. 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 CIDR blocos para hosts que podem acessar seu compartilhamento de arquivos e buckets do 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

• enable-local-aws-operator-debugging— Permite que o dispositivo seja depurado pelo AWS operador local SSH abrindo a porta 22.

Uso (Snowball Edge Client configurado)

snowballEdge enable-local-aws-operator-debugging

Desativando a depuração AWS do operador local

• disable-local-aws-operator-debugging— Desativa o dispositivo para depuração AWS do operador local fechando a porta 22. SSH Por padrão, a SSH porta 22 está fechada. Quando o dispositivo Snowcone é desligado ou é desligado, a depuração do AWS operador local é desativada.

Uso (Snowball Edge Client configurado)

snowballEdge disable-local-aws-operator-debugging

Criando uma interface de rede direta

• create-direct-network-interface — Cria uma interface de rede direta (DNI). Cria uma interface de rede direta para usar com as instâncias de EC2 computação da Amazon em seu dispositivo. Você pode encontrar as interfaces de rede diretas disponíveis em seu dispositivo usando o comando describe-direct-network-interfaces.

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

• describe-direct-network-interface : obtém as interfaces de rede diretas em seu dispositivo. Uma interface de rede direta pode ser usada para configurar a rede para instâncias EC2 e serviços de computação da Amazon em seu dispositivo. Você pode criar uma nova interface de rede direta usando o comando create-direct-network-interface.

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

• update-direct-network-interface : atualiza uma interface de rede direta. Use esse comando para atualizar uma interface de rede direta que será usada com as instâncias de EC2 computação da Amazon em seu dispositivo. Você pode encontrar as interfaces de rede diretas que estão disponíveis no seu dispositivo usando o comando describe-direct-network-interfaces. Quando você estiver modificando uma interface de rede conectada a uma EC2 instância da Amazon, a interface será primeiro desanexada.

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

• delete-direct-network-interface: exclui uma interface de rede direta que não está mais em uso. Para excluir uma interface de rede direta associada à sua instância de EC2 computação da Amazon, você deve primeiro desassociar a interface de rede direta da sua instância.

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:

• INSTALLED_ONLY: o atributo está instalado, mas não ativado.

• INSTALLED_AUTOSTART— O recurso está ativado e o dispositivo tentará se conectar ao mesmo Região da AWS quando estiver ligado.

• NOT_INSTALLED: o dispositivo não suporta o atributo ou já estava em campo antes de seu lançamento.

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:

• INSTALLED_ONLY: o atributo está instalado, mas não ativado.

• INSTALLED_AUTOSTART— O recurso está ativado e o dispositivo tenta se conectar ao mesmo Região da AWS quando está ligado.

  nota

  O estado NOT_INSTALLED existe apenas para identificar dispositivos que não suportam o Snow Device Management ou que já estavam em campo antes de seu lançamento. Não é possível instalar ou desinstalar o atributo em dispositivos que já estão implantados. Para usar o Snow Device Management, você deve solicitar um novo dispositivo com o atributo pré-instalado.

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 externo do Network Time Protocol (NTP). Você pode usar os NTP CLI comandos 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 o snowballEdge CLI no AWS Snowcone Edge AWS Snowcone e.

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

nota

O update-time-servers comando substituirá as configurações anteriores dos servidores de NTP horário.

Uso

snowballEdge update-time-servers time.google.com

exemplo Exemplos de resultado

Updating time servers now.

Verificando fontes de tempo

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

Uso

snowballEdge describe-time-sources

exemplo Exemplos de resultado

{
  "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.

• Address— O DNS nome/endereço IP da fonte de horário.

• State: o status atual da conexão entre o dispositivo e essa fonte de tempo. Existem cinco estados possíveis:

  • CURRENT: a fonte de tempo está sendo usada atualmente para sincronizar a hora.

  • COMBINED: a fonte de tempo é combinada com a fonte atual.

  • EXCLUDED: a fonte de tempo é excluída pelo algoritmo de combinação.

  • LOST: a conexão com a fonte de tempo foi perdida.

  • UNACCEPTABLE: uma fonte de tempo inválida em que o algoritmo de combinação foi considerado falso ou tem muita variabilidade.

• Type— Uma fonte de NTP tempo pode ser um servidor ou um par. Os servidores podem ser configurados pelo comando update-time-servers. Os pares só podem ser outros dispositivos Snowball Edge no cluster e são configurados automaticamente quando o cluster é associado.

• Stratum: esse campo mostra o estrato da fonte. O estrato 1 indica uma fonte com um relógio de referência conectado localmente. Uma fonte sincronizada com uma fonte do estrato 1 está no estrato 2. Uma fonte sincronizada com uma fonte do estrato 2 está no estrato 3 e assim por diante.

Uma fonte de NTP tempo pode ser um servidor ou um par. 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.