翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Kinesis Video Streams Edge エージェントをネイティブプロセスとして実行する
<a name="gs-run"></a>

Amazon Kinesis Video Streams Edge Agent を systemd サービスとしてセットアップします。これは任意の手順です。

`systemd` は Linux デバイスのシステムおよびサービスマネージャーです。 `systemd`は、アプリケーションにエラーが発生したり、アプリケーションを実行しているデバイスが電源を失ったりした場合に Amazon Kinesis Video Streams Edge Agent を再起動するため、プロセスを管理するための推奨方法です。

以下の操作を実行します。

**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`。