Comandos de licencias

Si bien License Administration Console proporciona un método fácil para acceder a muchas de las características de licencias, también se pueden ejecutar tareas de licencia con comandos. Puede usar comandos de administración de licencias al realizar 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:\Archivos de programa\Citrix\Licensing\LS en un equipo de 32 bits
  • C:\Archivos de programa (x86)\Citrix\Licensing\LS en un equipo de 64 bits
  • /opt/citrix/licensing/LS para License Server VPX

Tabla de comandos

Comando Descripción
lmadmin Proporciona la configuración de las licencias. Use la consola License Administration Console para la configuración de las licencias y las tareas de administración. No use lmadmin.
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 a licencias de usuario o dispositivo solamente. Nota: al especificar udadmin -export se exporta el uso del producto, no una lista de licencias. Para obtener una lista de licencias, especifique udadmin -list.

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 conmutador, 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, hay que sustituir lista_archivos_licencia por los nombres de los archivos de licencia que corresponda.
  [corchetes] El texto incluido entre corchetes indica opciones que pueden agregarse al comando o texto que tiene que sustituirse.

Argumentos universales

Argumentos válidos para la mayoría de los comandos de administración de licencias:

Argumento Descripción
-all Aplica el comando a todos los servidores de licencias de la red.
-c 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 licencia remoto: -c @servername Para un servidor de licencia 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 Puede ingresar más de una ruta de archivo de licencias, separando cada ruta con un punto y coma. Los nombres de ruta que incluyan espacios deben ir entre comillas.
-h Manipulador de licencias, según lo indica el comando lmstat -a. El manipulador de la 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] Muestra el estado de todos los archivos de licencias que existen en el servidor de licencias o en todos los servidores de licencias, si no se especifica ningún servidor concreto.
-verbose Muestra una descripción más larga de los errores encontrados.

Diagnóstico de problemas de extracción de licencias (lmdiag)

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, éste intenta extraer una licencia.

También se puede usar lmdiag para ver si un determinado tipo de licencia está funcionando. Por ejemplo, para ejecutar lmdiag en un servidor Citrix Virtual Apps con licencias Advanced Edition, solo debe especificar el argumento MPS_ADV_CCU.

Sintaxis:

lmdiag -c lista_archivos_licencia [-n] [feature[:palabra clave=valor]]

Argumento Descripción
-c lista_archivo_licencia Diagnostica los archivos especificados. También puede usar:-c @hostlocal o -c @nombre_servidor
-n Se ejecuta en modo no interactivo; lmdiag no solicita ninguna entrada en este modo.
función 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 ninguna versión de producto, lmdiag se aplica a todas las versiones de producto encontradas en los archivos de licencia de la lista. lmdiag muestra información sobre la licencia y, después, intenta extraer cada licencia. Si la extracción se realiza correctamente, lmdiag comunica que la operación tuvo éxito. Si la extracción falla, lmdiag muestra el motivo del fallo. lmdiag intenta conectar 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 enumera cada número de puerto TCP/IP que está a la escucha y, si se especifica -c lista_archivos_licencia, diagnostica los archivos especificados.

lmdiag no contacta con el equipo que ejecuta el producto Citrix cuando intenta extraer licencias. lmdiag solo indica si hay problemas en el servidor de licencias. Es decir, si el producto no puede extraer licencias porque está haciendo referencia a un servidor de licencias incorrecto, lmdiag no detecta este problema. Por ejemplo, un servidor de licencias que no tuviese licencias para dicho producto). lmdiag comunicaría que es capaz de extraer licencias aunque el producto Citrix estuviese utilizando 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 (inhabilitado de forma predeterminada). Para habilitarlo:

  1. Detener el servicio de licencias.
  2. Ejecute lmadmin - allowStopServer y/o -allowRemoteStop Server.
  3. Reiniciar el servidor de licencias.

Sintaxis:

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

Argumento Descripción
-c lista_archivos_licencia o -c@localhost o -c@servidor Usa los archivos de licencias especificados. Siempre se recomienda especificar -c license_file_list con lmdown. También puede usar: -c @localhost o -c @server-name
-vendor CITRIX Detiene sólo el demonio de proveedor Citrix. El demonio de administrador de licencias sigue ejecutándose.
-q No ofrece interactividad ni imprime un encabezado. De lo contrario lmdown pregunta “¿Está seguro? [[y/n]]: . “
-all Si se especifican varios servidores, detiene todos ellos automáticamente. El uso de -all implica -q.

El comando lmdown debe ejecutarse en un servidor de licencias. Se puede emplear -all para detener todos los servidores de licencias de la red.

Si lmdown encuentra más de un servidor (por ejemplo, si -c especifica un directorio con muchos archivos *.lic) y -all no se especifica, el comando muestra una selección de servidores de licencias para apagar. Puede cerrar los servidores de licencias remotos utilizando -c y especificando el nombre del servidor de licencias.

Nota:

Si utiliza el Administrador de tareas para detener el demonio del administrador de licencias (el servicio Citrix Licensing), detenga primero el proceso lmgrd y, después, detenga el proceso del demonio de proveedor Citrix.

Para detener y reiniciar solo el demonio de proveedor de Citrix, use lmdown -c @localhost -vendor CITRIX, luego use lmreread -c @localhost -vendor CITRIX para reiniciar el demonio de proveedor.

Comprobar nombres de host (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

Argumento (bindingidentifier) 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 de host 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 archivos de licencia y el archivo de opciones. Después de volver a leerlos, si encuentra cambios, el demonio de proveedor Citrix usa los nuevos parámetros o 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 lista_archivos_licencia [-all] [-vendor CITRIX]

Argumento Descripción
-c @localhost or -c lista_archivos_licencia Usa los archivos de licencias especificados.
-all Si se especifica más de un lmgrd, todos los demonios de administración de licencias vuelven a leer los archivos.
-vendor CITRIX Reinicia el demonio de proveedor Citrix.

Ejemplos:

  • lmreread -c @localhost [-all]
  • lmreread -c @nombre_de_punto_de_acceso_de_cliente
  • 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 usa lmutil con otro comando, ejecuta dicho comando.

Sintaxis:

lmutil

lmutil otro_comando

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 ayuda a supervisar el estado de las actividades relacionadas con las licencias en la red, 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 del proveedor Citrix y los archivos de licencias

lmstat muestra la información que recibe del servidor de licencias. lmstat sólo muestra un uso de la licencia, aunque haya varias conexiones compartiendo dicha licencia.

Sintaxis:

lmstat [-a] [-c lista_archivo_licencia] [-f [función]] [-i [función] [-s [servidor] [-S [CITRIX]] [-t valor_tiempo]

Argumento Descripción
-a Muestra toda la información.
-c @localhost o -c@servidor o -c lista_archivos_licencia Usa los archivos de licencias especificados.
-f [función] Muestra los productos que usan una “función” (licencia de producto). Si no se especifica una función, se muestra la información de uso de todas las versiones.
-i [función] Muestra información de la línea INCREMENT de la función (licencia de producto) especificada; o de todas si no se especifica ninguna función.
-s [servidor] Muestra el estado de todos los archivos de licencias que existen en el servidor de licencias o en todos los servidores de licencias, si no se especifica ningún servidor concreto.
-S [CITRIX] Enumera todos los servidores de productos que están usando las versiones de productos (licencias de producto) facilitados por el demonio de proveedor Citrix.
-t valor_tiempo_espera Establece el tiempo de espera de la conexión con el valor_tiempo_espera. Esto limita el tiempo que lmstat puede emplear intentando conectar con el servidor de licencias.

El resultado de lmstat -c@localhost -a es similar al de este ejemplo. Es posible que las líneas del ejemplo se dividan 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

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
MPS citrix_product_name Nombre del producto Citrix que ha extraído la licencia.
mps_server1 hostname El equipo donde se está ejecutando el producto Citrix.
MPS display Nombre del producto Citrix que ha extraído la licencia.
license_server1 server_host El equipo donde se está ejecutando el servidor de licencias.
27 000 puerto El puerto TCP/IP donde se está ejecutando el servidor de licencias.
203 handle Manipulador de licencias. El manipulador de la licencia es un número utilizado para identificar una licencia extraída determinada.
start Wed 3/17 11:56 checkout_time Fecha y hora en que se extrajo por primera vez esta licencia.

lmstat -c@localhost -a puede generar una gran cantidad de 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)

La utilidad lmver muestra información de versión para los archivos binarios del sistema de licencias como por ejemplo las utilidades de línea de comandos. La excepción es la utilidad lmadmin. Para mostrar información de versión para la utilidad lmadmin, use lmadmin -version.

Sintaxis:

lmver binario

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.

Puede liberar una licencia para un usuario cuando éste ya no está más asociado con la empresa o está ausente durante un periodo de tiempo largo. 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 periodo 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). Antes de hacerlo, póngase en contacto con Citrix.

La ayuda del comando udadmin muestra información de uso en inglés solamente, pero se puede usar el comando en sistemas que no sean en inglés.

Sintaxis:

udadmin [-options] [-delete -events -export -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 Enumera 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 por vez.
-events Informa, por orden cronológico, de todos los eventos registrados por licencias de usuario o dispositivo para cada función.
-export Exporta todos los datos de usuario o dispositivo en un solo documento CSV. La primera fila es el encabezado de la columna. El formato es: primero la función y luego el usuario. Cada elemento único (usuario,IDdispositivo,versiónSolicitada) se informa en una línea. Las solicitudes de licencias redundantes para el mismo elemento (usuario,IDdispositivo,versiónSolicitada) no se muestran individualmente. La solicitud más reciente actualiza la marca de tiempo.
-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. Especificando -list -times se obtiene una salida que contiene una marca de hora.
del usuario. Especificando -list -times se obtiene una salida que contiene una marca de hora.
Sin argumento o ? Muestra información de uso del comando udadmin.

Ejemplos:

  • udadmin -list -a

    Los datos de uso tienen 0 minutos de antigüedad. Próxima actualización en 15 minutos.

    Usuarios

    u01.01 XDT_ENT_UD 2017.1201 (jue 14 de septiembre 13:41:07 2017)

    u01.04 XDT_ENT_UD 2017.1201 (jue 14 de septiembre 13:41:07 2017) . . .

    Dispositivos

    D.ADV.23 XDT_ADV_UD 2017.1201 (jue 21 de septiembre 18:31:01 2017)

    D01 XDT_PLT_UD 2017.1201 (mar 12 de septiembre 14:30:33 2017)

  • udadmin -list -a

    Enumera todas las funciones, versiones, recuentos de licencias, así como los usuarios y dispositivos de cada versión.

  • udadmin -export

    feature,userId,deviceId,deviceName,versionRequested,versionUserAllocated,versionDeviceAllocated,time

  • udadmin -f XDT_ENT_UD -device dn01.88 -delete

    Elimina un dispositivo de una función.