ライセンスコマンド
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 or -c @localhost or -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コマンドを実行します。-allを使用して、ネットワーク上のすべてのLicense Serverをシャットダウンできます。
-
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\_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 は、ライセンスされたユーザーとデバイスを表示し、指定されたユーザーとデバイスのライセンスを解放します。
ユーザーのライセンスを解放できるのは、次の場合のみです。
- 従業員が会社との関係を終了した場合。
- 従業員が長期休暇中の場合。
デバイスのライセンスを解放できるのは、デバイスがサービス停止中の場合のみです。
注意:
自動90日リース期間より前に、上記で強調された理由以外でライセンスを一括解放すると、Citrix EULAに違反する可能性があります。これを行う前に、Citrixにお問い合わせください。
udadmin コマンドラインヘルプは、使用情報を英語でのみ表示しますが、非英語システムでもこのコマンドを使用できます。
構文:
udadmin [-options] [-delete | -events | -export | -list | -times]
| オプション | 説明 |
|---|---|
| -f feature name | -list または -delete とともに使用すると、指定された機能名に対してのみ、ユーザーまたはデバイスのライセンスを表示または解放します。 |
| -user user name | 指定されたユーザー名のユーザーに対してのみライセンスを解放します。 |
| -device device name | 指定されたデバイス名のデバイスに対してのみライセンスを解放します。 |
| -a | ライセンスサーバーにインストールされているすべての機能とバージョンをリストします。 |
| 引数 | 説明 |
| -delete | 一度に1人のユーザー、機能、またはデバイスのライセンスを解放します。 |
| -events | ユーザー/デバイスライセンスによってログに記録されたすべてのイベントを、機能ごとに時系列でソートして報告します。 |
| -export | 未処理のユーザーおよびデバイスデータをエクスポートします。このデータはライセンス使用状況の計算に使用され、使用中のライセンスのリストではありません。Citrixは、お客様がこの引数を使用することを推奨していません。これはサポートまたはデバッグのみに使用されます。 |
| -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 -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-->