기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Kinesis Video Streams Edge 에이전트를 네이티브 프로세스로 실행
<a name="gs-run"></a>

Amazon Kinesis Video Streams Edge 에이전트를 시스템 서비스로 설정합니다. 이 단계는 선택 사항입니다.

`systemd`는 Linux 디바이스의 시스템 및 서비스 관리자입니다. `systemd`는 애플리케이션이 오류가 발생하거나 애플리케이션을 실행하는 디바이스의 전원이 끊어질 경우 Amazon Kinesis Video Streams Edge 에이전트를 다시 시작하므로 프로세스를 관리하는 데 권장되는 방법입니다.

해결 방법:

**Amazon Kinesis Video Streams Edge 에이전트를 네이티브 프로세스로 실행**

1. 에서 새 파일을 `/etc/systemd/system` 생성하고 이름을 로 지정합니다`{{aws.kinesisvideo.edge-runtime-agent}}.service`.

   다음을 붙여 넣습니다.

   ```
   [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
   ```

   `systemd` 서비스 구성 파일에서 허용하는 파라미터에 대한 자세한 내용은 [설명서를](https://www.freedesktop.org/software/systemd/man/systemd.unit.html#%5BUnit%5D%20Section%20Options) 참조하세요.
**참고**  
에 지정된 대로 `...` 위치에 필요한 환경 변수를 추가합니다[Amazon Kinesis Video Streams Edge 에이전트 빌드](gs-build-agent.md).

1. 새 서비스를 포함하도록 서비스 파일을 다시 로드합니다.

   유형 `sudo systemctl daemon-reload`

1. 서비스를 시작합니다.

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

1. Amazon Kinesis Video Streams Edge Agent 서비스의 상태를 확인하여 실행 중인지 확인합니다.

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

   다음은 표시되는 출력의 예입니다.

   ```
   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. 로그에 오류가 있는지 검사합니다.

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

1. `systemctl --help`를 사용하여 프로세스를 관리하는 옵션의 전체 목록을 입력합니다`systemctl`.

   다음은 Amazon Kinesis Video Streams Edge 에이전트를 관리하기 위한 몇 가지 일반적인 명령입니다.
   + 다시 시작하려면를 입력합니다`sudo systemctl restart {{aws.kinesisvideo.edge-runtime-agent}}.service`.
   + 중지하려면를 입력합니다`sudo systemctl stop {{aws.kinesisvideo.edge-runtime-agent}}.service`.
   + 디바이스를 재부팅할 때마다 자동으로 시작하려면를 입력합니다`sudo systemctl enable {{aws.kinesisvideo.edge-runtime-agent}}.service`.