View a markdown version of this page

Installieren des Agents - AWS Ground Station

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

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

  1. CloudFormation Vorlage (empfohlen).

  2. Manuelle Installation auf Amazon EC2.

Verwenden Sie ein CloudFormation Vorlage

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

Schritt 1: Erstellen AWS Ressourcen

Erstellen Sie Ihren AWS-Ressourcenstapel mithilfe der Vorlage Public Broadcast Satellite mithilfe von AWS Ground Station Agent (Breitband).

Schritt 2: Überprüfen Sie den Agentenstatus

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 Kundendienstmitarbeiter-Status

Manuell auf EC2 installieren

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

Anweisungen zum manuellen Einrichten der AWS-Ressourcen, die für einen Kontakt erforderlich sind, finden Sie unter Beispielkonfigurationen für Missionsprofile.

Die AwsGroundStationAgentEndpointRessource 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, 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. 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 über eine Anwendung (z. B. SDR) verfügen, die die Daten über einen UDP-Socket an diesem Standort empfängt.

Schritt 2: EC2-Instanz erstellen

Die folgenden AMIs werden unterstützt. Wählen Sie ein AMI, das dem Betriebssystem entspricht, das Sie ausführen möchten. Bei den AWS Ground Station Agent-AMIs ist der Agent vorinstalliert (empfohlen).

Amazon Linux 2023 (empfohlen)
  1. AWS Ground Station AMI — groundstation-al2023-gs-agent-ami-* wobei * das Datum ist, an dem das AMI erstellt wurde — wird mit installiertem Agenten geliefert (empfohlen).

  2. Ein Amazon Linux 2023 AMI auf Lager -al2023-ami-*-x86_64.

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

  2. amzn2-ami-kernel-5.10-hvm-x86_64-gp2.

Schritt 3: Laden Sie den Agenten herunter und installieren Sie ihn

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

Der AWS Ground Station Agent ist in regionsspezifischen S3-Buckets verfügbar und kann über die AWS-Befehlszeile (CLI) auf unterstützte EC2-Instances heruntergeladen werden. Wir empfehlen, immer vom latest Pfad herunterzuladen, um sicherzustellen, dass Sie die aktuellste Version des Agenten ausführen. Der Download-Pfad lautets3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/${OS_PATH}/aws-groundstation-agent.rpm, wo sich ${AWS::Region} eine der unterstützten AWS Ground Station Console- und Data Delivery-Regionen befindet.

Das RPM ist betriebssystemspezifisch. Stellen Sie ${OS_PATH} den Wert ein, der dem Betriebssystem entspricht, auf dem Ihre Instance ausgeführt wird:

  • Amazon Linux 2023: amazon_linux_2023_x86_64

  • Amazon Linux 2: amazon_linux_2_x86_64

Wenn Sie sich nicht sicher sind, auf welchem Betriebssystem Ihre Instance ausgeführt wird, führen Sie sie auscat /etc/os-release. Die Installation des für das falsche Betriebssystem erstellten RPM schlägt fehl, da die beiden Builds nicht binärkompatibel sind.

Anmerkung

Verwenden Sie immer den latest Pfad, anstatt eine bestimmte Versionsnummer in Ihren Download-Skripten fest zu codieren. Durch die Verwendung des latest Pfads wird sichergestellt, dass Ihre Instances automatisch Sicherheitspatches und Bugfixes erhalten, wenn sie bereitgestellt werden.

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

Amazon Linux 2023:

aws s3 --region us-east-2 cp s3://groundstation-wb-digif-software-us-east-2/aws-groundstation-agent/latest/amazon_linux_2023_x86_64/aws-groundstation-agent.rpm /tmp

Amazon Linux 2:

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 zur Fehlerbehebung oder zum Rollback herunterladen müssen, können Sie sie aus dem versionsspezifischen Ordner im S3-Bucket herunterladen. Dies wird für den normalen Betrieb nicht empfohlen.

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

Amazon Linux 2023:

aws s3 --region us-east-2 cp s3://groundstation-wb-digif-software-us-east-2/aws-groundstation-agent/1.0.5953.0/amazon_linux_2023_x86_64/aws-groundstation-agent.rpm /tmp

Amazon Linux 2:

aws s3 --region us-east-2 cp s3://groundstation-wb-digif-software-us-east-2/aws-groundstation-agent/1.0.5953.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 AWS Ground Station, folgen Sie den Anweisungen fürÜberprüfung der RPM-Installation.

Installieren Sie den Agenten

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

Nach der Installation des Agenten müssen Sie die Agenten-Konfigurationsdatei aktualisieren. Siehe Konfigurieren Sie den Agenten.

Schritt 5: Wenden Sie die Leistungsoptimierung an

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.

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 und starten Sie die Instance neu.

Schritt 6: Den Agenten verwalten

Informationen zum Starten, Beenden und Überprüfen des Agentenstatus finden Sie unterDen Agenten verwalten.