Comandos de licencias
Si bien Citrix Licensing Manager proporciona un método fácil para acceder a muchas de las funciones de licencias, también se pueden ejecutar tareas de licencia con comandos. Puede usar los comandos de administración de licencias para operaciones avanzadas en el servidor de licencias que no están disponibles en la consola. Estas operaciones incluyen el diagnóstico de problemas de extracción mediante lmdiag
.
Los comandos de administración de licencias se almacenan en:
-
C:\Program Files\Citrix\Licensing\LS
en un equipo de 32 bits -
C:\Program Files (x86)\Citrix\Licensing\LS
en un equipo de 64 bits
Descripción de los comandos de licencias
Nota:
En la versión 11.16.6, compilación 34000, de License Server, la administración de usuarios existente lmadmin.exe se reemplaza por la administración de usuarios propiedad de Citrix lmgrd.exe. Asegúrese de no utilizar
lmadmin
.
Comandos de licencias | Descripción |
---|---|
lmgrd |
Inicia y administra el Servidor de licencias y otros procesos asociados. lmgrd es el archivo del Servidor de licencias principal utilizado para el servicio de Windows de Citrix Licensing. Aloja el puerto del Servidor de licencias (el valor predeterminado es 27000). Use Citrix Licensing Manager para la configuración de las licencias y las tareas de administración. |
lmdiag |
Diagnostica problemas de extracción de licencias. |
lmdown |
Cierra License Manager y los demonios de proveedor Citrix (inhabilitado de forma predeterminada). |
lmhostid |
Devuelve el ID de host del servidor donde se está ejecutando el sistema de licencias de Citrix. |
lmreread |
Hace que el demonio administrador de licencias vuelva a leer el archivo de licencias e inicie el demonio de proveedor Citrix. |
lmstat |
Muestra el estado de un servidor de licencias. |
lmutil |
Muestra una lista de los comandos de licencias o ejecuta otros comandos. |
lmver |
Muestra la información de versión de los binarios del sistema de licencias. |
udadmin |
Muestra todos los dispositivos y usuarios con licencia, y elimina los dispositivos y usuarios con licencia especificados. Este comando se aplica solamente a licencias de usuario/dispositivo. Para obtener una lista de licencias, especifique udadmin -list . |
CtxManageUserAndGroup |
Configura el acceso de usuarios y grupos para administrar el servidor de licencias. |
CtxManageUserAndGroup.exe –useradd “domain\username” -Role “admin/user” |
Comando para agregar un usuario. |
CtxManageUserAndGroup.exe –useradd “domain\username” –Role “adminGroup/userGroup” |
Comando para agregar un grupo. |
Comandos para el formato de licencias
Convenciones de formato para los comandos de administración de licencias:
Convención | Descripción |
---|---|
Negrita | Un comando o un modificador de línea de comandos, como lmstat. |
Cursiva | Reemplace las variables por un valor. Por ejemplo, en la expresión: lmstat -c license_file_list. Antes de ejecutar el comando, sustituya license_file_list por los nombres de los archivos de licencia que corresponda. |
[Corchetes] | Los corchetes alrededor de texto indican las opciones que puede agregar al comando. Podría indicar que el texto entre corchetes debe sustituirse. Por ejemplo: 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
|
Argumentos universales
Argumentos válidos para la mayoría de los comandos de administración de licencias:
Argumento | Descripción |
---|---|
-all | Muestra toda la información sobre el servidor de licencias. |
-c | Le permite especificar los archivos de licencias o el número de puerto y el nombre de host del Servidor de licencias. Si se escribe simplemente una ruta sin especificar ningún nombre de archivo de licencia, el comando se aplica a todos los archivos de licencia que haya en el directorio. Para un host local: -c @localhost . Para un servidor de licencias remoto: -c @servername . Para un servidor de licencias en un clúster: -c @clientaccesspointname . Para una ruta especificada: -c path . Para los nombres de uno o más archivos de licencias: -c license_file_list . Para introducir más de una ruta de archivo de licencias, separe cada ruta con un punto y coma. Los nombres de ruta que incluyan espacios deben ir entre comillas. |
-h | Identificador de licencia, según lo indica el comando lmstat -a . El identificador de licencia es un número utilizado para identificar una licencia extraída determinada. |
-help | Muestra información de uso y sale del comando. |
-s [servidor] | Si no especifica un servidor, este argumento muestra el estado de todos los archivos de licencias indicados en el servidor de licencias o los archivos de licencias de todos los servidores de licencias. |
-verbose | Muestra una descripción más larga de los errores encontrados. |
Diagnóstico de problemas de extracción de licencias (lmdiag)
El comando lmdiag
permite diagnosticar problemas cuando un producto no puede extraer una licencia. En concreto, permite comprobar si las licencias son válidas e indica si el servidor de licencias está funcionando. Cuando se ejecuta este comando, este intenta extraer una licencia.
También puede usar el comando lmdiag
para ver si un determinado tipo de licencia está funcionando.
Ejemplo:
Ejecute lmdiag
solamente en las licencias Advanced Edition del servidor Citrix Virtual Apps. Especifique MPS_ADV_CCU
como argumento.
Sintaxis:
lmdiag -c license_file_list [-n] [feature[:keyword=value]]
Argumento | Descripción |
---|---|
-c license_file_list | Diagnostica los archivos especificados. También puede usar: -c @localhost o -c @server-name
|
-n | Se ejecuta en modo no interactivo; lmdiag no solicita ninguna entrada en este modo. |
feature | Limita el resultado a la función especificada. |
palabra clave=valor | Si un archivo de licencias contiene varias líneas para una función determinada, el resultado se limita a la línea que contiene el texto del valor especificado. Por ejemplo: lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01 intenta extraer una licencia en la línea con el ID de host LICSERV01. “Palabra clave” puede ser alguna de estas palabras clave: VERSION, HOSTID, EXPDATE, KEY, VENDOR_STRING, ISSUER |
Si no se especifica una función, lmdiag
opera con todas las funciones de los archivos de licencia de su lista. El comando lmdiag
muestra información sobre la licencia y, luego, intenta extraer cada licencia. Cuando la extracción se realiza correctamente, lmdiag
indica que la extracción se ha realizado correctamente. Cuando se produce un error en la extracción, lmdiag
le indica el motivo. El comando lmdiag
intenta conectarse a cada puerto TCP/IP del Servidor de licencias. Detecta si el número de puerto que figura en el archivo de licencias es incorrecto. lmdiag
indica cada número de puerto TCP/IP que está a la escucha y, si se especifica -c license_file_list, diagnostica los archivos especificados.
El comando lmdiag
no contacta con el equipo que ejecuta el producto Citrix cuando intenta extraer licencias. El comando lmdiag
solo indica si hay problemas en el servidor de licencias. Es decir, el producto no puede extraer licencias porque está apunta a un servidor de licencias incorrecto, pero lmdiag
no detecta este problema. Por ejemplo, un servidor de licencias que no tiene licencias para ese producto. El comando lmdiag
notifica que puede extraer licencias cuando el producto Citrix apunta a un servidor de licencias incorrecto.
Detener demonios (lmdown)
El comando lmdown
detiene el demonio del administrador de licencias y el demonio de proveedor Citrix en el servidor de licencias o en todos los servidores de licencias de la red. El comando lmdown
está inhabilitado de forma predeterminada.
Sintaxis:
lmdown -c license_file_list [-vendor CITRIX] [-q] [-all]
Argumento | Descripción |
---|---|
-c license_file_list o -c @localhost o -c @server | Usa los archivos de licencias especificados. Siempre recomendamos especificar -c license_file_list con lmdown . También puede usar: -c @localhost o -c @server-name
|
-vendor CITRIX | Detiene solamente el demonio de proveedor Citrix. El demonio del administrador de licencias sigue ejecutándose. |
-q | No ofrece interactividad ni imprime un encabezado. De lo contrario, lmdown pregunta “Are you sure? y/n:”. |
-all | Si se especifican varios servidores, detiene todos ellos automáticamente. El uso de -all implica -q. |
Ejecute el comando lmdown
en un servidor de licencias. Se puede emplear -all para apagar todos los servidores de licencias de la red.
Si lmdown
encuentra más de un servidor y no se ha especificado el argumento -all, el comando muestra una selección de servidores de licencias que apagar. Por ejemplo, el argumento -c especifica un directorio con muchos archivos *.lic. Puede apagar los servidores de licencias remotos mediante -c y el nombre del Servidor de licencias.
Nota:
Si utiliza el Administrador de tareas para detener el demonio del administrador de licencias (Citrix Licensing Service), detenga primero el proceso
lmgrd
y, después, detenga el proceso del demonio de proveedor Citrix.
Para detener y reiniciar solamente el demonio de proveedor Citrix, utilice lmdown -c @localhost -vendor CITRIX
y, a continuación, utilice lmreread -c @localhost -vendor CITRIX
para reiniciar el demonio de proveedor.
Comprueba la información de enlace del Servidor de licencias (lmhostid)
El comando lmhostid
devuelve el ID de host del Servidor de licencias. Se puede usar este comando para comprobar el nombre de host del Servidor de licencias. Se puede abrir un archivo de licencia y comparar el nombre de host que figura en dicho archivo con el del Servidor de licencias.
Nota
Citrix Licensing 11.5 y posterior para Windows permite mostrar varios ID de host si existe más de un host.
Sintaxis:
lmhostid -bindingidentifier
Donde bindingidentifier
es el argumento.
Argumento | Descripción |
---|---|
-ether | Se usa para licencias de producto asociadas a una dirección MAC de dispositivo de hardware. |
-internet | Se usa para licencias de productos de software de Citrix basados en Windows que requieren una dirección TCP/IP. |
-hostname | Se usa para licencias de productos de software Citrix basados en Windows y asociados al nombre del host del Servidor de licencias. Nota: El parámetro hostname distingue entre mayúsculas y minúsculas y debe coincidir exactamente con el nombre del Servidor de licencias. |
Vuelva a leer los archivos de licencia y los archivos opciones (lmreread)
El comando lmreread
hace que el demonio de proveedor Citrix vuelva a leer los cambios del archivo de licencias y del archivo de opciones. Después de volver a leerlos, el demonio de proveedor Citrix usa los nuevos parámetros y licencias a partir de ese momento.
El comando lmreread
no puede ejecutarse desde una ubicación remota; debe ejecutarse localmente en el servidor de licencias.
Sintaxis:
lmreread -c license_file_list [-all] [-vendor CITRIX]
Argumento | Descripción |
---|---|
-c @localhost o -c license_file_list | Usa los archivos de licencias especificados. |
-all | Si se especifica más de un comando lmgrd , este argumento da la orden a todos los demonios del administrador de licencias de que vuelvan a leer los archivos. |
-vendor CITRIX | Reinicia el demonio de proveedor Citrix. |
Ejemplos:
lmreread -c @localhost \[-all\]
lmreread -c @client\_access\_point\_name
lmreread -c /opt/citrix/licensing/myfiles/CITRIX.lic -vendor CITRIX
Ver la lista de comandos de licencias (lmutil)
El comando lmutil
muestra una lista de los comandos de licencias cuando se usa en solitario. Cuando se especifica lmutil
con otro comando, ejecuta ese comando.
Sintaxis:
lmutil
lmutil other_command
Ejemplos:
-
lmutil
Muestra una lista de todos los comandos de licencias.
-
lmutil lmstat -c @localhost
Ejecuta el comando lmstat.
Determinar el estado de licencia (lmstat)
El comando lmstat
le ayuda a supervisar el estado de todas las actividades relacionadas con las licencias y proporciona la siguiente información sobre la extracción de licencias:
- El producto que ha extraído una o varias licencias
- Los datos de la extracción de licencia
- La versión del archivo de licencias
- El nombre y el puerto del Servidor de licencias
- La fecha de extracción de la licencia
- Información sobre el estado del demonio de proveedor Citrix y los archivos de licencias
El comando lmstat
muestra información recibida del Servidor de licencias. El comando lmstat
solo muestra un uso de la licencia, aunque haya varias conexiones que compartan esa licencia.
Sintaxis:
lmstat [-a] [-c license_file_list] [-f [feature]] [-i [feature] [-s[server] [-S [CITRIX]] [-t timeout_value]
Argumento | Descripción |
---|---|
-a | Muestra toda la información. |
-c @localhost o -c @server o -c license_file_list | Usa los archivos de licencias especificados. |
-f [función] | Muestra los productos que usan una “función” (licencia de producto). Si no especifica una función, se muestra la información de uso de todas las funciones. |
-i [función] | Si no especifica una función, este argumento muestra información de la línea INCREMENT para la función especificada (licencia del producto) o para todas las funciones. |
-s [servidor] | Si no especifica un servidor, este argumento muestra el estado de todos los archivos de licencias indicados en el servidor de licencias o los archivos de licencias indicados en todos los servidores de licencias. |
-S [CITRIX] | Ofrece una lista de todos los servidores de productos que utilizan las funciones (licencias de producto) facilitadas por el demonio de proveedor Citrix. |
-t timeout_value | Establece el tiempo de espera de la conexión en timeout_value. Este valor limita el tiempo que lmstat puede emplear para intentar conectarse al servidor de licencias. |
El resultado de lmstat -c @localhost -a
es similar al de este ejemplo. Es posible que las líneas del ejemplo queden divididas debido al espacio en pantalla.
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-->
A continuación se muestra un desglose de la información contenida en la línea MPS_ENT_CCU del resultado del comando lmstat:
Descripción | ||
---|---|---|
Nombre del producto Citrix | MPS | Nombre del producto Citrix que ha extraído la licencia. |
Nombre de host | mps_server1 | El equipo donde se está ejecutando el producto Citrix. |
Pantalla | MPS | Nombre del producto Citrix del que se ha extraído la licencia. |
Host del servidor | license_server1 | El equipo en el que se ejecuta el servidor de licencias. |
Puerto | 27000 | El puerto TCP/IP en el que se ejecuta el servidor de licencias. |
Identificador | 203 | Identificador de licencia. El identificador de licencia es un número utilizado para identificar una licencia extraída determinada. |
Día y hora de la extracción | start Wed 3/17 11:56 | Fecha y hora en que se extrajo por primera vez esta licencia. |
El comando lmstat -c @localhost -a
puede generar mucha actividad de red en sistemas donde se extraigan muchas licencias de producto.
Use el comando lmstat -a
para verificar la información de extracción de licencias.
Mostrar versiones de binarios (lmver)
El comando lmver
muestra información de versión para los archivos binarios del sistema de licencias como, por ejemplo, las utilidades de los comandos.
Sintaxis:
lmver binary
Ejemplo:
lmver lmdiag
Mostrar o liberar licencias para usuarios o dispositivos (udadmin)
El comando udadmin
muestra los usuarios y dispositivos con licencia, y además libera licencias asignadas a usuarios y dispositivos específicos.
Nota:
La herramienta UDAdmin solo se usa para notificar el uso de licencias para el modelo de licencia de usuario/dispositivo y no para las licencias simultáneas.
Puede liberar una licencia para un usuario solamente cuando:
- El empleado ya no esté asociado a la empresa.
- El empleado tenga un permiso de ausencia prolongada.
Las licencias de dispositivo solo se pueden liberar cuando los dispositivos están fuera de servicio.
Precaución:
Tenga en cuenta que la liberación de licencias en masa, anterior al período de concesión automático de 90 días y que no se deba a los motivos indicados anteriormente, puede incurrir en incumplimiento de las condiciones del Contrato de licencia de usuario final (EULA) de Citrix. Antes de hacerlo, póngase en contacto con Citrix.
La ayuda de la línea de comando udadmin
muestra información de uso en inglés solamente, pero se puede usar el comando en sistemas que no estén en inglés.
Sintaxis:
udadmin [-options] [-delete | -events | -list | -times]
Opciones | Descripción |
---|---|
-f nombre de la funcionalidad | Cuando se usa con -list o -delete, muestra o libera la licencia del nombre de componente especificado para el usuario o dispositivo solamente. |
-user nombre de usuario | Libera la licencia para el nombre de usuario especificado solamente. |
-device nombre del dispositivo | Libera la licencia para el nombre de dispositivo especificado solamente. |
-a | Indica todas las funciones y versiones instaladas en el servidor de licencias. |
Argumento | Descripción |
-delete | Libera la licencia para un usuario, una función o un dispositivo. |
-events | Informa, por orden cronológico, de todos los eventos registrados por licencias de usuario/dispositivo para cada función. |
-list | Muestra los usuarios y dispositivos con licencias, y la fecha de la última actualización. Se muestra la fecha de la próxima actualización si se ha detectado mucha actividad en los 15 minutos desde el último informe. Al especificar -list -times , se obtiene un resultado que contiene una marca de hora. |
-times | Al especificar -list -times , se obtiene un resultado que contiene una marca de hora. |
Sin argumento o ?
|
Muestra información de uso del comando udadmin . |
Ejemplos:
- 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-->
En este artículo
- Descripción de los comandos de licencias
- Comandos para el formato de licencias
- Argumentos universales
- Diagnóstico de problemas de extracción de licencias (lmdiag)
- Detener demonios (lmdown)
- Comprueba la información de enlace del Servidor de licencias (lmhostid)
- Vuelva a leer los archivos de licencia y los archivos opciones (lmreread)
- Ver la lista de comandos de licencias (lmutil)
- Determinar el estado de licencia (lmstat)
- Mostrar versiones de binarios (lmver)
- Mostrar o liberar licencias para usuarios o dispositivos (udadmin)