翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# エージェントのインストール
<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`.

### ステップ 2: エージェントをダウンロードしてインストールする
<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` パスを使用すると、インスタンスはプロビジョニング時にセキュリティパッチとバグ修正を自動的に受信します。

 例: 最新の 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 バケット内のバージョン固有のフォルダからダウンロードできます。これは通常のオペレーションでは推奨されません。

 例: rpm のバージョン 1.0.2716.0 を 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)
+ [リブート](ec2-instance-performance-tuning.md#reboot)

 **その他の AMI**: 前のステップで他の AMI を選択した場合は、「[EC2 インスタンスのパフォーマンスを調整する](ec2-instance-performance-tuning.md)」に記載されているすべてのチューニングを適用し、インスタンスを再起動します。

### ステップ 6: エージェントを管理する
<a name="manage-agent"></a>

 エージェントの起動、停止、およびステータスの確認については、「[エージェントを管理する](managing-agent.md)」を参照してください。