Lizenzierungsbefehle

Obwohl die Lizenzverwaltungskonsole 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. Solche Operationen umfassen die Diagnose von Check-out-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

• Beschreibungen der Befehle

• lmadmin— Bietet Lizenzierungskonfiguration. Verwenden Sie die Lizenzverwaltungskonsole für Lizenzierungs- und Verwaltungsaufgaben. Verwenden Sie lmadmin nicht.

• lmdiag — Diagnostiziert Probleme beim Lizenz-Check-out.

• lmdown — Fährt den Lizenzmanager und die Citrix®-Hersteller-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-Hersteller-Daemon zu starten.

• lmstat — Zeigt den Status eines Lizenzservers an.

• lmutil — Zeigt eine Liste der Lizenzierungsdienstprogramme an oder führt andere Befehle aus.

• lmver — Zeigt Versionsinformationen für die Lizenzierungs-Binä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. Die Angabe von udadmin -export exportiert unverarbeitete Benutzer- und Gerätedaten. Diese Daten werden zur Berechnung der Lizenznutzung verwendet und stellen keine Liste der verwendeten Lizenzen dar. Um eine Liste der Lizenzen zu erhalten, geben Sie udadmin -list an.

Format der Lizenzbefehle

Formatierungskonventionen für die Lizenzverwaltungsbefehle:

Universelle Argumente

Gültige Argumente für die meisten Lizenzverwaltungsbefehle:

Probleme beim Lizenz-Check-out 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]]

Wenn keine Funktion angegeben ist, arbeitet lmdiag mit allen Funktionen in den Lizenzdateien Ihrer Liste. Der Befehl lmdiag zeigt Informationen über die Lizenz an und versucht dann, jede Lizenz auszuchecken. Wenn der Check-out erfolgreich ist, zeigt lmdiag an, dass der Check-out erfolgreich war. Wenn der Check-out 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-Hersteller-Daemon auf Ihrem Lizenzserver oder allen Lizenzservern in Ihrem Netzwerk herunter. Der Befehl lmdown ist standardmäßig deaktiviert. Um ihn zu aktivieren:

1. Beenden Sie den Lizenzdienst.
2. Führen Sie lmadmin - allowStopServer und -allowRemoteStop Server oder -allowRemoteStop Server aus.
3. Starten Sie den Lizenzserver neu.

Syntax:

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

• | – | – |

• -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 License Manager-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. 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 Task-Manager verwenden, um den License Manager-Daemon (Citrix Licensing Service) zu beenden, stoppen Sie zuerst den lmgrd-Prozess und dann den Citrix Vendor-Daemon-Prozess.

Um nur den Citrix Vendor-Daemon 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.

• Hostnamen überprüfen (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öglichen die Anzeige mehrerer Host-IDs, wenn mehr als ein Host vorhanden ist.

Syntax:

lmhostid -bindingidentifier

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

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, wird dieser Befehl ausgeführt.

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 Netzwerk-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 Informationen an, die er vom Lizenzserver erhält. Der Befehl lmstat zeigt nur eine Nutzung der Lizenz 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]

• -S [CITRIX]	Listet alle Produktserver auf, die die vom Citrix-Vendor-Daemon bereitgestellten Funktionen (Produktlizenzen) verwenden.
  -t timeout_value	Legt das 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 diesem Beispiel ähnlich. 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:

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

Sie können lmstat -a verwenden, um Lizenzausleihdaten 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 Befehlsdienstprogramme. Eine Ausnahme bildet der Befehl lmadmin. Um Versionsinformationen für den Befehl lmadmin anzuzeigen, verwenden Sie lmadmin -version.

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 Lizenzen für bestimmte Benutzer und Geräte frei.

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 oder einer längeren Abwesenheit befindet.

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

Vorsicht:

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

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

Syntax:

udadmin [-options] [-delete | -events | -export | -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 -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-->