

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Execute o Amazon Kinesis Video Streams Edge Agent como um processo nativo
<a name="gs-run"></a>

Configure o Amazon Kinesis Video Streams Edge Agent como um serviço systemd. Esta é uma etapa opcional.

`systemd`é um gerenciador de sistemas e serviços em dispositivos Linux. `systemd`é a forma recomendada de gerenciar o processo, pois ele reiniciará o Amazon Kinesis Video Streams Edge Agent caso o aplicativo encontre um erro ou o dispositivo que executa o aplicativo perca energia.

Faça o seguinte:

**Execute o Amazon Kinesis Video Streams Edge Agent como um processo nativo**

1. Crie um novo arquivo `/etc/systemd/system` e nomeie-o`{{aws.kinesisvideo.edge-runtime-agent}}.service`.

   Cole o seguinte:

   ```
   [Unit]
   Description=AWS Kinesis Video Streams edge agent
   After=network.target
   StartLimitBurst={{3}}
   StartLimitInterval={{30}}
   
   [Service]
   Type=simple
   Restart={{on-failure}}
   RestartSec={{10}}
   WorkingDirectory=/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}
   Environment="GST_PLUGIN_PATH=/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}"
   Environment="LD_LIBRARY_PATH=/{{download-location}}/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/{{EdgeAgentVersion}}/lib"
   {{...}}
   Environment="AWS_IOT_CORE_DATA_ATS_ENDPOINT={{data-account-specific-prefix}}.iot.{{aws-region}}.amazonaws.com"
   ExecStart=/usr/lib/jvm/{{java-11-amazon-corretto}}/bin/java --add-opens java.base/jdk.internal.misc=ALL-UNNAMED -Dio.netty.tryReflectionSetAccessible=true -cp kvs-edge-agent.jar:libs.jar com.amazonaws.kinesisvideo.edge.controller.ControllerApp
   
   [Install]
   WantedBy=multi-user.target
   ```

   Para obter mais informações sobre os parâmetros aceitos pelo arquivo `systemd` de configuração do serviço, consulte a [documentação](https://www.freedesktop.org/software/systemd/man/systemd.unit.html#%5BUnit%5D%20Section%20Options).
**nota**  
Adicione as variáveis de ambiente necessárias no `...` local, conforme especificado em[Crie o Amazon Kinesis Video Streams Edge Agent](gs-build-agent.md).

1. Recarregue os arquivos do serviço para incluir o novo serviço.

   Digite `sudo systemctl daemon-reload`.

1. Inicie o serviço .

   Digite `sudo systemctl start {{aws.kinesisvideo.edge-runtime-agent}}.service`.

1. Verifique o status do serviço Amazon Kinesis Video Streams Edge Agent para verificar se ele está em execução.

   Digite `sudo systemctl status {{aws.kinesisvideo.edge-runtime-agent}}.service`.

   Veja a seguir um exemplo da saída que você verá.

   ```
   aws.kinesisvideo.edge-runtime-agent.service - AWS Kinesis Video Streams edge agent
        Loaded: loaded (/etc/systemd/system/aws.kinesisvideo.edge-runtime-agent.service; disabled; vendor preset: enabled)
        Active: active (running) since Thu 2023-06-08 19:15:02 UTC; 6s ago
      Main PID: 506483 (java)
         Tasks: 23 (limit: 9518)
        Memory: 77.5M
           CPU: 4.214s
        CGroup: /system.slice/aws.kinesisvideo.edge-runtime-agent.service
                └─506483 /usr/lib/jvm/java-11-amazon-corretto/bin/java -cp kvs-edge-agent.jar:libs.jar com.amazonaws.kinesisvideo.edge.controller.ControllerApp
   ```

1. Inspecione os registros em busca de erros.

   Digite `journalctl -e -u aws.kinesisvideo.edge-runtime-agent.service`.

1. Digite `systemctl --help` para obter a lista completa de opções para gerenciar o processo usando`systemctl`.

   A seguir estão alguns comandos comuns para gerenciar o Amazon Kinesis Video Streams Edge Agent:
   + Para reiniciar, digite`sudo systemctl restart {{aws.kinesisvideo.edge-runtime-agent}}.service`.
   + Para parar, digite`sudo systemctl stop {{aws.kinesisvideo.edge-runtime-agent}}.service`.
   + Para iniciar automaticamente a cada reinicialização do dispositivo, digite`sudo systemctl enable {{aws.kinesisvideo.edge-runtime-agent}}.service`.