Created on | Updated on
フォローする

カスタムインストールに関して

このページの情報は上級ユーザー向けです。 間違ってパスをカスタマイズすると、Redshiftが正しく実行できなくなります。

このセクションでは、Redshiftバイナリとデータファイルの場所をカスタマイズするためのさまざまなオプションについて説明します。 これは、1台のマシンに複数のバージョンのRedshiftを並べてインストールすることを支援するために使用できます。

Path

Redshiftでは、次のパスが使用されます。

  • Plugin Path – Redshift DCCプラグインを含むパス。
  • Core Data Path – シェーダバイナリやその他のGPUカーネルを含むコアRedshiftデータファイルを含む最上位パス。 このパスは、一元配置シナリオで複数のマシン間で安全に共有できます。
  • Local Data Path – ログディレクトリを含む最上位のパスと、ライセンスと環境設定ファイルのデフォルトの場所です。 このファイルは、複数のマシン間で共有することはできません。
  • Procedurals Path –Redshift proceduralsの検索パス
  • Preferences File Path – preferences xmlファイルへのフルパス。
  • License Path – ライセンスファイルをスキャンするパス。

Default Path

Windows

Core data path C:\ProgramData\Redshift
Local data path C:\ProgramData\Redshift
Procedurals path <core data path>\Procedurals
License path <local data path>
Preference file path <local data path>\preferences.xml
Log file path <local data path>\Log


Linux

Core data path /usr/redshift
Local data path ~/redshift
Procedurals path <core data path>/procedurals
License path <local data path>
Preference file path <local data path>/preferences.xml
Log file path <local data path>/log

macOS

Core data path /Applications/redshift
Local data path ~/redshift
Procedurals path <core data path>/procedurals
License path <local data path>
Preference file path <local data path>/preferences.xml
Log file path <local data path>/log

上記で説明したデフォルトの動作は、環境変数を設定するか、パス設定XMLファイルを使用して上書きすることができます。

環境変数を使用したパスのカスタマイズ

 
次の環境変数を設定すると、上記のデフォルトを上書きします。
  • REDSHIFT_COREDATAPATH – Core Data Pathをオーバーライドする
  • REDSHIFT_LOCALDATAPATH – Local Data Pathをオーバーライドする
  • REDSHIFT_PROCEDURALSPATH – Procedurals Pathをオーバーライドする
  • REDSHIFT_PREFSPATH – Preferences File Path (preferences.xmlファイルへのファイル名を含むフルパス)をオーバーライドする
  • REDSHIFT_LICENSEPATH – License Path (ライセンスファイルのプライマリ検索パス)をオーバーライドする

 例:一元配置

Redshiftが多くのマシンに導入されている環境では、新しいバージョンがリリースされるたびに(通常は数日おきに)Redshiftインストーラを各マシンで実行することに負担がかかります。
システム管理者は、環境変数を使用してRedshiftデータパスをカスタマイズすることで、バージョンの更新で単一の共有ネットワークの場所を更新するだけで済み、プロセスを大幅に簡素化できます。

集中型ネットワーク共有からRedshiftを実行するには、1)必要なファイルを集中型ネットワーク共有に収集する、2)ネットワーク共有からデータファイルを読み込むようにRedshiftコアを構成する、3)各ホストアプリケーションを構成する(Maya、3ds Maxなど) ...)適切なRedshiftプラグインとその依存関係を見つける。

必要なファイルの収集

次のステップでは、Redshiftコアを設定して、ネットワーク共有内のデータを探します。 これを行うには、各レンダーマシンで環境変数REDSHIFT_COREDATAPATHを定義します。 たとえば、// server / share / Redshiftに必要なファイルを収集した場合は、REDSHIFT_COREDATAPATHを// server / share // Redshiftに設定します。 環境変数の設定方法に関する具体的な手順は、このドキュメントの範囲を超えていますが、システム管理者にはよく知られています。

ホストアプリケーションの設定

上記のようにRedshiftコアを設定したら、ネットワーク共有上の適切なRedshiftプラグインを見つけるようにホストアプリケーションを設定する必要があります。 必要な手順は、ホストアプリケーション固有であり、以下で説明します。

Maya

ネットワーク共有上でredshift4mayaプラグインを見つけるようにMayaを設定するには、以下のようにMayaモジュールファイルを作成し(必要に応じてMayaのバージョンを変更する)、Mayaのモジュール検索パスのどこかに置きます。 中央の場所からMayaモジュールを共有するには、環境変数MAYA_MODULE_PATH(各レンダリングマシン上)をネットワーク共有を指すように定義します。 あるいは、モジュールファイルを各レンダリングマシンにコピーすることができます。

Windows

+ MAYAVERSION:2017 redshift4maya any %REDSHIFT_COREDATAPATH%
scripts: Plugins/Maya/Common/scripts
icons: Plugins/Maya/Common/icons
plug-ins: Plugins/Maya/2017/nt-x86-64
MAYA_CUSTOM_TEMPLATE_PATH +:= Plugins/Maya/Common/scripts/NETemplates
REDSHIFT_MAYAEXTENSIONSPATH +:= Plugins/Maya/2017/nt-x86-64/extensions
REDSHIFT_PROCEDURALSPATH +:= Procedurals
PATH +:= bin

Linux and macOS

+ MAYAVERSION:2017 redshift4maya any $REDSHIFT_COREDATAPATH
scripts: Plugins/Maya/Common/scripts
icons: Plugins/Maya/Common/icons
plug-ins: Plugins/Maya/2017/nt-x86-64
MAYA_CUSTOM_TEMPLATE_PATH +:= Plugins/Maya/Common/scripts/NETemplates
REDSHIFT_MAYAEXTENSIONSPATH +:= Plugins/Maya/2017/nt-x86-64/extensions
REDSHIFT_PROCEDURALSPATH +:= Procedurals
PATH +:= bin

3ds Max

集中型Redshiftインストールで3ds Maxを使用するには、ネットワーク共有から各マシンの3ds Maxインストールフォルダにファイルをコピーする必要があります。 次の例は、コマンドラインからこれを実行する方法の例です(3ds Max 2018では、他のバージョンで必要に応じて変更します)。 これらのコマンドは各レンダリングマシンで実行する必要があり、管理者権限が必要な場合があります(3ds Maxインストールフォルダに書き込むため)。

copy /Y %REDSHIFT_COREDATAPATH%\Plugins\3dsMax\2018\redshift4max.dlr C:\Program Files\Autodesk\3ds Max 2018\plugins\
copy /Y %REDSHIFT_COREDATAPATH%\Plugins\3dsMax\scripts\* to C:\Program Files\Autodesk\3ds Max 2018\scripts\
copy /Y %REDSHIFT_COREDATAPATH%\bin\redshift-core-vc100.dll C:\Program Files\Autodesk\3ds Max 2018\
copy /Y %REDSHIFT_COREDATAPATH%\bin\OpenImageIO-1.6.17-vc100.dll C:\Program Files\Autodesk\3ds Max 2018\

 Softimage

各マシンのワークグループを共有ネットワークの場所に設定します(または既存の共有ワークグループを使用する)。 次に、適切なRedshift .xsiaddonを共有ワークグループにインストールします(この手順は、1台のマシンで行う必要があります)。

Redshift .xsiaddonを共有ワークグループに手動でインストールする代わりに、xsiaddonExtractorツールを使用してxsiaddonの内容を任意のフォルダに抽出することもできます。

構文は次のとおりです。

xsiaddonExtractor.exe [-output ]

 -output引数はオプションです。 省略すると、アドオンがカレントディレクトリに展開されます。

これにより、redshift4softimage2014.xsiaddonの内容がToolsディレクトリ(xsiaddonExtractor.exeが存在する場所)に抽出されます。

xsiaddonExtractor.exe ..\Plugins\Softimage\redshift4softimage2014.xsiaddon

 これにより、redshift4softimage2014.xsiaddonの内容がネットワークフォルダ\\ server \ share \ RedshiftWorkgroupに抽出されます。

xsiaddonExtractor.exe -output \\server\share\RedshiftWorkgroup ..\Plugins\Softimage\redshift4softimage2014.xsiaddon

Cinema 4D

Cinema 4Dは、C4D_PLUGINS_DIR環境変数で指定された追加の場所からプラグインを読み込むことをサポートしています。 これは、Cinema 4Dの適切なバージョンのReshiftプラグインをコピーできるネットワーク上の場所に転送することができます。

たとえば、C4D_PLUGINS_DIR環境変数を\\ server \ share \ C4D_PLUGINS_R19に設定してから、R19 Redshiftプラグインフォルダをこの場所にコピーすることができます。

誤ったインストールでの問題を防ぐため、Redshiftコアのバージョンが期待バージョンと一致しない場合、プラグインはロードされません。 さらに、1つ以上のCinema 4Dプラグインの場所で複数のインスタンスが検出された場合でも、ロードを拒否します。 これらのいずれかの条件が発生すると、次のメッセージがCinema 4D Consoleウィンドウに表示され、ログに記録されます。

Redshift: Plugin initialization failed. Please ensure that Redshift has been installed correctly and it matches this version of the plugin.

その場合は、Cinema 4DのプラグインパスにRedshiftプラグインが1つしかないこと、Redshiftコアの正しいバージョンがRedshift固有の環境変数(REDSHIFT_COREDATAPATHなど)を介してプラグインによってまたはパス設定XMLファイルを介して見つけられることを確認してください。

Houdini

ネットワーク共有上でredshift4houdiniプラグインを見つけるようにHoudiniを設定するには、各レンダリングマシンの環境変数HOUDINI_PATHにredshift4houdiniプラグインへのパスを追加する必要があります。 これは、システム環境変数を設定するか、houdini.envファイルを変更することで実現できます。 Windowsでは、redshift4houdiniが依存関係を見つけるために、RedshiftコアdllへのパスをシステムPATH環境変数に追加する必要もあります。 また、変数HOUDINI_DSO_ERRORを定義し、その値を2に設定することをお勧めします。例は、Houdini 16.0.705の場合の例です。 実行しているHoudiniのバージョンに応じて、必要に応じて変更してください。

houdini.envファイルで変数を定義するときは、プラットフォームに関係なく、環境変数とパス区切り記号にLinuxスタイルの構文を使用する必要があります。

Windows上のhoudini.envファイルの例

HOUDINI_DSO_ERROR = 2
HOUDINI_PATH = "$REDSHIFT_COREDATAPATH/Plugins/Houdini/16.0.705;&"
PATH = "$REDSHIFT_COREDATAPATH/bin;$PATH"

LinuxおよびmacOS上のhoudini.envファイルの例

HOUDINI_DSO_ERROR = 2
HOUDINI_PATH = "$REDSHIFT_COREDATAPATH/redshift4houdini/16.0.705;&"

末尾のセミコロン ';'とアンパサンド '&'文字に注意してください。 。 これは、Houdiniが独自のネイティブプラグインを見つけられるようにするために重要です。 

Katana

ネットワーク共有上にredshift4katanaプラグインを見つけるようにKatanaを設定するには、redshift4katanプラグインへのパスを各レンダリングマシンのKATANA_RESOURCES環境変数に追加する必要があります。 これは、システム環境変数を設定するか、Katanaランチャーを変更することで実現できます。

Windowsでは、redshift4katanaが依存関係を見つけるために、RedshiftコアdllへのパスをシステムPATH環境変数に追加する必要もあります。 同様に、Linuxでは、Redshiftコアライブラリを指すようにLD_LIBRARY_PATHを変更する必要があります。

変数DEFAULT_RENDERERを定義し、その値をRedshiftに設定することもお勧めします。 Katana 2.6v1の例を以下に示します。 実行中のKatanaのバージョンに応じて必要に応じて変更してください。

Windows上のKatanaランチャースクリプトに追加する変数の例

set "PATH=%REDSHIFT_COREDATAPATH%/bin;%PATH%"
set "KATANA_RESOURCES=%REDSHIFT_COREDATAPATH%/Plugins/Katana/2.6v1;"
set "DEFAULT_RENDERER=Redshift"

 Linux上のKatanaランチャースクリプトに追加する変数の例

#render plugins
export LD_LIBRARY_PATH="${REDSHIFT_COREDATAPATH}/bin:${LD_LIBRARY_PATH}"
export KATANA_RESOURCES=${REDSHIFT_COREDATAPATH}/redshift4katana/katana2.5v4
export DEFAULT_RENDERER=Redshift

 一元インストールの更新

一元Redshiftインストールを新しいバージョンに更新するには、ネットワーク共有の内容を新しいファイルに置き換えるだけです。 Softimageの場合、共有ワークグループの既存のRedshiftアドオンファイルを、1台のマシン上の共有ワークグループに適切な.xsiaddonをインストールするか、Redshiftに含まれているxsiaddonExtractor.exeツールを使用して置き換える必要があります。

Path ConfigurationXMLを使用したパスのカスタマイズ

環境変数を使用する代わりに、ホストアプリケーションによってロードされるRedshiftプラグインと同じフォルダにpathconfig.xmlという名前のファイルを配置することによって、さまざまなRedshiftパスをカスタマイズすることもできます。 この方法は、パス設定を特定のプラグインの場所に結びつけるために便利です。プラグインの場所を設定するだけで、特定のバージョンのホストアプリケーションでRedshiftのバージョンを切り替えることができます。

pathconfig.xmlの形式は非常に簡単です。 次の形式の行が1行以上含まれている必要があります。

<path name="PATH_VARIABLE" value="//server/share/path" />

 たとえば、REDSHIFT_COREDATAPATHを// server / share / rs-core-data-pathに設定するには、次の行を追加します。

<path name="REDSHIFT_COREDATAPATH" value="//server/share/rs-core-data-path" />

xmlファイルにすべての変数を設定する必要はありません。 たとえば、REDSHIFT_COREDATAPATHを設定して他のものを省略することができます。これにより、コアデータパスを除くすべてのパスについてデフォルトの動作が行われます。

注意

パスの値は、環境変数の拡張をサポートしています。

server / shareという値を持つSERVER_SHAREという名前の環境変数がすでに存在する場合は、%SERVER_SHARE%(windows)または$ SERVER_SHARE(Linux / macOS)としてxmlに値を設定できます

パス解決規則

さまざまなパスは、最初にpathconfig.xmlエントリを確認した後、環境変数をチェックし、次にデフォルト値を使用して解決されます。

0 コメント

記事コメントは受け付けていません。