

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Installieren des Agents
<a name="installing-the-agent"></a>

Der AWS Ground Station Agent kann auf folgende Weise installiert werden: 

1. CloudFormation Vorlage (empfohlen). 

1. Manuelle Installation auf Amazon EC2.

## Verwenden Sie eine Vorlage CloudFormation
<a name="using-cloudformation-template"></a>

Die CloudFormation EC2-Datenliefervorlage erstellt die erforderlichen AWS-Ressourcen, um Daten an Ihre EC2-Instance zu liefern. Diese CloudFormation Vorlage verwendet das AWS Ground Station verwaltete AMI, auf dem der AWS Ground Station Agent vorinstalliert ist. Das Boot-Skript der erstellten EC2-Instance füllt dann die Agenten-Konfigurationsdatei auf und wendet die erforderliche Leistungsoptimierung an (). [Optimieren Sie Ihre EC2-Instance im Hinblick auf die Leistung](ec2-instance-performance-tuning.md)

### Schritt 1: Ressourcen erstellen AWS
<a name="create-aws-resources"></a>

 Erstellen Sie Ihren AWS-Ressourcenstapel mithilfe der Vorlage [Public Broadcast Satellite mithilfe von AWS Ground Station Agent (Breitband](https://docs.aws.amazon.com/ground-station/latest/ug/examples.pbs-agent.html)). 

### Schritt 2: Überprüfen Sie den Agentenstatus
<a name="check-agent-status"></a>

Standardmäßig ist der Agent konfiguriert und aktiv (gestartet). Um den Agentenstatus zu überprüfen, können Sie eine Verbindung zur EC2-Instance (SSH oder SSM Session Manager) herstellen und nachschauen. [AWS Ground Station Status des Agenten](managing-agent.md#gs-agent-status) 

## Manuell auf EC2 installieren
<a name="manually-install-ec2"></a>

 Ground Station empfiehlt zwar die Verwendung von CloudFormation Vorlagen für die Bereitstellung Ihrer AWS-Ressourcen, es kann jedoch Anwendungsfälle geben, in denen die Standardvorlage möglicherweise nicht ausreicht. In solchen Fällen empfehlen wir Ihnen, die Vorlage an Ihre Bedürfnisse anzupassen. Wenn das immer noch nicht Ihren Anforderungen entspricht, können Sie Ihre AWS-Ressourcen manuell erstellen und den Agenten installieren. 

### Schritt 1: AWS-Ressourcen erstellen
<a name="create-aws-resources"></a>

 Anweisungen zum manuellen Einrichten der AWS-Ressourcen, die für einen Kontakt erforderlich sind, finden Sie unter [Beispielkonfigurationen für Missionsprofile](https://docs.aws.amazon.com/ground-station/latest/ug/examples.html). 

Die **AwsGroundStationAgentEndpoint**Ressource definiert einen Endpunkt für den Empfang eines DigiF-Datenflusses über den AWS Ground Station Agenten und ist entscheidend für die erfolgreiche Kontaktaufnahme. Die API-Dokumentation befindet sich zwar in der [API-Referenz](https://docs.aws.amazon.com/ground-station/latest/APIReference/Welcome.html), in diesem Abschnitt werden jedoch kurz Konzepte behandelt, die für den Agenten relevant sind. AWS Ground Station 

 Auf dem Endpunkt empfängt der AWS Ground Station Agent AWS KMS verschlüsselten UDP-Verkehr von der Antenne. `ingressAddress` Das `socketAddress` `name` ist die öffentliche IP der EC2-Instance (von der angehängten EIP). Es `portRange` sollten mindestens 300 zusammenhängende Ports in einem Bereich sein, der für jegliche andere Nutzung reserviert wurde. Detaillierte Anweisungen finden Sie unter [Eingangsports reservieren — wirkt sich auf das Netzwerk aus](ec2-instance-performance-tuning.md#reserve-ingress-ports). Diese Ports müssen so konfiguriert werden, dass sie eingehenden UDP-Verkehr in der Sicherheitsgruppe für die VPC zulassen, auf der die Empfängerinstanz ausgeführt wird. 

 Auf dem Endpunkt übergibt `egressAddress` der Agent den DigiF-Datenfluss an Sie. Sie sollten eine Anwendung (z. B. SDR) haben, die die Daten über einen UDP-Socket an diesem Standort empfängt. 

### Schritt 2: EC2-Instanz erstellen
<a name="create-ec2-instance"></a>

Folgendes wird AMIs unterstützt:

1. AWS Ground Station AMI — `groundstation-al2-gs-agent-ami-*` wobei \$1 das Datum ist, an dem das AMI erstellt wurde — wird mit installiertem Agenten geliefert (empfohlen).

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

### Schritt 3: Laden Sie den Agenten herunter und installieren Sie ihn
<a name="download-install-agent"></a>

**Anmerkung**  
 Die Schritte in diesem Abschnitt müssen abgeschlossen werden, wenn Sie im vorherigen Schritt **nicht** das AWS Ground Station Agent-AMI ausgewählt haben. 

#### Laden Sie den Agenten herunter
<a name="download-agent"></a>

 Der AWS Ground Station Agent ist in regionsspezifischen S3-Buckets verfügbar und kann über die AWS-Befehlszeile (CLI) auf Support-EC2-Instances heruntergeladen werden, `s3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/amazon_linux_2_x86_64/aws-groundstation-agent.rpm` wobei \$1 \$1AWS::Region\$1 auf eine der unterstützten [AWS-Bodenstationskonsole und Datenlieferregionen](https://docs.aws.amazon.com/ground-station/latest/ug/aws-ground-station-antenna-locations.html) verweist. 

 Beispiel: Laden Sie die neueste RPM-Version aus der AWS-Region us-east-2 lokal in den Ordner /tmp herunter. 

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

 Wenn Sie eine bestimmte Version des AWS Ground Station Agenten herunterladen müssen, können Sie sie aus dem versionsspezifischen Ordner im S3-Bucket herunterladen. 

 Beispiel: Laden Sie Version 1.0.2716.0 von rpm aus der AWS-Region us-east-2 lokal in den Ordner /tmp herunter. 

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

**Anmerkung**  
Wenn Sie überprüfen möchten, ob das RPM, das Sie heruntergeladen haben, verkauft wurde, folgen Sie den Anweisungen für. AWS Ground Station[Überprüfung der RPM-Installation](rpm-install-validation.md)

#### Installieren Sie den Agenten
<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
```

### Schritt 4: Konfigurieren Sie den Agenten
<a name="configure-agent"></a>

 Nach der Installation des Agenten müssen Sie die Agenten-Konfigurationsdatei aktualisieren. Siehe [Konfigurieren Sie den Agenten](configuring-agent.md). 

### Schritt 5: Wenden Sie die Leistungsoptimierung an
<a name="apply-performance-tuning"></a>

 **AWS Ground Station Agent-AMI**: Wenn Sie im vorherigen Schritt das AWS Ground Station Agent-AMI ausgewählt haben, wenden Sie die folgenden Leistungsoptimierungen an. 
+  [Optimieren Sie Hardware-Interrupts und Empfangswarteschlangen — das wirkt sich auf CPU und Netzwerk aus](ec2-instance-performance-tuning.md#tune-hardware-interrupts) 
+ [Eingangsports reservieren — wirkt sich auf das Netzwerk aus](ec2-instance-performance-tuning.md#reserve-ingress-ports)
+ [Starten Sie neu](ec2-instance-performance-tuning.md#reboot)

 **Andere AMIs**: Wenn Sie im vorherigen Schritt ein anderes AMI ausgewählt haben, wenden Sie alle unter aufgeführten Optimierungen an [Optimieren Sie Ihre EC2-Instance im Hinblick auf die Leistung](ec2-instance-performance-tuning.md) und starten Sie die Instance neu. 

### Schritt 6: Den Agenten verwalten
<a name="manage-agent"></a>

 Informationen zum Starten, Beenden und Überprüfen des Agentenstatus finden Sie unter[Den Agenten verwalten](managing-agent.md). 