Uso de comandos de administración de licencias Por el departamento de publicaciones de Citrix Citrix Systems, Inc.
Aviso La información contenida en este documento está sujeta a cambios sin previo aviso. ESTA PUBLICACIÓN SE PROPORCIONA "TAL CUAL" Y NO INCLUYE NINGÚN TIPO DE GARANTÍA, NI EXPLÍCITA NI IMPLÍCITA, NI GARANTÍA DE COMERCIABILIDAD NI DE ADECUACIÓN A UN PROPÓSITO CONCRETO NI DE NO-INFRACCIÓN. CITRIX SYSTEMS, INC. ( CITRIX ) NO SE HACE RESPONSABLE DE LOS ERRORES U OMISIONES DE TIPO TÉCNICO O EDITORIAL QUE ESTA PUBLICACIÓN PUDIERA CONTENER, NI POR DAÑOS DIRECTOS, CONSECUENCIALES NI INCIDENTALES O DE OTRO TIPO QUE PUDIERAN RESULTAR POR EL SUMINISTRO O UTILIZACIÓN DE ESTA PUBLICACIÓN, AUN CUANDO CITRIX HAYA SIDO ADVERTIDO PREVIAMENTE DE LA POSIBILIDAD DE DICHOS DAÑOS. Esta publicación contiene información protegida por copyright. Con excepción de una copia para distribución interna, no está permitida la fotocopia o reproducción de ninguna parte de esta publicación en ningún formato, sin la autorización previa por escrito de Citrix. La garantía exclusiva de los productos Citrix, cuando exista, se describe en la documentación que acompaña a cada producto. Citrix no ofrece garantía para otros productos más que los suyos. Los nombres de producto mencionados aquí pueden ser marcas comerciales o registradas de sus respectivos fabricantes. Copyright 2006 Citrix Systems, Inc., 851 W Cypress Creek Rd, Ft. Lauderdale, Florida 33309 EE UU. Reservados todos los derechos. Historial de versiones 14 abril 2006 Tammy Jones Versión original 3 agosto 2006 Tammy Jones Rev. 1 Licencias: Uso de comandos de administración de licencias ii
Contenido COMANDOS DE ADMINISTRACIÓN DE LICENCIAS... 1 RESUMEN... 1 INTRODUCCIÓN... 1 CONVENCIONES DE FORMATO DE LOS COMANDOS DE ADMINISTRACIÓN DE LICENCIAS... 1 VISTA GENERAL DE LOS COMANDOS DISPONIBLES... 2 ARGUMENTOS UNIVERSALES... 2 DIAGNÓSTICO DE PROBLEMAS DE EXTRACCIÓN DE LICENCIAS (LMDIAG)... 3 CÓMO DETENER LOS DEMONIOS (LMDOWN)...4 ADMINISTRACIÓN DEL DEMONIO DE ADMINISTRACIÓN DE LICENCIAS (LMGRD)... 4 COMPROBACIÓN DE NOMBRES DE HOST (LMHOSTID)... 5 LIBERACIÓN DE LICENCIAS (LMREMOVE)... 5 RELECTURA DE LOS ARCHIVOS DE LICENCIA Y DE OPCIONES (LMREREAD)... 7 CÓMO DETERMINAR EL ESTADO DE LAS LICENCIAS (LMSTAT)... 8 ROTACIÓN TEMPORAL DE LOS ARCHIVOS DE REGISTRO DE INFORMES (LMSWITCHR)... 10 CÓMO VER LA LISTA DE COMANDOS DE LICENCIAS (LMUTIL)... 11 LECTURAS RECOMENDADAS... 11 Licencias: Uso de comandos de administración de licencias iii
Comandos de administración de licencias Resumen Este documento técnico describe cómo usar comandos para realizar diversas tareas de administración de licencias. Este documento forma parte de una serie de publicaciones técnicas cuyo fin es ofrecer información más detallada acerca de las tareas que van más allá de la instalación de los componentes del sistema de licencias, y está diseñado para complementar a la Guía de introducción a Citrix Licensing. Para ver una lista completa de los documentos técnicos ofrecidos, consulte la Guía de introducción a Citrix Licensing en Citrix Knowledge Center. Introducción Además de Licensing Management Console, que ofrece un sencillo método para acceder a muchas de las funciones del sistema de licencias, también es posible realizar tareas relacionadas con el sistema de licencias utilizando una serie de comandos de administración de licencias. A continuación se enumeran algunas situaciones en las que puede ser útil usar los comandos de administración de licencias: Cuando no está instalado License Management Console. Cuando se desea realizar operaciones avanzadas en el servidor de licencias, que no están disponibles en License Management Console. Dichas operaciones pueden ser, por ejemplo, el diagnóstico de problemas de extracción de licencias (lmdiag), la liberación de licencias retenidas en una agrupación de licencias (lmremove), y el almacenamiento temporal de un registro de informes en un nuevo archivo en una ubicación distinta (lmswitchr). Los comandos de administración de licencias pueden resultar útiles a la hora de solucionar problemas de licencias. Para obtener más información sobre comandos para solucionar problemas, consulte el documento técnico Licencias: Solución de problemas en Citrix Knowledge Base. Convenciones de formato de los comandos de administración de licencias La tabla siguiente presenta las convenciones de formato utilizadas en los comandos de administración de licencias: Convención Negrita Cursiva Se usa texto en negrita para comandos y modificadores de comando. El texto en cursiva indica una variable que es necesario sustituir por un valor real. Por ejemplo, en: lmswitchr -c lista_archivos_licencia 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 (en negrita) o texto que tiene que ser sustituido. Licencias: Uso de comandos de administración de licencias 1
Vista general de los comandos disponibles La tabla siguiente enumera los comandos de administración de licencias que se guardan, de forma predeterminada, en el directorio C:\Archivos de programa\citrix\licensing\ls: Comando lmdiag lmdown lmgrd lmhostid lmremove lmreread lmstat lmswitchr lmutil Diagnostica problemas de extracción de licencias. Cierra los demonios del administrador de licencias y del proveedor Citrix. Demonio del administrador de licencias que inicia y administra al demonio de proveedor Citrix, cambia la ubicación y el nombre del registro de depuración y muestra la información de versión de lmgrd. Devuelve el ID de host del servidor donde se está ejecutando el sistema de licencias de Citrix. Libera una licencia que ha quedado retenida y la devuelve a la agrupación de licencias libres. Hace que el demonio del administrador de licencias vuelva a leer el archivo de licencias e inicie el demonio de proveedor Citrix. Muestra el estado de un servidor de licencias. Cambia el nombre del archivo de registro de informes. Muestra una lista de los comandos de licencias. s universales A continuación se enumeran los argumentos válidos para la mayoría de los comandos de administración de licencias: -all Aplica el comando a todos los servidores de licencias de la red. -c Permite especificar los archivos de licencia o el número de puerto y el nombre de host del servidor de licencias. -c @ localhost La mayoría de los comandos de administración de licencias necesitan conocer la ruta al archivo de licencia. Es necesario especificar el locahost con un argumento -c @ localhost. 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. Con algunos comandos, es posible escribir más de una ruta de archivo de licencias, separándolas mediante punto y coma. Los nombres de ruta que incluyan espacios deben ir entre comillas. -h El manipulador (handle) de la licencia, devuelto por el comando lmstat a. Es un número utilizado para identificar a una licencia extraída específica. -help Muestra información de uso y sale del comando. -s [servidor] Muestra el estado de todos los archivos de licencia que existen en el servidor de licencias o en todos los servidores de licencias, si no se especifica ningún servidor concreto. -v Muestra la versión del comando y lo cierra. Licencias: Uso de comandos de administración de licencias 2
-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, se puede ejecutar lmdiag con las licencias de Presentation Server Advanced Edition especificando simplemente MPS_ADV_CCU como argumento del comando. lmdiag -c lista_archivos_licencia [-n] [feature[:palabra_clave=valor]] donde: -c lista_archivos_licencia Diagnostica los archivos especificados. -n Se ejecuta en modo no interactivo; en este modo, lmdiag no pide ninguna información adicional. feature palabra_clave=valor Limita el resultado al feature especificado. Si un archivo de licencias contiene varias líneas para un feature determinado, el resultado se limita a la línea que contiene el texto especificado como valor. Por ejemplo: lmdiag MPS_ENT_CCU:HOSTID=LICSERV01 intenta una extracción en la línea con el ID de host LICSERV01. palabra_clave es una de las siguientes: VERSION, HOSTID, EXPDATE, KEY, VENDOR_STRING, ISSUER Si no se especifica ningún feature, lmdiag se aplica a todos los encontrados 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 indica el motivo del fallo. lmdiag intenta conectar con cada puerto TCP/IP del servidor de licencias. Detecta si el número de puerto que figura en el archivo de licencia 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. Cuando intenta extraer licencias, lmdiag no establece contacto con el equipo en el que se ejecuta el producto Citrix. lmdiag sólo indica si hay problemas en el servidor de licencias. Es decir, si el producto no pudiese extraer licencias porque estuviese utilizando un servidor de licencias incorrecto (por ejemplo, un servidor de licencias que Licencias: Uso de comandos de administración de licencias 3
no tuviese licencias para dicho producto), lmdiag no detectaría este problema. lmdiag comunicaría que es capaz de extraer licencias aunque el producto Citrix estuviese utilizando un servidor de licencias incorrecto. Cómo detener los 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. lmdown -c lista_archivos_licencia [-vendor CITRIX] [-q] [-all] donde: -c lista_archivos_licen cia -vendor CITRIX Usa los archivos de licencia especificados. Es recomendable usar siempre -c lista_archivos_licencia al usar el comando lmdown. 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. En caso contrario, lmdown pide confirmación ("Are you sure? [y/n]"). [y/n]:. -all Si se especifican varios servidores, detiene todos ellos automáticamente. -q va implícito en - all. 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 seleccíón de servidores de licencias para apagar. Es posible apagar 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 CitrixLicensing), detenga primero el proceso lmgrd y, después, detenga el proceso del demonio de proveedor Citrix. Para detener y reiniciar sólo el demonio de proveedor Citrix, use el comando lmdown -vendor CITRIX para detenerlo, y después use lmreread -vendor CITRIX para reiniciarlo. Administración del demonio de administración de licencias (lmgrd) lmgrd es el demonio del administrador de licencias, que es uno de los dos demonios (daemon) que tiene el servidor de licencias (el otro es el demonio de proveedor Citrix). El demonio del administrador de licencias se ocupa del contacto inicial con el producto Citrix, transfiriendo todas las solicitudes de licencia al demonio de proveedor Citrix. La herramienta lmgrd: Inicia y mantiene el demonio de proveedor Citrix. Licencias: Uso de comandos de administración de licencias 4
Permite cambiar el nombre y la ubicación del archivo de registro de depuración. Este registro se usa para solucionar problemas de configuración en el servidor de licencias y errores en lmgrd y en el demonio de proveedor Citrix. Para obtener más información sobre el registro de depuración, consulte Licencias: Solución de problemas en Citrix Knowledge Center. Muestra la información de versión y copyright de lmgrd. lmgrd -c [lista_archivos_licencia] -l [+]ruta_registro_depuración donde: -c lista_archivos_licencia Usa los archivos de licencia especificados. -l +ruta_registro_depuración Escribe el registro de depuración en el archivo especificado. Esta opción usa la letra "l", no el número "1". Si se pone el signo + antes de ruta_registro_depuración las entradas se van agregando al archivo (de lo contrario, el archivo se sobrescribe cada vez que se inicia el demonio de proveedor Citrix). -v Muestra el número de versión y copyright de lmgrd. -help Muestra información sobre su uso. Comprobación de 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. lmhostid nombre_host El parámetro nombre_host distingue entre mayúsculas y minúsculas y debe coincidir exactamente con el nombre de host del servidor de licencias. El resultado de este comando es similar al siguiente: The FLEXlm host ID of this machine is "HOSTNAME=servidorLicencias1" Liberación de licencias (lmremove) El comando lmremove permite liberar una licencia de un producto Citrix que quedó retenida en estado de uso permanente. Las licencias retenidas en estado de uso permanente (hung) son licencias extraídas que no se han devuelto a la agrupación de licencias disponibles después de que el producto fallase o se cerrase de forma imprevista. Si se han extraído una o varias licencias de un producto Citrix, y el producto falla, puede que estas licencias no se devuelvan automáticamente y, por lo tanto, queden colgadas o "en estado de uso permanente" (es decir, las licencias no se están utilizando realmente pero tampoco se han devuelto y permanecen extraídas). Estas licencias se devuelven automáticamente a la agrupación, pero lmremove devuelve las licencias inmediatamente. Licencias: Uso de comandos de administración de licencias 5
Este comando puede ejecutarse con un archivo de licencia determinado o con todos los archivos de licencia de un directorio. Si se ejecuta lmremove con todos los archivos de licencia de un directorio y en el directorio hubiese licencias que estuviesen siendo utilizadas por el producto Citrix, el producto volvería a extraer las licencias que estaba utilizando poco después de que el comando lmremove las hubiese liberado. lmremove -c lista_archivos_licencia feature nombre_producto_citrix nombre_host display o bien lmremove -c lista_archivos_licencia -h feature host_servidor puerto manipulador donde: -c lista_archivos_licencia Lista de los archivos de licencia que se quieren liberar. feature nombre_producto_citrix nombre_host display host_servidor puerto manipulador Nombre del feature extraído por el producto. Por ejemplo, MPS_ENT_CCU es el nombre de feature de Presentation Server Enterprise Edition que utiliza el modelo de usuario concurrente. Nombre del producto del que se está eliminando un consumo de licencia: por ejemplo, MPS para Presentation Server y MPM para Password Manager. Nombre del servidor donde se está ejecutando el producto Citrix. Nombre del producto del que se está eliminando una licencia: por ejemplo, MPS para Presentation Server y MPM para Password Manager. Nombre de host del servidor de licencias. Número del puerto TCP/IP donde se está ejecutando el servidor de licencias, según lo indica el comando lmstat -a. El manipulador (handle) de la licencia, devuelto por el comando lmstat a. Es un número utilizado para identificar a una licencia extraída específica. La información de nombre_producto_citrix, nombre_host, display, host_servidor, puerto y manipulador debe obtenerse del resultado del comando lmstat -a. Licencias: Uso de comandos de administración de licencias 6
La variante -h usa los valores de host_servidor, puerto y manipulador de licencia, según lo devuelve el comando lmstat -a. Observe este ejemplo de un resultado de lmstat -a para una licencia de Presentation Server Enterprise Edition: Users of MPS_ENT_CCU: (Total of 30 licenses issued; Total of 1 license in use) "MPS_ENT_CCU" v2004.1201, vendor: CITRIX floating license MPS mps_server1 MPS 25fb337e:MPSCLIENT (v2004.0227) (license_server1/27000 101), start Tue 3/16 16:59 En este ejemplo, las primeras líneas del resultado muestran el número de licencias de Presentation Server Enterprise Edition que se están utilizando. La línea que empieza por MPS muestra los detalles de una extracción de una licencia de Presentation Server Enterprise Edition. El nombre_producto_citrix es MPS, el nombre_host es mps_server1, display es MPS, el host_servidor es license_server1, el puerto TCP/IP es 27000 y el manipulador de licencia es 101. Para eliminar esta licencia, ejecute alguno de los comandos siguientes: lmremove MPS_ENT_CCU MPS mps_server1 MPS o bien lmremove -h MPS_ENT_CCU license_server1 27000 101 Relectura de los archivos de licencia y de 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. Si está habilitado el registro de informes, se borran los datos del registro de informes que pudiese haber en el búfer de datos interno del demonio de proveedor Citrix. lmreread -c lista_archivos_licencia [-all] [-vendor CITRIX] donde: -c lista_archivos_licencia Usa los archivos de licencia especificados. -all -vendor CITRIX Si se especifica más de un lmgrd, todos los demonios de administración de licencias vuelven a leer los archivos. Reinicia el demonio de proveedor Citrix. Ejemplo lmreread -c C:\Archivos de programa\citrix\licensing\myfiles\citrix.lic -vendor CITRIX El comando lmreread no puede ejecutarse desde una ubicación remota; debe ejecutarse localmente, en el servidor de licencias. Para detener y reiniciar el demonio de proveedor Citrix Licencias: Uso de comandos de administración de licencias 7
Utilice lmdown -vendor CITRIX para detener el demonio de proveedor Citrix. El comando lmdown detiene el demonio de proveedor Citrix. Utilice lmreread -vendor CITRIX para reiniciar el demonio de proveedor Citrix. El comando lmreread reinicia el demonio de proveedor Citrix. (El comando lmreread también puede emplearse para que se vuelvan a leer los archivos de licencia). Cómo determinar el estado de las licencias (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 Datos de la extracción La versión del archivo de licencia El nombre y el puerto del servidor de licencias La fecha de extracción de la licencia Este comando también proporciona información sobre el estado del demonio de proveedor Citrix y los archivos de licencia. 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. lmstat [-a] [-c lista_archivos_licencia] [-f [feature]] [-i [feature] [-s[servidor] [-S [CITRIX]] [-t valor_tiempo_espera] donde: -a Muestra toda la información. -c lista_archivos_licencia Usa los archivos de licencia especificados. -f [feature] Muestra los productos que usan un feature (licencia de producto). Si no se especifica ningún feature, se muestra la información de uso de todos. -i [feature] Muestra la información de la línea INCREMENT del feature (licencia de producto) especificado; o de todos si no se especifica ningún feature. -s [servidor] Muestra el estado de todos los archivos de licencia 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 producto que están usando los features (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 definido en Licencias: Uso de comandos de administración de licencias 8
valor_tiempo_espera. Esto limita el tiempo que lmstat puede emplear intentando conectar con el servidor de licencias. El resultado de lmstat -a es similar al siguiente: License server status: 27000@license_server1 License files on license_server1: C:\Program Files\Citrix\Licensing\MyFiles\citrix_startup.lic: C:\ProgramFiles\Citrix\Licensing\MyFiles\citrixlic_20031001094430.lic: license_server1: license server UP (MASTER) v9.2 Vendor daemon status (on license_server1): CITRIX: UP v9.2 Feature usage info: Users of CITRIX: (Total of 5000 licenses issued; Total of 1 license in use) "CITRIX" v2002.0101, vendor: CITRIX floating license MPS mps_server1 MPS MPS_ENT_2004.0227 (v1.0) (license_server1/27000 101), start Tue 3/16 16:59 Users of MPS_ENT_CCU: (Total of 30 licenses issued; Total of 1 license in use) "MPS_ENT_CCU" v2004.1201, vendor: CITRIX floating license MPS mps_server1 MPS 25fb337e:MPSCLIENT (v2004.0227) (license_server1/27000 203), start Wed 3/17 11:56 Desglose de la información contenida en la línea MPS_ENT_CCU del resultado del comando lmstat: MPS nombre_producto_citrix Nombre del producto Citrix que ha extraído la licencia. mps_server1 nombre_host El equipo donde se está ejecutando el producto Citrix. MPS display Nombre del producto Citrix que ha extraído la licencia. license_server1 host_servidor El equipo donde se está ejecutando el servidor de licencias. 27000 puerto El puerto TCP/IP donde se está ejecutando el servidor de licencias. 203 manipulador Manipulador de la licencia. El manipulador de la licencia es un número utilizado para identificar una licencia extraída determinada. Licencias: Uso de comandos de administración de licencias 9
start Wed 3/17 11:56 fecha_extracción Fecha y hora en que se extrajo por primera vez esta licencia. Nota: lmstat -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. Rotación temporal de los archivos de registro de informes (lmswitchr) El comando lmswitchr cambia temporalmente el archivo de registro de informes cerrando el archivo utilizado en ese momento y abriendo otro archivo con un nuevo nombre. También inicia uno nuevo si no existiese ninguno. De manera predeterminada, el registro de informes está activado. : lmswitchr -c lista_archivos_licencia CITRIX nuevo_registro_informes donde: -c lista_archivos_licencia Usa los archivos de licencia especificados. CITRIX nuevo_registro_informes El demonio de proveedor Citrix. Ruta del nuevo archivo de registro de informes. Si el registro de informes no está habilitado, lmswitchr instruye al demonio de proveedor Citrix para que escriba los resultados en el nuevo_registro_informes. Si el registro de informes ya está habilitado, lmswitchr ordena al demonio de proveedor Citrix que deje de escribir resultados en el archivo de registro original y empiece a escribirlos en el nuevo. Con este comando sólo se cambia la ubicación del archivo de registro de informes temporalmente. Para cambiar la ubicación de forma permanente, cambie la ruta o el nombre del archivo de registro de informes en el archivo de opciones (en la línea REPORTLOG). El efecto de lmswitchr dura hasta que el archivo de opciones vuelve a leerse o hasta que el demonio de proveedor Citrix se cierra. Cuando se reinicia el demonio de proveedor Citrix o se vuelve a leer el archivo de opciones, el demonio busca la línea REPORTLOG en el archivo de opciones. Si no encuentra la línea REPORTLOG, el demonio de proveedor Citrix deja de escribir el registro de informes. Si encuentra la línea REPORTLOG, el demonio de proveedor Citrix empieza a escribir en el archivo especificado. Licencias: Uso de comandos de administración de licencias 10
Cómo ver la lista de comandos de licencias (lmutil) El comando lmutil muestra una lista de todos los comandos de licencias disponibles que se han descrito en este documento técnico. lmutil Lecturas recomendadas Los documentos técnicos indicados a continuación ofrecen información más detallada sobre los temas tratados en el presente documento: Guía de introducción a Citrix Licensing Licencias: Solución de problemas Licencias: Uso de comandos de administración de licencias 11