

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Instal agen
<a name="installing-the-agent"></a>

 AWS Ground Station Agen dapat diinstal dengan cara-cara berikut: 

1. CloudFormation template (disarankan). 

1. Instalasi manual di Amazon EC2.

## Gunakan CloudFormation template
<a name="using-cloudformation-template"></a>

 CloudFormation Template pengiriman data EC2 membuat sumber daya AWS yang diperlukan untuk mengirimkan data ke instans EC2 Anda. CloudFormation Template ini menggunakan AMI AWS Ground Station terkelola yang memiliki AWS Ground Station Agen yang sudah diinstal sebelumnya. Script boot instans EC2 yang dibuat kemudian mengisi file konfigurasi agen dan menerapkan tuning kinerja yang diperlukan (). [Menyetel instans EC2 Anda untuk kinerja](ec2-instance-performance-tuning.md)

### Langkah 1: Buat AWS sumber daya
<a name="create-aws-resources"></a>

 Buat tumpukan sumber daya AWS Anda menggunakan templat [Satelit siaran publik menggunakan AWS Ground Station Agent (pita lebar)](https://docs.aws.amazon.com/ground-station/latest/ug/examples.pbs-agent.html). 

### Langkah 2: Periksa status agen
<a name="check-agent-status"></a>

Secara default agen dikonfigurasi dan aktif (dimulai). Untuk memeriksa status agen, Anda dapat terhubung ke instans EC2 (SSH atau SSM Session Manager) dan lihat. [AWS Ground Station Status agen](managing-agent.md#gs-agent-status) 

## Instal secara manual di EC2
<a name="manually-install-ec2"></a>

 Meskipun Ground Station merekomendasikan penggunaan CloudFormation templat untuk menyediakan Sumber Daya AWS Anda, mungkin ada kasus penggunaan di mana templat standar mungkin tidak cukup. Untuk kasus seperti itu kami sarankan Anda menyesuaikan template sesuai dengan kebutuhan Anda. Jika itu masih tidak memenuhi persyaratan Anda, Anda dapat membuat sumber daya AWS secara manual dan menginstal agen. 

### Langkah 1: Buat sumber daya AWS
<a name="create-aws-resources"></a>

 Lihat [Contoh konfigurasi profil misi](https://docs.aws.amazon.com/ground-station/latest/ug/examples.html) untuk petunjuk menyiapkan sumber daya AWS yang diperlukan untuk kontak secara manual. 

**AwsGroundStationAgentEndpoint**Sumber daya mendefinisikan titik akhir untuk menerima aliran data DiGIF melalui AWS Ground Station Agen dan sangat penting untuk mengambil kontak yang berhasil. Meskipun dokumentasi API terletak di [Referensi API](https://docs.aws.amazon.com/ground-station/latest/APIReference/Welcome.html), bagian ini akan membahas secara singkat konsep yang relevan dengan AWS Ground Station Agen.

 Titik akhir `ingressAddress` adalah tempat AWS Ground Station Agen akan menerima lalu lintas UDP AWS KMS terenkripsi dari Antena. `socketAddress``name`Ini adalah IP publik dari instans EC2 (dari EIP terlampir). `portRange`Harus setidaknya 300 port bersebelahan dalam kisaran yang telah dicadangkan dari penggunaan lain. Lihat [Reserve port ingress - berdampak pada jaringan](ec2-instance-performance-tuning.md#reserve-ingress-ports) untuk instruksi. Port ini harus dikonfigurasi untuk memungkinkan lalu lintas masuknya UDP pada grup keamanan untuk VPC tempat instance penerima berjalan. 

 Titik akhir `egressAddress` adalah tempat Agen akan menyerahkan aliran data DiGIF kepada Anda. Anda harus memiliki aplikasi (misalnya SDR) yang menerima data melalui soket UDP di lokasi ini. 

### Langkah 2: Buat instans EC2
<a name="create-ec2-instance"></a>

Berikut ini AMIs didukung:

1. AWS Ground Station AMI - `groundstation-al2-gs-agent-ami-*` di mana\* adalah tanggal AMI dibangun - dilengkapi dengan agen yang diinstal (disarankan).

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

### Langkah 3: Unduh dan instal agen
<a name="download-install-agent"></a>

**catatan**  
 Langkah-langkah di bagian ini harus diselesaikan jika Anda **tidak** memilih AWS Ground Station Agen AMI pada langkah sebelumnya. 

#### Agen unduhan
<a name="download-agent"></a>

 AWS Ground Station Agen tersedia dari bucket S3 khusus wilayah dan dapat diunduh ke instans EC2 yang didukung menggunakan baris perintah AWS (CLI). Kami menyarankan untuk selalu mengunduh dari `latest` jalur untuk memastikan Anda menjalankan versi agen terbaru. Jalur unduhan adalah `s3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/amazon_linux_2_x86_64/aws-groundstation-agent.rpm` tempat $ {AWS::Region} mengacu pada salah satu [Konsol AWS Ground Station dan Wilayah Pengiriman Data](https://docs.aws.amazon.com/ground-station/latest/ug/aws-ground-station-antenna-locations.html) yang didukung. 

**catatan**  
 Selalu gunakan `latest` jalur daripada hard-coding nomor versi tertentu dalam skrip unduhan Anda. Menggunakan `latest` jalur memastikan instance Anda secara otomatis menerima tambalan keamanan dan perbaikan bug saat disediakan. 

 Contoh: Unduh versi rpm terbaru dari AWS region us-east-2 secara lokal ke folder/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
```

 Jika Anda perlu mengunduh versi AWS Ground Station Agen tertentu untuk tujuan pemecahan masalah atau rollback, Anda dapat mengunduhnya dari folder khusus versi di bucket S3. Ini tidak disarankan untuk operasi normal. 

 Contoh: Unduh versi 1.0.2716.0 rpm dari AWS region us-east-2 secara lokal ke folder /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
```

**catatan**  
Jika Anda ingin mengonfirmasi bahwa RPM yang Anda unduh telah dijual AWS Ground Station, ikuti instruksi untuk[Validasi instalasi RPM](rpm-install-validation.md).

#### Instal agen
<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
```

### Langkah 4: Konfigurasikan agen
<a name="configure-agent"></a>

 Setelah menginstal agen, Anda harus memperbarui file konfigurasi agen. Lihat [Konfigurasikan agen](configuring-agent.md). 

### Langkah 5: Terapkan Tuning Kinerja
<a name="apply-performance-tuning"></a>

 **AWS Ground Station Agen AMI**: Jika Anda memilih AWS Ground Station Agen AMI pada langkah sebelumnya maka terapkan penyetelan kinerja berikut. 
+  [Menyetel interupsi perangkat keras dan menerima antrian - berdampak pada CPU dan jaringan](ec2-instance-performance-tuning.md#tune-hardware-interrupts) 
+ [Reserve port ingress - berdampak pada jaringan](ec2-instance-performance-tuning.md#reserve-ingress-ports)
+ [Boot ulang](ec2-instance-performance-tuning.md#reboot)

 **Lainnya AMIs**: Jika Anda memilih AMI lain di langkah sebelumnya, terapkan semua penyetelan yang tercantum di bawah [Menyetel instans EC2 Anda untuk kinerja](ec2-instance-performance-tuning.md) dan Reboot instance. 

### Langkah 6: Kelola agen
<a name="manage-agent"></a>

 Untuk memulai, berhenti dan periksa status agen lihat[Kelola agen](managing-agent.md). 