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.
Lizenzierungsbefehle | Beschreibung |
---|---|
lmgrd |
Startet und verwaltet den Lizenzierungsserver und andere zugehörige Prozesse. lmgrd ist die Kernlizenzierungsserverdatei, die für den Citrix Lizenzierungsdienst in Windows verwendet wird. Sie dient als Host des Lizenzserverports (Standard: 27000). Verwenden Sie Citrix Licensing Manager für die Aufgaben bei der Lizenzierungskonfiguration und -verwaltung. |
lmdiag |
Diagnostizieren von Problemen beim Auschecken von Lizenzen. |
lmdown |
Korrektes Herunterfahren des License Manager Daemons und des Citrix Vendor Daemons (standardmäßig deaktiviert). |
lmhostid |
Zeigt die Host-ID des Servers an, auf dem die Citrix Lizenzierung ausgeführt wird. |
lmreread |
Die Lizenzdatei wird vom License Manager Daemon neu gelesen und der Citrix Vendor Daemon wird gestartet. |
lmstat |
Anzeigen des Status eines Lizenzservers. |
lmutil |
Anzeigen einer Liste aller Lizenzierungshilfsprogramme oder Ausführen anderer Befehle. |
lmver |
Anzeigen der Versionsinformationen für die Binärdateien der Lizenzierung. |
udadmin |
Zeigt alle lizenzierten Benutzer und Geräte und löscht die angegebenen lizenzierten Benutzer und Geräte. Dieser Befehl gilt nur für Benutzer-/Gerätelizenzen. Um eine Liste der Lizenzen zu erhalten, geben Sie udadmin -list an. |
CtxManageUserAndGroup |
Konfigurieren des Benutzer- und Gruppenzugriffs zum Verwalten des Lizenzservers. |
CtxManageUserAndGroup.exe –useradd “domain\username” -Role “admin/user” |
Befehl zum Hinzufügen eines Benutzers. |
CtxManageUserAndGroup.exe –useradd “domain\username” –Role “adminGroup/userGroup” |
Befehl zum Hinzufügen einer Gruppe. |
Formatierung der Lizenzbefehle
Formatierungskonventionen, die bei der Beschreibung der Lizenzverwaltungsbefehle verwendet wurden:
Konvention | Beschreibung |
---|---|
Fett | Ein Befehl oder Schalter wie zum Beispiel lmstat. |
Kursiv | Ersetzen Sie Variablen durch einen Wert. Zum Beispiel im Ausdruck: lmstat -c license_file_list. Ersetzen Sie license_file_list durch die Namen von Lizenzdateien, bevor Sie den Befehl ausführen. |
[Klammern] | Klammern um Text zeigen die Optionen an, die Sie dem Befehl hinzufügen können. Es könnte darauf hindeuten, dass Text in den Klammern ersetzt werden muss. Beispiel: 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
|
Universelle Argumente
Gültige Argumente für die meisten Lizenzverwaltungsbefehle:
Argument | Beschreibung |
---|---|
-all | Anzeige aller Informationen zum Lizenzserver. |
-c | Angeben der Lizenzdateien oder des Lizenzserverports und -hostnamens. Wenn Sie nur den Pfad angeben, aber keinen Lizenzdateinamen, gilt der Befehl für alle Lizenzdateien im Verzeichnis. Für einen lokalen Host: -c @localhost . Für einen Remotelizenzserver: -c @servername . Für einen Lizenzserver in einem Cluster: -c @clientaccesspointname . Für einen angegebenen Pfad: -c path . Für die Namen einer oder mehrerer Lizenzdateien: -c license_file_list . Sie können mehr als einen Lizenzdateipfad angegeben, indem Sie die Pfade durch ein Semikolon trennen. Pfadnamen, die Leerzeichen enthalten, müssen in Anführungszeichen gesetzt werden. |
-h | Lizenzhandle, wie von lmstat -a ausgegeben. Das Lizenzhandle ist eine Zahl, die zum Identifizieren einer bestimmten ausgecheckten Lizenz verwendet wird. |
-help | Zeigt Verwendungsinformationen an. |
-s [server] | Wenn Sie keine Angabe für server machen, zeigt dieses Argument den Status aller Lizenzdateien, die auf dem Lizenzserver aufgelistet sind, oder der Lizenzdateien auf allen Lizenzservern. |
-verbose | Zeigt eine ausführlichere Beschreibung für alle gefundenen Fehler an. |
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]]
Argument | Beschreibung |
---|---|
-c license_file_list | Diagnostizieren der angegebenen Dateien. Sie können auch Folgendes verwenden: -c @localhost oder -c @server-name
|
-n | Läuft im nicht interaktiven Modus; lmdiag fordert in diesem Modus keine Eingabe an. |
Feature | Beschränken des Feedbacks auf das angegebene Feature. |
keyword=value | Wenn eine Lizenzdatei mehrere Zeilen für ein bestimmtes Feature enthält, wird nur die Zeile als Ergebnis angezeigt, die mit “value” festgelegt wurde. Beispiel: lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01 versucht, eine Lizenz in der Zeile mit der Host-ID LICSERV01 auszuchecken. Mögliche Werte für “Keyword” sind: VERSION, HOSTID, EXPDATE, KEY, VENDOR_STRING, ISSUER |
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]
Argument | Beschreibung |
---|---|
-c license_file_list oder -c @localhost oder -c @server | Verwenden der angegebenen Lizenzdateien. Wir empfehlen immer -c license_file_list mit lmdown anzugeben. Sie können auch verwenden: -c @localhost oder -c @server-name
|
-vendor CITRIX | Nur der Citrix Vendor Daemon wird heruntergefahren. Der License Manager Daemon wird weiter ausgeführt. |
-q | Keine Eingabeaufforderung oder kein Drucken des Headers. Sonst fragt lmdown “Are you sure? [y/n]: “. |
-all | Wenn mehrere Server angegeben wurden, werden automatisch alle heruntergefahren. -q wird bei -all impliziert. |
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.
Argument | Beschreibung |
---|---|
-ether | Wird für die Produktlizenzen verwendet, die der MAC-Adresse des Geräts zugewiesen sind. |
-internet | Wird für Windows-basierte Citrix Produktlizenzen verwendet, die eine TCP/IP-Adresse benötigen. |
-hostname | Wird für Windows-basierte Citrix Produktlizenzen verwendet, die dem Hostnamen des Lizenzservers zugewiesen sind. Hinweis: Für den Parameter hostname wird die Groß- und Kleinschreibung erkannt; er muss genau mit dem Namen des Lizenzservers übereinstimmen. |
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]
Argument | Beschreibung |
---|---|
-c @localhost or -c license_file_list | Verwenden der angegebenen Lizenzdateien. |
-all | Bei der Angabe mehrerer lmgrd -Befehle werden mit diesem Argument alle License Manager Daemons zum Neulesen gezwungen. |
-vendor CITRIX | Veranlasst den Neustart des Citrix Vendor Daemons. |
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]
Argument | Beschreibung |
---|---|
-a | Zeigt alle Informationen an. |
-c @localhost or -c @server or -c license_file_list | Verwendet die angegebenen Lizenzdateien. |
-f [feature] | Zeigt die Produkte an, die ein Feature (eine Produktlizenz) verwenden. Wenn Sie feature nicht definieren, wird die Verwendung für alle Features angezeigt. |
-i [feature] | Wenn Sie feature nicht definieren, zeigt dieses Argument Informationen von der INCREMENT-Zeile dieses Features (dieser Produktlizenz) oder von allen Features an. |
-s [server] | Wenn Sie server nicht definieren, zeigt dieses Argument den Status aller Lizenzdateien auf dem Lizenzserver oder der Lizenzdateien auf allen Lizenzservern. |
-S [CITRIX] | Listet alle Produktserver auf, die die Features (Produktlizenzen) verwenden, die vom Citrix Vendor Daemon bedient werden. |
-t timeout_value | Setzt das Verbindungstimeout auf den Timeoutwert. Dieser Wert schränkt die Dauer ein, für die lmstat versucht, eine Verbindung mit dem Lizenzserver herzustellen. |
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:
Beschreibung | ||
---|---|---|
Citrix Produktname | MPS | Der Name des Citrix Produkts, das die Lizenz ausgecheckt hat. |
Hostname | mps_server1 | Computer, auf dem das Citrix Produkt ausgeführt wird. |
Anzeige | MPS | Der Name des Citrix Produkts, das die Lizenz ausgecheckt hat. |
Serverhost | license_server1 | Computer, auf dem der Lizenzserver ausgeführt wird. |
Port | 27000 | Der vom Lizenzserver verwendete TCP/IP-Port. |
Handle | 203 | Lizenzhandle. Das Lizenzhandle ist eine Zahl, die zum Identifizieren einer bestimmten ausgecheckten Lizenz verwendet wird. |
Auscheckzeit | start Wed 3/17 11:56 | Zeit, zu der diese Lizenz zuerst ausgecheckt wurde. |
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.
Hinweis:
Das UDAdmin-Tool wird nur für die Berichterstellung der Lizenznutzung für das Benutzer-/Gerätelizenzmodell verwendet und nicht für CCU-Lizenzen.
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]
Optionen | Beschreibung |
---|---|
-f Featurename | Bei Verwendung mit “-list” oder “-delete” wird nur die Lizenz für den angegebenen Featurenamen für den Benutzer oder das Gerät angezeigt bzw. freigegeben. |
-user Benutzername | Gibt nur die Lizenz für den angegebenen Benutzer frei. |
-device Gerätename | Gibt nur die Lizenz für das als “Gerätename” angegebene Gerät frei. |
-a | Listet alle Features und Versionen auf, die auf dem Lizenzserver installiert sind. |
Argument | Beschreibung |
-delete | Gibt die Lizenz für jeweils einen Benutzer, ein Feature oder ein Gerät frei. |
-events | Listet alle von der Benutzer-/Gerätelizenzierung für die einzelnen Features protokollierten Ereignisse in chronologischer Reihenfolge auf. |
-list | Zeigt die Benutzer und Geräte mit Lizenzen an und wie viel Zeit seit dem letzten Update vergangen ist. Die Zeit seit dem letzten Update wird angezeigt, wenn innerhalb von 15 Minuten seit dem letzten Bericht erhebliche Aktivitäten stattgefunden haben. Durch Angabe von -list -times wird eine Ausgabe mit Zeitstempel generiert. |
-times | Durch Angabe von -list -times wird eine Ausgabe mit Zeitstempel generiert. |
Kein Argument oder ?
|
Zeigt Syntaxinformationen für den Befehl udadmin an. |
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-->
In diesem Artikel
- Beschreibung der Lizenzierungsbefehle
- Formatierung der Lizenzbefehle
- Universelle Argumente
- Diagnostizieren von Problemen beim Auschecken (lmdiag)
- Daemon stoppen (lmdown)
- Überprüfen der Bindungsinformationen des Lizenzservers (lmhostid)
- Lizenz- und Optionsdateien erneut einlesen (lmreread)
- Anzeigen der Liste der Lizenzierungshilfsprogramme (lmutil)
- Ermitteln des Lizenzstatus (lmstat)
- Anzeigeversionen von Binärdateien (lmver)
- Lizenzen für Benutzer oder Geräte anzeigen oder freigeben (udadmin)