Lizenzierungsbefehle

Neben dem einfach zu benutzenden Citrix Licensing Manager stehen für Lizenzierungsaufgaben auch Lizenzverwaltungsbefehle zur Verfügung. Sie verwenden die Lizenzverwaltungsbefehle beispielsweise für erweiterte Aufgaben auf dem Lizenzserver, die in der Konsole nicht verfügbar sind. Dazu gehört die Diagnose von Problemen beim Auschecken mit lmdiag.

Die Lizenzverwaltungsbefehle werden in diesem Verzeichnis gespeichert:

• C:\Program Files\Citrix\Licensing\LS auf einem 32-Bit-Computer
• C:\Program Files (x86)\Citrix\Licensing\LS auf einem 64-Bit-Computer

Beschreibung der Lizenzierungsbefehle

Hinweis:

Im Lizenzserver 11.16.6 Build 34000 wird die bisherige Benutzerverwaltung lmadmin.exe durch die Citrix-eigene Benutzerverwaltung lmgrd.exe ersetzt. Stellen Sie sicher, dass Sie nicht lmadmin verwenden.

Formatierung der Lizenzbefehle

Formatierungskonventionen, die bei der Beschreibung der Lizenzverwaltungsbefehle verwendet wurden:

Universelle Argumente

Gültige Argumente für die meisten Lizenzverwaltungsbefehle:

Diagnostizieren von Problemen beim Auschecken (lmdiag)

Mit dem Befehl lmdiag können Sie Probleme diagnostizieren, wenn ein Produkt keine Lizenz auschecken kann. Insbesondere können Sie testen, ob Ihre Lizenzen gültig sind und ob der Lizenzserver funktionsbereit ist. Wenn Sie diesen Befehl ausführen, wird versucht, eine Lizenz auszuchecken.

Außerdem können Sie mit dem Befehl lmdiag feststellen, ob ein bestimmter Typ der Lizenz funktioniert.

Beispiel:

Führen Sie lmdiag nur auf Lizenzen auf Citrix Virtual Apps-Servern Advanced Edition aus. Geben Sie MPS_ADV_CCU als Argument an.

Syntax:

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

Wenn kein Feature angegeben ist, wird lmdiag auf alle Features in den Lizenzdateien in der Liste angewendet. Der Befehl lmdiag zeigt Informationen zur Lizenz an und versucht dann, jede Lizenz auszuchecken. Wenn das Auschecken erfolgreich ist, zeigt lmdiag dies an. Wenn ein Fehler beim Checkout auftritt, zeigt lmdiag die Ursache des Fehlers an. Der Befehl lmdiag versucht eine Verbindung mit jedem TCP/IP-Port auf dem Lizenzserver herzustellen. Hiermit wird erkannt, ob die Portnummer in der Lizenzdatei falsch ist. lmdiag listet jede abhörende TCP/IP-Portnummer auf, und wenn -c license_file_list angegeben wurde, werden die in der Liste angegebenen Lizenzdateien diagnostiziert.

Der Befehl lmdiag stellt keinen Kontakt mit dem Computer her, auf dem das Citrix Produkt ausgeführt wird, wenn versucht wird, Lizenzen auszuchecken. Der Befehl lmdiag gibt nur an, wenn Probleme auf dem Lizenzserver bestehen. Das Produkt kann also keine Lizenzen auschecken, weil es auf den falschen Lizenzserver verweist, aber lmdiag erkennt dieses Problem nicht. Beispielsweise hat ein Lizenzserver keine Lizenzen für dieses Produkt. Der Befehl lmdiag meldet, dass Lizenzen ausgecheckt werden können, wenn das Citrix Produkt auf den falschen Lizenzserver verweist.

Daemon stoppen (lmdown)

Mit dem Befehl lmdown fahren Sie den License Manager Daemon und den Citrix Vendor Daemon auf einem oder allen Lizenzservern im Netzwerk herunter. Der Befehl lmdown ist standardmäßig deaktiviert.

Syntax:

lmdown -c license_file_list [-vendor CITRIX] [-q] [-all]

Führen Sie den Befehl lmdown auf einem Lizenzserver aus. Mit -all fahren Sie alle Lizenzserver im Netzwerk herunter.

Wenn mehrere Server von lmdown erkannt wurden und Sie das Argument -all nicht festgelegt haben, können Sie auswählen, welche Lizenzserver Sie heruntergefahren möchten. Beispielsweise gibt das Argument -c ein Verzeichnis mit vielen *.lic-Dateien an. Fahren Sie die Remote-Lizenzserver herunter, indem Sie -c verwenden und den Namen des Lizenzservers angeben.

Hinweis:

Wenn Sie den License Manager Daemon (Citrix Lizenzierungsdienst) mit dem Task-Manager beenden, sollten Sie zuerst den lmgrd-Prozess und dann den Citrix Vendor Daemon anhalten.

Um nur den Citrix Vendor Daemon zu beenden und neu zu starten, verwenden Sie lmdown -c @localhost -vendor CITRIX und anschließend lmreread -c @localhost -vendor CITRIX, um den Vendor Daemon neu zu starten.

Überprüfen der Bindungsinformationen des Lizenzservers (lmhostid)

Der Befehl lmhostid gibt die Host-ID des Lizenzservers zurück. Mit diesem Befehl prüfen Sie den Hostnamen des Lizenzservers. Sie können eine Lizenzdatei öffnen und den Hostnamen in der Lizenzdatei mit dem Ihres Lizenzservers vergleichen.

Hinweis

In Version 11.5 und höher der Citrix Lizenzierung für Windows können Sie mehrere Host-IDs anzeigen, wenn mehrere Hosts vorhanden sind.

Syntax:

lmhostid -bindingidentifier

Wobei bindingidentifier das Argument ist.

Lizenz- und Optionsdateien erneut einlesen (lmreread)

Mit dem Befehl lmreread können Sie den Citrix Vendor Daemon zwingen, die geänderte Lizenzdatei und Optionsdatei neu zu lesen. Nach dem Neulesen verwendet der Citrix Vendor Daemon die neuen Einstellungen und Lizenzen.

lmreread kann nicht remote verwendet werden; führen Sie es lokal auf dem Lizenzserver aus.

Syntax:

lmreread -c license_file_list [-all] [-vendor CITRIX]

Beispiele:

• lmreread -c @localhost \[-all\]
• lmreread -c @client\_access\_point\_name
• lmreread -c /opt/citrix/licensing/myfiles/CITRIX.lic -vendor CITRIX

Anzeigen der Liste der Lizenzierungshilfsprogramme (lmutil)

Mit dem Befehl lmutil zeigen Sie eine Liste der Hilfsprogramme für die Lizenzierung an. Wenn Sie lmutil mit einem anderen Befehl festlegen, wird dieser Befehl ausgeführt.

Syntax:

lmutil

lmutil other_command

Beispiele:

• lmutil

  Zeigt eine Liste der Lizenzierungshilfsprogramme an.

• lmutil lmstat -c @localhost

  Führt den lmstat-Befehl aus.

Ermitteln des Lizenzstatus (lmstat)

Mit dem Befehl lmstat können Sie den Status aller Lizenzierungsaktivitäten überwachen und Informationen zu ausgecheckten Lizenzen erhalten, u. a.:

• Das Produkt, das eine oder mehrere Lizenzen ausgecheckt hat
• Auscheckdaten
• Die Version der Lizenzdatei
• Der Name und Port des Lizenzservers
• Das Datum, an dem die Lizenz ausgecheckt wurde
• Informationen zum Citrix Vendor Daemon-Status und zu den Lizenzdateien

Der Befehl lmstat zeigt Informationen an, die vom Lizenzserver empfangen wurden. Der Befehl lmstat zeigt nur eine Lizenznutzung an, selbst wenn mehrere Verbindungen diese Lizenz gemeinsam verwenden.

Syntax:

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

Die Ausgabe von lmstat -c @localhost -a ähnelt folgendem Beispiel. Die Zeilen im Beispiel können aus Platzgründen auf dem Bildschirm umbrechen.

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

Im Anschluss finden Sie eine Beschreibung der Informationen, die auf der MPS_ENT_CCU-Zeile der lmstat-Ausgabe angegeben sind:

Der Befehl lmstat -c @localhost -a kann zu einer hohen Netzwerkaktivität in Systemen mit vielen ausgecheckten Produktlizenzen führen.

Mitlmstat -a“lmstat -a” können Sie die Auscheckdaten der Lizenz prüfen.

Anzeigeversionen von Binärdateien (lmver)

Der Befehl lmver zeigt Versionsinformationen für die Lizenzierungsbinärdateien an, wie beispielsweise die Befehlszeilenprogramme.

Syntax:

lmver binary

Beispiel:

lmver lmdiag

Lizenzen für Benutzer oder Geräte anzeigen oder freigeben (udadmin)

udadmin zeigt die lizenzierten Benutzer und Geräte an und gibt die Lizenzen für bestimmte Benutzer und Geräte frei.

Sie können eine Benutzerlizenz nur in folgenden Situationen freigeben:

• Der Mitarbeiter ist nicht mehr mit dem Unternehmen verbunden.
• Der Arbeitnehmer ist für längere Zeit beurlaubt.

Die Lizenzen für Geräte können Sie nur freigeben, wenn die Geräte aus dem Dienst genommen werden.

Achtung:

Die Massenfreigabe von Lizenzen vor der automatischen Leasedauer von 90 Tagen, außer aus den oben angegebenen Gründen, verstößt möglicherweise gegen die Citrix Lizenzvereinbarung (EULA). Wenden Sie sich vorher an Citrix.

Die Hilfe für den Befehl udadmin zeigt die Syntaxinformationen nur in Englisch an, Sie können den Befehl aber auch auf nicht-englischen Systemen verwenden.

Syntax:

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

Beispiele:

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