

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Instalación del agente de
<a name="installing-the-agent"></a>

El AWS Ground Station agente se puede instalar de las siguientes maneras: 

1. CloudFormation plantilla (recomendada). 

1. Instalación manual en Amazon EC2.

## Usa una CloudFormation plantilla
<a name="using-cloudformation-template"></a>

La CloudFormation plantilla de entrega de datos de EC2 crea los recursos de AWS necesarios para entregar datos a su instancia de EC2. Esta CloudFormation plantilla utiliza la AMI AWS Ground Station gestionada que tiene el AWS Ground Station agente preinstalado. A continuación, el script de arranque de la instancia EC2 creada rellena el archivo de configuración del agente y aplica los ajustes de rendimiento necesarios ([Ajuste el rendimiento de la instancia EC2](ec2-instance-performance-tuning.md)).

### Paso 1: Crear recursos AWS
<a name="create-aws-resources"></a>

 Cree su pila de recursos de AWS con la plantilla [Public Broadcast Satellite con AWS Ground Station Agent (banda ancha)](https://docs.aws.amazon.com/ground-station/latest/ug/examples.pbs-agent.html). 

### Paso 2: Compruebe el estado del agente
<a name="check-agent-status"></a>

De forma predeterminada, el agente está configurado y activo (iniciado). Para comprobar el estado del agente, puede conectarse a la instancia EC2 (SSH o SSM Session Manager) y consultar [AWS Ground Station Estado del agente](managing-agent.md#gs-agent-status). 

## Instale manualmente en EC2
<a name="manually-install-ec2"></a>

 Si bien Ground Station recomienda usar CloudFormation plantillas para aprovisionar sus recursos de AWS, puede haber casos de uso en los que la plantilla estándar no sea suficiente. En estos casos, le recomendamos que personalice la plantilla para adaptarla a sus necesidades. Si eso sigue sin cumplir sus requisitos, puede crear manualmente sus recursos de AWS e instalar el agente. 

### Paso 1: Crear recursos de AWS
<a name="create-aws-resources"></a>

 Consulte [Ejemplos de configuraciones de perfil de misión](https://docs.aws.amazon.com/ground-station/latest/ug/examples.html) para obtener instrucciones sobre cómo configurar manualmente los recursos de AWS necesarios para un contacto. 

El **AwsGroundStationAgentEndpoint**recurso define un punto final para recibir un flujo de datos DigiF a través del AWS Ground Station agente y es fundamental para establecer un contacto exitoso. Si bien la documentación de la API se encuentra en la [referencia de la API](https://docs.aws.amazon.com/ground-station/latest/APIReference/Welcome.html), en esta sección se analizarán brevemente los conceptos relevantes para el agente. AWS Ground Station 

 El punto final `ingressAddress` es donde el AWS Ground Station agente recibirá el tráfico UDP AWS KMS cifrado de la antena. `socketAddress` `name` es la IP pública de la instancia EC2 (de la EIP adjunta). `portRange` debe tener al menos 300 puertos contiguos en un rango que se haya reservado para cualquier otro uso. Para obtener instrucciones, consulte [Los puertos de entrada de reserva afectan a la red](ec2-instance-performance-tuning.md#reserve-ingress-ports). Estos puertos deben configurarse para permitir el tráfico de entrada UDP en el grupo de seguridad de la VPC en la que se ejecuta la instancia receptora. 

 El punto final `egressAddress` es donde el agente le entregará el flujo de datos de DigiF. Debería tener una aplicación (por ejemplo, SDR) que reciba los datos a través de un conector UDP en esta ubicación. 

### Paso 2: crear una instancia EC2
<a name="create-ec2-instance"></a>

Se admite lo siguiente AMIs :

1. AWS Ground Station La AMI (`groundstation-al2-gs-agent-ami-*`donde \* es la fecha en que se creó la AMI) viene con el agente instalado (recomendado).

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

### Paso 2: descargar e instalar el agente
<a name="download-install-agent"></a>

**nota**  
 Los pasos de esta sección deben completarse si **no** eligió la AMI del AWS Ground Station agente en el paso anterior. 

#### Descargar el agente
<a name="download-agent"></a>

 El AWS Ground Station agente está disponible en buckets S3 específicos de la región y se puede descargar en instancias EC2 compatibles mediante la línea de comandos (CLI) de AWS. Recomendamos descargarlo siempre desde la `latest` ruta para asegurarse de que está ejecutando la versión más reciente del agente. En la ruta de descarga, $ {AWS::Region} hace referencia a una de las [regiones de entrega de datos y consola AWS Ground Station](https://docs.aws.amazon.com/ground-station/latest/ug/aws-ground-station-antenna-locations.html) compatibles. `s3://groundstation-wb-digif-software-${AWS::Region}/aws-groundstation-agent/latest/amazon_linux_2_x86_64/aws-groundstation-agent.rpm` 

**nota**  
 Utilice siempre la `latest` ruta en lugar de codificar un número de versión específico en sus scripts de descarga. El uso de la `latest` ruta garantiza que las instancias reciban automáticamente los parches de seguridad y las correcciones de errores cuando se aprovisionen. 

 Ejemplo: descargue la versión rpm más reciente de la región us-east-2 de AWS de forma local a la carpeta /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
```

 Si necesita descargar una versión específica del AWS Ground Station agente para solucionar problemas o revertirla, puede descargarla desde la carpeta específica de la versión en el bucket de S3. Esto no se recomienda para operaciones normales. 

 Ejemplo: descargue la versión 1.0.2716.0 de RPM de la región us-east-2 de AWS de forma local a la carpeta /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
```

**nota**  
Si quiere confirmar que se vendió el RPM que descargó AWS Ground Station, siga las instrucciones correspondientes[Validación de la instalación de RPM](rpm-install-validation.md).

#### Instalar el agente
<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
```

### Paso 4: configurar el agente
<a name="configure-agent"></a>

 Tras instalar el agente, debe actualizar el archivo de configuración del agente. Consulte [Configure el agente](configuring-agent.md). 

### Paso 5: aplicar ajustes de rendimiento
<a name="apply-performance-tuning"></a>

 **AWS Ground Station AMI de agente**: si eligió la AMI de AWS Ground Station agente en el paso anterior, aplique los siguientes ajustes de rendimiento. 
+  [Ajuste las interrupciones del hardware y las colas de recepción, lo que repercute en la CPU y la red](ec2-instance-performance-tuning.md#tune-hardware-interrupts) 
+ [Los puertos de entrada de reserva afectan a la red](ec2-instance-performance-tuning.md#reserve-ingress-ports)
+ [Reboot](ec2-instance-performance-tuning.md#reboot)

 **Otros AMIs**: Si eligió cualquier otra AMI en el paso anterior, aplique todos los ajustes enumerados en [Ajuste el rendimiento de la instancia EC2](ec2-instance-performance-tuning.md) y reinicie la instancia. 

### Paso 6: administrar el agente
<a name="manage-agent"></a>

 Para iniciar, detener y comprobar el estado del agente, consulte[Administre el agente](managing-agent.md). 