ライセンスコマンド

ライセンス管理コンソールは多くのライセンス機能にアクセスする簡単な方法を提供しますが、コマンドを使用してライセンス関連タスクを実行することもできます。コンソールでは利用できないLicense Serverでの高度な操作には、ライセンス管理コマンドを使用する場合があります。このような操作には、lmdiagを使用したチェックアウトの問題診断が含まれます。

• ライセンス管理コマンドは、次の場所に保存されています。

• 32ビットコンピューターの場合：C:\Program Files\Citrix\Licensing\LS

• 64ビットコンピューターの場合：C:\Program Files (x86)\Citrix\Licensing\LS

• コマンドの説明

• lmadmin— ライセンス構成を提供します。ライセンス構成および管理タスクには、ライセンス管理コンソールを使用してください。lmadminは使用しないでください。

• lmdiag — ライセンスチェックアウトの問題を診断します。

• lmdown — License ManagerおよびCitrix®ベンダーデーモンを正常にシャットダウンします（デフォルトで無効）。

• lmhostid — Citrix Licensingが実行されているサーバーのホストIDを報告します。

• lmreread — License Managerデーモンにライセンスファイルを再読み込みさせ、Citrixベンダーデーモンを起動します。

• lmstat — License Serverのステータスを表示します。

• lmutil — ライセンスユーティリティのリストを表示するか、他のコマンドを実行します。

• lmver — ライセンスバイナリのバージョン情報を表示します。

• udadmin — すべてのライセンスユーザーとデバイスを表示し、指定されたライセンスユーザーとデバイスを削除します。このコマンドは、ユーザー/デバイスライセンスにのみ適用されます。udadmin -exportを指定すると、未処理のユーザーおよびデバイスデータがエクスポートされます。このデータはライセンス使用状況の計算に使用され、使用中のライセンスのリストではありません。ライセンスのリストを取得するには、udadmin -listを指定します。

ライセンスコマンドの形式

ライセンス管理コマンドの書式規則：

共通引数

ほとんどのライセンス管理コマンドで有効な引数：

チェックアウトの問題診断 (lmdiag)

lmdiagコマンドを使用すると、製品がライセンスをチェックアウトできない場合に問題を診断できます。特に、ライセンスが有効であるか、およびLicense Serverが実行されているかをテストできます。このコマンドを実行すると、ライセンスのチェックアウトが試行されます。

lmdiagコマンドを使用して、特定の種類のライセンスが機能しているかどうかを確認することもできます。

例：

Citrix Virtual Apps™サーバーのAdvanced Editionライセンスのみでlmdiagを実行します。引数としてMPS_ADV_CCUを指定します。

構文：

lmdiag -c license_file_list [-n] [feature[:keyword=value]]

機能が指定されていない場合、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コマンドはデフォルトで無効になっています。有効にするには：

1. ライセンスサービスを停止します。
2. lmadmin - allowStopServerおよび-allowRemoteStop Serverまたは-allowRemoteStop Serverを実行します。
3. License Serverを再起動します。

構文:

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ベンダーデーモンのみをシャットダウンします。ライセンスマネージャーデーモンは引き続き実行されます。
  -q	プロンプトを表示したり、ヘッダーを印刷したりしません。指定しない場合、lmdownは「続行しますか？ [y/n]: 」と尋ねます。
  -all	複数のサーバーが指定されている場合、それらすべてを自動的にシャットダウンします。-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

ライセンスファイルとオプションファイルの再読み込み (lmreread)

lmrereadコマンドは、Citrixベンダーデーモンにライセンスファイルとオプションファイルへの変更を再読み込みさせます。再読み込み後、Citrixベンダーデーモンはそれ以降、新しい設定とライセンスを使用します。

lmrereadをリモートで使用することはできません。ライセンスサーバー上でローカルに実行してください。

構文:

lmreread -c license_file_list [-all] [-vendor 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コマンドは、すべてのネットワークライセンスアクティビティのステータスを監視し、ライセンスのチェックアウトに関する情報を提供します。これには以下が含まれます。

• 1つ以上のライセンスをチェックアウトした製品
• チェックアウトデータ
• ライセンスファイルのバージョン
• ライセンスサーバー名とポート
• ライセンスがチェックアウトされた日付
• Citrixベンダーデーモンのステータスとライセンスファイルに関する情報

lmstatコマンドは、ライセンスサーバーから受信した情報を表示します。lmstatコマンドは、複数の接続が同じライセンスを共有している場合でも、ライセンスの1つの使用のみを表示します。

構文:

lmstat [-a] [-c license_file_list] [-f [feature]] [-i [feature] [-s[server] [-S [CITRIX]] [-t timeout_value]

• -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行に含まれる情報の内訳です。

lmstat -c@localhost -aコマンドは、多くの製品ライセンスがチェックアウトされているシステムで、大量のネットワークアクティビティを生成する可能性があります。

lmstat -aを使用して、ライセンスのチェックアウトデータを確認できます。

バイナリのバージョン表示 (lmver)

lmverコマンドは、コマンドユーティリティなどのライセンスバイナリのバージョン情報を表示します。lmadminコマンドは例外です。lmadminコマンドのバージョン情報を表示するには、lmadmin -versionを使用します。

構文:

lmver binary

例:

lmver lmdiag

ユーザーまたはデバイスのライセンス表示または解放 (udadmin)

udadminは、ライセンスされたユーザーとデバイスを表示し、指定されたユーザーとデバイスのライセンスを解放します。

ユーザーのライセンスを解放できるのは、以下のいずれかの条件を満たす場合のみです。

• 従業員が会社に在籍していない場合
• 従業員が長期休暇中の場合

デバイスのライセンスを解放できるのは、デバイスがサービス停止中の場合のみです。

注意:

自動90日間リース期間が終了する前に、前述の理由以外でライセンスを一括解放すると、Citrix EULAに違反する可能性があります。これを行う前に、Citrixにお問い合わせください。

udadminコマンドラインヘルプは英語でのみ使用情報を表示しますが、非英語システムでもこのコマンドを使用できます。

構文:

udadmin [-options] [-delete | -events | -export | -list | -times]

例:

-  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-->