maxRenders=‹max› 使用可能なレンダリングプロセスの最大数です。デフォルトはマシンのプロセッサ数です。マシンの物理プロセッサ数よりも多くのレンダリングを許可すると、パフォーマンスが低下する可能性があります。

maxUsage=‹pct› 使用するCPUの最大パーセンテージです（パーセント記号 % は含めないでください）。ホストマシン上のサーバープロセスのロードアベレージがこの数値より高い場合、サーバーはレンダリングの受付を停止します。100 より大きい値を指定すると、このチェックは無効になります。デフォルトは 101（無効）です。

注意: このオプションの使用には注意してください。時間経過に伴うロードアベレージに基づいているため、平均値がしきい値を下回るまでに、サーバーが複数のレンダリングリクエストを拒否する可能性があります。

renderOnly=‹0|1› これを 1 に設定すると、非グラフィカルライセンスのみを使用できます。（これと graphicsOnly の両方が 1 の場合、両方とも無視されます。）これにより、Houdiniなどのインターフェースを持つ「グラフィカルな」アプリケーションが、このホストを使用するのを防ぎます。

graphicsOnly=‹0|1› これを 1 に設定すると、グラフィカルライセンスのみを使用できます。（これと renderOnly の両方が 1 の場合、両方とも無視されます。）これにより、hbatch などのコマンドラインアプリケーションが、このホストを使用するのを防ぎます。

relaxNonGraphics=‹0|1› これが 1 の場合、renderOnly が 1 であっても、非グラフィカルアプリケーションがグラフィカルライセンスを使用できるようになります。

hold=‹license› ‹secs› hserver がアプリケーションのライセンスをチェックアウトする際、使用後にライセンスを返却するのではなく、「保持 (hold)」するように指定できます。これにより、同じマシンでのライセンスの再取得がはるかに速くなりますが、その分ライセンスが拘束されます。 指定する2つの引数は、「ライセンスの種類」と「その種類のライセンスを保持する秒数」です。秒数が -1 の場合、サーバーはその種類のライセンスを無期限に保持します。デフォルトは以下の通りです。

• hold Houdini-Master 3600

• hold Render -1 （つまり、FXライセンスを1時間保持し、Renderライセンスを無期限に保持します。Renderライセンスは無料であるため、将来の使用に備えて無期限に保持することは理にかなっています。）

mantra=version=X.X command="‹command›" 特定のバージョンのMantraレンダラーでリモートレンダリングを開始する際に使用する、レンダリングコマンドを指定します。これにより、同じホスト上で複数バージョンのレンダラーをサポートできるようになります。

vmantra=version=X.X command="‹command›" 上記の mantra オプションと同じです。

APIオプション 

readTimeoutMs=‹ミリ秒› このサーバーがエンドポイントからの応答を待機する最大時間（ミリ秒単位）です。デフォルトは5分（300,000ミリ秒）です。どのようなAPI呼び出しであっても、このタイムアウト時間に近づくことは通常あり得ないため、この値は変更しないことが推奨されます。 （hserver が複数のライセンスサーバーを使用するように設定されている場合、これはリスト内の1つのサーバーを諦めて次のサーバーへ移行するまでの待機時間となります。）

connectTimeoutMs=‹ミリ秒› 接続のタイムアウトを指定します。これは、hserver がエンドポイントへの接続を諦めるまでに試行する時間（ミリ秒単位）です。デフォルトは30秒（30,000ミリ秒）です。

ClientID=‹値› APIキーを提供する際に必要となるクライアントIDです。同時に ClientSecret も指定する必要があります。

ClientSecret=‹値› APIキーを提供する際に必要となるクライアントシークレットです。同時に ClientID も指定する必要があります。

enableIPv6=‹値› IPv6サポートを有効にします。

APIKey=‹クライアントID› ‹クライアントシークレット› APIキー情報のクライアントIDとクライアントシークレットを指定します。詳細については、「APIキーライセンス 」の項目を参照してください。

APIKeyFile=‹ファイルの場所› hserver で使用するAPIキー情報を記載したファイルの保存場所を指定します。詳細については、hkey の「APIキーライセンス」に関する項目を参照してください。

ライセンスのパーティショニング

userGroup=‹グループ名› ライセンスサーバーにライセンスを要求する際に、使用をリクエストするユーザーグループを指定します。

コマンドラインからのhserverの制御

情報 

--help このヘルプを表示します。

--ini-help iniファイルのヘルプを表示します。

--version hserverのバージョン文字列を出力（表示）します。

ログオプション 

-u/--min-logfile-level ログファイルの最小エラーログレベルを指定します。

• 0: なし

• 1: メッセージ (デフォルト)

• 2: プロンプト

• 3: 警告

• 4: エラー

• 5: 致命的エラー

-U/--min-console-log-level コンソールの最小エラーログレベルを指定します。

• 0: なし

• 1: メッセージ

• 2: プロンプト (デフォルト)

• 3: 警告

• 4: エラー

• 5: 致命的エラー

-B/--enable-console コンソールログ出力を有効にします。

-b/--disable-console-colors デバッグコンソールのカラー表示を無効にします。

-Y/--log-to-system オプションファイルの logToSystem と同じです。

サーバーオプション (Server options)

-L/--logfile ‹file› logfile オプションを設定します。詳細はログのセクションを参照してください。

-D/--debug-mode サーバーをデバッグモードにします。

-d/--run-in-foreground hserverをバックグラウンドではなく、フォアグラウンド（画面上）で実行します。このオプションは、Linux/macOS、およびhserverをWindowsのサービスとして実行していない場合のWindowsで利用可能です。

-t/--max-threads ‹count› maxThreads オプションを設定します。デフォルトは 6 です。

-m/--read-mask ‹ip_mask› readIPMask オプションを設定します。デフォルトは +.+.+.* です。

-M/--write-mask ‹ip_mask› writeIPMask オプションを設定します。デフォルトは +.+.+.* です。

-E/--enable-experimental オプションファイルの useExperimental と同じです。

-C/--force-http 接続URLにかかわらずHTTP通信を強制し、従来の通信プロトコルへのフォールバック（切り替え）を行いません。

クライアントオプション (Client options)

-h/--host ‹host› クエリや制御を行うリモートホストを任意で指定します。

-l/--info 実行中のhserverに接続し、情報を取得します。

-V/--mantra-commands バージョン固有のすべてのMantraコマンドをリスト表示します。

-q/--quit 実行中のhserverを終了します。

-Q/--blocking-quit 実行中のhserverを終了します。クライアントにレスポンスを返す前に、サーバーはすべてのライセンスと実行中のタスクを放棄（解放）します。これは事実上のブロッキングシャットダウンであり、Dockerのような正常なシャットダウンが不可能なシステムでのみ使用されることを想定しています。

-p/--reload-options 実行中のhserverにオプションファイルを再読み込みさせます。

-P/--pause-pid ‹pid› pid (プロセスID) によってhserverのタスクを一時停止します。

-R/--resume-pid ‹pid› pid によってhserverのタスクを再開します。

-S/--server ‹servers› 使用するライセンスサーバーを選択するために、名前でサーバーを指定します。

-K/--kill-pid ‹pid› 強制終了するhserverのタスクを pid で指定します。

-H/--hold-license ‹license› ‹time› プロセスが不要になった後、ライセンスを保持するための「ライセンスの種類」と「時間」を指定します。

APIオプション (Api options)

-T/--read-timeout-ms ‹millis› readTimeout オプションを設定します。デフォルトは 15s (15秒) です。

--connect-timeout-ms ‹millis› サーバーへの接続を試行する最大時間（ミリ秒）です。

--clientid ‹value› APIキーを提供するために必要なクライアントIDです。ClientSecret も提供する必要があります。

--clientsecret ‹value› APIキーを提供するために必要なクライアントシークレットです。ClientID も提供する必要があります。

ライセンスのパーティショニング (License partitioning)

--user-group ‹group name› ライセンスサーバーにライセンスを要求する際に、使用をリクエストするユーザーグループを指定します。

サーバーリストの変更 

クライアントマシンのライセンス設定を行う際、リモートのライセンスサーバーを参照するようにサーバーリストを変更する必要がよくあります。サーバーは、Hkey ▸ File ▸ Change License Server から変更するか、コマンドラインで hserver -S <hostname> を実行することで変更できます。これらの方法はどちらも手動での操作が必要となりますが、スタジオ環境以外（個人や小規模環境など）では通常これで問題ありません。

Houdiniのインストールを自動化したいスタジオ環境で推奨される方法は、DNS SRV エントリを使用することです。DNS SRVを使用する利点は、IT部門がスクリプトを更新したり、各クライアントマシンを手動で更新したりすることなく、サーバーリストを更新できる点にあります。さらに、DNS SRVはスタジオの冗長サーバー構成ともうまく統合できます。

アプリケーションがサーバーリストを決定する優先順位は以下の通りです。

1. hserver の照会 
   アプリケーションが hserver 自身ではない場合、まずは hserver に対してサーバーリストを照会します。
    

2. レジストリキーの確認 (Windowsサービス用) 
   アプリケーションが hserver であり、かつWindows上で正式なサービスとして実行されている場合は、レジストリキーが確認されます。レジストリキーの場所は hklm\software\Side Effects Software\Houdini で、変数名は LicenseServer です。
    

3. 環境変数 SESI_LMHOST の確認 アプリケーションがLinux/OSXで実行されているか、Windowsで正式なサービスとして実行されていない場合、環境変数 SESI_LMHOST が確認されます。
    

   • Windowsでの注意点: hserver はシステムアカウントで実行されるため、この環境変数はシステムアカウントだけでなく、ユーザーアカウントからもアクセス可能である必要があります。
      

4. 設定ファイル .sesi_licenses.pref の使用 
   アプリケーションがLinux/OSXで実行されているか、Windowsで正式なサービスとして実行されていない場合、.sesi_licenses.pref ファイルが使用されます。
    

   • Windows: 場所は %USERPROFILE%/AppData/Local/.sesi_licenses.pref です。hserver を正式なサービスとして実行している場合、システムアカウント下で動作するためこのファイルの場所は異なります。したがって、このファイルを手動で編集することは推奨されません。ライセンス管理ソフトウェアに自動で調整させてください。

   • Linux: 場所は $HOME/.sesi_licenses.pref です。

   • Mac: 場所は $HOME/.sesi_licenses.pref です。
      

5. DNS SRV エントリの確認 DNS SRVエントリが確認されます。アプリケーションは _sesi-lm を検索します。
    

6. mDNS エントリの確認 mDNSエントリが確認されます。（※システムが許可している場合、sesinetd がこれを自動的にセットアップします。ユーザー側で必要な操作はありません。）
    

7. localhost の使用 上記のすべてのオプションでサーバーリストを見つけられなかった場合は、localhost が使用されます。（※まっさらなマシンにHoudiniを新規インストールした直後は、この状態になります。）

ライセンスサーバーのチェーン接続 

この構成では、複数のライセンスサーバー (sesinetd) をチェーン状に連結することができます。これにより、任意の仕様（例：ライセンスの製品タイプなど）に基づいてライセンスサーバーを分割することが可能になります。この設定を行うと、Houdiniはまずリスト内の最初の sesinetd サーバーからライセンスのチェックアウト（確保）を試み、空きがない場合は次のサーバー、さらに次のサーバーというように順番に試行します。

この設定を行うには、単一の sesinetd を接続先として指定するのではなく、ライセンスサーバーのリストをセミコロン（;）で区切って指定します。 リストの先頭にある sesinetd がコマンド（例：チェックアウト）の実行を試み、何らかの理由（接続不可、コマンドの失敗など）で失敗した場合、次の sesinetd が試行され、以降も同様に続きます。 hserver -S を使用してこのリストを指定する場合は、必ず接続リスト全体を引用符（クォーテーション）で囲んでください。

• 例: hserver -S "sesinetd1;sesinetd2"

セミコロンの代わりにカンマが使用された場合（以前のサポート対象外の設定で使用されていました）、アプリケーションはエラーをログに記録しますが、内部的にはセミコロンが使われたものとして自動的に再設定して動作します。ただし、以前のバージョンのHoudiniを考慮して意図的にカンマが選択された可能性も十分にあるため、アプリケーションはキャッシュされたサーバー情報の場所を上書き更新することはありません。

この設定を使用するには、バージョン18.0以上のHoudiniライセンスサーバー (hserver) が必要です。現在のところ、この設定を利用するにあたり sesinetd およびHoudini自体のバージョンに特別な要件はありません。