ライセンスコマンド
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 |
ライセンスサーバーのステータスを表示します。 |
lmutil |
ライセンスされたユーティリティのリストを表示するか、他のコマンドを実行します。 |
lmver |
ライセンスバイナリのバージョン情報を表示します。 |
udadmin |
すべてのライセンスユーザーとデバイスを表示し、指定されたライセンスユーザーとデバイスを削除します。このコマンドはユーザー/デバイスライセンスにのみ適用されます。ライセンスのリストを取得するには、udadmin -list を指定します。 |
CtxManageUserAndGroup |
ライセンスサーバーを管理するためのユーザーおよびグループアクセスを設定します。 |
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つ以上のライセンスファイル名に置き換えます。 |
| [Brackets] | テキストを囲む角括弧は、コマンドに追加できるオプションを示します。角括弧内のテキストを置き換える必要があることを示す場合もあります。例: lmstat [-a] [-c license_file_list] [-f [feature]] can be written as: C:\Program Files (x86)\Citrix\Licensing\LS>lmstat.exe -a -c @localhost -f XDT_ENT_UD |
共通引数
ほとんどのライセンス管理コマンドで有効な引数:
| 引数 | 説明 |
|---|---|
| -すべて | ライセンスサーバーに関するすべての情報を表示します。 |
| -c | ライセンスファイル、またはライセンスサーバーのポートとホスト名を指定できます。ライセンスファイル名を指定せずにパスを指定した場合、コマンドはディレクトリ内のすべてのライセンスファイルに適用されます。ローカルホストの場合: -c @localhost。リモートライセンスサーバーの場合: -c @servername。クラスター内のライセンスサーバーの場合: -c @clientaccesspointname。指定されたパスの場合: -c path。1つ以上のライセンスファイル名の場合: -c license_file_list。複数のライセンスファイルパスを入力するには、各パスをセミコロンで区切ります。スペースを含むパス名は二重引用符で囲む必要があります。 |
| -h | lmstat -aによって報告されるライセンスハンドル。ライセンスハンドルは、特定のチェックアウトされたライセンスを識別するために使用される番号です。 |
| -ヘルプ | 使用状況情報を表示して終了します。 |
| -s [server] | *サーバー*を指定しない場合、この引数は、ライセンスサーバーにリストされているすべてのライセンスファイル、またはすべてのライセンスサーバー上のライセンスファイルのステータスを表示します。 |
| -詳細 | 見つかったすべてのエラーについて、より詳細な説明を表示します。 |
チェックアウトの問題を診断する (lmdiag)
lmdiagコマンドを使用すると、製品がライセンスをチェックアウトできない場合に問題を診断できます。特に、ライセンスが有効であるか、およびライセンスサーバーが実行されているかをテストできます。このコマンドを実行すると、ライセンスのチェックアウトが試行されます。
特定の種類のライセンスが機能しているかどうかを確認するために、
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は入力を求めません。 |
| 機能 | フィードバックを指定された機能に限定します。 |
| キーワード=値 | ライセンスファイルに特定の機能の行が複数含まれている場合、結果はテキスト値を含む行に限定されます。例: lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01 はホストID LICSERV01 を持つ行でチェックアウトを試行します。キーワードは次のいずれかです: VERSION、HOSTID、EXPDATE、KEY、VENDOR_STRING、ISSUER |
機能が指定されていない場合、
lmdiag はリスト内のライセンスファイルにあるすべての機能に対して動作します。lmdiag コマンドはライセンスに関する情報を表示し、各ライセンスのチェックアウトを試行します。チェックアウトが成功すると、lmdiag はチェックアウトが成功したことを示します。チェックアウトが失敗すると、lmdiag は失敗の理由を示します。lmdiag コマンドは、ライセンスサーバー上の各TCP/IPポートへの接続を試行します。ライセンスファイルのポート番号が正しくないかどうかを検出します。lmdiag は、リッスンしている各TCP/IPポート番号を一覧表示し、-c license_file_list が指定されている場合は、指定されたファイルを診断します。
lmdiag コマンドは、ライセンスのチェックアウトを試行する際に、Citrix製品を実行しているコンピューターに接続しません。lmdiag コマンドは、ライセンスサーバーに問題がある場合にのみ示します。つまり、製品が誤ったライセンスサーバーを指しているためライセンスをチェックアウトできませんが、lmdiag はこの問題を検出しません。たとえば、その製品のライセンスがないライセンスサーバーなどです。Citrix製品が誤ったライセンスサーバーを指している場合でも、lmdiag コマンドはライセンスをチェックアウトできると報告します。
デーモンを停止する (lmdown)
lmdown コマンドは、ライセンスサーバーまたはネットワーク上のすべてのライセンスサーバーで、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 |
| -ベンダー CITRIX | Citrixベンダーデーモンのみをシャットダウンします。License Manager デーモンは引き続き実行されます。 |
| -q | プロンプトを表示したり、ヘッダーを印刷したりしないでください。そうしないと、lmdown は「よろしいですか? [y/n]: .」と尋ねます。 |
| -すべて | 複数のサーバーが指定されている場合、それらすべてを自動的にシャットダウンします。-all を指定すると、-q が暗黙的に適用されます。 |
ライセンスサーバーで
lmdown コマンドを実行します。ネットワーク上のすべてのライセンスサーバーをシャットダウンするには、-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 はコマンドの引数です。
| 引数 | 説明 |
|---|---|
| -イーサ | アプライアンスのMACアドレスに紐付けられた製品ライセンスに使用されます。 |
| -インターネット | TCP/IPアドレスを必要とするWindowsベースのCitrix製品ソフトウェアライセンスに使用されます。 |
| -ホスト名 | ライセンスサーバーのホスト名に紐付けられたWindowsベースのCitrix製品ソフトウェアライセンスに使用されます。注: パラメーター hostname は大文字と小文字を区別し、ライセンスサーバー名と正確に一致する必要があります。 |
ライセンスファイルとオプションファイルを再読み込みする (lmreread)
lmreread コマンドは、Citrixベンダーデーモンにライセンスファイルとオプションファイルへの変更を再読み込みさせます。再読み込み後、Citrixベンダーデーモンはそれ以降、新しい設定とライセンスを使用します。
lmreread をリモートで使用することはできません。ライセンスサーバー上でローカルに実行してください。
構文:
lmreread -c license_file_list [-all] [-vendor CITRIX]
| 引数 | 説明 |
|---|---|
| -c @localhost または -c license_file_list | 指定されたライセンスファイルを使用します。 |
| -すべて | 複数のlmgrdが指定されている場合、この引数はすべてのライセンスマネージャーデーモンに再読み込みを指示します。 |
| -ベンダー 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 @localhostlmstatコマンドを実行します。
ライセンスステータスの確認 (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 を指定しない場合、すべての機能の使用状況情報が表示されます。 |
| -i [機能] | feature を指定しない場合、この引数は、指定された機能(製品ライセンス)またはすべての機能の INCREMENT 行からの情報を表示します。 |
| -s [サーバー] | 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
lmstat 出力の MPS\_ENT\_CCU 行に含まれる情報の内訳は次のとおりです。
| 説明 | ||
|---|---|---|
| Citrix 製品名 | MPS | ライセンスがチェックアウトされている Citrix 製品の名前。 |
| ホスト名 | mps_server1 | Citrix 製品が実行されているコンピューター。 |
| 表示 | MPS | ライセンスがチェックアウトされている Citrix 製品の名前。 |
| サーバーホスト | license_server1 | ライセンスサーバーが稼働しているコンピューター。 |
| ポート | 27000 | ライセンスサーバーが稼働しているTCP/IPポート。 |
| ハンドル | 203 | ライセンスハンドル。ライセンスハンドルは、特定のチェックアウトされたライセンスを識別するために使用される番号です。 |
| チェックアウト時刻 | 開始 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 機能名 | -list または -delete と一緒に使用すると、指定された機能名のユーザーまたはデバイスのみのライセンスを表示または解放します。 |
| -user ユーザー名 | ユーザー名で指定されたユーザーのみのライセンスを解放します。 |
| -device デバイス名 | デバイス名で指定されたデバイスのみのライセンスを解放します。 |
| -a | ライセンスサーバーにインストールされているすべての機能とバージョンを一覧表示します。 |
| 引数 | 説明 |
| -削除 | ユーザー、機能、またはデバイスのライセンスを一度に1つずつ解放します。 |
| -イベント | ユーザー/デバイスライセンスによってログに記録されたすべてのイベントを、機能ごとに時系列順に報告します。 |
| -リスト | ライセンスを持つユーザーとデバイス、および最終更新からの時間を表示します。前回のレポートから15分以内に重要なアクティビティが発生した場合、次回の更新までの時間が表示されます。-list -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.