ライセンスコマンド
Citrix Licensing Manager は多くのライセンス機能にアクセスする簡単な方法を提供しますが、コマンドを使用してライセンスタスクを実行することもできます。コンソールでは利用できない、ライセンスサーバー上での高度な操作には、ライセンス管理コマンドを使用する場合があります。そのような操作には、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 の場合です。Citrix 製品が誤った License Server を指している場合でも、lmdiag コマンドはライセンスをチェックアウトできると報告します。
デーモンの停止 (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 or -c license_file_list | 指定されたライセンスファイルを使用します。 |
| -all | 複数のlmgrdが指定されている場合、この引数はすべてのライセンスマネージャーデーモンに再読み込みを指示します。 |
| -vendor CITRIX | Citrixベンダーデーモンを再起動するように指定します。 |
例:
lmreread -c @localhost \[-all\]lmreread -c @client\_access\_point\_namelmreread -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 or -c @server or -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
<!--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 を指定すると、タイムスタンプを含む出力が生成されます。 |
No argument or ?
|
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-->