ライセンスコマンド
Citrix Licensing Managerを使用すると多くのライセンス機能に簡単にアクセスでき、コマンドを使用してライセンス管理タスクを実行できます。一方、コマンドプロンプト上で使用するライセンス管理コマンドでは、管理コンソール上で実行できるタスクに加え、さらに詳細なライセンス管理を行えます。たとえば、lmdiag
コマンドでは、ライセンスのチェックアウト時の問題を診断することができます。
ライセンス管理コマンドは、次のフォルダーに配置されます:
-
C:\Program Files\Citrix\Licensing\LS
(32ビットコンピューター) -
C:\Program Files (x86)\Citrix\Licensing\LS
(64ビットコンピューター)
ライセンスコマンドの説明
注:
ライセンスサーバーバージョン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が実行されるライセンスサーバーの名前を表示します。 |
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つまたは複数のライセンスファイルの名前に置き換えます。 |
[かっこ] | テキストを囲むかっこは、コマンドに追加できるオプションを示します。また、かっこ内のテキストを置き換える必要があることを示している可能性があります。たとえば、次のようになります: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
|
共通のオプション
次の表は、ライセンス管理コマンドの多くで使用されるオプションを示します:
引数 | 説明 |
---|---|
-all | ライセンスサーバーに関するすべての情報を表示します。 |
-c | ライセンスファイルまたはライセンスサーバーのポートとホスト名を指定します。ライセンスファイルのファイル名を記述せずにパスのみを指定した場合、そのフォルダーのすべてのライセンスファイルにコマンドが適用されます。ローカルホストの指定: -c @localhost 。リモートのライセンスサーバーの指定: -c @servername 。クラスター内のライセンスサーバーの指定: -c @clientaccesspointname 。パスの指定: -c path 。ライセンスファイルの名前の指定: -c license_file_list 。複数のライセンスファイルを指定する場合は、各パスをセミコロン(;)で区切ります。パスにスペースが含まれる場合は、二重引用符(”)で囲む必要があります。 |
-h | ライセンスハンドルを指定します。この情報は、lmstat -a コマンドで確認できます。ライセンスハンドルとは、チェックアウトされたライセンスを識別するための番号を指します。 |
-help | コマンドの使用方法を表示します。 |
-s [server] | serverが指定されていない場合、この引数はライセンスに一覧表示されたすべてのライセンスファイルの状態、またはすべてのライセンスサーバーのライセンスファイルを表示します。 |
-verbose | 検出されたすべてのエラーの詳細な説明を表示します。 |
チェックアウト時の問題の診断(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 の実行時に入力が不要です。 |
feature | 診断する製品ライセンスを指定します。 |
keyword=value | 対象となる製品ライセンスの属性を指定します。ライセンスファイルで、1つの製品に対して複数の行が記述されている場合に、対象となる行を特定します。例: lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01 により、ホストIDが “LICSERV01” であるライセンスのチェックアウトが試行されます。属性名( |
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
コマンドはデフォルトで無効になっています。
構文:
lmdown -c license_file_list [-vendor CITRIX] [-q] [-all]
引数 | 説明 |
---|---|
-c license_file_list or -c @localhost or -c @server | ライセンスファイルを指定します。必ず-c license_file_list にlmdown を指定することをお勧めします。-c @localhost または-c @server-name を使用することもできます。 |
-vendor CITRIX | Citrixベンダーデーモンだけを停止します。License Managerデーモンは停止されません。 |
-q | 非インタラクティブモードで実行します。そうでない場合は、lmdown が「Are you sure? [y/n]:」を表示します。 |
-all | 複数のサーバーが指定されると、すべてが自動的にシャットダウンされます。-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
ここで、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 が指定されている場合、この引数はすべてのLicense Managerデーモンでの再読み込みを指示します。 |
-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
コマンドは、すべてのライセンスの使用状況を監視するときに便利なツールで、以下のライセンスチェックアウト情報を確認できます:
- ライセンスをチェックアウトしている製品
- チェックアウトデータ
- ライセンスファイルのバージョン
- ライセンスサーバーの名前とポート番号
- ライセンスのチェックアウト日時
- 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@ |
使用するライセンスファイルを指定します。 |
-f [ |
|
-i [ |
* |
-s [ |
* |
-S [CITRIX] | Citrixベンダーデーモンにより提供されているすべての製品ライセンスの使用サーバーを表示します。 |
-t |
接続タイムアウトを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のライセンス契約書に反する行為となる場合があります。事前に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-->