---
title: Tweak
description: OpenLM Version 26 で Tweak License Server（tlm_server）のステータスコマンドを実行してログを読み取るように OpenLM Broker を設定し、RV と RVIO のフローティングライセンスの使用状況を監視して、EasyAdmin で承認します。
product: OpenLM Version 26 (legacy)
---

> **OpenLM Version 26（レガシー）。** このページは OpenLM Platform ではなくレガシー製品について説明しています。

以下の手順で、Tweak のライセンスを OpenLM で監視します。Tweak は、Tweak License Server（`tlm_server`）を指す OpenLM での名前です。`tlm_server` は、Tweak Software の RV と RVIO のフローティングライセンスを提供します。OpenLM Broker はライセンスサーバーのマシン上で実行され、約 1 分ごとに `tlm_server` にステータスを問い合わせ、チェックアウトとチェックインのたびに `tlm_server` のログを読み取って、その両方を OpenLM SLM にレポートします。

:::note
RV のドキュメントを公開している Autodesk によると、GTO のスタンドアロンまたはフローティングのライセンスファイルによる RV のライセンスは引き続きサポートされていますが、配布は終了しています。
:::

## 要件

開始する前に、次を用意してください。

- 組織内のマシンにインストールされた OpenLM SLM、または [Software License Management Cloud（SLMC）](https://www.openlm.com/documentation/ja/legacy/slmc/index) アカウント。
- `tlm_server` を実行しているマシンにインストールされ、OpenLM SLM にレポートしている OpenLM Broker v22.2.7.1557 以降。これより前の Broker バージョンでは、ライセンスマネージャーの種類に **Tweak** が表示されません。
- ログファイル付きで実行されている `tlm_server`。つまり、`-log` オプションを指定して起動されていること。[Tweak License Server を準備する](#tweak-license-server-を準備する)を参照してください。
- `tlm_server` の実行ファイルとログファイルを見つけるための、ライセンスサーバーのマシンへのアクセス権。

## 監視機能

OpenLM Broker を通じた Tweak の現在の監視機能は次のとおりです。

| LM Type in the Broker | Commands | Logs | Quantity | Expiration date | Denied | Borrowing | Allocations | Report resolution |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Tweak | Yes | Yes | Yes | Yes | No | No | No | Seconds |

ステータスコマンドから、Broker はライセンスファイル内の各ライセンスについて次の情報をレポートします。

- **Feature name**: ライセンスされたパッケージ（例: `rvsolo`、`rvio`）。
- **Total and in use**: ライセンスのシート数と使用中のシート数。
- **Expiration date**: ライセンス自体の有効期限ではなく、`maint expires` の値であるメンテナンスの有効期限。
- **Current users**: シートを保持している各ユーザーとそのチェックアウト時刻。

ログから、Broker はチェックアウトとチェックインのたびに次の情報をレポートします。

- **Feature name**: 要求に含まれるパッケージ（例: `rvsolo`）。
- **Username**: クライアントアドレスの `@` より前の部分。
- **Workstation**: `@` より後の部分。`tlm_server` のログでは、クライアントの IP アドレスです。
- **Start and end time**: `APPROVED` 行と `RELEASED` 行の時刻（秒単位）。
- **Vendor**: ログファイルに選択したベンダー。

Broker は、Tweak の拒否された要求、借用ライセンス、ライセンス割り当てをレポートしません。

## OpenLM と Tweak の連携方法

*OpenLM が Tweak の使用状況を収集する仕組み*

Broker はライセンスサーバーのマシン上で実行されます。Broker は 2 つの方法でデータを収集し、OpenLM SLM に送信します。

- **ステータスコマンド:** Broker は 55 秒ごとに `tlm_server -s -h <host> -p <port>` を実行し、その出力を読み取ります。

    ```text
    tlm_server running on host 'tlm01' port 5436
    Version: 2.6.0

    License 1: rvsolo *.*.* :: 2 in use, 3 available, 5 total, maint expires Sat Jun 16 12:13:00 2027
         -> jdoe@10.0.12.41 checked out at Mon Oct 19 08:12:40 2026
         -> asmith@10.0.12.57 checked out at Mon Oct 19 09:30:05 2026
    ```

    各 `License` 行は、合計数とメンテナンスの有効期限を持つフィーチャーになり、その下の各 `->` 行はシートを保持しているユーザーになります。
- **ログファイル:** Broker は、`tlm_server` が `-log` オプションで書き込むログを既定で 10 秒ごとに読み取ります。読み取る行は次の 2 種類です。

    ```text
    APPROVED (lic #1, 2/5 remaining) request for rvsolo 6.2.6 from jdoe@10.0.12.41 at Mon Oct 19 08:12:40 2026
    RELEASED rvsolo *.*.* from jdoe@10.0.12.41 at Mon Oct 19 11:47:05 2026
    ```

    `APPROVED` はチェックアウト、`RELEASED` はチェックインです。Broker は `REJECTED` の要求を含め、それ以外の行をすべて無視します。
- **最初の読み取り:** ログファイルを追加すると、Broker はファイルの末尾から読み取りを開始し、それ以降の新しいチェックアウトとチェックインをレポートします。それ以前の使用状況の履歴はアップロードしません。すでにシートを保持しているユーザーは、ステータスコマンドで把握されます。

## Tweak License Server を準備する

Broker がライセンスサーバーから必要とするものは 2 つです。ステータスコマンド用の `tlm_server` の実行ファイルのフルパスと、`tlm_server` が書き込むログファイルです。`tlm_server` がログファイルを書き込むのは、`-log` オプションを指定して起動した場合だけです。このオプションがない場合、`tlm_server` は動作の記録をコンソールに出力するため、Broker はそれを読み取れません。

1. ライセンスサーバーのマシンで、`tlm_server` の起動方法を確認します。

    - **Windows:** ベンダーの手順では、`tlm_server.exe` を Non-Sucking Service Manager（NSSM）でサービスとしてインストールします（例: `C:\Program Files (x86)\tlm_server-win32-x86-2.6.0\bin\tlm_server.exe`）。サービスの引数に `-log` と `-f` が含まれます。
    - **Linux:** `start_tlmserver_init.sh` スクリプトにコマンドラインが含まれます。ベンダーのパッケージは、変更しない限り `/usr/local/tweak` にインストールされます。

2. コマンドラインに、`-log` とその後にファイル名が含まれていることを確認します（例: `-log "C:\Program Files (x86)\tlm_server-win32-x86-2.6.0\tlm_server.log"`）。

    含まれていない場合は、このオプションを追加して `tlm_server` を再起動します。引数はフォルダーではなくファイルで、存在しない場合は `tlm_server` が作成します。

3. ポートを確認します。

    既定値は `5436` で、Windows では `tlm_server` は `5436` しか使用できません。Linux では `-p` オプションで別のポートを設定できます。

4. ライセンスサーバーのマシンのコマンドプロンプトで、`tlm_server` のフルパスを指定してステータスコマンドを実行します。例:

    ```text
    "C:\Program Files (x86)\tlm_server-win32-x86-2.6.0\bin\tlm_server.exe" -s -h localhost -p 5436
    ```

    出力には、[OpenLM と Tweak の連携方法](#openlm-と-tweak-の連携方法)に示したとおり各ライセンスが一覧表示されます。各 `License` 行の末尾が、`maint expires` と `Sat Jun 16 12:13:00 2027` の形式の日付であることを確認します。それ以外の場合、Broker はステータスの出力を読み取れません。[既知の制限](#既知の制限)を参照してください。

5. ログファイルを開き、`APPROVED` を検索します。

    一致する行がない場合は、ログの開始以降、RV クライアントがライセンスをチェックアウトしていません。

コマンドラインのオプションとサービスの設定については、Autodesk ShotGrid のドキュメントの [Tweak License Server (tlm_server) Version 2.6](https://help.autodesk.com/cloudhelp/ENU/SG-RV/files/rv-legacy-licenses/SG_RV_rv_manuals_rv_tweak_license_html.html) を参照してください。

## OpenLM Broker の設定

:::note
この手順を開始する前に、OpenLM Broker をライセンスサーバーのマシンにインストールし、OpenLM SLM にレポートしていることを確認してください。
:::

1. ライセンスサーバーのマシンでブラウザーを開き、Broker の Web UI（[http://localhost:5090/](http://localhost:5090/)）に移動します。

2. **License Managers** ページで **Host** を確認します。

    OpenLM はこのホスト名でライセンスサーバーを一覧表示します。このフィールドには、Tweak だけでなく、ページ上のすべてのライセンスマネージャーのホストが保持されます。フィールドが空の場合は、ライセンスサーバーのマシンのホスト名を入力し、フィールドの横にある保存アイコンを選択します。

3. **License Managers** → **Add License Manager** に移動します。

4. **LM Type** から **Tweak** を選択します。

5. **Port** に `tlm_server` のポート（通常は `5436`）を入力し、**Add** を選択します。

    この Broker のほかのライセンスマネージャーがすでに使用しているポートは受け付けられません。

    *Tweak をライセンスマネージャーとして追加する*

6. **Commands** タブで、**Executable path** は空のままにします。

    **Executable path** を変更すると、保存時に Broker が両方のコマンドを既定値に置き換えますが、既定値のコマンドは実行できません。フルパスはコマンドの中に指定します。

7. **On-demand commands** の **Status** コマンドを、`tlm_server` のフルパスとステータスのオプションに置き換えます。例:

    ```text
    "C:\Program Files (x86)\tlm_server-win32-x86-2.6.0\bin\tlm_server.exe" -s -h tlm01.example.com -p 5436
    ```

    Broker は `"tlm_server" -s -h <host> -p <port>" -m` を事前に入力しますが、このコマンドは失敗します。ポートの後に余分な引用符があり、`tlm_server` には `-m` オプションがないためです。スペースを含むパスは引用符で囲んだままにしてください。

8. **Periodic commands** の **Data Inquiry** を選択し、コマンドを同じ内容に置き換えます。

    Data Inquiry は 55 秒ごとに実行され、使用状況を OpenLM SLM に送信するコマンドです。事前に入力された内容には、Status コマンドと同じ誤りがあります。

    *Data Inquiry と Status のコマンドを修正する*

9. **Vendors** タブで **Add Vendor** を選択し、`ShotGrid` を入力して、**Continue** を選択します。

    追加したベンダーは、ほかのタブに切り替えてから戻ると一覧に表示されます。Broker はステータスのデータに、このタブの最初のベンダーを、タブが空の場合は `ShotGrid` を付けます。ログファイルにも同じベンダーを指定すると、両方のデータがまとまります。

10. **Log Files** タブで **Add Log File** を選択し、ダイアログに次の内容を入力します。

    - **Log Type**: **Tweak LM log**（Tweak で使用できる唯一の種類）。
    - **Log Name**: ログの名前（例: `tlm_server log`）。
    - **Log Path**: `-log` の後に指定したファイルのフルパス（例: `C:\Program Files (x86)\tlm_server-win32-x86-2.6.0\tlm_server.log`）。フィールドの横にある検索アイコンを選択して参照することもできます。
    - **Vendor**: **Vendors** タブで追加したベンダーである **ShotGrid**。
    - **Advanced** の設定は既定値のままにします。

    *Broker に tlm_server のログを指定する*

11. **Continue** を選択し、**Save** を選択します。

## OpenLM SLM の設定

### EasyAdmin による自動設定

ここまでの手順が完了していれば、Broker はステータスコマンドを実行してログを読み取り、Tweak を OpenLM SLM にレポートします。EasyAdmin でライセンスサーバーを承認します:

1. EasyAdmin（`http://<Server IP>:5015`）を開き、**Start → Widgets → License Manager - Servers** に移動します。
2. ウィジェット上部の **There are N servers pending approval** のリンクを選択します。

    **Administration - License Manager Servers** ウィンドウが開き、保留中のエントリが一覧の先頭に表示されます。

3. 保留中の Tweak エントリ（Broker で設定したホスト名とポート）を探し、その行の末尾にある編集アイコンを選択します。

    Broker は OpenLM SLM が認識する LM の種類 **Tweak** をレポートするため、**Type** は **OpenLM Generic** ではなく **Tweak** です。

4. 必要に応じて **Display name** で接続名を変更し、**Host Name** と **Port** を確認してから **APPROVE** を選択します。

### EasyAdmin による手動設定

自動設定が失敗した場合:

1. **Start → Administration → License Manager Servers** に移動します。
2. **Add LM** を選択します。
3. **Display name** に接続名（例: `Tweak`）を入力します。
4. **Type** で **Tweak** を選択します。

    **Use Broker** がオンになります。

5. **Host Name**、**Port**、**Time Zone** の下の行に、Tweak 用に Broker で設定したとおりのホスト名とポートを入力し、タイムゾーンを選択します。
6. **SAVE** を選択します。

## 設定の確認

1. ブラウザーで EasyAdmin を開きます。
2. **Start → Widgets → License Manager - Servers** に移動します。
3. Tweak のライセンスサーバーの **Status** が **Up to date** であることを確認します。
4. **Start → Widgets → Feature Usage Status** に移動し、`rvsolo` などの各パッケージが、**Quantity** に合計シート数、**Used** に使用中の数とともに表示されることを確認します。
5. **Start → Reports → License Activity** に移動し、**Include Current Activity** を選択して、**Apply** を選択します。各チェックアウトがユーザー名とワークステーションとしてのクライアントの IP アドレスとともに表示されることを確認します。

## トラブルシューティング

Tweak が EasyAdmin で保留中として表示されない場合は、Broker が OpenLM SLM にレポートしていることを確認します。同じ Broker のほかのライセンスマネージャーが EasyAdmin で更新されていれば、レポートは届いています。

ライセンスサーバーに合計数や有効期限が表示されない場合は、ステータスコマンドが失敗しています。Broker のインストールフォルダーの `logs` フォルダーにある Broker のログに、原因が記録されます。

- `Unbalanced quotes`: コマンドに、事前に入力された余分な引用符が残っています。[OpenLM Broker の設定](#openlm-broker-の設定)の説明に従って、両方のコマンドを修正します。
- `Command result transformation failed`: `tlm_server` は実行されましたが、Broker がその出力を読み取れません。[Tweak License Server を準備する](#tweak-license-server-を準備する)の説明に従って、`License` 行を確認します。
- 保存後にコマンドが既定値に戻った: **Executable path** が空ではありません。空にしてから、両方のコマンドを再度修正します。

ライセンスサーバーに合計数は表示されるのにチェックアウトやチェックインが表示されない場合は、次の点を確認します。

- **Log Path** が、`tlm_server` のコマンドラインで `-log` の後に指定したファイルを指していること。
- ログに `APPROVED` の行があること。ない場合は、`tlm_server` がログの書き込みを開始してから、どのクライアントもライセンスをチェックアウトしていません。

## 既知の制限

- Broker がステータスの出力を読み取れるのは、すべての `License` 行の末尾が `maint expires` と `Sat Jun 16 12:13:00 2027` の形式の日付である場合だけです。メンテナンスの日付がないライセンスや、`15-Oct-2027` などの別の形式の日付があるライセンスがあると、ステータスコマンド全体が失敗します。その場合、OpenLM は合計数も有効期限も取得できず、チェックアウトとチェックインはログからのみ取得されます。
- OpenLM の有効期限はメンテナンスの有効期限です。Broker はライセンス自体の有効期限をレポートしません。
- Broker は拒否された要求をレポートしません。ログの `REJECTED` 行は無視されます。RV は最も安価なライセンスの種類から順に要求するため、`tlm_server` は通常の動作でもこれらの行を書き込みます。
- Broker は借用ライセンスとライセンス割り当てをレポートせず、使用状況の履歴もアップロードしません。OpenLM での使用状況は、ライセンスマネージャーを設定した時点から始まります。
- OpenLM のワークステーションは、クライアントアドレスの `@` より後の部分で、`tlm_server` のログでは IP アドレスです。
- Broker は、Broker が実行されているマシン上のログを読み取ります。RV のクライアントライセンスに記載されたフォールバックサーバーを含め、監視する `tlm_server` のマシンごとに Broker をインストールしてください。
- RV のクライアントライセンスに記載されたフォールバックサーバーを含め、各 `tlm_server` は OpenLM で個別のライセンスサーバーになります。EasyAdmin では **Is Triad Configuration** のチェックを外したままにしてください。
