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

# 에이전트 설치
<a name="installing-the-agent"></a>

 AWS Ground Station 에이전트는 다음과 같은 방법으로 설치할 수 있습니다.

1. CloudFormation 템플릿(권장).

1. Amazon EC2에 수동 설치

## CloudFormation 템플릿 사용
<a name="using-cloudformation-template"></a>

EC2 데이터 전송 CloudFormation 템플릿은 EC2 인스턴스에 데이터를 전송하는 데 필요한 AWS 리소스를 생성합니다. 이 CloudFormation 템플릿은 AWS Ground Station 에이전트가 사전 설치된 AWS Ground Station 관리형 AMI를 사용합니다. 그러면 생성된 EC2 인스턴스의 부팅 스크립트가 에이전트 구성 파일을 채우고 필요한 성능 조정([성능을 위해 EC2 인스턴스 튜닝](ec2-instance-performance-tuning.md))을 적용합니다.

### 1단계: AWS 리소스 생성
<a name="create-aws-resources"></a>

 AWS [ AWS Ground Station ](https://docs.aws.amazon.com/ground-station/latest/ug/examples.pbs-agent.html)리소스 스택을 생성합니다.

### 2단계: 에이전트 상태 확인
<a name="check-agent-status"></a>

기본적으로 에이전트가 구성되고 활성 상태입니다(시작됨). 에이전트 상태를 확인하려면 EC2 인스턴스(SSH 또는 SSM 세션 관리자)에 연결하고 [AWS Ground Station 에이전트 상태](managing-agent.md#gs-agent-status)를 참조하세요.

## EC2에 수동으로 설치
<a name="manually-install-ec2"></a>

 Ground Station에서는 CloudFormation 템플릿을 사용하여 AWS 리소스를 프로비저닝할 것을 권장하지만, 표준 템플릿으로는 충분하지 않은 사용 사례가 있을 수 있습니다. 이러한 경우에는 필요에 맞게 템플릿을 사용자 지정하는 것이 좋습니다. 그래도 요구 사항을 충족하지 않는 경우 AWS 리소스를 수동으로 생성하여 에이전트를 설치할 수 있습니다.

### 1단계: AWS 리소스 생성
<a name="create-aws-resources"></a>

 연락처에 필요한 AWS 리소스를 수동으로 설정하는 지침은 [ 미션 프로파일 구성 예제](https://docs.aws.amazon.com/ground-station/latest/ug/examples.html)를 참조하세요.

**AwsGroundStationAgentEndpoint** 리소스는 AWS Ground Station 에이전트를 통해 DigIF 데이터 흐름을 수신하기 위한 엔드포인트를 정의하며 성공적인 연락을 취하는 데 매우 중요합니다. API 설명서는 [API 참조](https://docs.aws.amazon.com/ground-station/latest/APIReference/Welcome.html)에 있지만이 섹션에서는 AWS Ground Station 에이전트와 관련된 개념을 간략하게 설명합니다.

 엔드포인트의 `ingressAddress`는 AWS Ground Station 에이전트가 안테나에서 AWS KMS 암호화된 UDP 트래픽을 수신하는 곳입니다. `socketAddress` `name`는 연결된 EIP에서 가져온 EC2 인스턴스의 퍼블릭 IP입니다. `portRange`는 다른 용도로 예약된 범위 내의 연속 포트는 300개 이상이어야 합니다. 자세한 내용은 [수신 포트 예약 - 네트워크에 영향을 미칩니다.](ec2-instance-performance-tuning.md#reserve-ingress-ports) 섹션을 참조하세요. 이러한 포트는 수신기 인스턴스가 실행 중인 VPC의 보안 그룹에서 UDP 수신 트래픽을 허용하도록 구성해야 합니다.

 엔드포인트의 `egressAddress`는 에이전트가 DigIF 데이터 흐름을 사용자에게 전달하는 곳입니다. 이 위치에 UDP 소켓을 통해 데이터를 수신하는 애플리케이션(예: SDR)이 있어야 합니다.

### 2단계: EC2 인스턴스 생성
<a name="create-ec2-instance"></a>

지원되는 AMI는 다음과 같습니다.

1. AWS Ground Station AMI - `groundstation-al2-gs-agent-ami-*` 여기서 \*는 AMI가 빌드된 날짜이며 에이전트가 설치된 상태로 제공됩니다(권장).

1. `amzn2-ami-kernel-5.10-hvm-x86_64-gp2`.

### 3단계: 에이전트 다운로드 및 설치
<a name="download-install-agent"></a>

**참고**  
 이전 단계에서 AWS Ground Station 에이전트 AMI를 선택**하지** 않은 경우이 섹션의 단계를 완료해야 합니다.

#### 에이전트 다운로드
<a name="download-agent"></a>

 AWS Ground Station 에이전트는 리전별 S3 버킷에서 사용할 수 있으며 AWS 명령줄(CLI)을 사용하여 지원되는 EC2 인스턴스에 다운로드할 수 있습니다. 에이전트의 최신 버전을 실행하려면 항상 `latest` 경로에서를 다운로드하는 것이 좋습니다. 다운로드 경로는 ${AWS::Region}`s3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/amazon_linux_2_x86_64/aws-groundstation-agent.rpm`이 지원되는 [ AWS Ground Station 콘솔 및 데이터 전송 리전 중 하나를 참조하는 곳입니다](https://docs.aws.amazon.com/ground-station/latest/ug/aws-ground-station-antenna-locations.html).

**참고**  
 다운로드 스크립트에서 특정 버전 번호를 하드 코딩하는 대신 항상 `latest` 경로를 사용합니다. `latest` 경로를 사용하면 인스턴스가 프로비저닝될 때 보안 패치 및 버그 수정을 자동으로 수신할 수 있습니다.

 예: 로컬 AWS 리전 us-east-2에서 /tmp 폴더로 최신 rpm 버전을 다운로드합니다.

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

 문제 해결 또는 롤백을 위해 특정 버전의 AWS Ground Station 에이전트를 다운로드해야 하는 경우 S3 버킷의 버전별 폴더에서 다운로드할 수 있습니다. 정상 작동에는 권장되지 않습니다.

 예: 로컬로 AWS 리전 us-east-2에서 /tmp 폴더로 rpm 버전 1.0.2716.0을 다운로드합니다.

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

**참고**  
다운로드한 RPM이에서 판매되었는지 확인하려면의 지침을 AWS Ground Station따르세요[RPM 설치 검증](rpm-install-validation.md).

#### 에이전트 설치
<a name="install-agent"></a>

```
sudo yum install ${MY_RPM_FILE_PATH}

Example: Assumes agent is in the "/tmp" directory
sudo yum install /tmp/aws-groundstation-agent.rpm
```

### 4단계: 에이전트 구성
<a name="configure-agent"></a>

 에이전트를 설치한 후 에이전트 구성 파일을 업데이트해야 합니다. [에이전트 구성](configuring-agent.md)을(를) 참조하세요.

### 5단계: 성능 조정 적용
<a name="apply-performance-tuning"></a>

 **AWS Ground Station 에이전트 AMI**: 이전 단계에서 AWS Ground Station 에이전트 AMI를 선택한 경우 다음 성능 튜닝을 적용합니다.
+  [하드웨어 인터럽트 및 수신 대기열 튜닝 - CPU 및 네트워크에 영향을 미칩니다.](ec2-instance-performance-tuning.md#tune-hardware-interrupts) 
+ [수신 포트 예약 - 네트워크에 영향을 미칩니다.](ec2-instance-performance-tuning.md#reserve-ingress-ports)
+ [재부팅](ec2-instance-performance-tuning.md#reboot)

 **기타 AMI**: 이전 단계에서 다른 AMI를 선택한 경우 [성능을 위해 EC2 인스턴스 튜닝](ec2-instance-performance-tuning.md)에 나열된 모든 조정을 적용하고 인스턴스를 재부팅합니다.

### 6단계: 에이전트 관리
<a name="manage-agent"></a>

 에이전트 상태를 시작, 중지 및 확인하려면 [에이전트 관리](managing-agent.md)을 참조하세요.