| On this page |
|
Launcherはリリース前のソフトウェアです。 バグまたはワークフローの問題を抱えている可能性があります。 リリースまでに改良できるようにフィードバックを送っていただけるとありがたいです。 |
概要
Launcherアプリケーションをダウンロードすれば、それを使用して複数のバージョンのHoudiniをインストール、管理、実行することができます。 新しいビルドのHoudiniをインストールする時は、Launcherを再インストールする必要はありません。
Houdiniの起動は、Launcherからでも、従来の方法(デスクトップアプリアイコン、または、Houdiniシェルのコマンドラインから)のどちらでも可能です。 Houdiniの起動にはLauncherは必須ではありません。
Launcherを使用してHoudiniをアップグレードした場合、Launcherは 変更された部分のみ をダウンロードします。 これがLauncherを使用する大きなメリットであり、特に、自宅のインターネット接続が遅いユーザに恩恵があります。
Launcherは、ISOイメージファイルからのオフラインインストールにも対応しています。
Launcherのインストールと起動
Windows
-
SideFXのダウンロードページからインストーラファイルをダウンロードして、それを実行します。インストールウィザードの指示に従います。
-
スタートメニューからHoudini Launcherを起動します。
Mac
-
SideFXダウンロードページからLauncherディスクイメージをダウンロードします。それを開いてLauncher appをApplicationsフォルダにドラッグします。
-
ApplicationsフォルダからHoudini Launcher appを起動します。
Linux
-
SideFXダウンロードページからLauncherインストーラファイルをダウンロードします。
-
シェルを開きます。
-
cdでインストーラファイルをダウンロードしたディレクトリに移動します。
-
以下のコマンドラインを実行します:
chmod a+x install_houdini_launcher.sh; install_houdini_launcher.sh -
指示に従います。
Tip
一部のインストーラは、残りのデータをインストーラのパーツとしてダウンロードできるように小さなプログラムになっていることがあります。 すべてのデータを含んだISOイメージバージョンのインストーラをダウンロードすることもできます。 これは、複数のマシンにLauncherをインストールしたり、インターネットアクセスせずにマシンにインストールする場合に役立ちます。
オフラインでHoudiniをインストール
Tip
Houdini ISOイメージには、まだLauncherがインストールされていない人のために便宜的にLauncherインストーラが含まれています。
-
インストールしたいバージョンのHoudiniのISOイメージをダウンロードします。
-
Launcherを起動します。
-
右上にある
ギアメニューをクリックして、 Installation Source ▸ Choose Offline Install Source をクリックします。
-
ISOファイルが含まれているディレクトリに移動して、 Open をクリックします。
-
Launcherウィンドウ内の左側にある Houdini をクリックします。次に Install Houdini をクリックします。
インストールのスクリプト化
Launcherインストールのスクリプト化
SideFX Web APIを介してプログラムからLauncherを取得することができます。
-
sidefx.pyをダウンロードします。このスクリプトには、認証済みでAPIコールするための便利なラッパーが用意されています。
-
以下は、APIを介してLauncherをダウンロードするサンプルコードです。
import sys import os import stat import requests import shutil import subprocess import platform import sidefx CLIENT_ID = "==Your Client Id==" CLIENT_SECRET = "==Your Client Secret==" # 現行プラットフォームが認識されると、SideFX Web APIに渡すことができる現行プラットフォームキーワードが返されます。 # 認識されなかった場合は、空っぽの文字列の''が返されます。 def get_current_platform(): current_platform = platform.system() if current_platform == 'Windows' or current_platform.startswith('CYGWIN'): return 'win64' elif current_platform == 'Darwin': return 'macos' elif current_platform == 'Linux': return 'linux' else: return '' # API関数にアクセス可能なsidefx.serviceオブジェクトを返します。 def create_service(client_id, client_secret_key): return sidefx.service( access_token_url="https://www.sidefx.com/oauth2/application_token", client_id=client_id, client_secret_key=client_secret_key, endpoint_url="https://www.sidefx.com/api/") # "build"引数で指定されたファイルをダウンロードし、ダウンロードに成功したら # そのダウンロードしたファイル名を返します。 def download_build(service, build): platform = get_current_platform() build_info = service.download.get_daily_build_download( build["product"], build["version"], build["build"], platform) download_file(build_info["download_url"], build_info["filename"]) return build_info["filename"] # ホスト先が"url"のファイルをダウンロードし、そのファイル名を"filename"にします。 def download_file(url, filename): with requests.get(url, stream=True) as response: with open(filename, "wb") as open_file: shutil.copyfileobj(response.raw, open_file) make_executable(filename) # "file_path"で指定されたファイルに実行可能権限を追加します。 def make_executable(file_path): stat_info = os.stat(file_path) os.chmod(file_path, stat.ST_MODE | stat.S_IEXEC | stat.S_IXUSR | stat.S_IXGRP | stat.S_IRUSR | stat.S_IRGRP) def run(): product = "houdini-launcher" platform = get_current_platform() service = create_service(CLIENT_ID, CLIENT_SECRET) # デイリービルドのリストを取得します。 # 最新プロダクションビルドが必要であれば、このステップをスキップして構いません。 builds = service.download.get_daily_builds_list( product, version=None, platform=platform, only_production=False) # 利用可能な最新デイリービルドを取得します。 launcher_file = download_build(service, builds[0]) # ==インストール部分はここから始めます== if __name__ == "__main__": run()
-
コードのインストール部分はプラットフォームに依存します。 プラットフォームに応じて以下のコードを上記のスクリプトに追加することでLauncherのインストールを自動化することができます。 Launcherのインストールパスはカスタマイズすることができます。 LinuxとMacOSでは、相対パスと絶対パスのどちらにも対応していますが、Windowsでは、絶対パスしか対応していません。
Windows
# 優先パスを変更して"C:\\houdini_launcher"フォルダにLauncherをインストールします。 # この工程は、インストールパスによってはマシンに対してスーパーユーザーのセキュリティ権限が必要になることに注意してください。 # もし権限が必要であれば、コマンドシェルをアドミニストレータ権限で実行してください。 subprocess.call(["./install-houdini-launcher.exe", "/S", "/D=C:\\houdini_launcher"])
Mac
# Launcherの".dmg"ファイルをマウントします。 subprocess.call(["hdiutil", "attach", launcher_file]) # "houdini_launcher"フォルダがなければ、そのフォルダを作成します。 if not os.path.exists("houdini_launcher"): os.mkdir("houdini_launcher") # 優先パスを変更して現行スクリプトのパスの"houdini_launcher"フォルダにLauncherをインストールします。 subprocess.call(["cp", "-R", "/Volumes/Houdini/Houdini Launcher.app", "houdini_launcher"]) # Launcherの".dmg"ファイルをマウント解除します。 subprocess.call(["hdiutil", "unmount", "/Volumes/Houdini"])
Linux
# 優先パスを変更して現行スクリプトのパスの"houdini_launcher"フォルダにLauncherをインストールします。 # この工程は、インストールパスによってはマシンに対してスーパーユーザーのセキュリティ権限が必要になることに注意してください。 # もし権限が必要であれば、Pythonスクリプトを`sudo`で実行してください。 subprocess.call(["./install_houdini_launcher.sh", "houdini_launcher"])
Houdiniインストールのスクリプト化
Launcherはグラフィカルなプログラムですが、コマンドライン実行可能ファイルもインストールされています。 これは、リモートまたはスクリプトでインストールを行なうのに役立ちます。
非グラフィカルなコマンドライン実行可能ファイルの名前はhoudini_installerです。
Windows
このコマンドラインプログラムはデフォルトではC:/Program Files/SideFX/launcher/binにあります。
Mac
このコマンドラインプログラムは/Applications/Houdini Launcher.app/Contents/MacOSにあります。
Linux
このコマンドラインプログラムはデフォルトでは/opt/sidefx/launcher/binにあります。
| To... | Do this |
|---|---|
インストールの準備をする |
|
インストールをスクリプト化する |
Tip 特別ビルドのHoudiniをインストールしたいのであれば、上記のコマンドに Houdiniバージョン文字列(この例では |
オフラインインストールをスクリプト化する |
|
詳細は、以下のインストールサブコマンドを参照してください。
コマンドラインオプション
houdini_installerの一般的な実行形式は以下のとおりです:
houdini_installer [global_opts] subcommand [subcommand_opts]
…subcommandにはinstall、modify、uninstall、repair、list、install-package、uninstall-packageのどれかを指定します。
ほとんどの場合、installやuninstallのコマンドのみを使用することになります。
以下のように実行すると:
houdini_install [subcommand] [product] --help
…ヘルプ情報が表示されます。
グローバルオプションは以下のとおりです:
-h, --help
ヘルプを表示します。
-q, --quiet
エラー以外の出力を抑えます。
-v, --verbose
もっと詳細な情報をプリントします。
--settings-file INI file
INI fileからログイン資格情報やEULAの同意などの設定を読み込みます。
この設定ファイルは、key = valueの形式の行で構成されたINI書式である必要があります。
対応しているキーは、username, password, client_id, client_secret, accept_eulaです。
アクションするのにユーザーがログインする必要がある場合は、username/passwordやclient_id/client_secretのどちらでも指定することができます。
-o, --log-file file
詳細なインストールログをfileに書き出します。
これは、stdoutに書き出される詳細情報には影響を与えません。
install、modify、repair、install-packageのサブコマンドで利用可能なコマンドオプションは以下のとおりです:
--accept-EULA SideFX-YYYY-MM-DD
エンドユーザライセンス契約に承諾した日付を指定します。
--offline-installer path
オフラインインストーラファイルの場所。
installサブコマンド
新しいプロダクト/バージョンをインストールします。 プロダクトをマシン毎に1回しかインストールできない(例えば、HQueue Server)場合、または、インストールディレクトリに既にそのプロダクトのインストールが含まれていた場合、インストールは開始されないです。
houdini_installer [options] install [install_options] --product <<product>> --version <<version>> [--installdir <<installdir>>]
必須のオプション:
--product product_name
Houdini、"Engine 3ds Max|Maya|Unity|Unreal"、"License Server"、"HQueue Client"、"HQueue Server"のどれか。
スペースを含んだプロダクト名は必ず引用符で閉じてください。例:
houdini_installer install --product "Engine Maya"
--accept-EULA SideFX-YYYY-MM-DD
指定した日付でEnd User License Agreementに同意を示します。
必須のオプション(オンラインインストール):
--version version_number
インストールするプロダクトバージョン(ビルド番号を含む)。
--settings-file file_path
INIファイルからログイン認証とEULAの同意を含んだ構成を読み込みます。
対応しているキーは、username, password, client_id, client_secret, accept_eulaです。
必須のオプション(オフラインインストール):
--offline-installer file_path
オフラインインストーラファイルの場所。
任意のオプション:
--installdir file_path
インストール先のディレクトリ。
--platform platform
インストールするビルドのプラットフォーム識別子。 これは、そのバージョンで利用可能なプラットフォームが複数存在する場合(例えば、linux_x86_64_gcc6.3)にのみ必須です。
--avahi
(Linuxプラットフォームのみ)'apt-get'または'yum'のネイティブパッケージマネージャからAvahiをインストールします。 Avahiをインストールすると、同じローカルネットワーク内の他のマシンからLicense Serverを検索できるようになります。
--for-houdini houdini_version
(Mayaプラグインのみ)指定した<houdini_version>のMayaプラグインをインストールします。 このオプションを渡さなかった場合、デフォルトのMayaプラグインバージョンがインストールされます。
modifyサブコマンド
既存インストールのバージョンを移動/アップグレード/ダウングレードします。
houdini_installer [options] modify [modify_options] installdir
必須の引数:
installdir
インストールディレクトリを含んだディレクトリ。
必須のオプション(オンラインインストール):
--settings-file file_path
INIファイルからログイン認証とEULAの同意を含んだ構成を読み込みます。
対応しているキーは、username, password, client_id, client_secret, accept_eulaです。
必須のオプション(オフラインインストール):
--offline-installer file_path
オフラインインストーラファイルの場所。
オプション:
--installdir installdir
インストールの移動先のディレクトリ。
--version version
更新するバージョン。
--platform platform
更新するビルドのプラットフォーム識別子。
--for-houdini houdini_version
(Mayaプラグインのみ)指定した<houdini_version>のMayaプラグインをインストールします。
--accept-EULA SideFX-YYYY-MM-DD
指定した日付でEnd User License Agreementに同意を示します。
uninstallサブコマンド
インストールされているプロダクト/バージョンを削除します。
houdini_installer [options] uninstall [uninstall_options] installdir
必須の引数:
installdir
アンインストールするインストールを含んだディレクトリ。
repairサブコマンド
壊れたインストール(例えば、ファイルが見つからない)の問題の修復を試みます。
houdini_installer [options] repair [repair_options] installdir
必須の引数:
installdir
修復するインストールを含んだディレクトリ。
オプション:
--settings-file file_path
INIファイルからログイン認証とEULAの同意を含んだ構成を読み込みます。
対応しているキーは、username, password, client_id, client_secret, accept_eulaです。
--offline-installer file_path
オフラインインストーラファイルの場所。
listサブコマンド
インストールされているプロダクト/バージョンをリストします。
houdini_installer [options] list [directory]...
オプションの引数(s):
directory
詳細をリストするインストールディレクトリ。 何も指定しなければ、すべてのインストールに関する詳細がリストされます。
install-packageサブコマンド
URLまたはオフラインISOファイルから新しいHoudiniパッケージをインストールします。 デフォルトのURLはhttps://www.sidefx.com/download/download-labs/packages/です。 そのURLでは異なるバージョンのSideFX Labsが用意されています。 Houdini ISOファイルにはSideFX Labsも同梱されています。
houdini_installer [options] install-package [install_package_options] [--installdir <<installdir>>]
オプション:
--package-name package_name
インストールするパッケージの名前。ダウンロード元から利用可能なパッケージが複数存在する場合、これは必須です。
--url URL
packages.jsonファイルの取得先のURL。 デフォルトでは、Launcherはhttps://www.sidefx.com/download/download-labs/packages/で用意されているパッケージをチェックします。
--installdir file_path
インストール先のディレクトリ。
--settings-file file_path
INIファイルからログイン認証とEULAの同意を含んだ構成を読み込みます。
対応しているキーは、username, password, client_id, client_secret, accept_eulaです。
uninstall-packageサブコマンド
インストール済みのHoudiniパッケージを削除します。
houdini_installer [options] uninstall-package package_path
必須の引数:
package_path
パッケージJSONファイルのパス。例:
houdini_installer uninstall-package "/Applications/Houdini/sidefx_packages/SideFXLabs18.5.json"