ネットワークライセンスファイルについて

ネットワークライセンス

ネットワークライセンスには、組織がインストールおよび実行するライセンスを保有している各製品の暗号パスコードが記載されています。ネットワークサーバーのライセンス管理者またはシステム管理者は、ネットワークライセンスファイルにアクセスしなければならない場合があります。

MATLAB インストール

MATLAB^® ソフトウェアをインストールするときに、インストーラーはネットワークライセンスファイルの処理を次のように実行します。

サーバー上でインストーラーが次を行います。
- license.dat というネットワークライセンスファイルのコピーを作成し、MATLAB インストールフォルダーの \etc フォルダーに配置します。
- ファイルに SERVER 行と DAEMON 行を追加します。SERVER 行はサーバーホストとポート番号を識別します。DAEMON 行はネットワークライセンスマネージャーデーモンの名前を識別します。
- 処理したライセンスファイルを matlabroot/etc に保存します。ここで、matlabroot は MATLAB インストールフォルダーです。
- インストール時にオプションファイルが作成されると、ライセンスファイルの DAEMON 行に Options= 構文も追加されます。この構文はオプションファイルのパス名を指定します。
  たとえば、使用しているサーバー名が thunderball で IP アドレスが 144.212.111.103 の場合、ライセンスファイルの SERVER 行と DAEMON 行は次のようになります。
```
SERVER thunderball INTERNET=144.212.111.103 27000
DAEMON MLM "C:\Program Files\MATLAB\R2019b\etc\win64\MLM.exe" \
            options="C:\Program Files\MATLAB\R2019b\etc\mlm.opt"
```
クライアントマシン上でインストーラーが次を行います。
- 指定したライセンスファイルのコピーを network.lic という名前で作成し、MATLAB クライアントのインストールフォルダーにある \licenses フォルダーに配置します。
- SERVER 行はそのまま残して、すべての INCREMENT 行と DAEMON 行をライセンスファイルから削除します。また、ファイルにステートメント USE_SERVER を追加します。この行はクライアントにサーバー上のネットワークライセンスファイルを指定します。ファイルには製品のすべてのパスコードが記載されています。

MATLAB 検索パス

MATLAB は起動時にライセンスファイルを読み取り、製品のライセンスを確認します。MATLAB は次の場所を順番に検索してライセンスファイルを見つけます。

MATLAB の起動コマンドラインで、-c オプションを使用して指定されたライセンスファイル。
環境変数 MLM_LICENSE_FILE および LM_LICENSE_FILE。
プログラムを起動したユーザーのプロファイルフォルダー
MATLAB インストールの \licenses フォルダーにある license.dat というファイル、または拡張子 .lic をもつ任意のファイル。

ライセンスファイルが見つかると、MATLAB は検索を停止します。

MATLAB 検索パスの設定

既定では、MATLAB はライセンスファイルをクライアントマシン上の MATLAB クライアントインストールフォルダーにある \licenses フォルダーにインストールします。ただし、次のいずれかの方法でこの場所を上書きすることができます。

MATLAB の起動時にコマンドラインで -c オプションを使用してライセンスファイルのパスを指定します。MATLAB はこのパスを最初に検索します。
検索を行うパスの一覧を指定できます。-c オプションを使用すると、環境変数の検索を明示的に禁止することになります。-c オプションを使用するときには、次のことに注意してください。
- ライセンスファイルへのパスがスペースを含む場合は、パス名を引用符で囲みます。
- 複数のライセンスファイルを指定する場合は、ライセンスファイルの一覧全体を引用符で囲みます。
環境変数を設定します。MATLAB はこれらのパスを 2 番目に検索します。
- MLM_LICENSE_FILE - ライセンスファイルの場所を指定しますが、MathWorks^® 製品のみに適用されます (MathWorks 製品のみに影響するため推奨)。
  MATLAB はこの環境変数を最初に検索します。
- LM_LICENSE_FILE - このサーバーでネットワークライセンスマネージャーを使用するすべてのアプリケーションのライセンスファイルの場所を指定します。
ライセンスをユーザー 1 人に限定します。MATLAB はこのパスを 3 番目に検索します。
MATLAB は、プログラムを起動したユーザーのプロファイルフォルダーを検索します。特定ユーザーによる使用に制限されたライセンスの場合、アクティベーションアプリケーションによって、ライセンスファイルは対象ユーザーのプロファイル内のフォルダに格納されます。

ネットワークライセンスファイルの内容

ネットワークライセンスファイルとは特殊な形式の ASCII テキストファイルで、実行するライセンスのある各製品の暗号パスコードが記載されています。各製品のパスコードは、該当する製品で使用可能なライセンスキーの数を指定します。各製品に関連付けられているライセンスキーの使用状況に応じて、その製品へのアクセスを許可するか拒否するかがネットワークライセンスマネージャーによって決定されます。

各 INCREMENT 行は、製品、製品に対して使用可能なキーの数、その他の情報を指定します (この例に示されているすべての要素が実際のライセンスファイルの INCREMENT 行に含まれているとは限りません)。
バックスラッシュまたは円記号 (\) は、その行が次の行に続くことを示します。
シャープ記号 (#) で始まる行はコメント行です。MathWorks インストーラーは、インストール中のライセンスファイル処理時に、これらのコメント行にあるライセンスサーバーホストの ID またはインターネットアドレスなどの情報を使用します。

# BEGIN-------cut here-------CUT HERE-------BEGIN
# MATLAB license passcode file.
# LicenseNo: 12345           HostID: INTERNET=144.212.101.43
INCREMENT TMW_Archive MLM 18 01-sep-2015 0  \
	BC9DE773A77D15AF8 VENDOR_STRING=83 HOSTID=DEMO SN=12345
INCREMENT MATLAB MLM 18 01-sep-2015 1  \
	4C9D3348561BE9E3B USER_BASED DUP_GROUP=U SN=12345
INCREMENT SIMULINK MLM 18 01-sep-2015 1  \
	1CD148466EF58DF8B USER_BASED DUP_GROUP=U SN=12345
INCREMENT Signal_Toolbox MLM 18 01-sep-2015 1  \
	6CF74B458BA143DC3 USER_BASED DUP_GROUP=U SN=12345
# END---------cut here-------CUT HERE-------END

ネットワークライセンスファイルの変更

一般に、サーバーやクライアントマシン上のネットワークライセンスファイルを変更する必要はありません。ただし、次のような場合にはライセンスファイルを編集しなければなりません。

ライセンスサーバーの名前を変更する場合 (たとえば、ライセンスを新しいサーバーでホストする場合など)。ネットワークライセンスの更新を参照してください。
ポート番号を変更する場合 (たとえば、サーバーのポートアドレスが変更された場合など)。Migrate MATLAB Client Installations to New License Server を参照してください。
ネットワークインストールを新しいライセンスファイルで更新する場合。Update License File on License Server を参照してください。