Comandos de licencias

Si bien License Administration Console 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

Descripciones de los comandos

• 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 utilice lmadmin.

• lmdiag: Diagnostica problemas de extracción de licencias.

• lmdown: Cierra License Manager y los demonios de proveedor de Citrix (inhabilitado de forma predeterminada).

• lmhostid: Devuelve el ID de host del servidor donde se está ejecutando Citrix Licensing.

• lmreread: Hace que el demonio del administrador de licencias vuelva a leer el archivo de licencias e inicie el demonio de proveedor de 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. Al especificar udadmin -export, se exportan datos de usuario y dispositivo sin procesar. Estos datos se utilizan para calcular el uso de licencias y no representan una lista de las licencias en uso. 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:

Argumentos universales

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

Diagnosticar problemas de extracción (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]]

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. Para habilitarlo:

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

Sintaxis:

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

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.

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

Volver a leer los archivos de licencias y los archivos de 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]

Ejemplos:

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

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

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:

El comando 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)

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. El comando lmadmin es una excepción. Para mostrar la información de versión del comando lmadmin, utilice lmadmin -version.

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.

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 | -export | -list | -times]

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