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

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

ネットワークライセンスには、組織がインストールおよび実行するライセンスを保有している各製品の暗号パスコードが記載されています。

一般に、サーバーまたはクライアントコンピューター上のネットワークライセンスファイルを変更する必要はありません。しかし、状況によっては、ライセンスファイルを編集しなければならない場合もあります。

ライセンスサーバーの名前を変更する場合 (たとえば、ライセンスを新しいサーバーでホストする場合など)。ネットワークライセンスの更新を参照してください。
ポート番号を変更する場合 (たとえば、サーバーのポートアドレスが変更された場合など)。How do I migrate my MATLAB clients to a new license server when the license server changes? を参照してください。
ネットワークインストールを新しいライセンスファイルで更新する場合。MATLAB^® Answers の How do I update the license file used by the Network License Manager? を参照してください。

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

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

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

# BEGIN---------------BEGIN---------------BEGIN
# MATLAB license passcode file.
# LicenseNo: 123456           HostID: 6C4B905F446E
#
# R2021b
#
INCREMENT MATLAB MLM 46 30-jan-2025 13 FDC7243F4976  \
        VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0:  \
        DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720  \
        NOTICE=product=MATLAB SN=123456 SIGN="00C8 0547 EFDF 50D7 B9CE  \
        4C9D 3348 561B E9E3 6CCA 7986 C2F6 38C8 794F EE84"
INCREMENT SIMULINK MLM 46 30-jan-2025 1 7DE4D05FF067  \
        VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0:  \
        DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720  \
        NOTICE=product=SIMULINK SN=123456 SIGN="00BE C534 0A32 1821  \
        AFCE D040 2085 3E00 9005 4983 7EFB 875F E4A7 FEE6 9548"

ライセンスの処理

ネットワークライセンスマネージャーまたは MATLAB ソフトウェアのインストール時に、インストーラーはサーバーマシン用とクライアントマシン用のネットワークライセンスをそれぞれ処理します。

サーバーへのネットワークライセンスマネージャーのインストール中

サーバー上でインストーラーが次を行います。

license.dat というネットワークライセンスファイルのコピーを作成し、ファイルを処理して SERVER と DAEMON の行を追加し、ネットワークライセンスマネージャーをインストールする /etc フォルダーにこのコピーを配置します。
SERVER 行はサーバーホストとポート番号を識別します。DAEMON 行はネットワークライセンスマネージャーデーモンの名前を識別します。
ネットワークネームドユーザーライセンスについては、インストール時にインストーラーでオプションファイルが作成されると、ライセンスファイルの DAEMON 行に Options= 構文も追加されます。この構文はオプションファイルのパス名を指定します。
たとえば、使用しているサーバー名が thunderball で MAC アドレスが 03:42:f8:1b:b2:72 の場合、ライセンスファイルの SERVER 行と DAEMON 行は次のようになります。
```
SERVER thunderball 03:42:f8:1b:b2:71
DAEMON MLM "C:\Program Files\MATLAB\R2024a\etc\win64\MLM.exe" \
            options="C:\Program Files\MATLAB\R2024a\etc\mlm.opt"
```

クライアントコンピューターへの MATLAB のインストール中

インストーラーを実行するには、まずネットワークライセンスマネージャーのインストール中に構成された license.dat ファイルをコピーし、クライアントマシンまたはネットワークからアクセス可能な場所のいずれかに配置する必要があります。

次に、インストール中に、インストーラーは license.dat のコピーを作成し、それを処理してライセンスファイルから INCREMENT 行と DAEMON 行を削除して、SERVER 行はそのまま残します。また、ファイルにステートメント USE_SERVER を追加します。この行はクライアントにサーバー上のネットワークライセンスファイルを指定します。ファイルには製品のすべてのパスコードが記載されています。

この構成済みファイルに network.lic という名前を付け、そのファイルを matlabroot\licenses に配置します。

メモ

ライセンスセンターからダウンロードしたライセンスファイルをユーザーに提供しないでください。ユーザーは、ネットワークライセンスマネージャーのインストール中に特別に構成されたライセンスファイルを使用する場合にのみ、インストールができます。

MATLAB ライセンスの検索パス

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

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

MATLAB がネットワークライセンスサーバーからチェックアウトされると、同じセッションでチェックアウトされるすべてのツールボックスもそのライセンスサーバーから取得されます。パス上のライセンスファイルがサーバーライセンスではない場合 (つまり、インディビジュアル、コンピューター指定、または評価版のスタンドアロンライセンスファイルである場合) でも、ツールボックスはそのファイルまたはライセンスサーバーからチェックアウトできます。

MATLAB ライセンスの検索パスの設定

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

MATLAB の起動時にコマンドラインで -c オプションを使用して、ライセンスファイルへのパスを指定します。
-c オプションは環境変数を含む検索順序全体をオーバーライドし、コマンドラインに指定されている内容 "のみ" を使用します。これは MATLAB が検索する "唯一の" パスです。
検索を行うパスの一覧を指定できます。-c オプションを使用するときには、次のことに注意してください。
- ライセンスファイルへのパスにスペースが含まれる場合は、パス名を引用符で囲みます。
- 複数のライセンスファイルを指定する場合は、必ずライセンスファイルのリスト全体を引用符で囲みます。
環境変数を設定します。
"MLM_LICENSE_FILE" は、MATLAB 製品のライセンスファイルの場所を指定します。MathWorks は、まずこの環境変数を検索します。

メモ

環境変数 LM_LICENSE_FILE を設定できますが、この変数はすべての Flex 対応製品に影響を与えるため、使用は推奨されません。代わりに、<VENDOR>_LICENSE_FILE を使用してください。

メモ

環境変数 MLM_LICENSE_FILE を使用している場合は、matlab/licenses/network.lic を削除する必要があります。

ネットワークライセンスの更新

製品やシート数の変更により MathWorks から新しいライセンスを受け取った場合、MATLAB ライセンスにユーザーがアクセスする可能性の最も低い時間に、ネットワークサーバー上のライセンスファイルを更新するように計画してください。この手順では、ネットワークライセンスマネージャーの停止と起動が必要です。再読み取りは特定のライセンスに影響を及ぼす可能性があるため、実行しないでください。

この手順は、この時点ではライセンスマネージャーソフトウェアを更新しないことを前提とします。更新する場合は、ネットワークライセンスマネージャーソフトウェアの更新も参照してください。

メモ

MATLAB を新しいリリースにアップグレードする目的でこの手順を使用しないでください。後のリリースにアップグレードする場合は、新しい MATLAB リリースの入手を参照してください。

ライセンスファイルの更新を行うのはライセンス管理者でなければなりません。

サーバー上のライセンスファイルを更新するには、次を行います。

MathWorks Web サイトのライセンスセンターにアクセスし、アカウントにサインインします。
更新するライセンスを選択します。
[インストールとアクティベーション] をクリックします。
更新するサーバー用のライセンスファイルを取得します。
ネットワークライセンスマネージャーを停止します。
サーバー上の既存のライセンスと新しいライセンスの両方をエディターで開きます。以下の手順に従って、新しいライセンスの大部分を古いライセンスにコピーします。
1. 既存のライセンスで、ファイルの先頭にある SERVER 行と DAEMON 行を除くすべてのコンテンツを削除します。
2. 新しいライセンスで、SERVER 行と DAEMON 行の下から末尾までのすべてのコンテンツをコピーします。
3. コピーしたコンテンツを、既存のライセンスの SERVER 行と DAEMON 行の下に貼り付けます。
4. 既存のライセンスを保存します。新しいライセンスをバックアップとして保存できます。ただし、SERVER 行と DAEMON 行は組織固有のものに置き換えなければならない点に注意してください。
オプションファイルがある場合、その構成によっては更新が必要なこともあります。オプションファイルがない場合はこの手順を省略します。
ネットワークライセンスマネージャーを起動します。