ライセンスコマンド

ライセンス管理コンソールを使用すると、多くのライセンス管理タスクを簡単に実行できます。一方、コマンドプロンプト上で使用するライセンス管理コマンドでは、管理コンソール上で実行できるタスクに加え、さらに詳細なライセンス管理を行えます。たとえば、lmdiagコマンドでは、ライセンスのチェックアウト時の問題を診断することができます。

ライセンス管理コマンドは、次のフォルダーに配置されます：

• C:\Program Files\Citrix\Licensing\LS（32ビットコンピューター）
• C:\Program Files (x86)\Citrix\Licensing\LS（64ビットコンピューター）

コマンドの説明

• lmadmin— ライセンスの構成を行います。ライセンスの構成および管理タスクについては、ライセンス管理コンソールを使用し、lmadminを使用しないでください。

• lmdiag — ライセンスのチェックアウト時の問題を診断します。

• lmdown — License ManagerデーモンとCitrixベンダーデーモンを正しく停止します（デフォルトでは無効になっています）。

• lmhostid — Citrixのライセンスが使用されるライセンスサーバーの名前を表示します。

• lmreread — License Managerデーモンにライセンスファイルを再読み込みさせて、Citrixベンダーデーモンを起動します。

• lmstat — ライセンスサーバーの状態を表示します。

• lmutil — ライセンス管理コマンドの一覧を表示したり、ほかのコマンドを実行したりします。

• lmver — ライセンスサーバーのバイナリファイルのバージョン情報を表示します。

• udadmin — ライセンス済みのすべてのユーザーとデバイスを表示し、特定のユーザーとデバイスを削除します。このコマンドはユーザーまたはデバイスライセンスにのみ適用します。udadmin -exportを指定すると未処理のユーザーデータとデバイスデータがエクスポートされます。これはライセンスの使用を計算するために使用されるデータであり、使用中のライセンスの一覧ではありません。ライセンス一覧を取得するには、udadmin -listを指定します。

ライセンス管理コマンドの表記規則

ライセンス管理コマンドの表記規則は以下のとおりです：

共通のオプション

次の表は、ライセンス管理コマンドの多くで使用されるオプションを示します：

チェックアウト時の問題の診断（lmdiag）

lmdiagコマンド使用すると、ライセンスをチェックアウトできないときの問題を診断できます。特に、ライセンスが有効で、ライセンスサーバーの動作に問題がないかどうかをテストできます。ライセンスサーバー上でこのコマンドを実行すると、ライセンスのチェックアウトが試行されます。

また、lmdiagコマンドを使用して、特定の種類のライセンスが正しく動作しているかどうかについて確認することもできます。

例：

Citrix Virtual AppsサーバーAdvanced Editionの製品ライセンスのみを対象にして、lmdiagコマンドを実行します。引数としてMPS_ADV_CCUを指定します。

構文：

lmdiag -c license_file_list [-n] [feature[:keyword=value]]

featureパラメーターを指定しない場合、すべての製品ライセンスに対してlmdiagコマンドが実行されます。lmdiagコマンドは、指定したライセンスの情報を表示した後、各ライセンスをチェックアウトします。チェックアウトに成功すると、lmdiagコマンドはチェックアウトが成功したことが表示されます。チェックアウトに失敗すると、lmdiagコマンドによりその理由が表示されます。lmdiagコマンドを実行すると、ライセンスサーバー上のすべてのTCP/IPポートへの接続が試行されます。これにより、ライセンスファイルで指定されているポート番号が正しいかどうかが診断され、lmdiagによりリスニング中のTCP/IPポート番号が一覧表示されます。-c<license_file_list>を指定した場合は指定したファイルが診断されます。

lmdiagコマンドでは、ライセンスのチェックアウトを試行するときに、Citrix製品が動作するサーバーへの接続は行いません。lmdiagコマンドで診断できるのはライセンスサーバー上の問題だけです。つまり、Citrix製品が不正なライセンスサーバーに接続しているために発生する問題は、lmdiagコマンドでは診断できません。たとえば、ライセンスサーバーにその製品のライセンスがない場合などです。このため、Citrix製品側で接続先のライセンスサーバーが正しく設定されていない場合でも、lmdiagコマンドでは正しくチェックアウトできたことを示すメッセージが表示されます。

デーモンの停止（lmdown）

lmdownコマンドを使用すると、ライセンスサーバー上のLicense ManagerデーモンとCitrixベンダーデーモンを停止できますが、lmdownコマンドはデフォルトで無効になっています。有効にするには次の手順に従います：

1. ライセンスサービスを停止します。
2. lmadmin - allowStopServerおよび-allowRemoteStop Server、または-allowRemoteStop Serverを実行します。
3. ライセンスサーバーを再起動します。

構文：

lmdown -c license_file_list [-vendor CITRIX] [-q] [-all]

ライセンスサーバーでlmdownコマンドを実行します。-allオプションを使用して、ネットワーク上のすべてのライセンスサーバーを停止できます。

lmdownが複数のサーバーを認識し、-all引数が指定されていない場合、このコマンドは停止するライセンスサーバーの候補を表示します。たとえば、-c引数で、多数の*.licファイルがあるディレクトリを指定します。-cオプションを使用し、ライセンスサーバーの名前を指定して、リモートのライセンスサーバーを停止します。

注：

WindowsのタスクマネージャーでCitrix Licensingサービスを終了する場合は、License Managerデーモン（lmgrd.exeプロセス）を停止してから、Citrixベンダーデーモン（CITRIX.exeプロセス）を停止してください。

Citrixベンダーデーモンのみを停止し再起動するには、lmdown -c @localhost -vendor CITRIXを使用し、次にlmreread -c @localhost -vendor CITRIXでベンダーデーモンを再起動します。

ホスト名の確認（lmhostid）

lmhostidコマンドを使用すると、そのライセンスサーバーのホストIDが表示されます。このコマンドを使用して、ライセンスサーバーのホスト名を確認できます。ライセンスファイルにライセンスサーバーのホスト名が正しく記述されているかどうかを確認することができます。

注

Citrix Licensingバージョン11.5以降（Windows版）では、複数のライセンスサーバーがある環境で複数のホストIDが表示されます。

構文：

lmhostid -bindingidentifier

ライセンスファイルとオプションファイルの再読み込み（lmreread）

lmrereadコマンドを使用すると、ライセンスファイルやオプションファイルをCitrixベンダーデーモンで再読み込みできます。ライセンスファイルやオプションファイルが再読み込みされると、Citrixベンダーデーモンで新しいファイルが使用されます。

lmrereadコマンドをリモートで実行することはできません。対象となるデーモンが動作しているライセンスサーバー上でこのコマンドを実行します。

構文：

lmreread -c license_file_list [-all] [-vendor CITRIX]

例：

• lmreread -c @localhost \[-all\]
• lmreread -c @client\_access\_point\_name
• lmreread -c /opt/citrix/licensing/myfiles/CITRIX.lic -vendor CITRIX

ライセンス管理コマンド一覧の表示（lmutil）

スタンドアロンで使用する場合、lmutilコマンドを実行すると、ライセンス管理コマンドが表示されます。 lmutilにほかのコマンドを付けて指定すると、そのコマンドが実行されます。

構文：

lmutil

lmutil other_command

例：

• lmutil

  すべてのライセンス管理コマンドを表示します。

• lmutil lmstat -c @localhost

  lmstatコマンドを実行します。

ライセンス使用状況の確認（lmstat）

lmstatコマンドは、ネットワーク上のライセンスの使用状況を監視するときに便利なツールで、以下のライセンスチェックアウト情報を確認できます：

• ライセンスをチェックアウトしている製品
• チェックアウトデータ
• ライセンスファイルのバージョン
• ライセンスサーバーの名前とポート番号
• ライセンスのチェックアウト日時
• Citrixベンダーデーモンの状態や、ライセンスファイルの情報

lmstatコマンドでは、ライセンスサーバーから取得した情報が表示されます。複数の接続によりライセンスが共有されている場合でも、lmstatコマンドでは使用ライセンス数1として表示されます。

構文：

lmstat [-a] [-c license_file_list] [-f [feature]] [-i [feature] [-s[server] [-S [CITRIX]] [-t timeout_value]

lmstat -c@localhost -aの出力例は、次のとおりです。画面レイアウト上、この例では改行されることがあります。

License Server status: 27000@localhost

   License file(s) on localhost: C:\Program Files (x86)\Citrix\Licensing\MyFiles\citrix_startup.lic:C:\Program Files (x86)\Citrix\Licensing\MyFiles\License.lic:

   localhost: license server UP v11.15.0

   Vendor daemon status (on LicenseServer):

      CITRIX: UP v11.15.0

Feature usage info:

   Users of CITRIX: (Total of 10000 licenses issued; Total of 1 licenses in use)

   "CITRIX" v2038.0101, vendor: CITRIX, expiry: permanent(no expiration date)
vendor_string: ;LT=SYS;GP=720;SA=0
floating license

   XDT DDCPrinc-0001.citrix.com XDT XDT_PLT&MPS_PLT_2018.0518 (v1.0) (localhost/27000 102), start Tue 5/8 17:59

Users of CTXLSDIAG: (Total of 10000 licenses issued; Total of 0 licenses in use)

Users of XDT_PLT_CCS: (Total of 200000 licenses issued; Total of 3 licenses in use)

   "XDT_PLT_CCS" v2018.1201, vendor: CITRIX, expiry: 01-dec-2018
vendor_string: ;LT=Retail;GP=720;PSL=10;CL=VDS,VDA,VDE,VDP;SA=0;ODP=0;NUDURMIN=2880;NUDURMAX=525600
floating license

   XDT DDCAux-0001.citrix.com XDT 00001E3A (v2018.0518) (localhost/27000 534201), start Wed 5/9 15:17
   XDT DDCAux-0001.citrix.com XDT 00001E81 (v2018.0518) (localhost/27000 392504), start Wed 5/9 15:18
   XDT DDCAux-0001.citrix.com XDT 00001E0C (v2018.0518) (localhost/27000 419703), start Wed 5/9 15:18
<!--NeedCopy-->

このlmstatの出力でMPS_ENT_CCUの行に含まれる情報は次のとおりです：

多くのライセンスがチェックアウトされている環境では、コマンドlmstat -c@localhost -aにより多くのネットワークトラフィックが発生する場合があります。

lmstat -aを実行すると、ライセンスのチェックアウトデータを確認できます。

バイナリのバージョンの表示（lmver）

lmverコマンドを実行すると、ライセンス管理コマンドなど、指定したバイナリファイルのバージョン情報が表示されます。例外は、lmadminコマンドです。lmadminコマンドのバージョン情報を表示するには、lmadmin -versionを使用します。

構文：

lmver binary

例：

lmver lmdiag

ユーザーやデバイスの表示とライセンスの解放（udadmin）

udadminコマンドを使用すると、ライセンスが割り当てられたユーザーとデバイスを表示したり、特定のユーザーやデバイスのライセンスを解放したりできます。

次の場合に限り、ユーザーのライセンスを解放できます：

• 会社への関連付けがなくなった従業員。
• 長期休暇中の従業員。

デバイスのライセンスの解放が必要になるのは、デバイスが故障した場合などです。

注意：

前述以外の理由により90日の自動解放期間の前に大量のライセンスを解放することは、Citrixのライセンス契約書に反する行為となる場合があります。事前にCitrixに問い合わせてください。

udadminのコマンドラインヘルプは英語のみで表示されますが、このコマンドは英語以外のシステムでも使用できます。

構文：

udadmin [-options] [-delete | -events | -export | -list | -times]

例：

-  udadmin -list -times

    Usage data is 0 minutes old. Next update in 15 minutes.

    Users:

    u01.01 XDT_ENT_UD 2017.1201 (Thu Sep 14 13:41:07 2017)

    u01.04 XDT_ENT_UD 2017.1201 (Thu Sep 14 13:41:07 2017)
    .
    .
    .

    Devices:

    D.ADV.23 XDT_ADV_UD 2017.1201 (Thu Sep 21 18:31:01 2017)

    D01 XDT_PLT_UD 2017.1201 (Tue Sep 12 14:30:33 2017)

-  udadmin -list -a

    Lists all features, versions, counts of licenses, and the users and devices for each feature.

-  udadmin -export

    feature,userId,deviceId,deviceName,versionRequested,versionUserAllocated,versionDeviceAllocated,time

-  udadmin -f XDT_ENT_UD -device dn01.88 -delete

    Releases one device from one feature.

<!--NeedCopy-->