| On this page |
Houdiniインストーラは、このプログラムが常に実行されるようにオペレーティングシステムに登録します。 Houdiniを実行できるようにするには、このプログラムが実行されている必要があります。
システムファイルを編集して起動時にsesinetdが実行されるように登録する行為は止めてください。
代わりに、使用したいコマンドラインオプションをsesinetd.optionsファイル内に記述することができます。
このファイルの場所はオペレーティングシステムによって異なります。
Mac
MacOSでは、インストーラは、システムが起動した時にライセンスサーバーが立ち上がるようにデーモンとしてそのライセンスサーバーを登録します(/Library/LaunchDaemons/com.sidefx.sesinetd.plist)。
Windows
Windowsでは、インストーラは、システムが起動した時にライセンスサーバーが立ち上がるようにサービスとしてそのライセンスサーバーを登録します。
オプションはC:\Program Files\Side Effects Software\License Server\内のsesinetd.optionsに記述することができます。
Linux
Linuxでは、インストーラは、ライセンスサーバー用のinit.dスクリプトを作成します。
(これは、さらにシステムの下位互換レイヤーによってsystemdディストリビューション上で取得されます。)
用途に合わせたライセンスセットアップの方法の詳細は、インストールとライセンス設定のガイドを参照してください。
コマンドラインオプション ¶
情報 ¶
--help
このヘルプを表示します。
--ini-help
コンフィグファイルに関するヘルプ情報を表示します。
-v/--version
sesinetdのバージョン文字列をプリントします。
サーバーログ ¶
-V/--min-logfile-level log level
サーバーログレベル。
-
0 = ログなし
-
1 = 致命的エラー(デフォルト)
-
2 = エラー
-
3 = 警告
-
4 = 情報
-
5 = デバッグ
-F/--min-console-level log level
コンソールログレベル。 上記のレベル値を参照してください。
-l/--logfile log file
サーバーログ情報に使用するログファイル。
-z/--max-logfile-size log size
最大ログファイルサイズ。
-d/--append-date
サーバーログに日付を追加します。
-c/--enable-console
ライセンスサーバーからのコンソール出力を有効にします。
Note
Windowsでは、このオプションに対応しておらず、すべての出力がログファイルに書き出されます。
-Y/--log-to-system
システムログファイルにログを書き出します。
ライセンスログ ¶
-W/--license-log-level 0|1
ライセンスログレベル。
-u/--license-logfile log file
ライセンス情報に使用するログファイル。
-y/--max-license-log-size log size
最大ライセンスログファイルサイズ。
ピーク使用状況 ¶
-U/--usage-interval interval
使用状況レポートの間隔を指定します。使用状況レポートを有効にするには、このオプションを指定してください。指定可能な間隔の値:
-
minute
-
5-minute
-
30-minute
-
hour
-
4-hour
-
12-hour
-
day
-G/--include-user
使用状況レポートにユーザ情報を含めます。デフォルトでは、これはオフです。
-i/--peakusage-file file
使用状況レポートファイルの場所を指定します。
--confidential-users
ユーザ情報のログを取る時に、その情報を残せるように内部的に別ファイルのログに取ります。
--upload-usage
sesinetdがピーク使用状況をsidefx.comにアップロードするように指示します。 sesinetdがピーク使用状況をアップロードできるようにするには、さらにclientidとclientsecretも指定する必要があります。
Note
このオプションは、ピーク使用状況に応じた課金を使用しているセットアップでのみ必要です。
サーバー ¶
-p/--port port
非標準ポートを通信に使用します。
-n/--threads threads
使用するスレッドの数を指定します。最低でも4つのスレッドを使用してください。
-m/--read-mask ip mask
クライアントのアクセス権を認証する際に使用する読み込みマスク。
-M/--write-mask ip mask
クライアントのアクセス権を認証する際に使用する書き込みマスク。
-D/--run-in-foreground
Windows以外のプラットフォームでは、sesinetdをバックグラウンドで実行しないでください。
-o/--debug-mode
ライセンスサーバーをデバッグモードにします。
-P/--enable-partitioning
ライセンスの分割を有効にします。
--clientid value
APIキーを用意するのに必要となるクライアントID。 ClientSecretも用意する必要があります。
--clientsecret value
APIキーを用意するのに必要となるクライアントシークレット。 ClientIDも用意する必要があります。
--enable-ipv6
IPv6サポートを有効にします(ベータ)。
--user value
sesinetdを実行するユーザ。www-dataが既にシステム上でセットアップされているかどうかに応じて、デフォルトはwww-dataまたはsesinetdとなります。
--group value
sesinetdを実行するグループ。www-dataが既にシステム上でセットアップされているかどうかに応じて、デフォルトはwww-dataまたはsesinetdとなります。
--disable-redundant-config
sesinetdがDNSキャッシュを更新しなくなります。つまり、DNS名にインストールされているどのライセンスもユーザがチェックアウトできる有効なライセンスではなくなります。
SSL ¶
-B/--enable-ssl
サーバーのSSL対応を有効にします。
--ssl-cert-file file
SSL認証ファイルの場所。
--ssl-priv-file file
SSLプライベートファイルの場所。
--ssl-ca-dir directory
SSL対応の通信用CAディレクトリ。
--ssl-verify-peer
ピアの検証を有効にします。
オプションファイル ¶
オプションファイルは、プラットフォーム固有のライセンスディレクトリ下にsesinetd.iniという名前のファイルで配置します。
Mac
/Library/Preferences/sesi/sesinetd.ini内にオプションを記述することができます。
Windows
C:\Program Files\Side Effects Software\License Server\下のsesinetd.iniファイル内にオプションを記述することができます。
Linux
/usr/lib/sesi/sesinetd.ini内にオプションを記述することができます。
サーバーログ ¶
enableConsole=0|1
ログをコンソールにも出力したい場合は有効にします。
minConsoleLogLevel=level
コンソールの最小ログレベル。
これは、コマンドラインで-Fを設定することと同じです。
minServerLogLevel=level
サーバーログレベル。
これは、コマンドラインで-Vを設定することと同じです。
serverLogFile=file
サーバーログファイルの場所。
これは、コマンドラインで-lを設定することと同じです。
appendDateToServerLog=0|1
サーバーログファイルにログを書き込んでいく時に、日付をそのログファイルに追加します。
これは、検索用途で便利です。
これは、コマンドラインで-dを設定することと同じです。
maxServerLogSize=value
サーバーログファイルにログを書き込める最大ログサイズ。
これは、コマンドラインで-zを設定することと同じです。
logToSystem=0|1
有効にすると、ライセンスサーバーは、セットアップされたログだけでなく、システムにもログを書き出します。
ライセンスログ ¶
licenseLogLevel=0|1
ライセンス情報のログレベル(下記の“ピーク使用状況”のレベル値を参照してください)。
licenseLogFile=file
ライセンスログファイルのパス(下記の“ピーク使用状況”のレベル値を参照してください)。
maxLicenseLogSize=size
ライセンスログの最大ログファイルサイズ。
サーバー ¶
ClientID=value
APIキーを用意するのに必要となるクライアントID。 ClientSecretも用意する必要があります。
ClientSecret=value
APIキーを用意するのに必要となるクライアントシークレット。 ClientIDも用意する必要があります。
port=value
サーバーの実行に使用するカスタムポート。デフォルトは1715です。
これは、コマンドラインで-pを設定することと同じです。
threadCount=value
サーバーの実行に使用するスレッドの数。
デフォルトは6スレッドです。
この値は必ず4以上にしてください。
これは、コマンドラインで-nを設定することと同じです。
readIPMask=mask
サーバーへの読み込みマスク。
これは、サーバー上で読み込みオペレーションの実行が許可されているIPアドレスをサーバーに伝えます。
デフォルトは*.*.*.*で、コマンドラインで-mを設定することと同じです。
writeIPMask=mask
サーバーへの書き込みマスク。
これは、サーバー上で変更オペレーション(例えば、ライセンスのインストール)の実行が許可されているIPアドレスをサーバーに伝えます。
デフォルトは+.+.+.+で、コマンドラインで-Mを設定することと同じです。
enableSSL=0|1
サーバーでSSLの対応を有効にします。
Warning
現在のところ、SSL対応は実験レベルです。
sslCertFile=file
認証ファイルの場所。
sslPrivateFile=file
プライベートSSLファイルの場所。
debugMode=0|1
デバッグモードを有効にします。 これによってログの詳細度が上がり、一部の状況下でログの機能が追加されます。 これは、ライセンスサーバーの問題をデバッグする時に非常に役立ちます。
user=value
sesinetdを実行するユーザ。www-dataが既にシステム上でセットアップされているかどうかに応じて、デフォルトはwww-dataまたはsesinetdとなります。
group=value
sesinetdを実行するグループ。www-dataが既にシステム上でセットアップされているかどうかに応じて、デフォルトはwww-dataまたはsesinetdとなります。
ピーク使用状況 ¶
usageInterval=value
ピーク使用状況の情報のログを取る時に使用される間隔。利用可能なオプション:
-
minute
-
5-minute
-
30-minute
-
hour
-
4-hour
-
12-hour
-
day
includeUser=0|1
使用状況レポートにユーザ情報を含めます。デフォルトでは、これはオフです。
peakusageFile=file
使用状況レポートファイルの場所を指定します。
confidentialUsers=0|1
ユーザ情報のログを取る時に、その情報を残せるように内部的に別ファイルのログに取ります。
uploadUsage=0|1
sesinetdがピーク使用状況をsidefx.comにアップロードするように指示します。 sesinetdがピーク使用状況をアップロードできるようにするには、さらにclientidとclientsecretも指定する必要があります。
はじめよう ¶
ライセンスファイル ¶
キー文字列そのものがローカル上のライセンスファイルに書き込まれます。
オペレーティングシステム上でこのライセンスファイルに .doc または .txt の拡張子を付けないようにしてください。
このファイルの名前は必ずlicensesでなければなりません。
SideFXからあなたのマシン用のライセンスファイルのコピーを受け取ったら、その新しいファイルを読み込ませるためにライセンスサーバーを再起動する必要があります。
Mac
ライセンスファイルの場所は、/Library/Preferences/sesi/licensesです。
Windows
ライセンスファイルの場所は、C:\Program Files\Side Effects Software\License Server\です。
Linux
ライセンスファイルの場所は、/usr/lib/sesi/licensesです。
ライセンスタイプ ¶
-
Workstation ライセンスはノードロックライセンスです。つまり、このライセンスはローカルマシン上で使用することができ、ネットワークを介してフローティングライセンスとして使用することはできません。
-
LAL(ローカルアクセスライセンス) は、最大100km離れた場所までサービスを利用することができます。
-
GAL(グローバルアクセスライセンス) は、場所の制限がありません。
Note
ApprenticeおよびIndieユーザには、ワークステーション(ノードロック)ライセンスのみが発行されます。
ライセンスサーバーの開始/停止 ¶
ライセンスサーバーを開始/停止できるようにするには、 管理者権限(root,sudo) がなければなりません。
最初からApprentice Local Licensingを使ってHoudiniをインストールしていた場合、インストーラを再実行して、 Commercial Licensing を選択する必要があります。 これは、必要なライセンスサーバーツールをインストールします。
Windows
コントロールパネル ▸ 管理ツール ▸ サービス のサービス一覧内のHoudiniLicenseServerでライセンスサーバーを開始/停止することができます。
Linux
/etc/init.dに配置されているsesinetd起動スクリプトを実行します。
/etc/init.d/sesinetd {start|stop}とタイプすることでライセンスサーバーを開始/停止することができます。
Mac
ユーティリティからターミナルを起動します。
そのターミナルで、sudo launchctl unload /Library/LaunchDaemons/com.sidefx.sesinetd.plistとタイプすることでライセンスサーバーを停止することができます。
sudo launchctl load /Library/LaunchDaemons/com.sidefx.sesinetd.plistとタイプすることでライセンスサーバーを開始することができます。
中央サーバーマシン上でライセンスサーバーソフトウェアを再起動しても、リモートクライアントは、通信の心拍がなくなった後(またはライセンスチェックの後)で約5分間はセッションを継続することができます。
ピークの使用状況をログに残す ¶
これは、ライセンス購入の計画で役立つプロダクトタイプ別のピークのライセンス使用状況を監視するための優れたツールです。 間隔(minute, hour, day)を指定すると、そのピークの使用状況とオプションでユーザデータを監視して、需要の拡大に応じてライセンス購入の計画に役立つ色々な表現でログファイルに残すことができます。
使用状況ログのオプション ¶
以下がライセンスサーバー(sesinetd)のオプションです。
-Uは、ログを有効にするための唯一の必須オプションで、このオプションを指定しないと使用状況ログが有効になりません。
利用可能な間隔:
-
minute
-
5-minute
-
30-minute
-
hour
-
4-hour
-
12-hour
-
day
この間隔が短いほどエクスポートに時間がかかるので正しく選択してください。
これは、指定した間隔内で、必要な情報(その間隔内のピークの使用状況、その間隔内でのライセンスを掴んだ人など)が集められ、その間隔の最後に、その間隔内で蓄積されたすべての情報をログファイルに残します。
Note
ライセンスの使用状況のピークが0(その間隔内で誰もそのライセンスを使用していない)の場合、そのライセンスに関して何もログが残りません。
Note
間隔の開始時刻は、前の間隔に丸められます。
例えば、11:00:52amに間隔としてminuteで開始すると、その間隔の開始時刻は11:00:00amとなり、その間隔は11:01:00amに終了してその間の情報がログに残ります。 それ以降は、指定された間隔に基づきます。つまり、最初の間隔の開始時刻が11:00:00amで、次の時刻が11:01:00amとなります。
-iオプションには、ログファイルの場所を指定します。デフォルトの場所は、ライセンスパス内の sesinetd_peak_usage.bin という名前のファイルがある場所です。
Mac
デフォルトのパスは、/Library/Preferences/sesi/sesinetd_peak_usage.binです。
Windows
デフォルトのパスは、C:\Program Files\Side Effects Software\License Server\です。
Linux
デフォルトのパスは、/usr/lib/sesi/sesinetd_peak_usage.binです。
-Gオプションは、指定した間隔内でライセンスを使用した人物のログを取ります。デフォルトでは、ユーザのログを取らず、各ライセンスのピークの使用状況のみのログがファイルに書き出されます。
ピーク使用状況エクスポータ ¶
エクスポータは、ピーク使用状況ログファイルからピーク使用状況情報を抽出する際に使用します。
エクスポータは、他のオプションと併用して異なるフォーマット(例えば、mysql)にエクスポートすることでその情報を正確な仕様に合わせることができます。
このエクスポータは$HHP/parsepeakuserlog.pyに配置されています。
エクスポータの現在利用可能なオプションは以下のとおりです:
--no-progress-info
進捗情報を表示しません。
--verbosity
これはエクスポータをデバッグする時に非常に役立ちます。
--group-by
エクスポータが情報をグループ分けする方法。
現在のところ利用可能な値はhour, day, monthです。
--usage-by-license
プロダクト単位ではなくライセンス単位でピーク使用状況情報を表示します。
--export-dir
エクスポートする情報の書き出し先。
--export-type
エクスポートする情報の書式。
利用可能な値はcsv, mysql, xlsxです。
--export-users
エクスポータが情報をエクスポートする時にユーザ情報を含めるかどうかを指定します。
--csv-dialect
使用するCSVの方言のタイプ。
現在のところ、唯一のオプションはexcelです。
--start-date
エクスポータが情報を取り込んだ時に使用する開始日。
--end-date
エクスポータが情報をエクスポートした時に使用する終了日。
Note
--export-typeでxlsxを使用するには、エクスポータを実行する前にxlsxwriterがインストールされている必要があります。
Note
タイムゾーンをもっと上手く制御したいのであれば、pytz Pythonモジュールを使用すると良いでしょう。
最も正確に時間を制御したいのであれば、tzlocal Pythonモジュールも使用すると良いでしょう。
これらのモジュールはエクスポータを実行する前にインストールされている必要があります。
ピーク使用状況の書式をMySQLでエクスポートしたテーブル ¶
sesinetd_userテーブルには、レポート周期中にライセンスを使用していた各ユーザに関する情報が格納されます。
|
項目 |
データタイプ |
説明 |
|---|---|---|
|
id |
int |
テーブル内のユーザのID。 |
|
username |
varchar(100) |
ログを取ったユーザのユーザ名。 |
|
machine |
varchar(100) |
ログを取ったユーザのマシン。 |
プロダクト別の使用状況 ¶
sesinetd_product_usageテーブルには、指定した間隔内のプロダクト別のピーク使用状況に関する情報が格納されます。
|
項目 |
データタイプ |
説明 |
|---|---|---|
|
product |
enum |
使用状況エントリーのプロダクト名。 |
|
timestamp |
integer |
プロダクト使用状況のタイムスタンプ。 |
|
peak |
integer |
タイムスタンプにおけるプロダクトのピーク使用状況。 |
sesinetd_product_usage_usersテーブルには、指定した間隔内でプロダクトを使用したユーザに関する情報が格納されます。
|
項目 |
データタイプ |
説明 |
|---|---|---|
|
user_id |
integer |
使用状況ユーザのID。 |
|
product |
enum |
使用状況エントリーのプロダクト名。 |
|
timestamp |
integer |
使用状況ユーザのログが取られたタイムスタンプ。 |
ライセンス別の使用状況 ¶
sesinetd_licenseテーブルには、レポート周期中にライセンスされた各ライセンスに関する情報が格納されます。
|
項目 |
データタイプ |
説明 |
|---|---|---|
|
license_id |
varchar(10) |
ログが取られたライセンスのID。 |
|
product |
enum |
ライセンスのプロダクトタイプ。 |
|
version |
decimal |
ライセンスのバージョン。 |
|
quantity |
integer |
ライセンスのトークンの総数。 |
|
expires |
date |
ライセンスの有効期限。 |
|
ip_mask |
varchar(100) |
ライセンスのIPマスク。 |
sesinetd_license_usageテーブルには、指定した間隔内のライセンスのピーク使用状況に関する情報が格納されます。
|
項目 |
データタイプ |
説明 |
|---|---|---|
|
license_id |
varchar(10) |
ログが取られたライセンスのID。 |
|
timestamp |
integer |
使用状況間隔のログが取られた時刻。 |
|
peak |
integer |
指定した間隔内のこのライセンスのピーク使用状況。 |
sesinetd_license_usage_usersテーブルには、間隔内で指定したライセンスを使用していたユーザに関する情報が格納されます。
|
項目 |
データタイプ |
説明 |
|---|---|---|
|
user_id |
integer |
使用状況ユーザのユーザID。 |
|
license_id |
integer |
ユーザが使用していたライセンスのライセンスID。 |
|
timestamp |
integer |
使用状況を取得した間隔のタイムスタンプ。 |
冗長サーバー ¶
Note
これは、以前の冗長システムからまったく新しいシステムであり、その古いシステムと何の関係もありません。
通常のライセンス設定では、すべてのライセンスをサーバーが実行されているマシン名に紐付ける必要があります。 Houdini19.0以降では、ライセンスはDNS名(DNSがセットアップされている場合)またはマシン名(DNSがセットアップされていない場合)のどちらかにインストールします。 定期的にsesinetdはそのDNS名の解決を試みて、その解決した名前がライセンスがインストールされているマシン名と一致するかどうかをチェックします。 名前が一致すれば、sesinetdはそのライセンスを使用可能とマークし、一致しなければそのライセンスを使用不可とマークします。 メインのライセンスサーバーがダウンした場合、そのDNSはバックアップサーバーに切り替えられます。 そのバックアップサーバーへの切り替えは、何かしらの外部プロセス(例えば、IT部門または何かしらの自動プロセス)を介して実行されることに注意してください。 そのバックアップサーバーは、DNSチェックを実施して、以前はメインサーバーでのみ有効だったすべてのライセンスを有効化します。 メインサーバーが再び動作可能になると、そのDNSはメインサーバーに切り替わり、各ライセンスで逆のことが起こります。 sesinetdは延長された間隔でDNSチェックを行なうので、切り替えが起きたら、バックアップサーバー上でDNSチェックを強制更新することを推奨します。 強制更新しなかった場合、バックアップサーバーがライセンスを無効としてマークする期間が発生してしまう可能性があります。
起動しているサーバー上でDNSチェックを強制更新するには、cmd_refresh_redundantコマンドをsesinetdに送信します。
sesinetdにリクエストを送信する方法の詳細は、ここを参照してください。
Warning
DNS名を使用してライセンスをインストールした場合、古いsesinetdはライセンスを使ってDNS名を有効化することができないので、そのライセンスはsesinetdバージョン19以降でのみ使用可能になります。 DNS名を使用するライセンスをバージョン19より前のサーバーで使用する必要がある場合、そのライセンスを返却して、古いhkey/sesictrlを使用してライセンスを再インストールする必要があります。