

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

# Gerencie o agente
<a name="managing-agent"></a>

 O AWS Ground Station Agente fornece os seguintes recursos para configurar, iniciar, interromper, atualizar, rebaixar e desinstalar o agente usando ferramentas de comando Linux integradas. 

**Tópicos**
+ [AWS Ground Station Configuração do agente](#gs-agent-configuration)
+ [AWS Ground Station Início do agente](#gs-agent-start)
+ [AWS Ground Station Agente: parada](#gs-agent-stop)
+ [AWS Ground Station Atualização do agente](#gs-agent-upgrade)
+ [AWS Ground Station Rebaixamento do agente](#gs-agent-downgrade)
+ [AWS Ground Station Desinstalação do agente](#gs-agent-uninstall)
+ [AWS Ground Station Status do agente](#gs-agent-status)
+ [AWS Ground Station Informações de RPM do agente](#gs-agent-rpm-info)

## AWS Ground Station Configuração do agente
<a name="gs-agent-configuration"></a>

 Navegue até`/opt/aws/groundstation/etc`, que deve conter um único arquivo chamado aws-gs-agent-config .json. Consulte [Arquivo de configuração do agente](configuring-agent.md#agent-config-file) 

## AWS Ground Station Início do agente
<a name="gs-agent-start"></a>

```
#start
sudo systemctl start aws-groundstation-agent

#check status
systemctl status aws-groundstation-agent
```

Deve produzir uma saída mostrando que o agente está **ativo**.

```
aws-groundstation-agent.service - aws-groundstation-agent
Loaded: loaded (/usr/lib/systemd/system/aws-groundstation-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Tue 2023-03-14 00:39:08 UTC; 1 day 13h ago
Docs: https://aws.amazon.com/ground-station/
Main PID: 8811 (aws-gs-agent)
CGroup: /system.slice/aws-groundstation-agent.service
└─8811 /opt/aws/groundstation/bin/aws-gs-agent production
```

## AWS Ground Station Agente: parada
<a name="gs-agent-stop"></a>

```
#stop
sudo systemctl stop aws-groundstation-agent

#check status
systemctl status aws-groundstation-agent
```

 Deve produzir uma saída mostrando que o agente está **inativo** (parado). 

```
aws-groundstation-agent.service - aws-groundstation-agent
Loaded: loaded (/usr/lib/systemd/system/aws-groundstation-agent.service; enabled; vendor preset: disabled)
Active: inactive (dead) since Thu 2023-03-09 15:35:08 UTC; 6min ago
Docs: https://aws.amazon.com/ground-station/
Process: 84182 ExecStart=/opt/aws/groundstation/bin/launch-aws-gs-agent (code=exited, status=0/SUCCESS)
Main PID: 84182 (code=exited, status=0/SUCCESS)
```

## AWS Ground Station Atualização do agente
<a name="gs-agent-upgrade"></a>

1. Faça download da versão mais recente do agente. Consulte [Baixar o agente](installing-the-agent.md#download-agent).

1. Interrompa o agente.

   ```
   #stop
   sudo systemctl stop aws-groundstation-agent
   
   #confirm inactive (stopped) state
   systemctl status aws-groundstation-agent
   ```

1. Atualizar o agente.

   ```
   sudo yum update ${MY_RPM_FILE_PATH}
   
   # check the new version has been installed correctly by comparing the agent version with the starting agent version
   yum info aws-groundstation-agent
   
   # reload the systemd configuration
   sudo systemctl daemon-reload
   
   # restart the agent
   sudo systemctl restart aws-groundstation-agent
   
   # check agent status
   systemctl status aws-groundstation-agent
   ```

## AWS Ground Station Rebaixamento do agente
<a name="gs-agent-downgrade"></a>

1. Baixe a versão do agente de que você precisa. Consulte [Baixar o agente](installing-the-agent.md#download-agent).

1. Rebaixe o agente.

   ```
   # get the starting agent version
   yum info aws-groundstation-agent
   
   # stop the agent service
   sudo systemctl stop aws-groundstation-agent
   
   # downgrade the rpm
   sudo yum downgrade ${MY_RPM_FILE_PATH}
   
   # check the new version has been installed correctly by comparing the agent version with the starting agent version
   yum info aws-groundstation-agent
   
   # reload the systemd configuration
   sudo systemctl daemon-reload
   
   # restart the agent
   sudo systemctl restart aws-groundstation-agent
   
   # check agent status
   systemctl status aws-groundstation-agent
   ```

## AWS Ground Station Desinstalação do agente
<a name="gs-agent-uninstall"></a>

 A desinstalação do agente renomeará/opt/aws/groundstation/etc/aws-gs-agent-config.json to /opt/aws/groundstation/etc/aws- gs-agent-config .json.rpmsave. Instalar o agente novamente na mesma instância gravará valores padrão para aws-gs-agent-config .json e precisará ser atualizado com os valores corretos correspondentes aos seus recursos da AWS. Consulte [Arquivo de configuração do agente](configuring-agent.md#agent-config-file). 

```
sudo yum remove aws-groundstation-agent
```

## AWS Ground Station Status do agente
<a name="gs-agent-status"></a>

 O status do agente é **ativo** (o agente está em execução) ou **inativo** (o agente está parado). 

```
systemctl status aws-groundstation-agent
```

 Um exemplo de saída mostra que o agente está instalado, **inativo** (parado) e **habilitado** (inicia o serviço na inicialização). 

```
aws-groundstation-agent.service - aws-groundstation-agent
Loaded: loaded (/usr/lib/systemd/system/aws-groundstation-agent.service; enabled; vendor preset: disabled)
Active: inactive (dead) since Thu 2023-03-09 15:35:08 UTC; 6min ago
Docs: https://aws.amazon.com/ground-station/
Process: 84182 ExecStart=/opt/aws/groundstation/bin/launch-aws-gs-agent (code=exited, status=0/SUCCESS)
Main PID: 84182 (code=exited, status=0/SUCCESS)
```

## AWS Ground Station Informações de RPM do agente
<a name="gs-agent-rpm-info"></a>

```
yum info aws-groundstation-agent
```

 A saída é a seguinte: 

**nota**  
A “versão” pode ser diferente com base na versão mais recente publicada pelo agente.

```
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
Installed Packages
Name        : aws-groundstation-agent
Arch        : x86_64
Version     : 1.0.2677.0
Release     : 1
Size        : 51 M
Repo        : installed
Summary     : Client software for AWS Ground Station
URL         : https://aws.amazon.com/ground-station/
License     : Proprietary
Description : This package provides client applications for use with AWS Ground Station
```