기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 에이전트 관리
<a name="managing-agent"></a>

 AWS Ground Station 에이전트는 기본 제공 Linux 명령 도구를 사용하여 에이전트를 구성, 시작, 중지, 업그레이드, 다운그레이드 및 제거하는 다음과 같은 기능을 제공합니다.

**주제**
+ [AWS Ground Station 에이전트 구성](#gs-agent-configuration)
+ [AWS Ground Station 에이전트 시작](#gs-agent-start)
+ [AWS Ground Station 에이전트 중지](#gs-agent-stop)
+ [AWS Ground Station 에이전트 업그레이드](#gs-agent-upgrade)
+ [AWS Ground Station 에이전트 다운그레이드](#gs-agent-downgrade)
+ [AWS Ground Station 에이전트 제거](#gs-agent-uninstall)
+ [AWS Ground Station 에이전트 상태](#gs-agent-status)
+ [AWS Ground Station 에이전트 RPM 정보](#gs-agent-rpm-info)

## AWS Ground Station 에이전트 구성
<a name="gs-agent-configuration"></a>

 `/opt/aws/groundstation/etc`으로 이동하세요. 이 파일에는 aws-gs-agent-config.json이라는 단일 파일이 들어 있어야 합니다. [에이전트 구성 파일](configuring-agent.md#agent-config-file) 섹션을 참조하세요 

## AWS Ground Station 에이전트 시작
<a name="gs-agent-start"></a>

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

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

에이전트가 **활성** 상태임을 보여주는 출력을 생성해야 합니다.

```
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 에이전트 중지
<a name="gs-agent-stop"></a>

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

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

 에이전트가 **비활성**(중지됨) 상태임을 나타내는 출력을 생성해야 합니다.

```
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 에이전트 업그레이드
<a name="gs-agent-upgrade"></a>

1. 에이전트의 최신 버전을 다운로드합니다. [에이전트 다운로드](installing-the-agent.md#download-agent)을(를) 참조하세요.

1. 에이전트를 중지합니다.

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

1. 에이전트 업데이트

   ```
   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 에이전트 다운그레이드
<a name="gs-agent-downgrade"></a>

1. 필요한 에이전트 버전을 다운로드하세요. [에이전트 다운로드](installing-the-agent.md#download-agent)을(를) 참조하세요.

1. 에이전트 다운로드

   ```
   # 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 에이전트 제거
<a name="gs-agent-uninstall"></a>

 에이전트를 제거하면 /opt/aws/groundstation/etc/aws-gs-agent-config.json의 이름이 /opt/aws/groundstation/etc/aws-gs-agent-config.json.rpmsave로 바뀝니다. 동일한 인스턴스에 에이전트를 다시 설치하면 aws-gs-agent-config.json의 기본값이 작성되므로 AWS 리소스에 해당하는 올바른 값으로 업데이트해야 합니다. [에이전트 구성 파일](configuring-agent.md#agent-config-file)을(를) 참조하세요.

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

## AWS Ground Station 에이전트 상태
<a name="gs-agent-status"></a>

 에이전트 상태는 **활성**(에이전트 실행 중) 또는 **비활성**(에이전트 중지됨)입니다.

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

 예제 출력에는 에이전트가 설치되어 있고, **비활성** 상태(중지됨) 및 **활성화됨**(부팅 시 서비스 시작)이 표시됩니다.

```
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 에이전트 RPM 정보
<a name="gs-agent-rpm-info"></a>

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

 출력값은 다음과 같습니다.

**참고**  
“버전”은 에이전트가 게시한 최신 버전에 따라 다를 수 있습니다.

```
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
```