ライセンスコマンド
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は「Are you sure? [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\_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] | 機能 (製品ライセンス) を使用している製品を表示します。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 を指定すると、タイムスタンプを含む出力が生成されます。 |
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-->