1. HQueueサーバーをインストールする

   1. HQueueサーバーを走らせたいマシンを選定します。ここでは serverMachine と仮定します。

   2. 選定したマシン上にHoudiniインストーラのtarballをダウンロードします。

   3. そのtarballを解凍して、sudoでHoudiniインストーラを実行します。

      例:

      tar zxf houdini-X.X.XXX-linux_x86_64_gccY.Y.tar.gz
      cd houdini-X.X.XXX-linux_x86_64_gccY.Y
      sudo ./houdini_install
      

   4. インストーラで:

      • HQueue Server以外のすべてのコンポーネントのチェックを外します。

      • プロンプトが表示されたら、すべてのHQueueサーバーオプションをデフォルト値のままにしてインストールを進めます。

   5. インストーラが終了すると、HQueueサーバーが/opt/hqueueにインストールされます。

   6. ウェブブラウザを開いて、http://serverMachine:5000にアクセスして、HQueueサーバーが起動しているかどうか確認することができます。

      Note

      serverMachine にDNSが設定されていない場合、そのサーバーマシンのIPアドレスを使用することでHQueueに接続することができます。

      例えば、 http://X.X.X.X:5000 です。

      Note

      HQueueサーバーは、マシンを再起動した後に自動で起動しません。 HQueueサーバーが自動的に起動するように設定するには、/opt/hqueue/scripts/hqserverdを記述したsystemdスクリプトを作成する必要があります。

2. ネットワークフォルダをHQueueに登録する

   1. ウェブブラウザを開いて、HQueueウェブインターフェースにアクセスします。 例えば、 http://serverMachine:5000 です。

   2. 右上コーナーにある“三本線”のアイコンの上にマウスカーソルを置いて、Network Foldersを選択します。

   3. そのNetwork Folder 1ボックス内のLinux Mountフィールドに、ネットワークフォルダのマウント先(例えば、 /Users/Shared/myShare )を設定します。他のすべてのフィールドはデフォルト値のままにします。

   4. 変更を保存します。HQueueジョブ内とHoudiniパラメータ内の$HQROOT参照は、LinuxマシンではLinux Mountフィールドの値に展開されます。

3. クライアントマシンを追加する

   1. クライアントマシン上にHoudiniインストーラのtarballをダウンロードします。

   2. そのtarballを解凍して、sudoでHoudiniインストーラを実行します。

      例:

      tar zxf houdini-X.X.XXX-linux_x86_64_gccY.Y.tar.gz
      cd houdini-X.X.XXX-linux_x86_64_gccY.Y
      ./houdini_install
      

      Note

      HQueueクライアントは、この./houdini_installインストーラスクリプトを実行したユーザアカウントでジョブを実行するようになります。

   3. このインストーラで:

      • インストラーをrootとして再実行するかどうか尋ねられた場合、“no”と入力します。

      • HQueue Client以外のすべてのコンポーネントのチェックを外します。

      • 接続先のHQueueサーバーを尋ねられたら、ファームを指したURL(例えば、http://serverMachine:5000)を設定して、インストールを進めます。

        Note

        serverMachineにDNSが設定されていない場合は、代わりにそのURLにそのサーバーマシンのIPアドレスを入力することができます。

        例えば、http://X.X.X.X:5000です。

      • 残りのHQueueクライアントオプションはデフォルト値のままにします。

   4. インストーラが終了すると、HQueueクライアントがホームディレクトリ($HOME/hqclient)にインストールされます。

   5. HQueueウェブインターフェースのClientsページに進んで、そのマシンがファームに追加するのに成功したことを確認します。

   Note

   ファームに追加したいクライアントマシン毎に上記の手順を繰り返します。

1. HQueueサーバーをインストールする

   1. HQueueサーバーを走らせたいマシンを選定します。ここでは serverMachine と仮定します。

   2. 選定したマシン上にHoudiniインストーラをダウンロードして実行します。

   3. インストーラでは、コンポーネントリストにHQueue Serverのチェックを付けて、他のすべてのコンポーネントのチェックを外します。インストールを進めます。

   4. インストーラが終了すると、HQueueサーバーが/Library/HQueueServerにインストールされ、新しいcom.sidefx.hqserver.plistサービスファイルが/Library/LaunchDaemonsに追加されます。このサービスファイルは、マシンを再起動した後に自動でHQueueサーバーを起動します。

   5. ウェブブラウザを開いて、http://serverMachine:5000にアクセスして、HQueueサーバーが起動しているかどうか確認することができます。

      Note

      serverMachine にDNSが設定されていない場合、そのサーバーマシンのIPアドレスを使用することでHQueueに接続することができます。

      例えば、 http://X.X.X.X:5000 です。

2. ネットワークフォルダをHQueueに登録する

   1. ウェブブラウザを開いて、HQueueウェブインターフェースにアクセスします。 例えば、 http://serverMachine:5000 です。

   2. 右上コーナーにある“三本線”のアイコンの上にマウスカーソルを置いて、Network Foldersを選択します。

   3. そのNetwork Folder 1ボックス内のmacOS Mountフィールドに、ネットワークフォルダのマウント先(例えば、 /Users/Shared/myShare )を設定します。他のすべてのフィールドはデフォルト値のままにします。

   4. 変更を保存します。HQueueジョブ内とHoudiniパラメータ内の$HQROOT参照は、MacOSマシンではmacOS Mountフィールドの値に展開されます。

3. クライアントマシンを追加する

   1. クライアントマシン上にHoudiniインストーラをダウンロードして実行します。

   2. インストーラでは、コンポーネントリストにHQueue Client (files only)のチェックを付けて、他のすべてのコンポーネントのチェックを外します。インストールを進めます。

   3. インストーラが終了すると、MacOSのTerminal appを開いて、そのターミナルでsudo /Library/HQueueClient/install.shと打って、クライアントインストールを完了させるインストーラスクリプトを実行します。

   4. このインストーラスクリプトでは:

      • プロンプトが表示されたら、HQueueクライアントを実行するユーザアカウントを入力します。このユーザアカウントは、クライアントに割り当てられたジョブを実行する際にも使用されます。もしhquserをユーザアカウントとして選んだ場合、インストーラスクリプトはそのユーザアカウントを作成します。詳細は、hquserアカウントを参照してください。

      • プロンプトが表示されたら、サーバーのマシン名とポート番号を入力します。これは、HQueueクライアントがHQueueサーバーを特定して接続するために必要です。

   5. インストーラスクリプトが終了すると、HQueueクライアントが/Library/HQueueClientにインストールされ、新しいcom.sidefx.hqclient.plistサービスファイルが/Library/LaunchDaemonsに追加されます。このサービスファイルは、マシンを再起動した後に自動でHQueueクライアントを起動します。

   6. HQueueウェブインターフェースのClientsページに進んで、そのマシンがファームに追加するのに成功したことを確認します。

   Note

   ファームに追加したいクライアントマシン毎に上記の手順を繰り返します。

1. HQueueサーバーをインストールする

   1. HQueueサーバーを走らせたいマシンを選定します。ここでは serverMachine と仮定します。

   2. 選定したマシン上にHoudiniインストーラをダウンロードして実行します。

   3. インストーラでは、コンポーネントリストにHQueue Serverのチェックを付けて、他のすべてのコンポーネントのチェックを外します。

   4. プロンプトが表示されたら、すべてのHQueueサーバーオプションをデフォルト値のままにしてインストールを進めます。

   5. インストーラが終了すると、HQueueサーバーがC:/HQueueServerにインストールされ、新しいHQueueServerサービスがWindowsサービスに追加されます。このサービスは、マシンを再起動した後に自動でHQueueサーバーを起動します。

   6. ウェブブラウザを開いて、http://serverMachine:5000にアクセスして、HQueueサーバーが起動しているかどうか確認することができます。

      Note

      serverMachine にDNSが設定されていない場合、そのサーバーマシンのIPアドレスを使用することでHQueueに接続することができます。

      例えば、 http://X.X.X.X:5000 です。

2. ネットワークフォルダをHQueueに登録する

   1. ウェブブラウザを開いて、HQueueウェブインターフェースにアクセスします。 例えば、 http://serverMachine:5000 です。

   2. 右上コーナーにある“三本線”のアイコンの上にマウスカーソルを置いて、Network Foldersを選択します。

   3. そのNetwork Folder 1ボックス内のWindows Mountフィールドに、ネットワークフォルダのマウント先を設定します。 ここには、マップされるネットワークドライブレター(例えば、H:)やUNCパス(例えば、\\diskServer\shareName)を入力することができます。 他のすべてのフィールドはデフォルト値のままにします。

   4. 変更を保存します。HQueueジョブ内とHoudiniパラメータ内の$HQROOT参照は、WindowsマシンではWindows Mountフィールドの値に展開されます。

3. クライアントマシンを追加する

   1. クライアントマシン上にHoudiniインストーラをダウンロードして実行します。

   2. インストーラでは:

      • コンポーネントリストにHQueue Clientのチェックを付けて、他のすべてのコンポーネントのチェックを外します。

      • HQueueサーバー情報を入力するように尋ねられたら、NameフィールドにHQueueサーバーのマシン名(例えば、serverMachine)を設定します。さらに、Port Numberフィールドには、そのHQueueサーバーがListenするポート番号(デフォルトは5000)を設定します。これは、HQueueクライアントがHQueueサーバーを特定して接続するために必要です。

        Note

        serverMachine にDNSが設定されていない場合、Nameフィールドには、そのサーバーマシンのIPアドレスを使用することができます。

      • 残りのHQueueクライアントオプションはデフォルト値のままにします。

   3. インストーラが終了すると、HQueueクライアントがC:/HQueueClientにインストールされ、新しい HQueueClient スケジュールタスクが作成されます。このスケジュールタスクは、マシンを再起動した後に自動でHQueueクライアントを起動し、Windows タスク スケジューラ で確認することができます。

   4. インストールの後はクライアントマシンを再起動してください。そうしなかった場合、クライアントは、マッピングされたネットワークドライブにアクセスできないことがあります。

   Note

   ファームに追加したいクライアントマシン毎に上記の手順を繰り返します。

Linuxでのスクリプトによるインストールは、Houdiniインストーラのtarballのhoudini-X.X.XXX-linux_x86_64_gccY.Y.tar.gzから始めます。 SideFXウェブサイトからそのtarballをダウンロードしてください。

1. HQueueサーバーをインストールする

   • 以下のコマンドを叩いてHQueueサーバーをインストールします:

     # インストーラのtarballを解凍します。
     tar zxf houdini-X.X.XXX-linux_x86_64_gccY.Y.tar.gz
     # 解凍されたインストーラディレクトリの中に入ります。
     cd houdini-X.X.XXX-linux_x86_64_gccY.Y
     # インストーラスクリプトを実行してHQueueサーバーをインストールします。
     sudo ./houdini.install --auto-install --accept-EULA 20XX-XX-XX --no-install-houdini –-no-install-license --install-hqueue-server --hqueue-server-dir /opt/hqueue --upgrade-hqueue-server-if-exists yes
     

   • HQueueサーバーは/opt/hqueueにインストールされ、rootアカウントで実行されます。

2. HQueueクライアントをインストールする

   • 以下のコマンドを叩いてHQueueクライアントをインストールします:

     # インストーラのtarballを解凍します。
     tar zxf houdini-X.X.XXX-linux_x86_64_gccY.Y.tar.gz
     # 解凍されたインストーラディレクトリの中に入ります。
     cd houdini-X.X.XXX-linux_x86_64_gccY.Y
     # インストーラスクリプトを実行してHQueueクライアントをインストールします。
     sudo ./houdini.install --auto-install --accept-EULA 20XX-XX-XX --no-install-houdini –-no-install-license --install-hqueue-client --hqueue-client-dir /home/myUser/hqclient --hqueue-client-user myUser --hqueue-server-name myServer --hqueue-server-port 5000
     

   • HQueueクライアントは/home/myUser/hqclientにインストールされ、myUserアカウントで実行されます。HQueueクライアントはhttp://myServer:5000の場所にあるHQueueサーバーに接続されます。

MacOSでのスクリプトによるインストールは、Houdiniインストーライメージのhoudini-X.X.XXX-macosx_YYY_clangZZ_ZZ.dmgから始めます。 SideFXウェブサイトからそのイメージをダウンロードしてください。

1. (前提条件)インストールするコンポーネントが指定されたChoice XMLファイルを生成する

   • MacOSでのスクリプトによるインストールには、インストーラにどのコンポーネントをインストールするべきか指定されたChoice XMLファイルを事前に生成する必要があります。

   • 以下のコマンドを叩いて、そのChoice XMLファイルを生成します:

     # 以前のHoudiniインストーライメージのマウントが残っていないようにします。
     sudo hdiutil detach /Volumes/Houdini
     # Houdiniインストーライメージをマウントします。
     sudo hdiutil attach houdini-X.X.XXX-macosx_YYY_clangZZ_ZZ.dmg
     # Choice XMLファイルを生成します。
     installer -showChoiceChangesXML -pkg /Volumes/Houdini/Houdini.pkg  -target / &> /tmp/install_choices.xml
     # クリーンアップします。Houdiniインストーライメージをマウント解除します。
     sudo hdiutil detach /Volumes/Houdini
     

   • テキストエディタで/tmp/install_choices.xmlを開き、<integer>1</integer>の行を<integer>0</integer>にすべて置換して、ファイル内のすべてのコンポーネントの選択を解除します。変更をファイルに保存して、テキストエディタを閉じます。

   • /tmp/install_choices.xmlのコピーを2個作成し、1つ目のコピーの名前をサーバーインストール用に/tmp/hqueue_server_install_choices.xmlに、2つ目のコピーの名前をクライアントインストール用に/tmp/hqueue_client_install_choices.xmlに変更します。

   • サーバーインストール用の/tmp/hqueue_server_install_choices.xmlをテキストエディタで開きます。HQueueサーバーコンポーネントを選択する行グループを検索します。その行グループは以下のようになっています:

     <dict>
             <key>attributeSetting</key>
             <integer>0</integer>
             <key>choiceAttribute</key>
             <string>selected</string>
             <key>choiceIdentifier</key>
             <string>hqserver</string>
     </dict>
     

     この行グループ内の<integer>0</integer>を<integer>1</integer>に置換して、インストールでHQueueサーバーコンポーネントが選択されるようにします。変更をファイルに保存して、テキストエディタを閉じます。

   • クライアントインストール用も同様に、/tmp/hqueue_client_install_choices.xmlをテキストエディタで開きます。HQueueクライアントコンポーネントを選択する行グループを検索します。その行グループは以下のようになっています:

     <dict>
                   <key>attributeSetting</key>
                   <integer>0</integer>
                   <key>choiceAttribute</key>
                   <string>selected</string>
                   <key>choiceIdentifier</key>
                   <string>hqclient</string>
           </dict>
     

     この行グループ内の<integer>0</integer>を<integer>1</integer>に置換して、インストールでHQueueクライアントコンポーネントが選択されるようにします。変更をファイルに保存して、テキストエディタを閉じます。

   • これでサーバー用とクライアント用のChoice XMLファイルの準備が出来ました。

   Note

   HQueueサーバー/クライアントのインストールまたはアップグレードの度にサーバー用とクライアント用にこれらのChoice XMLファイルを再生成する必要はありません。 これらのXMLファイルは今後のインストールでも再利用することができます。 Houdiniインストーラのコンポーネントオプションで変更があった場合にのみ、これらのXMLファイルを再生成する必要があります。

2. HQueueサーバーをインストールする

   • 以下のコマンドを叩いて、HQueueサーバーをインストールします:

     # 以前のHoudiniインストーライメージのマウントが残っていないようにします。
     sudo hdiutil detach /Volumes/Houdini
     # Houdiniインストーライメージをマウントします。
     sudo hdiutil attach houdini-X.X.XXX-macosx_YYY_clangZZ_ZZ.dmg
     # HQueueサーバーをインストールします。
     sudo installer -pkg /Volumes/Houdini/Houdini.pkg -target / -applyChoiceChangesXML /tmp/hqueue_server_install_choices.xml
     # クリーンアップします。Houdiniインストーライメージをマウント解除します。
     sudo hdiutil detach /Volumes/Houdini
     

   • HQueueサーバーは/Library/HQueueServerにインストールされ、rootアカウントで実行されます。HQueueサーバーを起動する新しいlaunchctlサービスの/Library/LaunchDaemons/com.sidefx.hqserver.plistも作成されます。

3. HQueueクライアントをインストールする

   • 以下のコマンドを叩いて、HQueueクライアントをインストールします:

     # 以前のHoudiniインストーライメージのマウントが残っていないようにします。
     sudo hdiutil detach /Volumes/Houdini
     # Houdiniインストーライメージをマウントします。
     sudo hdiutil attach houdini-X.X.XXX-macosx_YYY_clangZZ_ZZ.dmg
     # HQueueクライアントファイルをインストールします。
     sudo installer -pkg /Volumes/Houdini/Houdini.pkg -target / -applyChoiceChangesXML /tmp/hqueue_client_install_choices.xml
     # HQueueクライアントインストーラスクリプトを実行します。
     cd /Library/HQueueClient
     sudo ./install.sh --user myUser --hq-server myServer --hq-server-port 5000
     # クリーンアップします。Houdiniインストーライメージをマウント解除します。
     sudo hdiutil detach /Volumes/Houdini
     

   • HQueueクライアントは/Library/HQueueClientにインストールされ、myUserアカウントで実行されます。HQueueクライアントはhttp://myServer:5000の場所にあるHQueueサーバーに接続されます。

Windowsでのスクリプトによるインストールは、Houdiniインストーラ実行可能ファイルのhoudini-X.X.XXX-win64-vcYYY.exeから始めます。 SideFXウェブサイトからその実行可能ファイルをダウンロードしてください。

1. HQueueサーバーをインストールする

   • 以下のコマンドを叩いて、HQueueサーバーをインストールします:

     houdini-X.X.XXX-win64-vcYYY.exe /S /AcceptEULA=20XX-XX-XX /LicenseServer=No /DesktopIcon=No /FileAssociations=No /HoudiniServer=No /SideFXLabs=No /HQueueServer=Yes /Action=install /HQServerInstallDir=C:\HQueueServer /ServiceName=HQueueServer
     

   • HQueueサーバーはC:\HQueueServerにインストールされ、HQueueサーバーを起動する新しいHQueueServerサービスが作成されます。

2. HQueueクライアントをインストールする

   • 以下のコマンドを叩いて、HQueueクライアントをインストールします:

     # HQueueクライアントをインストールします。
     houdini-X.X.XXX-win64-vcYYY.exe /S /AcceptEULA=20XX-XX-XX /LicenseServer=No /DesktopIcon=No /FileAssociations=No /HoudiniServer=No /SideFXLabs=No /HQueueClient=Yes /HQClientInstallDir=C:\HQueueClient /HQClientServerName=myServer /HQClientServerPort=5000
     # マシンを再起動してインストールを完了します。
     shutdown /r
     

   • HQueueクライアントはC:\HQueueClientにインストールされ、インストーラ実行可能ファイルを実行したユーザアカウントで実行されます。HQueueクライアントはhttp://myServer:5000の場所にあるHQueueサーバーに接続されます。