本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 安装 代理
<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 G [round Station Agent（宽带），使用模板公共广播卫星创建您的 AWS](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` 是 EC2 实例的公共 IP（来自附加的 EIP）。`portRange` 应至少是 300 个连续的端口，并且该端口范围已从其他任何用途中预留。有关说明，请参阅[保留入口端口-影响网络](ec2-instance-performance-tuning.md#reserve-ingress-ports)：必须对这些端口进行配置，以确保接收器实例所在的 VPC 的安全组允许 UDP 入口流量。

 终端`egressAddress`是代理将digiF数据流移交给您的地方。您应该让应用程序（例如 SDR）在此位置通过 UDP 套接字接收数据。

### 步骤 2：创建 EC2 实例
<a name="create-ec2-instance"></a>

支持 AMIs 以下内容：

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`路径下载，以确保您运行的是最新版本的代理。下载路径是 `s3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/amazon_linux_2_x86_64/aws-groundstation-agent.rpm` $ {AWS::Region} 指支持的 [AWS Ground Station 控制台和数据传输区域](https://docs.aws.amazon.com/ground-station/latest/ug/aws-ground-station-antenna-locations.html)之一。

**注意**  
 请务必使用该`latest`路径，而不是在下载脚本中对特定的版本号进行硬编码。使用该`latest`路径可确保您的实例在配置时自动收到安全补丁和错误修复。

 示例：将最新 rpm 版本从 AWS 区域 us-east-2 下载到本地 /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
```

 如果您需要下载 AWS Ground Station 代理的特定版本以进行故障排除或回滚，则可以从 S3 存储桶中的特定版本文件夹中下载该代理。不建议在正常操作中使用此选项。

 示例：将 1.0.2716.0 版本 rpm 从 AWS 区域 us-east-2 下载到本地 /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
```

**注意**  
如果您想确认下载的 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)
+ [Reboot](ec2-instance-performance-tuning.md#reboot)

 **其他 AMIs**：如果您在上一步中选择了任何其他 AMI，请应用下面列出的所有调整[调整您的 EC2 实例的性能](ec2-instance-performance-tuning.md)并重启实例。

### 步骤 6：管理座席
<a name="manage-agent"></a>

 要启动、停止和检查座席状态，请参阅 [管理代理](managing-agent.md)。