As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Usando os comandos do cliente Snowball Edge
A seguir, você encontrará informações sobre os comandos do cliente Snowball Edge para uso com o dispositivo da família Snow. Cada comando inclui exemplos de uso e exemplos de saídas. O cliente Snowball Edge é um aplicativo de linha de comando autônomo que você executa em seu dispositivo para desbloquear, configurar e controlar o dispositivo da família Snow. Você também pode usar o cliente com clusters de dispositivos da família Snow. Ao usar o Snowball Edge Client, você pode obter informações de suporte adicionais executando o comando snowballEdge help
.
Para baixar o cliente Snowball Edge, consulte. Baixar e instalar o cliente do Snowball Edge
Tópicos
- Configurar um perfil para o Snowball Edge Client
- Obter o código QR para validação NFC
- Versão do Snowball Edge Client
- Desbloquear dispositivos do Snowball Edge
- Atualização de um Snowball Edge
- Como obter as credenciais
- Inicialização de um serviço no Snowball Edge
- Interrupção de um serviço no Snowball Edge
- Iniciando o NFS e restringindo o acesso
- Restringindo o acesso aos compartilhamentos NFS quando o NFS está em execução
- AWS Snowball Edge Registros
- Ver status do dispositivo
- Ver status do serviço
- Remoção de um nó a partir de um cluster
- Como adicionar um nó a um cluster
- Criar tags para o dispositivo
- Excluir tags do dispositivo
- Descrever tags no dispositivo
- Criando uma interface de rede direta
- Obter informações sobre uma interface de rede direta
- Atualizando uma interface de rede direta
- Excluindo uma interface de rede direta
- Crie uma interface de rede virtual (VNI)
- Obter informações sobre uma interface de rede virtual
- Atualizando uma interface de rede virtual
- Excluindo uma interface de rede virtual
- Verificação do status do atributo
- Configurando servidores de horário
- Verificando fontes de tempo
- Atualizando o tamanho da MTU
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 Obter credenciais para acessar um dispositivo Snow Family.
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-edge.config
O endpoint é o endereço IP, com https://
adicionado a ele. Você pode localizar o endereço IP do AWS Snowball Edge dispositivo na tela LCD do AWS Snowball Edge dispositivo. Quando o AWS Snowball Edge dispositivo é conectado à sua rede pela primeira vez, ele obtém 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 um dispositivo AWS Snowball Edge.
Importante
Qualquer pessoa que possa acessar o arquivo de configuração poderá acessar os dados nos seus dispositivos ou clusters do Snowball Edge. 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 Saída
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
Você pode ter múltiplos perfis se tiver vários trabalhos ao mesmo tempo ou se quiser a opção de gerenciar um cluster a partir de diferentes endpoints. 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 Snowball Edge. 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
exemplo Saída
QR code is saved to
~/downloads/snowball-qr-code.png
Versão do Snowball Edge Client
Use o comando version
para ver a versão do cliente da interface de linha de comando (CLI) do Snowball Edge.
Uso
snowballEdge version
Exemplo de saída
Snowball Edge client version: 1.2.0 Build 661
Desbloquear dispositivos do Snowball Edge
Para desbloquear um AWS Snowball Edge dispositivo independente, execute o snowballEdge
unlock-device
comando. Para desbloquear um cluster, use o comando snowballEdge
unlock-cluster
. Esses comandos autenticam seu acesso ao dispositivo AWS Snowball Edge .
nota
Para desbloquear os dispositivos associados ao seu trabalho, eles devem estar no local, ligados e conectados à rede e à alimentação. Além disso, o display LCD na parte frontal do AWS Snowball Edge dispositivo deve indicar que o dispositivo está pronto para uso.
Uso
snowballEdge unlock-device --endpoint
https://192.0.2.0
--manifest-filePath/to/manifest/file
--unlock-code01234-abcde-ABCDE-01234
exemplo Entrada de desbloqueio de dispositivo individual
snowballEdge unlock-device --endpoint
https://192.0.2.0
--manifest-file/usr/home/manifest.bin
--unlock-code01234-abcde-ABCDE-01234
exemplo Saída de desbloqueio de dispositivo individual
Your Snowball Edge device is unlocking. You may determine the unlock state of your device using the describe-device command. Your Snowball Edge device will be available for use when it is in the UNLOCKED state.
Uso do cluster
Ao desbloquear um cluster, forneça o endpoint para um dos seus nós, além de todos os endereços IP para os outros dispositivos no seu cluster.
snowballEdge unlock-cluster --endpoint https://192.0.2.0
--manifest-file Path/to/manifest/file
--unlock-code 01234-abcde-ABCDE-01234
--device-ip-addresses 192.0.2.0 192.0.2.1 192.0.2.2 192.0.2.3 192.0.2.4
exemplo Saída de desbloqueio de cluster
Your Snowball Edge Cluster is unlocking. You may determine the unlock state of your cluster using the describe-device command. Your Snowball Edge Cluster will be available for use when your Snowball Edge devices are in the UNLOCKED state.
Atualização de um Snowball Edge
Use os comandos a seguir para fazer download e instalar atualizações para seu dispositivo Snowball Edge. Para obter os procedimentos que usam esses comandos, consulte Atualização de software em dispositivos Snowball Edge.
snowballEdge check-for-updates
: retorna informações sobre a versão do software Snowball Edge disponível na nuvem e a versão atual instalada no dispositivo.
Uso (Snowball Edge Client configurado)
snowballEdge check-for-updates
exemplo Saída
Latest version: 102 Installed version: 101
snowballEdge describe-device-software
: retorna a versão atual do software e a data de validade do certificado SSL do dispositivo. Além disso, se a atualização do software estiver sendo baixada ou instalada, o estado do download também será exibido. 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 precisa 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 Saída
Installed version: 101 Installing version: 102 Install State: Downloading CertificateExpiry: Thur Jan 01 00:00:00 UTC 1970
snowballEdge download-updates
: inicia o download das atualizações mais recentes do Snowball Edge.
Uso (Snowball Edge Client configurado)
snowballEdge download-updates
exemplo Saída
Download started. Run describe-device-software API for additional information.
snowballEdge install-updates
: inicia a instalação das atualizações mais recentes do Snowball Edge que já foram baixadas.
Uso (Snowball Edge Client configurado)
snowballEdge install-updates
exemplo Saída
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 Saída
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-frequencyautoCheckFreq
] --auto-downloadautoDownload
[--auto-download-frequencyautoDownloadFreq
] --auto-installautoInstall
[--auto-install-frequencyautoInstallFreq
] --auto-rebootautoReboot
[--endpointendpoint
]
exemplo Saída
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 Saída
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
Usando os snowballEdge
get-secret-access-key
comandos snowballEdge list-access-keys
e, você pode obter as credenciais do usuário administrador do seu Conta da AWS no Snowball Edge. Você pode usar essas credenciais para criar AWS Identity and Access Management (usuários do IAM) e funções, além de 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 Snowball Edge, e você pode usá-las apenas no dispositivo ou cluster de dispositivos. Os dispositivos não têm permissões do IAM na Nuvem AWS.
nota
Se você estiver usando o AWS CLI com o Snowball Edge, deverá usar essas credenciais ao configurar a CLI. Para obter informações sobre como configurar credenciais para o AWS CLI, consulte Configurando o AWS CLI no Guia doAWS Command Line Interface Usuário.
Uso (Snowball Edge Client configurado)
snowballEdge list-access-keys
exemplo Saída
{ "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ] }
Uso (Snowball Edge Client configurado)
snowballEdge get-secret-access-key --access-key-id
Access Key
exemplo Saída
[snowballEdge] aws_access_key_id = AKIAIOSFODNN7EXAMPLE aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Inicialização de um serviço no Snowball Edge
Os dispositivos Snowball Edge oferecem suporte a vários serviços, além do Amazon S3. Isso inclui instâncias de computação, a interface de arquivos e. AWS IoT Greengrass O Amazon S3 e o Amazon EC2 sempre estão ativados por padrão e não podem ser interrompidos ou reiniciados com o Snowball Edge Client. No entanto, a interface do arquivo AWS IoT Greengrass pode ser iniciada com o snowballEdge start-service
comando. 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
exemplo Saída
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 no Snowball Edge
Para interromper um serviço em execução no Snowball Edge, use o comando snowballEdge stop-service
.
O adaptador Amazon S3, o Amazon EC2 e os serviços do IAM não AWS STS 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. Para obter mais informações sobre como usar a interface de arquivos, consulte Gerenciando a interface NFS.
nota
A interrupção do serviço de armazenamento compatível com o Amazon S3 em dispositivos da Família Snow desativa o acesso aos dados armazenados em seus buckets do S3 no dispositivo ou cluster. O acesso é restaurado quando o armazenamento compatível com o Amazon S3 nos dispositivos da Família Snow é reiniciado. Para dispositivos habilitados com armazenamento compatível com o Amazon S3 em dispositivos da Família Snow, é recomendável iniciar o serviço depois que o dispositivo Snowball Edge for ligado. Consulte Configuração do Snowball Edge neste guia.
Uso (Snowball Edge Client configurado)
snowballEdge stop-service --service-id service_id
exemplo Saída
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.
Iniciando o NFS e restringindo o acesso
Importante
Não inicie o serviço NFS se você pretende usar o Amazon Elastic Block Store (Amazon EBS). Na primeira vez que o NFS é iniciado, todo o armazenamento é alocado ao NFS. Não é possível realocar o armazenamento NFS para o Amazon EBS, mesmo que o serviço NFS seja interrompido.
nota
É possível fornecer blocos CIDR para intervalos de IP que têm permissão para montar os compartilhamentos do NFS expostos pelo dispositivo. Por exemplo, 10.0.0.0/16
. Se você não fornecer blocos CIDR permitidos, todas as solicitações de montagem serão negadas.
Lembre-se de que os dados transferidos por meio do NFS não são criptografados em trânsito.
Além dos hosts permitidos pelos blocos CIDR, o Snowcone não fornece nenhum mecanismo de autenticação ou de autorização para os compartilhamentos do NFS.
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 obter mais informações, consulte Como criar 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
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 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
AWS Snowball Edge Registros
Ao transferir dados entre o datacenter local e um Snowball Edge, 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 logs no formato JSON. Esta lista relata o tamanho dos logs em bytes, além do ARN, ID de serviço e tipo dos logs.Uso (Snowball Edge Client configurado)
snowballEdge list-logs
exemplo Saída
{ "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
— Faz o download de uma cópia de um registro específico do Snowball Edge para o seu servidor em um caminho especificado.CUSTOMER
os registros são salvos no.zip
formato e você pode extrair esse tipo de registro para visualizar seu conteúdo.SUPPORT
os 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 Saída
Logs are being saved to
download/path
/snowball-edge-logs-1515EXAMPLE88.bin -
get-support-logs
: baixa a cópia de todos os logs de tipoSUPPORT
a partir do Snowball Edge para o seu serviço em um caminho específico.Uso (Snowball Edge Client configurado)
Snowball Edge Client
snowballEdge get-support-logs
exemplo Saída
Logs are being saved to
download/path
/snowball-edge-logs-1515716135711.bin
Importante
O tipo CUSTOMER
pode 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 Snowball Edge usando os seguintes comandos do Snowball Edge Client:
-
describe-device
Uso (Snowball Edge Client configurado)
snowballEdge describe-device
exemplo Saída
{ "DeviceId" : "JID-EXAMPLE12345-123-456-7-890", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.0" }, "PhysicalNetworkInterfaces" : [ { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLEd9ecbf03e3", "PhysicalConnectorType" : "QSFP", "IpAddressAssignment" : "STATIC", "IpAddress" : "0.0.0.0", "Netmask" : "0.0.0.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E0:12:34", "MtuSize" : "1500" }, { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLE4c3840068f", "PhysicalConnectorType" : "SFP_PLUS", "IpAddressAssignment" : "DHCP", "IpAddress" : "192.0.2.2", "Netmask" : "255.255.255.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E0:56:78", "MtuSize" : "5743" }, { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLE0a3a6499fd", "PhysicalConnectorType" : "RJ45", "IpAddressAssignment" : "STATIC", "IpAddress" : "0.0.0.0", "Netmask" : "0.0.0.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E0:90:12", "MtuSize" : "1500" } ], "DeviceCapacities" : [ { "Name" : "HDD Storage", "Unit" : "Byte", "Total" : 39736350227824, "Available" : 39707789471744 }, { "Name" : "SSD Storage", "Unit" : "Byte", "Total" : 6979321856000, "Available" : 6884832575488 }, { "Name" : "vCPU", "Unit" : "Number", "Total" : 52, "Available" : 49 }, { "Name" : "Memory", "Unit" : "Byte", "Total" : 223338299392, "Available" : 216895848448 }, { "Name" : "GPU", "Unit" : "Number", "Total" : 0, "Available" : 0 } ], "DeviceType" : "EDGE_C" }
-
describe-cluster
Uso (Snowball Edge Client configurado)
snowballEdge describe-cluster
exemplo Saída
{ "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5", "Devices" : [ { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.0" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.1" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.2" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.3" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.4" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } } ] }
Ver status do serviço
Você pode determinar o status e a integridade geral dos serviços que funcionam nos dispositivos Snowball Edge 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 Saída
{ "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ] }
-
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. -
DEGRADED
: para armazenamento compatível com o Amazon S3 em dispositivos da Família Snow, esse status indica que um ou mais discos ou dispositivos no cluster estão inativos. O serviço de armazenamento compatível com o Amazon S3 em dispositivos da Família Snow está funcionando sem interrupções, mas você deve recuperar ou substituir o dispositivo afetado antes que o quorum do cluster seja perdido para minimizar o risco de perda de dados. Consulte a Visão geral do cluster neste guia. -
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 Saída
{ "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" } } ] }
exemplo Saída de serviço de armazenamento compatível com Amazon S3 em dispositivos da Família Snow
O
describe-service
comando fornece a seguinte saída para o valors3-snow
doservice-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" } } ] }
-
Remoção de um nó a partir de um cluster
O comando disassociate-device
remove um nó de um cluster Snowball Edge. Se você quiser substituir um nó não íntegro, use este comando. Para obter mais informações sobre clusters, consulte Visão geral do cluster neste guia.
Importante
Use o comando disassociate-device
somente quando você estiver removendo um nó não íntegro. Este comando falhará e retornará um erro se você tentar remover um nó íntegro.
Não use esse comando para remover um nó que foi desligado acidentalmente ou desconectado da rede e, portanto, está temporariamente indisponível para o resto do cluster. Os nós removidos com este comando não podem ser adicionados a nenhum cluster e devem ser retornados à AWS.
Se um nó foi acidentalmente desligado ou desconectado da rede, conecte o nó de volta à alimentação e à rede e usar o comando associate-device
. Não é possível usar o comando disassociate-device
para desassociar um nó se ele estiver ligado e for íntegro.
Uso (Snowball Edge Client configurado)
snowballEdge disassociate-device --device-id Job ID for the Device
exemplo Saída
Disassociating your Snowball Edge device from the cluster. Your Snowball Edge device will be disassociated from the cluster when it is in the "DISASSOCIATED" state. You can use the describe-cluster command to determine the state of your cluster.
Como adicionar um nó a um cluster
O comando associate-device
adiciona um nó a um cluster de dispositivos Snowball Edge. Se você desligar um nó, ele reverterá seu estado de desbloqueado para bloqueado. Para desbloquear esse nó, você pode usar este comando. Use esse comando para substituir um nó indisponível por um novo nó que você tenha solicitado como substituto. Para obter mais informações sobre clusters, consulte Visão geral do cluster neste guia.
Uso (Snowball Edge Client configurado)
snowballEdge associate-device --device-ip-address IP Address
exemplo Saída
Associating your Snowball Edge device with the cluster. Your Snowball Edge device will be associated with the cluster when it is in the ASSOCIATED state. You can use the describe-cluster command to determine the state of your cluster.
Criar tags para o dispositivo
Adiciona ou substitui as tags especificadas no dispositivo. É possível criar no máximo 50 tags. Cada tag consiste em um par de chave-valor. O valor é opcional.
nota
Não coloque dados confidenciais nas tags.
Uso (Snowball Edge Client configurado)
snowballEdge create-tags --tag Key=Name,Value=user-test --tag Key=Stage,Value=beta
Para obter mais informações, execute o comando describe-tags
.
exemplo Saída
Tag(s) [Key=Name,Value=test, Key=Stage,Value=beta] created.
Excluir tags do dispositivo
O comando delete-tags
exclui as tags especificadas do dispositivo Snowball Edge.
Uso (Snowball Edge Client configurado)
snowballEdge delete-tags --tag Key=Stage,Value=beta
Tag(s) [Key=Stage,Value=beta] deleted.
Para obter mais informações, execute o comando describe-tags
.
nota
Se você quiser excluir várias tags ao mesmo tempo, poderá especificar vários pares de chave-valor, como o seguinte:
delete-tags --tag Key=Name,Value=test --tag
Key=Stage,Value=Beta
Se você especificar uma chave de tag sem um valor de tag, qualquer tag com essa chave, independentemente de seu valor, será excluída. Se você especificar uma chave de tag com uma string vazia como o valor da tag, somente as tags que têm uma string vazia como valor serão excluídas.
Descrever tags no dispositivo
O comando describe-tags
descreve as tags no dispositivo Snowball Edge.
Uso (Snowball Edge Client configurado)
snowballEdge describe-tags
Para obter mais informações, execute o comando describe-tags
.
exemplo Saída
{ "Tags" : [ { "Key" : "Name", "Value" : "user-test" }, { "Key" : "Stage", "Value" : "beta" } ] }
Criando uma interface de rede direta
Use o create-direct-network-interface
comando para criar interfaces de rede diretas nos dispositivos da família Snow. Uma interface de rede direta (DNI) deve estar associada a uma instância de AMI. Você pode usar o vlan
parâmetro para atribuir uma ID de rede local virtual (VLAN) à interface para marcar todo o tráfego da interface com essa ID de VLAN. Além disso, você pode atribuir um endereço de controle de acesso à mídia (MAC) ao DNI com o mac
parâmetro. Se você não fornecer o mac
parâmetro e um valor, um endereço MAC será atribuído automaticamente.
Você pode usar o describe-device
comando para recuperar o ID da interface de rede física. Para ter mais informações, consulte Ver status do dispositivo.
snowballEdge create-direct-network-interface --instance-id
AMI-instance-id
--physical-network-interface-idphysical-network-interface-id
--vlanvlan-id
--macMAC-address
exemplo da saída create-direct-network-interface
do comando
{ "DirectNetworkInterface" : { "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o", "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w", "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q", "Driver" : "mlx5 core", "MacAddress" : "1A:2B:3C:4D:5E:6F", "MtuSize": "1500" } }
Obter informações sobre uma interface de rede direta
Use o describe-direct-network-interface
comando para ver informações sobre as interfaces de rede diretas em um dispositivo da família Snow.
snowballEdge describe-direct-network-interfaces --endpoint https://
snow-device-ip-address
--manifest-filepath/to/manifest/file.bin
--unlock-codeunlock-code
exemplo da saída descibe-direct-network-interfaces
do comando
{ "DirectNetworkInterface" : { "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o", "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w", "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q", "Driver" : "mlx5 core", "MacAddress" : "1A:2B:3C:4D:5E:6F", "MtuSize": "1500" } }
Atualizando uma interface de rede direta
Use o update-direct-network-interface
para alterar as propriedades de uma interface de rede direta (DNI). Quando você altera um DNI anexado a uma instância compatível com o Amazon EC2, a interface será desanexada. Para alterar a unidade de transmissão máxima (MTU) da interface física que o DNI está usando, use o comando. update-mtu-size
Para ter mais informações, consulte Atualizando o tamanho da MTU.
snowballEdge update-direct-network-interface --direct-network-interface-arn
directNetworkInterfaceArn
// --endpoint https://snow-device-ip-address
[--macmacAddress
] // --manifest-filepath/to/manifest/file.bin
--unlock-codeunlock-code
// [--vlanvlanId
] [--attach-instance-idinstanceId
| --detach]
exemplo da saída update-direct-network-interface
do comando
{ "DirectNetworkInterface" : { "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o", "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w", "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q", "Driver" : "mlx5 core", "MacAddress" : "2A:3B:5C:5D:6E:7F", "MtuSize": "1500" } }
Excluindo uma interface de rede direta
Use o delete-direct-network-interface
comando para excluir uma interface de rede direta (DNI). Para excluir um DNI associado a uma instância computacional compatível com o Amazon EC2, primeiro use o detatch
parâmetro do update-direct-network-interface
comando para separar o DNI da instância. Para ter mais informações, consulte Atualizando uma interface de rede direta.
snowballEdge delete-direct-network-interface --direct-network-interface-arn
directNetworkInterfaceArn
// --endpoint https://snow-device-ip-address
--manifest-filepath/to/manifest/file.bin
// [--profileprofile
] --unlock-codeunlock-code
exemplo da saída delete-direct-network-interface
do comando
The direct network interface has been deleted from your Snowball Edge. You can determine the direct network interfaces available on your Snowball Edge using the describe-direct-network-interfaces command.
Crie uma interface de rede virtual (VNI)
Use o create-virtual-network-interface
comando para criar interfaces de rede virtual no dispositivo Snowball Edge. Você pode usar o describe-device
comando para recuperar o ID da interface de rede física. Para ter mais informações, consulte Ver status do dispositivo.
nota
O static-ip-address-configuration
parâmetro é válido somente ao usar o STATIC
valor do ip-address-assignment
parâmetro.
snowballEdge create-virtual-network-interface --endpoint https://
ip-address-of-snow-device
--manifest-file/path/to/manifest/file.bin
--unlock-codeunlock-code
--ip-address-assignmentDHCP
orSTATIC
--physical-network-interface-id[physical network interface id]
--static-ip-address-configuration IpAddress=IP-address
,NetMask=netmask
exemplo da saída create-virtual-network-interface
do comando
{ "VirtualNetworkInterface": { "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf", "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment": "DHCP", "IpAddress": "192.0.2.0", "Netmask": "255.255.255.0", "DefaultGateway": "192.0.2.1", "MacAddress": "EX:AM:PL:E1:23:45", "MtuSize" : "1500" } }
Obter informações sobre uma interface de rede virtual
Use o describe-virtual-network-interface
comando para ver informações sobre as interfaces de rede virtual no dispositivo da família Snow.
snowballEdge describe-direct-network-interfaces --endpoint https://
ip-address-of-snow-device
--manifest-filepath/to/manifest/file.bin
--unlock-codeunlock-code
exemplo da saída descibe-virtual-network-interfaces
do comando
{ "VirtualNetworkInterface": { "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf", "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment": "DHCP", "IpAddress": "192.0.2.0", "Netmask": "255.255.255.0", "DefaultGateway": "192.0.2.1", "MacAddress": "EX:AM:PL:E1:23:45", "MtuSize" : "1500" } }
Atualizando uma interface de rede virtual
Use o update-virtual-network-interface
comando para atualizar as interfaces de rede virtual no dispositivo Snow Family. Para alterar a unidade de transmissão máxima (MTU) da interface física que o DNI está usando, use o comando. update-mtu-size
Para ter mais informações, consulte Atualizando o tamanho da MTU.
snowballEdge update-virtual-network-interface --direct-network-interface-arn
directNetworkInterfaceArn
--endpoint https://ip-address-of-snow-device
// --unlock-codeunlock-code
[--macmacAddress
] --manifest-filepath/to/manifest/file.bin
// [--vlanvlanId
] [--attach-instance-idinstanceId
| --detach]
exemplo da saída update-virtual-network-interface
do comando
{ "VirtualNetworkInterface": { "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf", "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment": "DHCP", "IpAddress": "192.0.2.9", "Netmask": "255.255.255.0", "DefaultGateway": "192.0.2.1", "MacAddress": "EX:AM:PL:E1:23:45", "MtuSize" : "1500" } }
Excluindo uma interface de rede virtual
Use o delete-direct-network-interface
comando para excluir uma interface de rede virtual (VNI).
snowballEdge delete-virtual-network-interface --virtual-network-interface-arn
virtual-network-interface-ARN
--endpoint https://endpoint
// --manifest-filepath/to/manifest/file.bin
] [--profileprofile
] --unlock-codeunlock-code
]
exemplo da saída delte-direct-network-interface
do comando
The virtual network interface has been deleted from your Snowball Edge. You can determine the virtual network interfaces available on your Snowball Edge using the describe-virtual-network-interfaces command.
Verificação do status do atributo
Para listar o status dos recursos disponíveis no seu dispositivo, use o describe-features
comando.
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-codeunlock-code
\ --endpoint https://device-local-ip
:9091
Exemplos de resultado
{ "RemoteManagementState" : String }
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
.
nota
O comando update-time-servers
substituirá as configurações anteriores dos servidores de horário NTP.
Tipos de dispositivos NTP e versões de software compatíveis
O NTP não está disponível em nenhum tipo de dispositivo de armazenamento e computação da versão 2. No entanto, os tipos de dispositivos de armazenamento e computação do Snowball Edge versão 3 com software versão 77 ou posterior oferecem suporte a NTP. Para verificar se o NTP está ativado, use o comando describe-time-sources
da CLI do Snowball Edge.
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 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
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 nome DNS/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 horário NTP pode ser um servidor ou um peer. Os servidores podem ser configurados pelo comandoupdate-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 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.
Atualizando o tamanho da MTU
Use o update-mtu-size
comando para modificar o tamanho em bytes da unidade máxima de transmissão (MTU) de uma interface física de um dispositivo da família Snow. Todas as interfaces de rede virtual e a interface de rede direta associadas a essa interface de rede física serão configuradas com o mesmo tamanho de MTU.
nota
O tamanho mínimo da MTU é 1500 bytes e o tamanho máximo é 9216 bytes.
Você pode usar o describe-device
comando para recuperar os IDs da interface de rede física e os tamanhos atuais de MTU dessas interfaces. Para ter mais informações, consulte Ver status do dispositivo.
Você pode usar os describe-virtual-network-interface
comandos descibe-direct-network-interface
e para recuperar os tamanhos atuais de MTU dessas interfaces. Para obter mais informações, consulte Obter informações sobre uma interface de rede direta e Obter informações sobre uma interface de rede virtual.
Uso
snowballEdge update-mtu-size --physical-network-interface-id
physical-network-interface-id
--mtu-sizesize-in-bytes
exemplo Exemplo da saída 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" } }