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á.
# Instalar o agente do
O AWS Ground Station Agente pode ser instalado das seguintes formas:
1. CloudFormation modelo (recomendado).
1. Instalação manual no Amazon EC2.
## Use um CloudFormation modelo
O CloudFormation modelo de entrega de dados do EC2 cria os recursos necessários da AWS para entregar dados à sua instância do EC2. Esse CloudFormation modelo usa a AMI AWS Ground Station gerenciada que tem o AWS Ground Station Agente pré-instalado. Em seguida, o script de inicialização da instância EC2 criada preenche o arquivo de configuração do agente e aplica o ajuste de desempenho necessário ([Ajuste sua instância do EC2 para obter desempenho](ec2-instance-performance-tuning.md)).
### Etapa 1: criar AWS recursos
Crie sua pilha de recursos da AWS usando o modelo de [satélite de transmissão pública usando o AWS Ground Station Agent (banda larga)](https://docs.aws.amazon.com/ground-station/latest/ug/examples.pbs-agent.html).
### Etapa 2: verificar o status do agente
Por padrão, o agente está configurado e ativo (iniciado). Para verificar o status do agente, você pode se conectar à instância EC2 (SSH ou SSM Session Manager) e consultar [AWS Ground Station Status do agente](managing-agent.md#gs-agent-status).
## Instale manualmente no EC2
Embora a Ground Station recomende o uso de CloudFormation modelos para provisionar seus recursos da AWS, pode haver casos de uso em que o modelo padrão pode não ser suficiente. Nesses casos, recomendamos que você personalize o modelo de acordo com suas necessidades. Se isso ainda não atender aos requisitos, você poderá criar recursos da AWS manualmente e instalar o agente.
### Etapa 1: criar recursos da AWS
Consulte [exemplos de configurações de perfil de missão](https://docs.aws.amazon.com/ground-station/latest/ug/examples.html) para obter instruções sobre como configurar manualmente os recursos da AWS necessários para um contato.
O **AwsGroundStationAgentEndpoint**recurso define um endpoint para receber um fluxo de dados DigiF AWS Ground Station via Agent e é fundamental para obter um contato bem-sucedido. Embora a documentação da API esteja localizada na [Referência da API](https://docs.aws.amazon.com/ground-station/latest/APIReference/Welcome.html), esta seção discutirá brevemente os conceitos relevantes para o AWS Ground Station Agente.
O endpoint `ingressAddress` é onde o AWS Ground Station agente receberá tráfego UDP AWS KMS criptografado da antena. `socketAddress` `name` é o IP público da instância do EC2 (do EIP anexado). `portRange` deve ter pelo menos 300 portas contíguas em um intervalo que tenha sido reservado para qualquer outro uso. Para obter instruções, consulte [Portas de entrada de reserva - impacta a rede](ec2-instance-performance-tuning.md#reserve-ingress-ports). Essas portas devem ser configuradas para permitir o tráfego de entrada UDP no grupo de segurança da VPC em que a instância receptora está sendo executada.
O endpoint `egressAddress` é onde o agente entregará o fluxo de dados DigiF para você. Você deve ter um aplicativo (por exemplo, SDR) recebendo os dados por meio de um soquete UDP neste local.
### Etapa 2: criar uma instância do EC2
O seguinte AMIs é suportado:
1. AWS Ground Station A AMI - `groundstation-al2-gs-agent-ami-*` onde \* é a data em que a AMI foi criada - vem com o agente instalado (recomendado).
1. `amzn2-ami-kernel-5.10-hvm-x86_64-gp2`.
### Etapa 3: baixar e instalar o agente
**nota**
As etapas desta seção devem ser concluídas se você **não** tiver escolhido a AMI do AWS Ground Station agente na etapa anterior.
#### Baixar o agente
O AWS Ground Station Agente está disponível em buckets S3 específicos da região e pode ser baixado em instâncias EC2 compatíveis usando a linha de comando (CLI) da AWS. Recomendamos sempre fazer o download do `latest` caminho para garantir que você esteja executando a versão mais atual do agente. O caminho de download é `s3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/amazon_linux_2_x86_64/aws-groundstation-agent.rpm` onde $ {AWS::Region} se refere a uma das [regiões de entrega de dados e console do AWS Ground Station](https://docs.aws.amazon.com/ground-station/latest/ug/aws-ground-station-antenna-locations.html) compatíveis.
**nota**
Sempre use o `latest` caminho em vez de codificar um número de versão específico em seus scripts de download. O uso do `latest` caminho garante que suas instâncias recebam automaticamente patches de segurança e correções de bugs quando são provisionadas.
Exemplo: baixe a versão rpm mais recente da região us-east-2 da AWS localmente para a pasta /tmp.
```
aws s3 --region us-east-2 cp s3://groundstation-wb-digif-software-us-east-2/aws-groundstation-agent/latest/amazon_linux_2_x86_64/aws-groundstation-agent.rpm /tmp
```
Se precisar baixar uma versão específica do AWS Ground Station Agente para fins de solução de problemas ou reversão, você pode baixá-la da pasta específica da versão no bucket do S3. Isso não é recomendado para operações normais.
Exemplo: baixe a versão rpm 1.0.2716.0 da região us-east-2 da AWS localmente para a pasta /tmp.
```
aws s3 --region us-east-2 cp s3://groundstation-wb-digif-software-us-east-2/aws-groundstation-agent/1.0.2716.0/amazon_linux_2_x86_64/aws-groundstation-agent.rpm /tmp
```
**nota**
Se você quiser confirmar que o RPM que você baixou foi vendido AWS Ground Station, siga as instruções para[Validação da instalação RPM](rpm-install-validation.md).
#### Instalar agente
```
sudo yum install ${MY_RPM_FILE_PATH}
Example: Assumes agent is in the "/tmp" directory
sudo yum install /tmp/aws-groundstation-agent.rpm
```
### Etapa 4: configurar o agente
Depois de instalar o agente, você deve atualizar o arquivo de configuração do agente. Consulte [Configurar o agente](configuring-agent.md).
### Etapa 5: aplicar ajuste de desempenho
**AWS Ground Station AMI do agente**: se você escolheu a AMI do AWS Ground Station agente na etapa anterior, aplique os seguintes ajustes de desempenho.
+ [Ajuste interrupções de hardware e filas de recebimento - afeta a CPU e a rede](ec2-instance-performance-tuning.md#tune-hardware-interrupts)
+ [Portas de entrada de reserva - impacta a rede](ec2-instance-performance-tuning.md#reserve-ingress-ports)
+ [Reinicializar](ec2-instance-performance-tuning.md#reboot)
**Outros AMIs**: se você escolheu qualquer outra AMI na etapa anterior, aplique todos os ajustes listados abaixo [Ajuste sua instância do EC2 para obter desempenho](ec2-instance-performance-tuning.md) e reinicie a instância.
### Etapa 6: gerenciar o agente
Para começar, pare e verifique o status do agente, consulte [Gerencie o agente](managing-agent.md).