View a markdown version of this page

安裝 代理程式 - AWS Ground Station
使用CloudFormation範本在 EC2 上手動安裝

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

安裝 代理程式

AWS Ground Station代理程式的安裝方式如下：

  1. CloudFormation範本 （建議）。

  2. 在 Amazon EC2 上手動安裝。

使用CloudFormation範本

EC2 資料交付CloudFormation範本會建立必要的 AWS 資源，以將資料交付至 EC2 執行個體。此CloudFormation範本使用預先安裝AWS Ground Station代理程式的AWS Ground Station受管 AMI。然後，建立的 EC2 執行個體的開機指令碼會填入代理程式組態檔案，並套用必要的效能調校 (調校 EC2 執行個體的效能)。

步驟 1：建立AWS資源

使用範本建立 AWS 資源堆疊 使用 AWS Ground Station Agent （寬頻） 公有廣播衛星 。

步驟 2：檢查客服人員狀態

根據預設，代理程式已設定並處於作用中狀態 （已啟動）。若要檢查代理程式狀態，您可以連線至 EC2 執行個體 (SSH 或 SSM Session Manager) 並參閱 AWS Ground Station客服人員狀態。

在 EC2 上手動安裝

雖然 Ground Station 建議使用 CloudFormation 範本來佈建 AWS 資源，但可能會有標準範本可能不足的使用案例。在這種情況下，我們建議您自訂範本以符合您的需求。如果仍然不符合您的需求，您可以手動建立 AWS 資源並安裝代理程式。

步驟 1：建立 AWS 資源

如需手動設定聯絡所需的 AWS 資源的說明，請參閱範例任務設定檔組態。

AwsGroundStationAgentEndpoint 資源定義了透過AWS Ground Station客服人員接收 DigIF 資料流程的端點，對於成功聯絡至關重要。雖然 API 文件位於 API 參考中，但本節將簡短討論與AWS Ground Station客服人員相關的概念。

端點的 ingressAddress是AWS Ground Station代理程式將從天線接收AWS KMS加密 UDP 流量的位置。socketAddress name 是 EC2 執行個體的公有 IP （來自連接的 EIP)。portRange 應為範圍中至少 300 個連續連接埠，這些連接埠已從任何其他用量保留。如需說明，請參閱 預留輸入連接埠 - 影響網路。這些連接埠必須設定為允許接收者執行個體執行所在 VPC 之安全群組上的 UDP 輸入流量。

端點的 egressAddress是 代理程式將 DigIF 資料流程交給您的位置。您應該讓應用程式 （例如 SDR) 在此位置透過 UDP 通訊端接收資料。

步驟 2：建立 EC2 執行個體

支援下列 AMIs。選擇符合您打算執行之作業系統的 AMI；AWS Ground Station代理程式 AMIs隨附預先安裝的代理程式 （建議）。

Amazon Linux 2023 （建議）

  1. AWS Ground Station AMI – groundstation-al2023-gs-agent-ami-*其中 * 是 AMI 的建置日期 – 隨附已安裝的代理程式 （建議）。

  2. 庫存 Amazon Linux 2023 AMI - al2023-ami-*-x86_64。

Amazon Linux 2

  1. AWS Ground Station AMI – groundstation-al2-gs-agent-ami-*其中 * 是 AMI 的建置日期 – 隨附已安裝的代理程式 （建議）。

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

步驟 3：下載並安裝代理程式

注意

如果您未在上一個步驟中選擇AWS Ground Station客服人員 AMI，則必須完成本節中的步驟。

下載代理程式

AWS Ground Station代理程式可從區域特定的 S3 儲存貯體取得，並且可以使用 AWS 命令列 (CLI) 下載到支援的 EC2 執行個體。我們建議您一律從 latest 路徑下載 ，以確保您執行的是最新版本的代理程式。下載路徑為 s3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/${OS_PATH}/aws-groundstation-agent.rpm，其中 ${AWS::Region}是其中一個支援的 AWS Ground Station 主控台和資料交付區域。

RPM 是作業系統特定的。將 ${OS_PATH}設定為與執行個體正在執行的作業系統相符的值：

  • Amazon Linux 2023： amazon_linux_2023_x86_64

  • Amazon Linux 2: amazon_linux_2_x86_64

如果您不確定執行個體正在執行哪個作業系統，請執行 cat /etc/os-release。安裝針對錯誤作業系統建置的 RPM 將會失敗，因為這兩個建置與二進位不相容。

注意

一律使用 latest 路徑，而不是硬式編碼下載指令碼中的特定版本號碼。使用 latest 路徑可確保您的執行個體在佈建時自動接收安全修補程式和錯誤修正。

範例：將最新的 rpm 版本從 AWS 區域 us-east-2 本機下載至 /tmp 資料夾。

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

如果您需要下載特定版本的AWS Ground Station代理程式以進行故障診斷或復原，您可以從 S3 儲存貯體中的版本特定資料夾下載。這不建議用於正常操作。

範例：將版本 1.0.5953.0 的 rpm 從 AWS region us-east-2 本機下載至 /tmp 資料夾。

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
注意

如果您想要確認您下載的 RPM 是由 提供AWS Ground Station，請遵循 的指示RPM 安裝驗證。

安裝代理程式


sudo yum install ${MY_RPM_FILE_PATH}

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

步驟 4：設定代理程式

安裝代理程式後，您必須更新代理程式組態檔案。請參閱 設定代理程式。

步驟 5：套用效能調校

AWS Ground Station客服人員 AMI：如果您在上一個步驟中選擇AWS Ground Station了客服人員 AMI，請套用下列效能調校。

其他 AMIs：如果您在上一個步驟中選擇任何其他 AMI，請套用 下列出的所有調校，調校 EC2 執行個體的效能然後重新啟動執行個體。

步驟 6：管理代理程式

若要啟動，請停止並檢查客服人員狀態，請參閱 管理代理程式。