Lizenzen und Verlängerung

Jede On-Premise-Installation benötigt eine gültige SPOT-Lizenz, bevor Dashboards oder die SAP-Extraktion starten können. Verwende das Online-Verfahren, wenn du einen Aktivierungsschlüssel erhalten hast und der Host den Lizenzdienst erreichen kann. Verwende Offline, wenn du für eine Installation ohne diese Verbindung eine Lizenzdatei erhalten hast.

Die Lizenz legt Ablaufdatum sowie Grenzwerte für SAP-Benutzer und SAP-Instanzen fest. Eine Überschreitung erzeugt eine Warnung und wird im Verlauf erfasst, stoppt aber weder SPOT noch den Connector. Eine fehlende, ungültige, abgelaufene oder widerrufene Lizenz blockiert dagegen Produktdaten und Extraktion.

Suite mit Weboberfläche

Erstinstallation

1. Installiere spot-suite oder spot-suite-external und öffne http://<server>:8080/setup.
2. Verwende in der Karte License eine der folgenden Optionen:
   • License key > Activate license für die Online-Aktivierung.
   • Offline license > Install file für die erhaltene Datei.
3. Warte, bis License valid angezeigt wird. Prüfe das Ablaufdatum, bevor du fortfährst.
4. Vervollständige Elasticsearch, SAP und den ersten Administrator und speichere anschließend das Setup.

Der restliche Teil des Formulars bleibt deaktiviert, bis SPOT die Lizenz validieren kann. Kopiere oder bearbeite die installierte Lizenzdatei nicht manuell.

Nach dem ersten Administrator

Melde dich als Administrator an und öffne Configuration > License. Dort kannst du:

• Status, Online-/Offline-Modus, Ablauf und zugewiesene Kapazität prüfen;
• beobachtete SAP-Benutzer und Instanzen mit den Grenzwerten vergleichen;
• Qualität, Aktualität und Nutzungsverlauf prüfen;
• einen neuen Online-Schlüssel aktivieren oder eine neue Offline-Datei installieren;
• das verschlüsselte Verlängerungspaket herunterladen.

Benutzer ohne Administratorrolle sehen nur eine allgemeine Warnung. Sie sehen weder Vertragswerte noch Kennungen oder Lizenzaktionen.

Connector-only über die CLI

Das Connector-only-Paket enthält den lokalen Validator. Prüfe nach der Installation des RPM- oder DEB-Pakets zuerst, ob er aktiv ist:

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

Online-Aktivierung

Verwende die verdeckte Eingabe. Der Schlüssel erscheint weder im Shell-Verlauf noch in der Prozessliste:

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

Für Automatisierung stehen --stdin und --key-file zur Verfügung. Die Eingabedatei muss eine reguläre, für spot lesbare Datei mit Modus 0600 sein. Übergib den Schlüssel niemals als Positionsargument und speichere ihn nicht in einem Skript, einer sichtbaren Variable oder einer systemd-Unit.

Offline-Installation

Erstelle eine geschützte temporäre Kopie und installiere sie mit dem dafür vorgesehenen Befehl:

sudo install -o spot -g spot -m 0600 /empfangener/pfad/lizenz /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 validiert zuerst den Kandidaten und ersetzt erst danach die aktive Lizenz. Ist die Datei ungültig, bleibt die vorherige Lizenz erhalten.

Validierung und Start

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 ist bei einer gültigen Lizenz erfolgreich, auch wenn eine Nutzungswarnung besteht. Eine tatsächlich ungültige Lizenz verhindert elastic-bootstrap und run; der Agent wird erst nach der Korrektur betriebsbereit.

Der Collector erfasst automatisch Messungen, solange der Agent läuft. Für die Diagnose kann eine bereinigte manuelle Messung angefordert werden:

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

Portable / non-root

Setze SPOT_HOME, starte den enthaltenen Validator und verwende dieselben Befehle ohne 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
# oder: "$SPOT_HOME/bin/spot-agent-sap" license-install /geschuetzter/pfad/lizenz
"$SPOT_HOME/bin/spot-agent-sap" license-check

Bei einer portablen Suite ist deren Verzeichnis als SPOT_HOME zu verwenden. Lizenz und Verlauf bleiben unter $SPOT_HOME/data/license; kopiere sie nicht zwischen Installationen und bearbeite ihren Inhalt nicht.

Berechnung der Nutzung

• SAP-Instanzen: alle konfigurierten SAP-Verbindungen, einschließlich deaktivierter Verbindungen.
• SAP-Benutzer: Summe der aktuellen users-logged-in-Werte aus aktivierten Verbindungen. SPOT summiert alle Quellen und rundet die Gesamtsumme einmal.
• Complete: jede aktivierte Quelle besitzt einen aktuellen Wert.
• Partial: mindestens ein aktueller Wert existiert, aber eine Quelle fehlt.
• Unknown: es existiert kein aktueller Wert.

Ein fehlender Wert wird niemals als Null behandelt. Eine partielle Messung kann eine Überschreitung belegen, wenn bereits ihre Zwischensumme über dem Grenzwert liegt. Sie kann jedoch nicht belegen, dass die Nutzung innerhalb des Grenzwerts liegt.

SPOT erfasst alle fünf Minuten eine Messung. Die Oberfläche zeigt Details für die letzten 24 Stunden und Tageszusammenfassungen für längere Zeiträume. Abdeckungslücken bleiben sichtbar.

Zeitpunkt für das Verlängerungspaket

Erzeuge ein neues Paket:

• wenn dein SPOT-Ansprechpartner es für die Verlängerungsprüfung anfordert;
• vor dem unter Configuration > License angezeigten Ablaufdatum;
• nach einer anhaltenden Überschreitung oder einer Änderung der Anzahl der SAP-Systeme, wenn die Kapazität geprüft werden soll;
• wenn der Support Abdeckung oder Kontinuität des Verlaufs prüfen muss.

Erzeuge das Paket möglichst nah am Zeitpunkt der Anforderung und nach Möglichkeit, nachdem die aktivierten Quellen aktuelle Daten gesendet haben. Bei partieller oder unbekannter Qualität bleibt dieser Zustand im Paket erhalten; es werden keine Werte erfunden. Der Export bleibt auch nach Ablauf der Lizenz verfügbar.

Paket herunterladen und übermitteln

Aus der Suite

1. Melde dich als Administrator an.
2. Öffne Configuration > License.
3. Prüfe Ablaufdatum, letzte Messung und Qualität.
4. Wähle unter Prepare renewal die Aktion Download renewal package.
5. Bewahre spot-renewal.spot-renewal unverändert auf und sende die Datei über den mit deinem SPOT-Ansprechpartner vereinbarten sicheren Kanal.

Aus 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

Übertrage die erzeugte Datei über den vereinbarten sicheren Kanal und entferne die Transportkopie, sobald der Empfang bestätigt wurde. Für Portable:

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

Das Paket ist für SPOT verschlüsselt und enthält bereinigten Lizenzstatus, Nutzung, Qualität, Abdeckung, Überschreitungen und einen verifizierbaren Verlauf. Es enthält weder den Lizenzschlüssel noch Zugangsdaten oder Details der SAP-Verbindungen. Öffne, bearbeite, kombiniere oder verpacke es nicht neu: Jede Änderung macht es nicht mehr verifizierbar. Bewahre nur die Kopien auf, die deine Übertragungsrichtlinie verlangt.

Erhaltene Verlängerung anwenden

SPOT stellt entweder einen neuen Online-Schlüssel oder eine neue Offline-Datei bereit. Wende sie entsprechend dem erhaltenen Modus unter Configuration > License oder mit license-activate / license-install an. Danach:

1. führe license-status --json aus oder aktualisiere die Lizenzkarte;
2. prüfe gültigen Status, neues Ablaufdatum und Grenzwerte;
3. starte den Connector neu, falls er blockiert war;
4. bestätige, dass der bisherige Verlauf weiterhin sichtbar ist.

Für die Verlängerung müssen Lizenz, Journal oder Connector-Zustand nicht gelöscht werden.