Lizenzierung 11.17.2 Build 52100

Lizenzierungsbefehle

Während der Citrix Licensing Manager eine einfache Methode zum Zugriff auf viele Lizenzierungsfunktionen bietet, können Sie Lizenzierungsaufgaben auch mithilfe von Befehlen ausführen. Die Lizenzverwaltungsbefehle können für erweiterte Operationen auf dem Lizenzserver verwendet werden, die in der Konsole nicht verfügbar sind. Zu diesen Operationen gehört die Diagnose von Checkout-Problemen mithilfe von lmdiag.

  • Lizenzverwaltungsbefehle werden gespeichert unter:

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

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

Lizenzierungsbefehle Beschreibung
lmgrd Startet und verwaltet den Lizenzserver und andere zugehörige Prozesse. lmgrd ist die zentrale Lizenzserverdatei, die für den Citrix Licensing Windows-Dienst verwendet wird. Sie hostet den Lizenzserver-Port (Standard 27000). Verwenden Sie den Citrix Licensing Manager für Lizenzkonfigurations- und Verwaltungsaufgaben.
lmdiag Diagnostiziert Probleme beim Lizenz-Checkout.
lmdown Fährt den Lizenzmanager und die Citrix®-Vendor-Daemons ordnungsgemäß herunter (standardmäßig deaktiviert).
lmhostid Meldet die Host-ID des Servers, auf dem Citrix Licensing ausgeführt wird.
lmreread Veranlasst den Lizenzmanager-Daemon, die Lizenzdatei neu einzulesen und den Citrix-Vendor-Daemon zu starten.
lmstat Zeigt den Status eines Lizenzservers an.
lmutil Zeigt eine Liste der lizenzierten Dienstprogramme an oder führt andere Befehle aus.
lmver Zeigt Versionsinformationen für die Lizenzierungsbinärdateien an.
udadmin Zeigt alle lizenzierten Benutzer und Geräte an und löscht angegebene lizenzierte 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 Konfiguriert den Benutzer- und Gruppenzugriff zur Verwaltung 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.

Lizenzbefehle formatieren

Formatierungskonventionen für die Lizenzverwaltungsbefehle:

Konvention Beschreibung
Fett Ein Befehl oder Schalter, z. B. lmstat.
Kursiv Ersetzen Sie Variablen durch einen Wert. Zum Beispiel im Ausdruck: lmstat -c license_file_list. Bevor Sie den Befehl ausführen, ersetzen Sie license_file_list durch die Namen einer oder mehrerer Lizenzdateien.
[Klammern] Klammern um den Text zeigen die Optionen an, die Sie dem Befehl hinzufügen können. Es kann darauf hinweisen, dass der Text innerhalb der Klammern ersetzt werden muss. Zum Beispiel: lmstat [-a] [-c license_file_list] [-f [feature]] kann geschrieben werden als: 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 Zeigt alle Informationen über den Lizenzserver an.
-c Ermöglicht die Angabe von Lizenzdateien oder des Lizenzserver-Ports und Hostnamens. Wenn Sie den Pfad ohne Lizenzdateinamen angeben, gilt der Befehl für alle Lizenzdateien im Verzeichnis. Für einen lokalen Host: -c @localhost. Für einen Remote-Lizenzserver: -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 mehrere Lizenzdateipfade eingeben, indem Sie jeden Pfad mit einem Semikolon trennen. Pfadnamen, die Leerzeichen enthalten, müssen in doppelten Anführungszeichen eingeschlossen werden.
-h Lizenz-Handle, wie von lmstat -a gemeldet. Das Lizenz-Handle ist eine Nummer, die zur Identifizierung einer spezifischen ausgecheckten Lizenz verwendet wird.
-help Zeigt Nutzungsinformationen an und beendet den Vorgang.
-s [server] Wenn Sie keinen Server angeben, zeigt dieses Argument den Status aller auf dem Lizenzserver aufgelisteten Lizenzdateien oder der Lizenzdateien auf allen Lizenzservern an.
-verbose Zeigt eine längere Beschreibung für alle gefundenen Fehler an.

Checkout-Probleme diagnostizieren (lmdiag)

Der Befehl lmdiag ermöglicht es Ihnen, Probleme zu diagnostizieren, wenn ein Produkt keine Lizenz auschecken kann. Insbesondere können Sie testen, ob Ihre Lizenzen gültig sind und ob der Lizenzserver läuft. Wenn Sie diesen Befehl ausführen, versucht er, eine Lizenz auszuchecken.

Sie können den Befehl lmdiag auch verwenden, um zu prüfen, ob ein bestimmter Lizenztyp funktioniert.

Beispiel:

Führen Sie lmdiag nur für Ihre Citrix Virtual Apps™ Server Advanced Edition-Lizenzen 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 Diagnostiziert die angegebenen Dateien. Sie können auch verwenden: -c @localhost oder -c @server-name
-n Führt im nicht-interaktiven Modus aus. lmdiag fordert in diesem Modus keine Eingaben an.
feature Begrenzt die Rückmeldung auf das angegebene Feature.
keyword=value Wenn eine Lizenzdatei mehrere Zeilen für ein bestimmtes Feature enthält, wird das Ergebnis auf die Zeile begrenzt, die den Textwert enthält. Zum Beispiel: lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01 versucht einen Checkout auf der Zeile mit der Host-ID LICSERV01. Das Schlüsselwort ist eines der folgenden: VERSION, HOSTID, EXPDATE, KEY, VENDOR_STRING, ISSUER

Wenn kein Feature angegeben ist, arbeitet lmdiag mit allen Features in den Lizenzdateien Ihrer Liste. Der Befehl lmdiag zeigt Informationen über die Lizenz an und versucht dann, jede Lizenz auszuchecken. Wenn der Checkout erfolgreich ist, zeigt lmdiag an, dass der Checkout erfolgreich war. Wenn der Checkout fehlschlägt, gibt lmdiag den Grund für den Fehler an. Der Befehl lmdiag versucht, sich mit jedem TCP/IP-Port auf dem Lizenzserver zu verbinden. Er erkennt, ob die Portnummer in der Lizenzdatei falsch ist. lmdiag listet jede lauschende TCP/IP-Portnummer auf, und wenn -c license_file_list angegeben ist, diagnostiziert es die angegebenen Dateien.

Der Befehl lmdiag kontaktiert den Computer, auf dem das Citrix-Produkt ausgeführt wird, nicht, wenn er versucht, Lizenzen auszuchecken. Der Befehl lmdiag zeigt nur an, ob Probleme auf dem Lizenzserver vorliegen. Das heißt, Ihr Produkt kann keine Lizenzen auschecken, weil es auf den falschen Lizenzserver verweist, aber lmdiag erkennt dieses Problem nicht. Zum Beispiel ein Lizenzserver, der keine Lizenzen für dieses Produkt enthält. Der Befehl lmdiag meldet, dass er Lizenzen auschecken kann, wenn das Citrix-Produkt auf den falschen Lizenzserver verweist.

Daemons beenden (lmdown)

Der Befehl lmdown fährt den Lizenzmanager-Daemon und den Citrix-Vendor-Daemon auf Ihrem Lizenzserver oder allen Lizenzservern in Ihrem 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 Sie die 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 Fährt nur den Citrix-Vendor-Daemon herunter. Der Lizenzmanager-Daemon läuft weiter.
-q Keine Aufforderung oder Kopfzeile ausgeben. Andernfalls fragt lmdown “Sind Sie sicher? [j/n]: .”
-all Wenn mehrere Server angegeben sind, werden alle automatisch heruntergefahren. -q ist bei -all impliziert.

Führen Sie den Befehl lmdown auf einem Lizenzserver aus. Sie können -all verwenden, um alle Lizenzserver in Ihrem Netzwerk herunterzufahren.

  • Wenn lmdown auf mehr als einen Server trifft und Sie das Argument -all nicht angegeben haben, zeigt der Befehl eine Auswahl von Lizenzservern zum Herunterfahren an. Zum Beispiel 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 Task-Manager verwenden, um den License Manager-Daemon (Citrix Licensing Service) zu beenden, stoppen Sie zuerst den lmgrd-Prozess und danach den Citrix Vendor Daemon-Prozess.

Um den Citrix Vendor Daemon nur zu stoppen 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üft die Bindungsinformationen des Lizenzservers (lmhostid)

Der Befehl lmhostid gibt die Host-ID des Lizenzservers zurück. Sie können den Befehl verwenden, um den Hostnamen Ihres Lizenzservers zu überprüfen. Sie können eine Lizenzdatei öffnen und den Hostnamen in der Lizenzdatei mit dem Ihres Lizenzservers vergleichen.

Hinweis

Citrix Licensing, Versionen 11.5 und höher für Windows, ermöglicht die Anzeige mehrerer Host-IDs, wenn mehr als ein Host vorhanden ist.

  • Syntax:

  • lmhostid -bindingidentifier

  • Der bindingidentifier ist ein Argument im Befehl.

Argument Beschreibung
-ether Wird für Produktlizenzen verwendet, die an die MAC-Adresse des Geräts gebunden sind.
-internet Wird für Windows-basierte Citrix Produktsoftwarelizenzen verwendet, die eine TCP/IP-Adresse erfordern.
-hostname Wird für Windows-basierte Citrix Produktsoftwarelizenzen verwendet, die an den Hostnamen des Lizenzservers gebunden sind. Hinweis: Der Parameter hostname ist Groß-/Kleinschreibung-sensitiv und muss exakt mit dem Namen Ihres Lizenzservers übereinstimmen.

Lizenz- und Optionsdateien neu einlesen (lmreread)

Der Befehl lmreread veranlasst den Citrix Vendor Daemon, Änderungen an der Lizenzdatei und der Optionsdatei neu einzulesen. Nach dem erneuten Einlesen verwendet der Citrix Vendor Daemon von da an die neuen Einstellungen und Lizenzen.

Sie können lmreread nicht remote verwenden; führen Sie es lokal auf dem Lizenzserver aus.

Syntax:

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

Argument Beschreibung
-c @localhost oder -c license_file_list Verwendet die angegebenen Lizenzdateien.
-all Wenn mehr als ein lmgrd angegeben ist, weist dieses Argument alle License Manager Daemons an, neu einzulesen.
-vendor CITRIX Gibt an, dass der Citrix Vendor Daemon neu gestartet werden soll.

Beispiele:

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

Liste der Lizenzierungsdienstprogramme anzeigen (lmutil)

Der Befehl lmutil zeigt eine Liste der Lizenzierungsdienstprogramme an, wenn er eigenständig verwendet wird. Wenn Sie lmutil mit einem anderen Befehl angeben, führt er diesen Befehl aus.

Syntax:

lmutil

lmutil other_command

Beispiele:

  • lmutil

    Zeigt alle Lizenzierungsdienstprogramme an.

  • lmutil lmstat -c @localhost

    Führt den Befehl lmstat aus.

Lizenzierungsstatus ermitteln (lmstat)

Der Befehl lmstat hilft Ihnen, den Status aller Lizenzierungsaktivitäten zu überwachen und liefert Ihnen Informationen zu Lizenzausleihen, einschließlich:

  • Das Produkt, das eine oder mehrere Lizenzen ausgeliehen hat
  • Die Ausleihdaten
  • Die Version der Lizenzdatei
  • Der Name und Port des Lizenzservers
  • Das Datum der Lizenzausleihe
  • Informationen zum Status des Citrix Vendor Daemons und den Lizenzdateien

Der Befehl lmstat zeigt die Informationen an, die er vom Lizenzserver erhält. Der Befehl lmstat zeigt nur eine Lizenznutzung an, selbst wenn mehrere Verbindungen diese Lizenz gemeinsam nutzen.

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 oder -c @server oder -c license_file_list Verwendet die angegebenen Lizenzdateien.
-f [feature] Zeigt die Produkte an, die eine Funktion (Produktlizenz) verwenden. Wenn Sie keine Funktion angeben, werden Nutzungsinformationen für alle Funktionen angezeigt.
-i [feature] Wenn Sie keine Funktion angeben, zeigt dieses Argument Informationen aus der INCREMENT-Zeile für die angegebene Funktion (Produktlizenz) oder alle Funktionen an.
-s [server] Wenn Sie keinen Server angeben, zeigt dieses Argument den Status aller auf dem Lizenzserver aufgelisteten Lizenzdateien oder der auf allen Lizenzservern aufgelisteten Lizenzdateien an.
-S [CITRIX] Listet alle Produktserver auf, die die vom Citrix Vendor Daemon bereitgestellten Funktionen (Produktlizenzen) verwenden.
-t timeout_value Legt den Verbindungs-Timeout auf timeout_value fest. Dieser Wert begrenzt die Zeit, die lmstat für den Verbindungsversuch zum Lizenzserver aufwendet.

Die Ausgabe von lmstat -c @localhost -a sieht ähnlich aus wie dieses Beispiel. Die Zeilen im Beispiel können aufgrund des Bildschirmplatzes 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-->

Das Folgende stellt eine Aufschlüsselung der Informationen dar, die in der Zeile MPS_ENT_CCU der lmstat-Ausgabe enthalten sind:

    Beschreibung
Citrix Produktname MPS Der Name des Citrix-Produkts, für das die Lizenz ausgecheckt wurde.
Hostname mps_server1 Computer, auf dem das Citrix-Produkt ausgeführt wird.
Anzeige MPS Name des Citrix-Produkts, für das die Lizenz ausgecheckt wurde.
Server-Host license_server1 Computer, auf dem der Lizenzserver ausgeführt wird.
Port 27000 TCP/IP-Port, auf dem der Lizenzserver ausgeführt wird.
Handle 203 Lizenz-Handle. Das Lizenz-Handle ist eine Nummer, die zur Identifizierung einer spezifischen ausgecheckten Lizenz verwendet wird.
Checkout-Zeit start Wed 3/17 11:56 Zeitpunkt, zu dem diese Lizenz zum ersten Mal ausgecheckt wurde.

Der Befehl lmstat -c @localhost -a kann potenziell viel Netzwerkaktivität in Systemen erzeugen, die viele Produktlizenzen ausgecheckt haben.

Sie können lmstat -a verwenden, um Lizenzauscheckdaten zu überprüfen.

Versionen von Binärdateien anzeigen (lmver)

Der Befehl lmver zeigt Versionsinformationen für die Lizenzierungs-Binärdateien an, wie z. B. die Befehlszeilendienstprogramme.

Syntax:

lmver binary

Beispiel:

lmver lmdiag

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

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

Hinweis:

Das UDAdmin-Tool wird nur zur Berichterstattung über die Lizenznutzung für das Benutzer-/Gerätelizenzmodell und nicht für Concurrent-Lizenzen verwendet.

Sie können eine Lizenz für einen Benutzer nur freigeben, wenn:

  • Der Mitarbeiter nicht mehr mit dem Unternehmen verbunden ist.
  • Der Mitarbeiter sich in einem längeren Urlaub befindet.

Sie können Lizenzen für Geräte nur freigeben, wenn die Geräte außer Betrieb sind.

Vorsicht:

Eine Massenfreigabe von Lizenzen vor der automatischen 90-Tage-Lease-Periode, außerhalb der zuvor genannten Gründe, könnte gegen die Citrix EULA verstoßen. Kontaktieren Sie Citrix, bevor Sie dies tun.

Die udadmin-Befehlszeilenhilfe zeigt Nutzungsinformationen nur in englischer Sprache an, Sie können den Befehl jedoch auf nicht-englischen Systemen verwenden.

Syntax:

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

Optionen Beschreibung
-f feature name Bei Verwendung mit -list oder -delete wird die Lizenz nur für den Benutzer oder das Gerät für den angegebenen Funktionsnamen angezeigt oder freigegeben.
-user user name Gibt die Lizenz nur für den durch den Benutzernamen angegebenen Benutzer frei.
-device device name Gibt die Lizenz nur für das durch den Gerätenamen angegebene Gerät frei.
-a Listet alle auf dem Lizenzserver installierten Funktionen und Versionen auf.
Argument Beschreibung
-delete Gibt die Lizenz für einen Benutzer, eine Funktion oder ein Gerät gleichzeitig frei.
-events Meldet alle vom Benutzer-/Gerätelizenzierungssystem protokollierten Ereignisse für jede Funktion, sortiert in chronologischer Reihenfolge.
-list Zeigt die Benutzer und Geräte mit Lizenzen und die Zeit seit der letzten Aktualisierung an. Wenn innerhalb von 15 Minuten nach dem letzten Bericht eine signifikante Aktivität stattfand, wird die Zeit bis zur nächsten Aktualisierung angezeigt. Die Angabe von -list -times erzeugt eine Ausgabe mit einem Zeitstempel.
-times Die Angabe von -list -times erzeugt eine Ausgabe mit einem Zeitstempel.
Kein Argument oder ? Zeigt Nutzungsinformationen 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-->