> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

# デバイス設定を更新

デバイス設定、サービスバージョン、推論エンジン、CA 証明書、追加サービスを管理します。

### デプロイの設定

Deployment Manager の「Configuration」ページでは、デバイス上で実行されているサービスを管理できます。このガイドでは、主な設定オプションについて説明します。編集内容を保存するには「Save Configuration」をクリックし、未保存の変更を破棄するには「Reset」をクリックします。

デバイスマニフェストを [使用するデバイス](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/device-manifests.md) は、マニフェストから設定を取得するため、「Configuration」タブと「Services」タブは表示されません。

#### デバイス設定

デバイス名を変更したり、タイムゾーンを更新したりできます。デバイス名は Deployment Manager のユーザーインターフェース上での表示にのみ使用され、連携機能に影響することはありません。タイムゾーンはデバイスの時計を設定するもので、ログ、イベント、メンテナンス時間帯に使用されます。デプロイ先の実際の場所に合わせて設定してください。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-5b850a8b6b8208f35daaf63f53ca2d546de5ee9a%2Fenterprise-device-settings.png?alt=media" alt="Device Settings panel with device name, timezone, and maintenance window"><figcaption></figcaption></figure>

#### 更新／パフォーマンス設定

サービスのバージョンは、各サービスのタブで設定できます。サービスのカードまたはタブにある「Update」をクリックすると、更新先のバージョン、推定ダウンロード容量と必要なディスク容量、メンテナンススケジュールを確認できます。更新に必要な容量がディスクに収まらない可能性がある場合、ボタンには「Update Anyway」と表示されます。確定すると更新が保存されるか、既存の未保存の編集内容に追加されます。新しいバージョンのダウンロード中も、現在のバージョンは実行され続けます。デバイス名の横には進行状況（例:「Updating Inference · 42%」）または「Update Failed」を示すチップが表示され、ダウンロードに失敗した理由は「Activity」タブで確認できます。

**バージョン表示:**

* **「Update Available」** - 新しいバージョンがあります
* **「Update Scheduled」** - 更新はメンテナンス時間帯まで保留されます
* **「Downloading」、「Restarting」、「Update Failed」** - インストールの進行状況または失敗を示します
* **「Update Pending」** - 実行中のバージョンが設定済みのバージョンと異なります。この状態が続く場合は、サービスのログを確認してください

デバイスがサービスに独自のイメージ（例: デフォルトのHMIではなくカスタムHMI）を使用している場合、バージョンは読み取り専用で表示されます。デフォルトのバージョンは別のイメージを参照するため、バージョン表示、「Update」ボタン、自動更新は適用されません。

**自動更新** - サービスのカードにある「Auto Update」またはタブにある「Automatic Updates」をオンにすると、サービスは Workspace のデフォルト設定で指定されているバージョンに維持されます。ただし、PLC Relay、OPC UA Server、RTSP Simulator は Roboflow に同梱されているバージョンに従います。更新は [メンテナンス時間帯](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/setting-up/setup-maintenance-windows.md)中に適用されます。「Device Settings」の「Latest Roboflow Core」をオンにすると、Inference と Redis の自動更新が有効になります。メンテナンス時間帯以外に設定変更を保存した場合、デプロイに影響する変更は次の時間帯まで保留されます。

複数のデバイスの Inference バージョンを一度に設定するには、デバイスリストで対象を選択し、「Set Inference Version」をクリックします。結果には各デバイスの状態が、保存済み、キュー登録済み（メンテナンス時間帯まで保留）、失敗、スキップのいずれかで表示されます。保存済みとは、Roboflow がバージョンを記録したことを意味し、デバイスへのインストールが完了したことを意味するものではありません。各デバイスの他の設定編集は保持されます。

**推論エンジン** - Inference サービスが使用するランタイムを指定します。次の4つのモードから選択します:

* **Auto** （推奨）- Inference Models ランタイムと、モデル固有のデフォルト設定を使用します。
* **ONNX** - デバイスで利用可能なプロバイダーを使用して ONNX Runtime を実行します。
* **TRT** - TensorRT 実行プロバイダーを使用する ONNX Runtime を強制します。初回実行時はモデルのコンパイルに数分かかることがあります。Offline Mode がオフの場合、TensorRT エンジンのキャッシュが有効になります。
* **CPU** - CPU のみで推論を実行します。GPU 関連の問題をデバッグする際に便利です。

「Performance」では、「RTSP Stream Capture」を使って、Inference サービスがすべての RTSP カメラに接続する方法を設定します。自動トランスポートには「Default」、パケット損失の多いネットワークでより安定したキャプチャを行うには「TCP」、低遅延にするには「UDP」、FFmpeg オプションを指定するには「Custom」を選択し、 `key;value|key;value` 形式で入力します。「TCP」では、「Probe Size」（バイト数）と「Analyze Duration」（マイクロ秒）を調整できます。値を大きくするとストリームの検出精度が上がりますが、起動に時間がかかります。

**オフラインモード** - この切り替えをオンにすると、Inference サービスから Roboflow への接続が停止します。その後、デバイスはローカルキャッシュにある Workflow とモデルのみを実行するため、公開済みの Workflow の変更や新しいモデルバージョンは推論に反映されません。この変更は Inference サービスの再起動後に有効になります。オンの間は、デバイスリストとデバイスページに「Offline Mode」チップが表示され、Workflow の公開確認画面には更新が適用されないデバイスが表示されます。

オフラインで使用するためにデバイスに保持されている Workflow を確認するには、デバイスの「Streams」タブを開き、「Workflows」までスクロールします。どのストリームでも使用されていない場合に Workflow をデバイスに保持するには、「Add Workflow」をクリックして選択し、「Save」をクリックします。デバイスは最新の公開バージョンと識別可能なモデルをダウンロードし、ピン留めを解除するまで保持します。実行時に選択されるモデルは、オフラインで使用するためにあらかじめキャッシュされている必要があります。

接続を切断する前に、 [デバイスをオフライン運用に備えて準備してください](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/setting-up/prepare-a-device-for-offline-operation.md)。キャッシュ、TensorRT、再起動、復旧の確認方法について詳しくは、 [オフラインモードの準備手順](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/offline-mode.md#web-app) に従ってください。

**マルチプロセス** - この切り替えをオンにすると、各ストリームの Workflow がそれぞれ独立したプロセスで実行されます。複数の Workflow を同時に実行する場合、スループットが向上します。各プロセスは個別にモデルを読み込むため、メモリ使用量が増加します。新しいデバイスでは、初期設定でオンになっています。この切り替えは、ホストの IPC 名前空間を Inference コンテナと共有します。デバイスが新しい設定を適用すると、切り替えによって Inference サービスが再起動します。

#### Python 設定

Inference サービスでカスタム Python コードを実行するには、「Configuration」タブの下部にある「Python Configuration」を展開し、 `config.py`。その `setup()` 関数はサービスの起動時に1回実行され、 `on_prediction(predictions, frame)` は各推論の後に実行され、 `pipeline_parameters` はInference Pipelineに追加設定を渡します。無効なPython構文があると保存できません。変更を保存すると、推論サービスが再起動します。

***

#### CA証明書

デバイスの「Networking」タブにある「CA Certificates」から、信頼済みCA証明書を管理できます。独自または内部の証明書を使用するサービス（例：社内プロキシやプライベートレジストリ）との通信に便利です。

「Add Certificate」をクリックし、「Certificate Name」と「PEM Content」を入力してから、「Save Configuration」をクリックします。証明書を削除するには、ゴミ箱アイコンをクリックします。証明書名に使用できるのは英字、数字、ピリオド、ハイフン、アンダースコアのみで、先頭にピリオドは使えません。デバイスは証明書をホストとすべてのサービスにインストールするため、証明書の変更を保存すると、すべてのサービスが再起動します。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-b52d9c82bc0b8ad590e170c7a10862d4df6ca318%2Fdevice-ca-certificates.png?alt=media" alt="CA Certificates section on the Networking tab with a certificate name, PEM content, and Add Certificate"><figcaption></figcaption></figure>

***

#### 追加サービス

Roboflowでは、事前設定済みの追加サービスをデバイスに追加することもできます。各サービスには独自の設定オプションがあり、追加しようとすると必要に応じて入力を求められます。

* [イベントストア](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/services/event-store.md) デバイス上に推論イベントを保存します。
* [OPC UAサーバー](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/services/opc-ua-server.md) データをOPC UAタグとして公開します。
* [PLCリレー](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/services/plc-relay.md) PLCタグの読み取りと書き込みを行います。
* [RTSPシミュレーター](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/services/rtsp-simulator.md) テストカメラとして動画ファイルをストリーミングします。
* デフォルトのHMI UI。

サービスカードの下にある「Add Service」をクリックして追加します。サービスを追加すると、設定はすぐに保存されます。サービスを削除するには、そのカードのヘッダーにあるゴミ箱アイコンをクリックします。削除は他の設定変更と同様に保留状態となり、「Save Configuration」をクリックすると保存されます。メンテナンス時間まで保留しておくこともでき、それまでに「Reset」をクリックすれば取り消せます。サービスを削除すると、それを使用しているWorkflowsやインテグレーションが停止します。RFDMは、専用のマネージャーコンテナを使わずにストリームを管理します。

独自のコンテナを実行するには、「Add Service」から「Custom Service」を選択し、サービス名、コンテナイメージ、タグを入力します。「Advanced Options」を開いて、ポート、ボリュームマウント、コマンド、再起動ポリシー、依存関係、ランタイム、環境変数を設定してから、「Add Service」をクリックします。ボリュームマウントは次の形式で指定します。 `host_path:container_path`読み取り専用にするには、 `:ro` を追加します。各コンテナパスをマウントできるのは1回だけです。

デバイスが保存済みの変更を適用すると、設定が変更されたサービスと、それらに依存するサービスのみが再起動します。

デバイス上のすべてのサービスを再起動するには、デバイスのオプションメニューまたはデバイス一覧の行メニューで「Restart Services」をクリックします。サービスの再起動中は、ストリームと推論が停止します。設定変更後60秒間は、再起動する前に待つようダイアログに表示されます。デバイスがTensorRTエンジンをコンパイルしている間に再起動すると、コンパイルは破棄されます。デバイス全体を再起動するには、デバイスのオプションメニューで「Reboot Device」をクリックします。起動が完了するまでデバイスを利用できません。

保存済みのサービスを1つ再起動するには、そのタブを開いて「Restart Service」をクリックします。サービスは一時的に停止し、そのサービスを使用するストリームも停止します。ダイアログには、サービスの準備が完了したこと、または再起動が失敗したかタイムアウトしたことが表示されます。失敗した場合は、「Retry Restart」をクリックします。先に変更を保存するか破棄してください。このボタンは、サービスの再起動に対応したバージョンのDeployment Managerを使用するデバイスにのみ表示され、マネージャーサービスには表示されません。

***

#### フォルダーのデバイス設定

フォルダーにはデバイス設定パッチを設定でき、そのフォルダー内の新しいデバイスには共有設定が適用されます。フォルダーに追加されたデバイスは、ワークスペースのデフォルト設定から開始します。次に、最上位のフォルダーから順に各親フォルダーのパッチが適用され、最後に対象フォルダー自身のパッチが適用されます。下位フォルダーで設定されたキーは、上位フォルダーの同じキーを置き換えます。デバイス自体に保存された設定は、引き続き優先されます。

パッチを編集するには、「Projects」ページでフォルダーのメニューを開いて「Device Config」をクリックするか、「Edge Devices」一覧でフォルダーのヘッダーにある「Device Config」をクリックします。ダイアログには、そのフォルダー内の新しいデバイスに適用される各設定と、その値の取得元（「Workspace」や親フォルダー名など）が表示されます。このフォルダーで設定を上書きするには、その設定にチェックを入れて値を入力します。環境変数など、継承されたテキスト設定をクリアするには、「Remove」をクリックします。「Remove」がない設定は、新しい値で上書きしてください。一覧にない設定を追加するには、「Config path」（例： `services.inference.environment_variables.NAME`）と「Value」を入力し、「Add Key」をクリックします。「Save」をクリックするとパッチが保存され、「Clear Patch」をクリックするとフォルダー独自のパッチが削除されます。編集には「Manage Devices」権限と、フォルダーへの「Read & Write」アクセス権が必要です。デバイスを閲覧できる他のユーザーは、パッチを読み取ることだけができます。独自のパッチが設定されたフォルダーには、「Device Config」チップが表示されます。
