HQueueファームをセットアップする前に、以下の項目が必須です:

HQueueファームのセットアップには、HQueueサーバーのインストール、HQueueへのネットワークフォルダの登録、ファームへのクライアントマシンの追加の作業が伴います。

HQueueファームが正しく設定されているかテストするために、単純なHoudiniレンダージョブを投入することができます。

以下にその方法を載せます:

1. Houdiniを起動します。

2. 単純なシーンを作成します。レンダリングするには、最低でも何かしらのジオメトリ、ライト、カメラ、Mantra ROPを配置します。

3. /outノードネットワークに進んで、HQueue Render ROPを配置します。

4. パラメータエディタで、Output DriverパラメータにMantra ROPを設定します。

5. HQueue ServerパラメータにHQueueファーム(例えば、http://serverMachine:5000)を指定します。

   Note

   serverMachineにDNSが設定されていない場合は、代わりにそのURLにそのサーバーマシンのIPアドレスを入力しても構いません。 例えば、http://X.X.X.X:5000です。

6. 次に、 Target HFS パラメータに、クライアントマシン上にインストールされているHoudiniの場所を設定します。

   Mac

   MacOSでは、 Target HFS を以下のように設定します:

   /Applications/Houdini/HoudiniX.Y.ZZZ/Frameworks/Houdini.framework/Versions/Current/Resources
   

   Windows

   Windowsでは、 Target HFS を以下のように設定します:

   C:/Program Files/Side Effects Software/Houdini X.Y.ZZZ
   

   Linux

   Linuxでは、 Target HFS を以下のように設定します:

   /opt/hfsX.Y.ZZZ
   

7. ネットワークフォルダ内のどこかに.hipファイルを保存します。

   Mac

   MacOSでは、そのネットワークフォルダはHQueue Server設定ファイル内のhqserver.sharedNetwork.mount.macosxキーに定義されています。 例えば、.hipファイルを/Volumes/myShare/test.hipに保存します。

   Windows

   Windowsでは、そのネットワークフォルダはHQueue Server設定ファイル内のhqserver.sharedNetwork.mount.windowsキーに定義されています。 例えば、.hipファイルをX:/test.hipに保存します。

   Linux

   Linuxでは、そのネットワークフォルダはHQueue Server設定ファイル内のhqserver.sharedNetwork.mount.linuxキーに定義されています。 例えば、.hipファイルを/mnt/myShare/test.hipに保存します。

8. パラメータエディタの上部にある Submit Job をクリックします。

   • 新しいジョブがHQueueウェブインターフェースに出現します。

   • そのジョブのID上をクリックすることで、そのジョブの中に入って詳細を確認することができます。

ジョブが失敗した時、HQueueウェブインターフェース内でそのジョブのIDをクリックすることで、その原因を調べることができます。 これによって、そのジョブの中に入って、その詳細を確認することができます。 ジョブの子ジョブが失敗したら、その子ジョブのIDをクリックすることで、さらにその中に入ることができます。 最終的には、そのジョブの出力が入ったOutput Logフィールドを確認することになります。 この出力には、ジョブが失敗した原因を示したエラーメッセージが入っています。

よくあるジョブの失敗エラーと解決方法に関しては、トラブルシューティングのFAQsを参照してください。

HQueue Serverをアップグレードする前に、HQueue Serverのデータベースと設定ファイルのバックアップコピーを取っておいてください。

古いHoudiniインストーラで既にインストールされたHQueue Serverをアップグレードする場合、Houdini Launcherを使用して、HQueue Serverを新規インストールします。HQueue Serverのインストールを参照してください。

Launcherで既にインストールされたHQueue Serverをアップグレードするには:

1. Launcherの左側にあるHQueueを選択します。

2. HQueue Serverの隣にあるギアアイコンメニューをクリックして、Modifyを選択します。

3. HQueue Server Modificationダイアログで、Versionドロップダウンメニューから、目的のバージョンを選択します。

   Note

   現在のところ、Python3バージョンのHQueue Serverは利用不可なので、 py2 (つまり、Python 2)バージョンを選択してください。

4. Modifyをクリックして、アップグレードを完了します。

HQueue Clientをアップグレードする前に、HQueue Clientの設定ファイルのバックアップコピーを取っておいてください。

古いHoudiniインストーラで既にインストールされたHQueue Clientをアップグレードする場合、Houdini Launcherを使用して、HQueue Clientを新規インストールします。クライアントマシンの追加を参照してください。

Launcherで既にインストールされたHQueue Clientをアップグレードするには:

1. Launcherの左側にあるHQueueを選択します。

2. HQueue Clientの隣にあるギアアイコンメニューをクリックして、Modifyを選択します。

3. HQueue Client Modificationダイアログで、Versionドロップダウンメニューから、目的のバージョンを選択します。

   Note

   現在のところ、Python3バージョンのHQueue Clientは利用不可なので、 py2 (つまり、Python 2)バージョンを選択してください。

4. Modifyをクリックして、アップグレードを完了します。

Houdini Launcherは、スクリプト、または、コマンドラインによるHQueue ServerとHQueue Clientのインストールに対応しています。 Houdini Launcherもスクリプトでインストール可能です。スクリプトによるLauncherインストールを参照してください。

コマンドラインからHQueue Serverをインストールするには:

cd /Applications/Houdini Launcher.app/Contents/MacOS
sudo ./houdini_installer install --product "HQueue Server" --version X.Y.ZZZ --settings-file /path/to/launcher_settings.ini --build-option py2 --accept-EULA=SideFX-20XX-XX-XX

cd C:/Program Files/Side Effects Software/Launcher
houdini_installer.exe install --product "HQueue Server" --version X.Y.ZZZ --settings-file C:/path/to/launcher_settings.ini --build-option py2 --accept-EULA=SideFX-20XX-XX-XX

cd /opt/sidefx/launcher/bin
sudo ./houdini_installer install --product "HQueue Server" --version X.Y.ZZZ --settings-file /path/to/launcher_settings.ini --build-option py2 --accept-EULA=SideFX-20XX-XX-XX

コマンドラインからHQueue Clientをインストールするには:

cd /Applications/Houdini Launcher.app/Contents/MacOS
sudo ./houdini_installer install --product "HQueue Client" --version X.Y.ZZZ --settings-file /path/to/launcher_settings.ini --build-option py2 --accept-EULA=SideFX-20XX-XX-XX

cd C:/Program Files/Side Effects Software/Launcher
houdini_installer.exe install --product "HQueue Client" --version X.Y.ZZZ --settings-file C:/path/to/launcher_settings.ini --build-option py2 --accept-EULA=SideFX-20XX-XX-XX

cd /opt/sidefx/launcher/bin
sudo ./houdini_installer install --product "HQueue Client" --version X.Y.ZZZ --settings-file /path/to/launcher_settings.ini --build-option py2 --accept-EULA=SideFX-20XX-XX-XX

Houdini Launcherを使用したコマンドラインインストールの詳細は、Houdini Launcher - スクリプトによるインストールを参照してください。

オプションで、クライアントマシン上でHQueueを実行するhquserユーザとhqgroupユーザグループをセットアップすることができます。 慣例では、そのユーザIDとそのグループのIDはどちらも601で、そのユーザのパスワードはhqpassですが、それらを変更しても構いません。

クライアント間でユーザアカウントを統一するメリットは以下のとおりです:

• 特定のクライアントにログインする必要がある時に、別のクライアントマシンの別のユーザアカウントを気にする必要がありません。

• クライアントソフトウェアで作成されたどのファイルも所有者が1人のユーザに統一されます。

ユーザとグループを作成したら、HQueueサーバー/クライアントをhquserとして起動してください。