AV License Server — Manual

1. Qué es y cómo funciona

AV License Server gestiona licencias de «puestos concurrentes» (flotantes): cada producto (p. ej. SPC, SPP) tiene un número máximo de puestos que pueden usarse al mismo tiempo, establecido en el código de activación del cliente. No está vinculado a un único PC: cualquier cliente de la red puede usar un puesto libre, hasta que todos estén ocupados.

El sistema se compone de dos programas, instalados en el mismo PC (el servidor):

• AV_LicenseServer.exe — se ejecuta como servicio de Windows en segundo plano, siempre activo (incluso sin ningún usuario conectado). Es el que responde a los clientes de la red. No tiene interfaz gráfica.
• AV_LicenseManager.exe — la consola de administración: sirve para iniciar/detener el servicio, consultar el registro (log) y gestionar el archivo de activación. No necesita permanecer abierta: el servidor funciona de forma independiente.

Los clientes (SPC, SPP, etc., instalados en otros PC de la red) se conectan al servidor a través de la red (TCP) al arrancar, solicitan una licencia y la mantienen activa enviando una señal periódica («heartbeat») mientras permanecen abiertos.

2. Requisitos

• Windows con privilegios de administrador para la instalación (necesarios para registrar el servicio de Windows y escribir en Program Files).
• El PC elegido como servidor debe tener una dirección IP fija o reservada en la red local (si cambia, hay que reconfigurar todos los clientes). Se recomienda asignarla mediante una reserva DHCP en el router, o configurarla como estática.
• No hay otros requisitos de software: el instalador incluye todo lo necesario.

3. Instalación

1. Copie el instalador <yyyymmdd>_AV_LicenseServer_x64.exe (generado a partir del kit en Kit\Output\; el nombre empieza por la fecha de generación, p. ej. 20261010_AV_LicenseServer_x64.exe) al PC elegido como servidor y ejecútelo.
2. Confirme la solicitud de privilegios de administrador (UAC).
3. En la página de tareas opcionales del asistente:
   • "Install and start the AV License Server Windows service" — marcada por defecto. Déjela marcada para iniciar el servicio de inmediato; desmárquela solo para instalar los archivos sin activar todavía el servicio.
   • "Create a desktop icon for AV License Manager" — desmarcada por defecto, útil si administra el sistema con frecuencia desde ese PC.
4. Finalice la instalación. Si se instaló el servicio, el instalador:
   • lo registra y lo inicia (nombre interno AV_LicenseServer, que aparece en services.msc como «AV License Server»);
   • abre automáticamente la excepción del Firewall de Windows para AV_LicenseServer.exe, limitada a los perfiles de red Dominio y Privada (no Pública) — sin esta excepción, los clientes de otros PC no podrían alcanzar el servidor (véase §8).
5. Archivos instalados en C:\Program Files\AV License Server\:
   • AV_LicenseServer.exe (el servicio)
   • AV_LicenseManager.exe (la consola — sus accesos directos del menú Inicio/Escritorio ya están configurados para ejecutarse como administrador, necesario para controlar el servicio)
   • AV_LicenseServer.ini — configuración de ejemplo con los valores por defecto (Port=7788, etc.); nunca se sobrescribe en una actualización posterior.
   • AV_LicenseServer_Manual.html — este manual, que también se abre desde el menú Inicio («AV License Server Manual»).
6. En este punto el servidor está activo pero todavía sin ninguna licencia habilitada: hay que instalar el archivo de activación Code.txt del cliente (§4) para que los clientes reales puedan obtener una licencia. Hasta entonces, los clientes intentan conectarse igualmente y obtienen automáticamente un periodo de prueba de 30 días (véase §7).

4. Activación: el archivo Code.txt

Code.txt es el archivo que determina qué productos están habilitados en este servidor, cuántos puestos concurrentes y hasta cuándo. Es específico de cada cliente y está vinculado al hardware del PC servidor (no funciona si se copia a otro PC).

4.1 Solicitar el código de activación

En la pestaña Licenses de AV License Manager, el botón "Code request" detecta automáticamente los dos identificadores de hardware de este PC (SystemID y NetworkID) y abre el navegador en la página de Arolo para solicitar el código, con ellos ya rellenados. No es necesario anotarlos a mano.

4.2 Instalar el código recibido

Una vez recibido el archivo Code.txt (por correo electrónico u otro medio) de quien genera la activación:

1. Abra AV License Manager, pestaña Licenses.
2. Haga clic en "Select Code.txt..." y elija el archivo recibido: se valida y se copia automáticamente a la carpeta del servidor.
3. Los datos (cliente, productos habilitados, puestos, fechas de caducidad) aparecen de inmediato en la lista, en solo lectura.
4. Reinicie el servicio (pestaña Service → Stop y después Start, o el botón Refresh status para comprobar el estado): Code.txt lo lee el servidor solo al arrancar — instalarlo con la aplicación abierta no tiene efecto sobre las licencias ya en curso hasta que se reinicie el servicio.

El botón "Remove license file" elimina la activación actual (úselo solo para sustituirla; sin Code.txt no se puede conceder ninguna licencia real, solo el periodo de prueba).

4.3 Qué contiene

Para cada producto: nombre, versión máxima autorizada, número de puestos concurrentes, fecha de emisión y fecha de caducidad (o «sin caducidad»), y qué funciones opcionales del producto están habilitadas (opciones, p. ej. ResidualAnalysis y CutOptimization para SPC; todas o ninguna). El archivo está cifrado en disco: al abrirlo con un editor de texto no se ve nada legible.

5. AV License Manager: uso diario

Tres elementos principales, todos en la pestaña Service:

• Etiqueta de cabecera — muestra el nombre, la versión instalada de AV License Server y la dirección IP:puerto a la que deben conectarse los clientes (p. ej. Service: AV_LicenseServer (AV License Server) v26.10.28.0 - 192.168.0.31:7788). Es el valor que hay que usar al configurar cada cliente (§6).
• Estado del servicio (Running / Stopped / not installed), actualizado cada 2 segundos, con los botones:
  • Start / Stop — inicia o detiene el servicio.
  • Install service / Uninstall service — registra o elimina el servicio de Windows (normalmente ya lo hace el instalador; solo es necesario en reinstalaciones manuales).
  • Refresh status — actualiza el estado de inmediato sin esperar al temporizador.
• Log — las últimas líneas de AV_LicenseServer.log, con actualización manual o automática cada 2 s, y un botón para abrir la carpeta del registro en el Explorador. Útil para entender por qué un cliente no recibe una licencia (el motivo exacto de un rechazo siempre queda escrito aquí).

Todas las operaciones sobre el servicio requieren privilegios de administrador: si se deniegan, la aplicación ofrece reiniciarse con privilegios elevados.

La pestaña Licenses muestra los datos del Code.txt activo y los botones para solicitar uno nuevo o instalar uno recibido (véase §4). La columna Available indica, para cada producto, cuántas licencias quedan libres en este momento: puestos menos las licencias en uso y las prestadas (véase §7.1). Se lee del servicio en ejecución al abrir la pestaña o con Refresh y muestra, por ejemplo, 3 of 5 o 2 of 5 (1 borrowed); 0 (expired) si la licencia del producto en Code.txt ha caducado; n/a (service not running) con el servicio detenido; n/a (restart the service) para un producto de un nuevo Code.txt que el servicio aún no ha cargado (§4.2). La columna Options muestra las funciones opcionales de cada producto habilitadas por Code.txt: All (todas), None (ninguna) o su lista (p. ej. ResidualAnalysis, CutOptimization).

La pestaña Borrowed enumera las licencias actualmente prestadas (véase §7.1): producto, usuario, equipo, fecha del préstamo, fecha de caducidad y días restantes. Es de solo lectura — un préstamo solo termina cuando el cliente lo devuelve o cuando caduca — y se actualiza al abrir la pestaña o con Refresh.

6. Configurar los clientes (SPC, SPP, ...)

Cada aplicación cliente tiene un archivo de configuración (p. ej. settings.xml) con un nodo como:

<License Server="192.168.0.31" Port="7788" Product="SPC"/>

• Server: la dirección IP del PC servidor, la que se muestra en la pestaña Service de AV License Manager (véase §5) — nunca 127.0.0.1/localhost si el cliente se ejecuta en un PC distinto del servidor (solo funcionaría por casualidad si cliente y servidor están en la misma máquina: véase §8).
• Port: el puerto configurado en el servidor (AV_LicenseServer.ini, por defecto 7788) — debe coincidir.
• Product: el nombre del producto esperado en Code.txt (no distingue mayúsculas de minúsculas).

Si en el futuro cambia la dirección IP del servidor (PC nuevo, red reconfigurada), hay que actualizarla en todos los clientes.

7. Cómo se gestionan las licencias de los clientes

• Al arrancar, el cliente se conecta al servidor y solicita una licencia para su producto/versión. Si hay un puesto libre (y el producto está habilitado en Code.txt), la obtiene; en caso contrario recibe un error (p. ej. «no seat available»).
• Durante el uso, el cliente envía una señal («heartbeat») cada 30 segundos para confirmar que sigue activo y conservar la licencia.
• Al cerrarse (normalmente), el cliente libera explícitamente la licencia, que queda disponible de inmediato para otro usuario.
• En caso de bloqueo, corte de corriente o cable de red desconectado: si la conexión TCP se interrumpe, el servidor libera la licencia de inmediato; si en cambio la conexión queda «colgada» sin más heartbeats, el servidor la libera igualmente tras HeartbeatTimeoutSec (90 segundos por defecto, configurable en AV_LicenseServer.ini). En la práctica, un puesto nunca queda bloqueado mucho tiempo por un cliente que ha desaparecido sin desconectarse correctamente.
• Periodo de prueba: si el producto solicitado no está habilitado por cualquier motivo (sin Code.txt, producto no incluido, hardware que no coincide, caducado...), el cliente obtiene igualmente una prueba de 30 días contados desde la fecha de compilación de su propio ejecutable, sin límite de puestos. No se puede «reiniciar» instalando/quitando Code.txt: la referencia está fijada a la compilación del cliente.
• Aviso de caducidad próxima: una licencia real (no de prueba) que está a punto de caducar (umbral configurable, 15 días por defecto) genera un aviso no bloqueante en el cliente — la licencia se concede igualmente.
• Titular de la licencia: una licencia real expone además el nombre del cliente al que está registrada (tomado de Code.txt), que el cliente puede mostrar en su interfaz.
• Opciones del producto: una licencia real también indica al cliente qué funciones opcionales del producto están habilitadas (Options de Code.txt, véase §4.3); la aplicación cliente activa solo esas. Durante el periodo de prueba todas las opciones están activas. Una licencia prestada conserva las opciones que tenía en el momento del préstamo.

Servidor detenido o reiniciado: el estado de las licencias se mantiene en memoria en el servicio, por lo que tras un reinicio no recuerda los puestos ocupados. Los programas cliente que ya estaban en ejecución siguen funcionando (la licencia solo se comprueba al arrancar) y, en su siguiente heartbeat (en un máximo de 30 segundos), vuelven a identificarse automáticamente y recuperan un puesto, sin ninguna acción manual. Para que lo encuentren, durante los 40 segundos posteriores a un reinicio el servidor reserva los puestos de los clientes que estaban conectados antes: a un cliente nuevo que arranque en ese intervalo se le indica que lo reintente en unos segundos. Si no hay una licencia válida (el servidor permanece inalcanzable unos 90 segundos, o mientras tanto otros usuarios han ocupado todos los puestos), SPC y SPP muestran un mensaje: SPC desactiva entonces sus controles, exactamente igual que al arrancar con una licencia no válida, y los vuelve a activar por sí solo en cuanto vuelve la licencia (el cliente reintenta cada 30 segundos); SPP se cierra. Para evitarlo, reinicie el servidor fuera del horario laboral.

7.1 Trabajar fuera de la red: licencias prestadas

Un usuario que tenga que trabajar fuera de la oficina (portátil en las instalaciones de un cliente, en casa, de viaje) puede tomar una licencia en préstamo antes de salir:

• Préstamo (todavía en la red): desde la aplicación cliente, elija el comando de préstamo y el número de días. El servidor mantiene un puesto reservado para ese equipo durante ese periodo y le envía un ticket firmado, que se guarda en el equipo. El servidor concede como máximo MaxBorrowDays días (30 por defecto, clave en AV_LicenseServer.ini; 0 desactiva los préstamos) y nunca más allá de la fecha de caducidad de la licencia en Code.txt. Las licencias de prueba no se pueden prestar.
• Fuera de la red: el cliente arranca y funciona con normalidad sin contactar con el servidor, hasta que caduca el préstamo. El ticket solo es válido en el equipo para el que se emitió, no se puede modificar y deja de funcionar si se retrasa el reloj del sistema.
• El puesto sigue ocupado: mientras la licencia está prestada, el servidor cuenta ese puesto como en uso, incluso después de reiniciar el servicio, por lo que no está disponible para otros usuarios. Las licencias prestadas aparecen en AV License Manager, pestaña Borrowed.
• De vuelta en la red: el cliente vuelve por sí solo al servidor, en el mismo puesto prestado. Para liberar el puesto antes, use el comando de devolución del cliente (el servidor debe estar accesible).
• Caducidad: si la licencia no se devuelve, al final del periodo de préstamo el servidor libera el puesto automáticamente y, en ese mismo momento, el ticket deja de funcionar en el equipo. Por tanto, un equipo perdido o averiado mantiene su puesto hasta que caduca el préstamo: no hay forma de liberarlo antes, así que elija el número de días en consecuencia.

7.2 Sin License Server: licencia independiente

Un único ordenador que no utiliza un License Server (por ejemplo, una empresa con un solo PC) puede licenciarse con una licencia independiente (stand-alone): un archivo (.lic) que autoriza un producto solo en ese ordenador, sin servidor, red ni puestos.

• Solicitud: en la ventana License de la aplicación cliente, recuadro Stand-alone license, el botón Copy copia el Computer code al portapapeles: envíelo a su proveedor, que emite el archivo .lic (producto, versión máxima, opciones, fecha de emisión y fecha de caducidad o sin caducidad).
• Instalación: en el mismo recuadro, haga clic en Import license... y elija el archivo recibido. Se comprueba (este ordenador, este producto, fechas, versión) y se guarda en %ProgramData%\AV_License\, válido para todos los usuarios del ordenador; se utiliza de inmediato y se libera el puesto de red que estuviera ocupado. También se utiliza un archivo <producto>.lic colocado junto al ejecutable del cliente.
• Uso: al arrancar, el cliente busca primero la licencia independiente; si no la hay o no se puede usar, contacta con el License Server como siempre (licencia de red, préstamo, prueba). Con una licencia independiente, el aviso de caducidad próxima, el titular y las opciones del producto funcionan como con una licencia de red; el préstamo no es necesario y se rechaza.
• Protección: el archivo solo es válido en el ordenador y para el producto para los que se emitió, no se puede modificar y deja de ser válido si se atrasa el reloj del sistema. Si está presente pero no se puede usar (caducado, emitido para otro ordenador...), el cliente muestra el motivo.
• Eliminación: Remove license lo elimina del ordenador; el cliente vuelve entonces al License Server.

8. Red y Firewall

El servidor escucha en todas las interfaces de red del PC (no en una sola dirección), por lo que:

• desde un cliente en el mismo PC que el servidor funcionan tanto la IP de red (p. ej. 192.168.0.31:7788) como 127.0.0.1:7788 (loopback);
• desde un cliente en un PC distinto solo funciona la dirección IP de red del servidor — nunca 127.0.0.1, que apuntaría al propio cliente.

El Firewall de Windows del PC servidor debe permitir las conexiones entrantes en este puerto; de lo contrario, los clientes remotos no pueden conectarse (véanse los síntomas en el §10). El instalador crea automáticamente esta excepción (limitada a redes de Dominio/Privadas, no Públicas — coherente con un servicio pensado solo para la LAN de la empresa). Solo hay que volver a crearla manualmente si:

• el servicio se instaló sin pasar por el kit oficial;
• la excepción se eliminó manualmente o por un restablecimiento del firewall;
• el PC servidor está conectado a una red clasificada como «Pública» en lugar de «Privada»/«Dominio» (en ese caso la excepción no se aplica: compruebe el perfil de red en Windows, Configuración > Red e Internet).

Comando para (re)crearla manualmente, ejecutado como administrador en el PC servidor (ajuste la ruta si está instalado en otro lugar):

netsh advfirewall firewall add rule name="AV License Server" dir=in action=allow program="C:\Program Files\AV License Server\AV_LicenseServer.exe" enable=yes profile=domain,private

9. Actualización

Ejecute el nuevo instalador (<yyyymmdd>_AV_LicenseServer_x64.exe) en el PC servidor igual que en una primera instalación: sobrescribe los ejecutables pero no toca el AV_LicenseServer.ini ni el Code.txt existentes (la configuración y la activación del cliente permanecen intactas). El servicio se detiene, los archivos se actualizan y el servicio se reinicia automáticamente si la tarea correspondiente permanece marcada.

10. Resolución de problemas

11. Referencia rápida

• Puerto por defecto: TCP 7788 (configurable en AV_LicenseServer.ini, clave Port).
• Nombre del servicio de Windows: AV_LicenseServer (aparece como «AV License Server» en services.msc).
• Carpeta de instalación habitual: C:\Program Files\AV License Server\.
• Archivos principales: AV_LicenseServer.exe, AV_LicenseManager.exe, AV_LicenseServer.ini, Code.txt, AV_LicenseServer.log.
• Timeout del heartbeat: 90 segundos por defecto (clave HeartbeatTimeoutSec).
• Periodo de prueba: 30 días desde la fecha de compilación del cliente, fijo, no configurable.
• Aviso de caducidad próxima: 15 días por defecto (clave ExpiryWarningDays).
• Conservación del registro (log): 15 días por defecto (clave LogRetentionDays).
• Licencias prestadas: como máximo 30 días por defecto (clave MaxBorrowDays, 0 = desactivadas); estado guardado en AV_LicenseServer.borrows.
• Licencia independiente: %ProgramData%\AV_License\<producto>.lic (o junto al ejecutable del cliente); no se necesita License Server (§7.2).