Comandos de licencias
Aunque Citrix Licensing Manager proporciona un método sencillo para acceder a muchas funciones de licencias, también puedes realizar tareas de licencias mediante comandos. Puedes usar los comandos de administración de licencias para operaciones avanzadas en el servidor de licencias que no están disponibles en la consola. Dichas operaciones incluyen el diagnóstico de problemas de desprotección mediante lmdiag.
-
Los comandos de administración de licencias se almacenan en:
-
C:\Program Files\Citrix\Licensing\LSen un equipo de 32 bits -
C:\Program Files (x86)\Citrix\Licensing\LSen 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 sustituye por la administración de usuarios propiedad de Citrix lmgrd.exe. Asegúrate de no usar
lmadmin.
| Comandos de licencias | Descripción |
|---|---|
lmgrd |
Inicia y administra el servidor de licencias y otros procesos asociados. lmgrd es el archivo principal del servidor de licencias que se usa para el servicio de licencias de Citrix en Windows. Aloja el puerto del servidor de licencias (27000 de forma predeterminada). Usa el Citrix Licensing Manager para las tareas de configuración y administración de licencias. |
lmdiag |
Diagnostica problemas de desprotección de licencias. |
lmdown |
Apaga de forma segura el License Manager y los demonios de proveedor de Citrix® (deshabilitado de forma predeterminada). |
lmhostid |
Informa del ID de host del servidor en el que se ejecuta Citrix Licensing. |
lmreread |
Hace que el demonio de License Manager 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 utilidades de licencias o ejecuta otros comandos. |
lmver |
Muestra información de la versión de los binarios de licencias. |
udadmin |
Muestra todos los usuarios y dispositivos con licencia y elimina los usuarios y dispositivos con licencia especificados. Este comando se aplica solo a las licencias de usuario/dispositivo. Para obtener una lista de licencias, especifica 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. |
Formato de los comandos de licencias
Convenciones de formato para los comandos de administración de licencias:
| Convención | Descripción |
|---|---|
| Negrita | Un comando o modificador, como lmstat. |
| Cursiva | Sustituye las variables por un valor. Por ejemplo, en la expresión: lmstat -c lista_archivos_licencia. Antes de ejecutar el comando, sustituye lista_archivos_licencia por los nombres de uno o varios archivos de licencia. |
| [Corchetes] | Los corchetes alrededor del texto indican las opciones que puedes agregar al comando. Puede indicar que el texto dentro de los corchetes debe sustituirse. Por ejemplo: lmstat [-a] [-c lista_archivos_licencia] [-f [función]] se puede escribir como: 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 | Te permite especificar archivos de licencias o el puerto y el nombre de host del servidor de licencias. Si especificas la ruta sin un nombre de archivo de licencia, el comando se aplica a todos los archivos de licencia del 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 ruta. Para los nombres de uno o varios archivos de licencia: -c lista_archivos_licencia. Puedes introducir más de una ruta de archivo de licencia separando cada ruta con un punto y coma. Los nombres de ruta que incluyen espacios deben ir entre comillas dobles. |
| -h | Identificador de licencia, según lo informado por lmstat -a. El identificador de licencia es un número que se usa para identificar una licencia desprotegida específica. |
| -help | Muestra información de uso y sale. |
| -s [servidor] | Si no especificas un servidor, este argumento muestra el estado de todos los archivos de licencia enumerados en el servidor de licencias o los archivos de licencia en todos los servidores de licencias. |
| -verbose | Muestra una descripción más larga de todos los errores encontrados. |
Diagnosticar problemas de desprotección (lmdiag)
El comando lmdiag te permite diagnosticar problemas cuando un producto no puede desproteger una licencia. En particular, puedes comprobar si tus licencias son válidas y si el servidor de licencias se está ejecutando. Cuando ejecutas este comando, intenta desproteger una licencia.
También puedes usar el comando lmdiag para ver si un tipo específico de licencia funciona.
Ejemplo:
Ejecuta lmdiag solo en las licencias de edición Advanced de tu servidor Citrix Virtual Apps™. Especifica MPS_ADV_CCU como argumento.
Sintaxis:
lmdiag -c lista_archivos_licencia [-n] [función[:palabra_clave=valor]]
| Argumento | Descripción |
|---|---|
| -c lista_archivos_licencia | Diagnostica los archivos especificados. También puedes usar: -c @localhost o -c @server-name
|
| -n | Se ejecuta en modo no interactivo. lmdiag no solicita ninguna entrada en este modo. |
| función | Limita los comentarios a la función especificada. |
| palabra_clave=valor | Si un archivo de licencia contiene varias líneas para una función en particular, el resultado se limita a la línea que contiene el valor de texto. Por ejemplo: lmdiag -c @localhost MPS_ENT_CCU:HOSTID=LICSERV01 intenta una desprotección en la línea con el ID de host LICSERV01. La palabra clave es una de las siguientes: VERSION, HOSTID, EXPDATE, KEY, VENDOR_STRING, ISSUER |
Si no se especifica ninguna función, lmdiag opera en todas las funciones de los archivos de licencia de tu lista. El comando lmdiag muestra información sobre la licencia, luego intenta desproteger cada licencia. Cuando la desprotección se realiza correctamente, lmdiag indica que la desprotección se realizó correctamente. Cuando la desprotección falla, lmdiag te da el motivo del error. El comando lmdiag intenta conectarse a cada puerto TCP/IP del servidor de licencias. Detecta si el número de puerto del archivo de licencia es incorrecto. lmdiag enumera cada número de puerto TCP/IP que está escuchando, y si se especifica -c lista_archivos_licencia, diagnostica los archivos especificados.
El comando lmdiag no se comunica con el equipo que ejecuta el producto Citrix cuando intenta desproteger licencias. El comando lmdiag solo indica si hay problemas en el servidor de licencias. Es decir, tu producto no puede desproteger licencias porque apunta al 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 informa de que puede desproteger licencias cuando el producto Citrix apunta al servidor de licencias incorrecto.
Detener demonios (lmdown)
El comando lmdown apaga el demonio de License Manager y el demonio de proveedor de Citrix en tu servidor de licencias o en todos los servidores de licencias de tu red. El comando lmdown está deshabilitado de forma predeterminada.
Sintaxis:
lmdown -c lista_archivos_licencia [-vendor CITRIX] [-q] [-all]
| Argumento | Descripción |
|---|---|
| -c lista_archivos_licencia o -c @localhost o -c @server | Usa los archivos de licencia especificados. Siempre recomendamos especificar -c lista_archivos_licencia con lmdown. También puedes usar: -c @localhost o -c @server-name
|
| -vendor CITRIX | Apaga solo el demonio de proveedor de Citrix. El demonio de License Manager sigue ejecutándose. |
| -q | No solicita ni imprime un encabezado. De lo contrario, lmdown pregunta “¿Estás seguro? [s/n]: .” |
| -all | Si se especifican varios servidores, los apaga automáticamente todos. -q está implícito con -all. |
Ejecuta el comando lmdown en un servidor de licencias. Puedes usar -all para apagar todos los servidores de licencias de tu red.
-
Si
lmdownencuentra más de un servidor y no especificaste el argumento -all, el comando muestra una selección de servidores de licencias para apagar. Por ejemplo, el argumento -c especifica un directorio con muchos archivos *.lic. Apaga los servidores de licencias remotos usando -c y especificando el nombre del servidor de licencias. -
Nota:
Si usas el Administrador de tareas para finalizar el demonio de License Manager (Servicio de licencias de Citrix), detén primero el proceso
lmgrdy luego detén el proceso del demonio de proveedor de Citrix.
Para detener y reiniciar únicamente el demonio de proveedor de Citrix, usa lmdown -c @localhost -vendor CITRIX y, a continuación, usa 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. Puedes usar el comando para comprobar el nombre de host de tu servidor de licencias. Puedes abrir un archivo de licencia y comparar el nombre de host del archivo de licencia con el de tu servidor de licencias.
Nota
Citrix Licensing, versiones 11.5 y posteriores para Windows, te permite mostrar varios ID de host si hay más de un host.
-
Sintaxis:
-
lmhostid -bindingidentifier -
Donde
bindingidentifieres el argumento.
| Argumento | Descripción |
|---|---|
| -ether | Se usa para licencias de productos vinculadas a la dirección MAC del dispositivo. |
| -internet | Se usa para licencias de software de productos Citrix basadas en Windows que requieren una dirección TCP/IP. |
| -hostname | Se usa para licencias de software de productos Citrix basadas en Windows que están vinculadas al nombre de 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 tu servidor de licencias. |
Vuelve a leer los archivos de licencia y de opciones (lmreread)
El comando lmreread hace que el demonio de proveedor de Citrix vuelva a leer los cambios en el archivo de licencia y el archivo de opciones. Después de la relectura, el demonio de proveedor de Citrix usa la nueva configuración y las licencias a partir de ese momento.
No puedes usar lmreread de forma remota; ejecútalo 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 licencia especificados. |
| -all | Si se especifica más de un lmgrd, este argumento indica a todos los demonios de License Manager que vuelvan a leer. |
| -vendor CITRIX | Especifica que se reinicie el demonio de proveedor de Citrix. |
Ejemplos:
lmreread -c @localhost \[-all\]lmreread -c @client\_access\_point\_namelmreread -c /opt/citrix/licensing/myfiles/CITRIX.lic -vendor CITRIX
Muestra la lista de utilidades de licencias (lmutil)
El comando lmutil muestra una lista de utilidades de licencias cuando se usa de forma independiente. Cuando especificas lmutil con otro comando, ejecuta ese comando.
Sintaxis:
lmutil
lmutil other_command
Ejemplos:
-
lmutilMuestra todas las utilidades de licencias.
-
lmutil lmstat -c @localhostEjecuta el comando lmstat.
Determinar el estado de las licencias (lmstat)
El comando lmstat te ayuda a supervisar el estado de todas las actividades de licencias y te proporciona información sobre las extracciones de licencias, que incluye:
- El producto que extrajo una o varias licencias
- Los datos de extracción
- La versión del archivo de licencia
- El nombre y el puerto del servidor de licencias
- La fecha en que se extrajo la licencia
- Información sobre el estado del demonio de proveedor de Citrix y los archivos de licencia
El comando lmstat muestra la información que recibe del servidor de licencias. El comando lmstat muestra solo un uso de la licencia, incluso si hay varias conexiones comparten 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 licencia especificados. |
| -f [feature] | Muestra los productos que usan una característica (licencia de producto). Si no especificas una característica, se muestra la información de uso de todas las características. |
| -i [feature] | Si no especificas una característica, este argumento muestra la información de la línea INCREMENT para la característica (licencia de producto) especificada o para todas las características. |
| -s [server] | Si no especificas un servidor, este argumento muestra el estado de todos los archivos de licencia listados en el servidor de licencias o los archivos de licencia listados en todos los servidores de licencias. |
| -S [CITRIX] | Enumera todos los servidores de productos que usan las características (licencias de producto) proporcionadas por el demonio de proveedor de Citrix. |
| -t timeout_value | Establece el tiempo de espera de conexión en timeout_value. Este valor limita la cantidad de tiempo que lmstat dedica a intentar conectarse al servidor de licencias. |
La salida de lmstat -c @localhost -a es similar a este ejemplo. Las líneas del ejemplo podrían romperse debido al espacio de la 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 presenta un desglose de la información contenida en la línea MPS_ENT_CCU de la salida de lmstat:
| Descripción | ||
|---|---|---|
| Nombre del producto Citrix | MPS | El nombre del producto Citrix que tiene la licencia extraída. |
| Nombre de host | mps_server1 | Equipo donde se ejecuta el producto Citrix. |
| Pantalla | MPS | Nombre del producto Citrix que tiene la licencia extraída. |
| Host del servidor | license_server1 | Equipo donde se ejecuta el servidor de licencias. |
| Puerto | 27000 | Puerto TCP/IP donde se ejecuta el servidor de licencias. |
| Identificador | 203 | Identificador de licencia. El identificador de licencia es un número que se usa para identificar una licencia extraída específica. |
| Hora de extracción | inicio mié 17/3 11:56 | Hora en que se extrajo esta licencia por primera vez. |
El comando lmstat -c @localhost -a puede generar mucha actividad de red en sistemas que tienen muchas licencias de productos extraídas.
Puedes usar lmstat -a para verificar los datos de extracción de licencias.
Mostrar versiones de binarios (lmver)
El comando lmver muestra la información de la versión de los binarios de licencias, como las utilidades de comando.
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 libera licencias para usuarios y dispositivos específicos.
Nota:
La herramienta UDAdmin solo se usa para informar sobre el uso de licencias para el modelo de licencia de usuario/dispositivo y no para licencias concurrentes.
Puedes liberar una licencia para un usuario solo cuando:
- El empleado ya no está asociado con la empresa.
- El empleado está de baja prolongada.
Puedes liberar licencias para dispositivos solo cuando los dispositivos están fuera de servicio.
Precaución:
Las liberaciones masivas de licencias, antes del período de arrendamiento automático de 90 días, fuera de las razones destacadas anteriormente, podrían infringir el EULA de Citrix. Antes de hacerlo, contacta con Citrix.
La ayuda de la línea de comandos de udadmin muestra la información de uso solo en inglés, pero puedes 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 característica | Cuando se usa con -list o -delete, muestra o libera la licencia solo para el usuario o dispositivo para el nombre de característica especificado. |
| -user nombre de usuario | Libera la licencia solo para el usuario especificado por el nombre de usuario. |
| -device nombre de dispositivo | Libera la licencia solo para el dispositivo especificado por el nombre del dispositivo. |
| -a | Enumera todas las características y versiones instaladas en el servidor de licencias. |
| Argumento | Descripción |
| -delete | Libera la licencia para un usuario, característica o dispositivo a la vez. |
| -events | Informa de todos los eventos registrados por la licencia de usuario/dispositivo para cada característica, ordenados cronológicamente. |
| -list | Muestra los usuarios y dispositivos con licencias y el tiempo transcurrido desde la última actualización. Si se produjo una actividad significativa dentro de los 15 minutos del último informe, aparece el tiempo hasta la próxima actualización. Al especificar -list -times se genera una salida que contiene una marca de tiempo. |
| -times | Al especificar -list -times se genera una salida que contiene una marca de tiempo. |
Sin argumento o ?
|
Muestra la información de uso para el 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
- Formato de los comandos de licencias
- Argumentos universales
- Diagnosticar problemas de desprotección (lmdiag)
- Detener demonios (lmdown)
- Comprueba la información de enlace del servidor de licencias (lmhostid)
- Vuelve a leer los archivos de licencia y de opciones (lmreread)
- Muestra la lista de utilidades de licencias (lmutil)
- Determinar el estado de las licencias (lmstat)
- Mostrar versiones de binarios (lmver)
- Mostrar o liberar licencias para usuarios o dispositivos (udadmin)