ライセンス 11.17.2 ビルド 52100

ライセンスコマンド

Citrix Licensing Managerは多くのライセンス機能にアクセスする簡単な方法を提供しますが、コマンドを使用してライセンス関連のタスクを実行することもできます。コンソールでは利用できないLicense Serverでの高度な操作には、ライセンス管理コマンドを使用する場合があります。このような操作には、lmdiagを使用したチェックアウトの問題診断が含まれます。

  • ライセンス管理コマンドは、次の場所に格納されています。

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

ライセンスコマンドの説明

注:

License Serverバージョン11.16.6ビルド34000では、既存のユーザー管理lmadmin.exeがCitrix独自のユーザー管理lmgrd.exeに置き換えられています。lmadminを使用しないようにしてください。

ライセンスコマンド 説明
lmgrd ライセンスサーバーおよびその他の関連プロセスを開始および管理します。lmgrdは、CitrixライセンスWindowsサービスに使用されるコアライセンスサーバーファイルです。ライセンスサーバーポート(デフォルト27000)をホストします。ライセンスの構成および管理タスクには、Citrix Licensing Managerを使用してください。
lmdiag ライセンスのチェックアウトの問題を診断します。
lmdown License ManagerおよびCitrix®ベンダーデーモンを正常にシャットダウンします(デフォルトで無効)。
lmhostid Citrix Licensingが実行されているサーバーのホストIDを報告します。
lmreread License Managerデーモンにライセンスファイルを再読み込みさせ、Citrixベンダーデーモンを開始させます。
lmstat License Serverのステータスを表示します。
lmutil ライセンスされたユーティリティのリストを表示するか、他のコマンドを実行します。
lmver ライセンスバイナリのバージョン情報を表示します。
udadmin ライセンスされたすべてのユーザーとデバイスを表示し、指定されたライセンスされたユーザーとデバイスを削除します。このコマンドは、ユーザー/デバイスライセンスにのみ適用されます。ライセンスのリストを取得するには、udadmin -listを指定します。
CtxManageUserAndGroup License Serverを管理するためのユーザーおよびグループアクセスを構成します。
CtxManageUserAndGroup.exe –useradd “domain\username” -Role “admin/user” ユーザーを追加するコマンド。
CtxManageUserAndGroup.exe –useradd “domain\username” –Role “adminGroup/userGroup” グループを追加するコマンド。

ライセンスコマンドの書式

ライセンス管理コマンドの書式規則:

規則 説明
太字 lmstatなどのコマンドまたはスイッチ。
斜体 変数を値に置き換えます。たとえば、式lmstat -c license_file_listでは、コマンドを実行する前にlicense_file_listを1つ以上のライセンスファイル名に置き換えます。
[角かっこ] テキストを囲む角かっこは、コマンドに追加できるオプションを示します。角かっこ内のテキストを置き換える必要があることを示す場合もあります。例:lmstat [-a] [-c license_file_list] [-f [feature]]は次のように記述できます:C:\Program Files (x86)\Citrix\Licensing\LS>lmstat.exe -a -c @localhost -f XDT_ENT_UD

共通引数

ほとんどのライセンス管理コマンドに有効な引数:

引数 説明
-all License Serverに関するすべての情報を表示します。
-c ライセンスファイルまたはLicense Serverのポートとホスト名を指定できます。ライセンスファイル名を指定せずにパスを指定すると、コマンドはディレクトリ内のすべてのライセンスファイルに適用されます。ローカルホストの場合:-c @localhost。リモートLicense Serverの場合:-c @servername。クラスター内のLicense Serverの場合:-c @clientaccesspointname。指定されたパスの場合:-c path。1つ以上のライセンスファイル名の場合:-c license_file_list。複数のライセンスファイルパスはセミコロンで区切って入力できます。スペースを含むパス名は二重引用符で囲む必要があります。
-h lmstat -aによって報告されるライセンスハンドル。ライセンスハンドルは、特定のチェックアウトされたライセンスを識別するために使用される番号です。
-help 使用法情報を表示して終了します。
-s [server] serverを指定しない場合、この引数はLicense Serverにリストされているすべてのライセンスファイル、またはすべてのLicense Server上のライセンスファイルのステータスを表示します。
-verbose 見つかったすべてのエラーについて、より詳細な説明を表示します。

チェックアウトの問題診断 (lmdiag)

lmdiagコマンドを使用すると、製品がライセンスをチェックアウトできない場合の診断が可能です。特に、ライセンスが有効であるか、License Serverが実行されているかをテストできます。このコマンドを実行すると、ライセンスのチェックアウトが試行されます。

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

例:

Citrix Virtual Apps™サーバーのAdvanced Editionライセンスのみでlmdiagを実行します。引数としてMPS_ADV_CCUを指定します。

構文:

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

引数 説明
-c license_file_list 指定されたファイルを診断します。-c @localhostまたは-c @server-nameも使用できます。
-n 非対話モードで実行します。このモードでは、lmdiagは入力を求めません。
feature フィードバックを指定された機能に限定します。
keyword=value ライセンスファイルに特定の機能に対して複数の行が含まれている場合、結果はテキスト値を含む行に限定されます。例:lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01は、ホストIDがLICSERV01の行でチェックアウトを試行します。キーワードは次のいずれかです:VERSION、HOSTID、EXPDATE、KEY、VENDOR_STRING、ISSUER

機能が指定されていない場合、lmdiagはリスト内のライセンスファイルにあるすべての機能に対して動作します。lmdiagコマンドはライセンスに関する情報を表示し、各ライセンスのチェックアウトを試行します。チェックアウトが成功すると、lmdiagはチェックアウトが成功したことを示します。チェックアウトが失敗すると、lmdiagは失敗の理由を通知します。lmdiagコマンドは、License Server上の各TCP/IPポートへの接続を試行します。ライセンスファイル内のポート番号が正しくない場合、それを検出します。lmdiagは、リッスンしている各TCP/IPポート番号をリストし、-c license_file_listが指定されている場合は、指定されたファイルを診断します。

lmdiagコマンドは、ライセンスのチェックアウトを試行する際に、Citrix製品を実行しているコンピューターには接続しません。lmdiagコマンドは、License Serverに問題がある場合にのみ示します。つまり、製品が誤ったLicense Serverを指しているためにライセンスをチェックアウトできない場合でも、lmdiagはこの問題を検出しません。たとえば、その製品のライセンスがないLicense Serverの場合です。lmdiagコマンドは、Citrix製品が誤ったLicense Serverを指している場合でも、ライセンスをチェックアウトできると報告します。

デーモンの停止 (lmdown)

lmdownコマンドは、License Serverまたはネットワーク上のすべてのLicense Serverで、License ManagerデーモンとCitrixベンダーデーモンをシャットダウンします。lmdownコマンドはデフォルトで無効になっています。

構文:

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

引数 説明
-c license_file_listまたは-c @localhostまたは-c @server 指定されたライセンスファイルを使用します。lmdownでは常に-c license_file_listを指定することをお勧めします。-c @localhostまたは-c @server-nameも使用できます。
-vendor CITRIX Citrixベンダーデーモンのみをシャットダウンします。License Managerデーモンは引き続き実行されます。
-q プロンプトを表示したり、ヘッダーを印刷したりしません。そうでない場合、lmdownは「よろしいですか?[y/n]:」と尋ねます。
-all 複数のサーバーが指定されている場合、それらすべてを自動的にシャットダウンします。-allを指定すると-qが暗黙的に適用されます。

License Serverでlmdownコマンドを実行します。ネットワーク上のすべてのLicense Serverをシャットダウンするには、-allを使用できます。

  • lmdown が複数のサーバーを検出し、-all 引数を指定しなかった場合、コマンドはシャットダウンするライセンスサーバーの選択肢を表示します。例えば、-c 引数は多数の *.lic ファイルを含むディレクトリを指定します。リモートのライセンスサーバーをシャットダウンするには、-c を使用してライセンスサーバーの名前を指定します。

  • 注記:

    タスクマネージャーを使用してライセンスマネージャーデーモン (Citrix Licensing Service) を終了する場合は、まず lmgrd プロセスを停止し、次に Citrix ベンダーデーモンプロセスを停止します。

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

ライセンスサーバーのバインディング情報 (lmhostid) の確認

lmhostid コマンドは、ライセンスサーバーのホスト ID を返します。このコマンドを使用して、ライセンスサーバーのホスト名を確認できます。ライセンスファイルを開き、ライセンスファイル内のホスト名をライセンスサーバーのホスト名と比較できます。

注記

Windows 版 Citrix Licensing バージョン 11.5 以降では、複数のホストが存在する場合に複数のホスト ID を表示できます。

  • 構文:

  • lmhostid -bindingidentifier

  • bindingidentifier はコマンドの引数です。

引数 説明
-ether アプライアンスの MAC アドレスに紐付けられた製品ライセンスに使用されます。
-internet TCP/IP アドレスを必要とする Windows ベースの Citrix 製品ソフトウェアライセンスに使用されます。
-hostname ライセンスサーバーのホスト名に紐付けられた Windows ベースの Citrix 製品ソフトウェアライセンスに使用されます。注記: パラメーター hostname は大文字と小文字を区別し、ライセンスサーバー名と正確に一致する必要があります。

ライセンスファイルとオプションファイルのリロード (lmreread)

lmreread コマンドは、Citrix ベンダーデーモンにライセンスファイルとオプションファイルへの変更をリロードさせます。リロード後、Citrix ベンダーデーモンはそれ以降、新しい設定とライセンスを使用します。

lmreread をリモートで使用することはできません。ライセンスサーバー上でローカルに実行してください。

構文:

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

引数 説明
-c @localhost または -c license_file_list 指定されたライセンスファイルを使用します。
-all 複数の lmgrd が指定されている場合、この引数はすべてのライセンスマネージャーデーモンにリロードを指示します。
-vendor CITRIX 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 コマンドは、すべてのライセンスアクティビティのステータスを監視するのに役立ち、ライセンスのチェックアウトに関する情報を提供します。これには以下が含まれます。

  • 1 つ以上のライセンスをチェックアウトした製品
  • チェックアウトデータ
  • ライセンスファイルのバージョン
  • ライセンスサーバー名とポート
  • ライセンスがチェックアウトされた日付
  • Citrix ベンダーデーモンのステータスとライセンスファイルに関する情報

lmstat コマンドは、ライセンスサーバーから受信した情報を表示します。複数の接続が同じライセンスを共有している場合でも、lmstat コマンドはライセンスの 1 つの使用のみを表示します。

構文:

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

引数 説明
-a すべての情報を表示します。
-c @localhost または -c @server または -c license_file_list 指定されたライセンスファイルを使用します。
-f [feature] 機能 (製品ライセンス) を使用している製品を表示します。feature を指定しない場合、すべての機能の使用情報が表示されます。
-i [feature] feature を指定しない場合、この引数は指定された機能 (製品ライセンス) またはすべての機能の INCREMENT 行からの情報を表示します。
-s [server] server を指定しない場合、この引数はライセンスサーバーにリストされているすべてのライセンスファイル、またはすべてのライセンスサーバーにリストされているライセンスファイルのステータスを表示します。
-S [CITRIX] Citrix ベンダーデーモンによって提供される機能 (製品ライセンス) を使用しているすべての製品サーバーをリストします。
-t timeout_value 接続タイムアウトを timeout_value に設定します。この値は、lmstat がライセンスサーバーへの接続を試みる時間の長さを制限します。

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 行に含まれる情報の内訳です。

    説明
Citrix 製品名 MPS ライセンスがチェックアウトされている Citrix 製品の名前。
ホスト名 mps_server1 Citrix 製品が実行されているコンピューター。
表示 MPS ライセンスがチェックアウトされている Citrix 製品の名前。
サーバーホスト license_server1 ライセンスサーバーが実行されているコンピューター。
ポート 27000 ライセンスサーバーが実行されている TCP/IP ポート。
ハンドル 203 ライセンスハンドル。ライセンスハンドルは、特定のチェックアウトされたライセンスを識別するために使用される番号です。
チェックアウト時間 start Wed 3/17 11:56 このライセンスが最初にチェックアウトされた時間。

lmstat -c @localhost -a コマンドは、多数の製品ライセンスがチェックアウトされているシステムで、多くのネットワークアクティビティを生成する可能性があります。

lmstat -a を使用して、ライセンスのチェックアウトデータを確認できます。

バイナリのバージョン表示 (lmver)

lmver コマンドは、コマンドユーティリティなどのライセンスバイナリのバージョン情報を表示します。

構文:

lmver binary

例:

lmver lmdiag

ユーザーまたはデバイスのライセンス表示またはリリース (udadmin)

udadmin は、ライセンスされたユーザーとデバイスを表示し、指定されたユーザーとデバイスのライセンスをリリースします。

注:

UDAdmin ツールは、ユーザー/デバイスライセンスモデルのライセンス使用状況のレポートにのみ使用され、同時実行ライセンスには使用されません。

ユーザーのライセンスをリリースできるのは、次の場合のみです。

  • 従業員が会社に在籍していない場合。
  • 従業員が長期休暇中の場合。

デバイスのライセンスをリリースできるのは、デバイスがサービス停止中の場合のみです。

注意:

自動 90 日間のリース期間が終了する前に、前述の理由以外でライセンスを一括リリースすると、Citrix EULA に違反する可能性があります。これを行う前に、Citrix にお問い合わせください。

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

構文:

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

オプション 説明
-f feature name -list または -delete とともに使用すると、指定された機能名のユーザーまたはデバイスのみのライセンスを表示またはリリースします。
-user user name ユーザー名で指定されたユーザーのみのライセンスをリリースします。
-device device name デバイス名で指定されたデバイスのみのライセンスをリリースします。
-a ライセンスサーバーにインストールされているすべての機能とバージョンをリストします。
引数 説明
-delete 一度に 1 人のユーザー、機能、またはデバイスのライセンスをリリースします。
-events ユーザー/デバイスライセンスによってログに記録されたすべてのイベントを、機能ごとに時系列でソートして報告します。
-list ライセンスを持つユーザーとデバイス、および最終更新からの時間を表示します。前回のレポートから 15 分以内に重要なアクティビティが発生した場合、次回の更新までの時間が表示されます。-list -times を指定すると、タイムスタンプを含む出力が生成されます。
-times -list -times を指定すると、タイムスタンプを含む出力が生成されます。
引数なし または ? udadmin コマンドの使用状況情報を表示します。

例:

-  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 -f XDT_ENT_UD -device dn01.88 -delete

    Releases one device from one feature.

<!--NeedCopy-->