Saltar al contenido principal

Licencias y renovación

Toda instalación on-premise necesita una licencia SPOT válida antes de iniciar los dashboards o la extracción SAP. Elige el procedimiento online si has recibido una clave de activación y el host puede alcanzar el servicio de licencias. Elige offline si has recibido un fichero de licencia para una instalación sin esa conectividad.

La licencia define su fecha de expiración y los límites de usuarios SAP e instancias SAP. Superar un límite genera un aviso y queda reflejado en el histórico, pero no detiene SPOT ni el connector. Una licencia ausente, inválida, caducada o revocada sí bloquea los datos de producto y la extracción.

Suite con interfaz web​

Primera instalación​

  1. Instala spot-suite o spot-suite-external y abre http://<servidor>:8080/setup.
  2. En la tarjeta Licencia, usa una de estas opciones:
    • Clave de licencia > Activar licencia para una activación online.
    • Licencia offline > Instalar fichero para el fichero recibido.
  3. Espera a que la tarjeta muestre Licencia válida. Comprueba la fecha de expiración antes de continuar.
  4. Completa Elasticsearch, SAP y el primer administrador; después guarda el setup.

El resto del formulario permanece deshabilitado hasta que SPOT pueda validar la licencia. No copies ni edites manualmente el fichero que queda instalado.

Después del primer administrador​

Entra con un administrador y abre Configuración > License. Desde esta sección puedes:

  • comprobar estado, modo online/offline, expiración y capacidad asignada;
  • comparar usuarios SAP e instancias observadas con sus límites;
  • revisar calidad, frescura e histórico de uso;
  • activar una nueva clave online o instalar un nuevo fichero offline;
  • descargar el paquete cifrado para una renovación.

Los usuarios sin rol administrador sólo reciben un aviso general. No ven cifras contractuales, identificadores ni acciones de licencia.

Connector-only mediante CLI​

El paquete connector-only incluye el validador local. Tras instalar el RPM o el DEB, comprueba primero que está activo:

sudo systemctl enable --now spot-license.service
sudo systemctl status spot-license.service --no-pager

Activación online​

Usa el prompt oculto. La clave no aparecerá en el historial del shell ni en la lista de procesos:

sudo -u spot /opt/spot/bin/spot-agent-sap license-activate

Para automatización también se admite --stdin o --key-file. El fichero de entrada debe ser regular, accesible por el usuario spot y tener permisos 0600. No uses una clave como argumento posicional y no la escribas en un script, una variable visible o una unidad systemd.

Instalación offline​

Prepara una copia temporal protegida e instálala con el comando dedicado:

sudo install -o spot -g spot -m 0600 /ruta/recibida/licencia /run/spot-license.offline
sudo -u spot /opt/spot/bin/spot-agent-sap license-install /run/spot-license.offline
sudo rm -f /run/spot-license.offline

license-install valida primero el candidato y sólo entonces reemplaza la licencia activa. Si el fichero no es válido, conserva la licencia anterior.

Validación y arranque​

sudo -u spot /opt/spot/bin/spot-agent-sap license-status --json
sudo -u spot /opt/spot/bin/spot-agent-sap license-check
sudo systemctl restart spot-agent-sap.service
sudo systemctl status spot-agent-sap.service --no-pager

license-check devuelve éxito cuando la licencia es válida, también si existe un aviso por consumo. Una licencia realmente inválida impide elastic-bootstrap y run, por lo que el servicio del agente no quedará operativo hasta corregirla.

El collector toma las muestras automáticamente mientras el agente está activo. Para diagnóstico puedes solicitar una muestra manual saneada:

sudo -u spot /opt/spot/bin/spot-agent-sap license-usage-sample

Portable / non-root​

Define SPOT_HOME, inicia el validador incluido y usa los mismos comandos sin sudo:

export SPOT_HOME="$HOME/spot-agent"
"$SPOT_HOME/scripts/run-license.sh" >"$SPOT_HOME/log/license.out" 2>"$SPOT_HOME/log/license.err" &
"$SPOT_HOME/bin/spot-agent-sap" license-activate
# o: "$SPOT_HOME/bin/spot-agent-sap" license-install /ruta/protegida/licencia
"$SPOT_HOME/bin/spot-agent-sap" license-check

En una suite portable sustituye SPOT_HOME por el directorio de esa suite. La licencia y su histórico permanecen bajo $SPOT_HOME/data/license; no los copies entre instalaciones ni edites su contenido.

Cómo se calcula el uso​

  • Instancias SAP: todas las conexiones SAP configuradas, incluidas las que estén deshabilitadas.
  • Usuarios SAP: suma del valor reciente users-logged-in de las conexiones habilitadas. SPOT suma todas las fuentes y redondea una vez el total.
  • Completa: todas las fuentes habilitadas tienen un valor reciente.
  • Parcial: hay algún valor reciente, pero falta al menos una fuente.
  • Desconocida: no hay ningún valor reciente.

Un dato ausente nunca se convierte en cero. Una lectura parcial puede demostrar que se ha superado un límite si el subtotal ya es superior, pero no demuestra que el consumo esté dentro del límite.

SPOT registra muestras cada cinco minutos. La interfaz muestra detalle de las últimas 24 horas y resúmenes diarios para periodos mayores. Los huecos de cobertura permanecen visibles.

Cuándo preparar el paquete de renovación​

Genera un paquete nuevo:

  • cuando tu contacto de SPOT lo solicite para revisar la renovación;
  • antes de la fecha de expiración mostrada en Configuración > License;
  • cuando exista un exceso persistente o haya cambiado el número de sistemas SAP y te pidan revisar la capacidad;
  • cuando soporte necesite comprobar cobertura o continuidad del histórico.

Hazlo lo más cerca posible de la solicitud y, si es posible, después de que las fuentes habilitadas hayan enviado datos recientes. Si la calidad es parcial o desconocida, el paquete conserva esa condición; no inventa valores. La exportación sigue disponible aunque la licencia ya haya caducado.

Descargar y entregar el paquete​

Desde la suite​

  1. Entra como administrador.
  2. Abre Configuración > License.
  3. Revisa la fecha de expiración, el último muestreo y la calidad.
  4. En Prepare renewal, pulsa Download renewal package.
  5. Conserva el fichero spot-renewal.spot-renewal tal como se descargó y envíalo por el canal seguro acordado con tu contacto de SPOT.

Desde connector-only​

umask 077
sudo -u spot /opt/spot/bin/spot-agent-sap license-renewal-export \
  --output /var/lib/spot-agent-sap/spot-renewal.spot-renewal

Copia después el fichero resultante al canal seguro acordado y elimina la copia de transporte cuando se confirme la recepción. Para portable:

umask 077
"$SPOT_HOME/bin/spot-agent-sap" license-renewal-export \
  --output "$SPOT_HOME/data/spot-renewal.spot-renewal"

El paquete está cifrado para SPOT y contiene estado de licencia saneado, consumo, calidad, cobertura, excesos e histórico verificable. No contiene la clave de licencia, credenciales ni detalles de conexión SAP. No lo abras, edites, combines ni vuelvas a empaquetar: una alteración hace que deje de ser verificable. Conserva únicamente las copias necesarias según tu política de transferencia.

Aplicar la renovación recibida​

SPOT te devolverá una nueva clave online o un nuevo fichero offline. Aplícala desde Configuración > License o con license-activate / license-install, según el modo recibido. Después:

  1. ejecuta license-status --json o refresca la tarjeta de licencia;
  2. comprueba estado válido, nueva expiración y límites;
  3. reinicia el connector si estaba bloqueado;
  4. confirma que el histórico anterior sigue visible.

La renovación no requiere borrar la licencia, el journal ni el estado del connector.