T41.3: Manages Licenses

Knowledge Review - InterSystems IRIS System Administration Specialist

1. Mantiene archivos de licencia actuales

Puntos Clave

  • Archivo de clave de licencia: archivo iris.key ubicado en el directorio install-dir/mgr autoriza la operación de la instancia
  • Métodos de activación: Management Portal (System Administration > Licensing > License Key) o línea de comandos
  • Tipos de licencia: Claves locales (instancia única) y claves multiservidor (compartidas entre instancias)
  • Servidor de licencias: Gestión centralizada de licencias para múltiples instancias compartiendo claves
  • Propiedades de licencia: Nombre del cliente, capacidad, fecha de expiración, características habilitadas

Notas Detalladas

Resumen de Claves de Licencia

InterSystems IRIS utiliza claves de licencia para asegurar la operación adecuada de sitios registrados, definir la capacidad disponible y controlar el acceso a características. Las claves de licencia no son requeridas para instalaciones de evaluación, pero todas las instancias de producción deben tener claves de licencia válidas. La clave de licencia se proporciona en un archivo típicamente llamado iris.key, que debe ser activado para que la instancia opere dentro de los parámetros licenciados.

Activación mediante Management Portal

Para activar una clave de licencia a través del Management Portal: 1. Navegar a System Administration > Licensing > License Key 2. Ver información de licencia activa actual (nombre del cliente, capacidad, fecha de expiración, características habilitadas) 3. Si no hay licencia activada, aparece "License missing or unreadable" como el Nombre del Cliente 4. Hacer clic en "Activate License Key" y navegar al archivo de clave de licencia 5. Revisar información mostrada para verificar capacidad y fecha de expiración 6. Si es válida, tanto la información de licencia actual como nueva se muestra lado a lado para comparación 7. Hacer clic en "Activate" para completar el proceso

El sistema copia la clave de licencia a install-dir/mgr como iris.key, sobrescribiendo cualquier licencia anterior.

Requisitos de Reinicio

La mayoría de las actualizaciones de licencia no requieren reinicio. Sin embargo, se requiere reinicio cuando:

  • Se cambia de Power Unit a cualquier otro tipo de licencia
  • La nueva licencia requiere al menos 1000 páginas de 64KB más de espacio gmheap que la clave existente (representando al menos 227 licencias)

Instalación en Windows

En Windows, los administradores pueden seleccionar una clave de licencia durante la instalación, que la activa automáticamente sin requerir activación manual.

Servidores de Licencias

Los servidores de licencias proporcionan gestión centralizada para claves multiservidor compartidas entre múltiples instancias:

  • Un servidor de licencias puede ejecutarse en cualquier computadora que aloje una instancia de IRIS
  • Coordina la asignación de licencias cuando más de una instancia comparte una licencia
  • Un servidor de licencias puede manejar múltiples instancias (se necesita como máximo uno por host)
  • Configurar a través de la página License Servers en System Administration > Licensing > License Servers
  • Especificar nombre, nombre de host/dirección IP (se requiere dirección estable y consistente), puerto (predeterminado 4002, debe estar entre 1024-65535)
  • Después de agregar o eliminar servidores de licencias, reiniciar la instancia de IRIS
  • Si múltiples instancias comparten una licencia, eliminar el servidor de licencias LOCAL predeterminado (127.0.0.1) en cada instancia

Actualización de Claves de Licencia

  • Reemplazar el archivo de clave en el KeyDirectory y ejecutar ReloadKeys^%SYS.LICENSE
  • El License Monitor (^LMFMON) verifica cada 30 minutos si hay claves diferentes que coincidan con el LicenseID configurado
  • Si se necesita reinicio, el License Monitor registra un error y espera hasta el día siguiente para reintentar

Referencias de Documentación

2. Soluciona problemas de licencia

Puntos Clave

  • Síntoma de un solo usuario: Indica agotamiento de licencia o activación de licencia inválida
  • Página License Usage: Muestra el conteo de procesos y consumo de licencias (System Operation > License Usage)
  • Página License Key: Muestra información de licencia actual y capacidad (System Administration > Licensing > License Key)
  • Actualización por línea de comandos: Permite activación de licencia cuando todas las unidades están consumidas usando iris terminal
  • Consultas de capacidad de licencia: Consultas SQL y métodos API muestran capacidad y uso actual

Notas Detalladas

Síntomas Comunes

El síntoma más común de problemas de licencia es que solo un usuario puede iniciar sesión después de ingresar una licencia y reiniciar InterSystems IRIS. Esto típicamente indica una configuración de licencia inválida o agotamiento de capacidad de licencia.

Uso de la Página License Usage

La página License Usage (System Operation > License Usage) es la herramienta principal para diagnosticar problemas de consumo de licencias:

  • Seleccionar "Usage by Process" para ver cuántos procesos están ejecutándose y consumiendo unidades de licencia
  • Ver identificador de proceso del sistema operativo (PID), namespace, nombre de rutina, estado de proceso y dispositivo para cada proceso activo
  • Identificar qué procesos están consumiendo capacidad y tomar acción apropiada

Uso de la Página License Key

La página License Key (System Administration > Licensing > License Key) muestra:

  • Nombre del cliente (o "License missing or unreadable" si es inválida)
  • Capacidad de licencia en varias unidades
  • Fecha de expiración
  • Características habilitadas

Verificar que la capacidad de licencia coincida con los requisitos, la fecha de expiración esté vigente y las características necesarias estén habilitadas.

Actualización por Línea de Comandos Cuando Está Bloqueado

Si todas las unidades de licencia están consumidas, previniendo acceso Terminal para activar una nueva licencia: ``` iris terminal -U %SYS '##Class(%SYSTEM.License).Upgrade()' ``` Esto activa una nueva clave de licencia que ha sido copiada al directorio install-dir\mgr.

Diagnóstico Programático

La clase %SYSTEM.License proporciona numerosos métodos y consultas:

  • $System.License.CKEY(): Muestra información de clave de licencia actual (equivalente al programa ^CKEY)
  • $System.License.ShowSummary: Muestra resumen de uso de licencia
  • $System.License.DumpLocalPID: Muestra uso de licencia por identificador de proceso del sistema operativo
  • $System.License.ShowCounts: Resume el uso de licencia rastreado en memoria compartida
  • $System.License.ShowServer(): Determina qué servidor de licencias está activo

Consultas Disponibles

Ejecutar consultas usando `##class(%ResultSet).RunQuery("%SYSTEM.License","query-name")`:

  • Summary(): Resumen de uso
  • ProcessList(): Uso por PID
  • UserList(): Uso por ID de Usuario
  • AllKeyConnectionList(): Uso de licencia distribuida (requiere conexión activa al servidor de licencias)

Consideraciones de Red para Servidores de Licencias

  • Cada monitor de licencias consulta al servidor de licencias vía TCP
  • Las reglas de firewall deben permitir este tráfico
  • Si un servidor de licencias remoto está protegido por un firewall, el puerto del servidor de licencias debe estar abierto para tráfico UDP
  • Las direcciones IP del servidor de licencias deben ser estables; si la dirección IP cambia, el License Monitor entra en modo de reinicio

Consideraciones para Claves Multiservidor

Cuando las instancias comparten claves multiservidor:

  • Asegurar que todas las instancias estén configuradas para usar el/los mismo(s) servidor(es) de licencias
  • Cada instancia necesita su propia copia del archivo iris.key apropiado
  • Todas las instancias autorizadas por la misma clave deben usar los mismos servidores de licencias
  • Las unidades de licencia no se suman a través de diferentes claves de licencia
  • Los usuarios que inician sesión en dos instancias con claves diferentes consumen una unidad de licencia separada de cada clave

Referencias de Documentación

Resumen de Preparación para el Examen

Conceptos Críticos a Dominar:

  1. Ubicación de archivo de licencia: iris.key almacenado en el directorio install-dir/mgr
  2. Procedimientos de activación: Método del Management Portal vs. método de línea de comandos
  3. Arquitectura de servidor de licencias: Gestión centralizada para claves multiservidor
  4. Tipos de licencia: Local vs. multiservidor, evaluación vs. producción
  5. Herramientas de solución de problemas: Página License Usage, página License Key, métodos %SYSTEM.License
  6. Requisitos de red: Consideraciones TCP y UDP para servidores de licencias
  7. Escenarios de actualización: Cuándo se requiere reinicio vs. activación automática
  8. Monitoreo de capacidad: Comprender consumo de unidades de licencia y capacidad disponible

Escenarios Comunes de Examen:

  • Activar una nueva clave de licencia a través del Management Portal
  • Diagnosticar el síntoma de "solo un usuario puede iniciar sesión"
  • Configurar servidor de licencias para múltiples instancias compartiendo una clave
  • Actualizar licencia cuando todas las unidades de licencia están agotadas
  • Solucionar problemas de conectividad del servidor de licencias
  • Interpretar información de capacidad y uso de licencia
  • Determinar cuándo se requiere reinicio de instancia para cambios de licencia
  • Usar herramientas de línea de comandos para activar licencias en situaciones de emergencia

Recomendaciones de Práctica Práctica:

  • Navegar páginas de gestión de licencias del Management Portal
  • Activar claves de licencia de prueba y observar diálogos de confirmación
  • Configurar servidor de licencias para múltiples instancias
  • Usar página License Usage para monitorear consumo de licencias de procesos
  • Ejecutar consultas de diagnóstico de licencias en Terminal
  • Practicar procedimiento de actualización de licencia por línea de comandos
  • Simular escenarios de agotamiento y recuperación de licencia
  • Revisar información de licencia antes y después de la activación

Report an Issue