AV License Server — Handbuch

1. Was es ist und wie es funktioniert

AV License Server verwaltet "gleichzeitig nutzbare" Lizenzen (concurrent seats): Jedes Produkt (z. B. SPC, SPP) hat eine maximale Anzahl an Arbeitsplätzen, die gleichzeitig genutzt werden können, festgelegt im Aktivierungscode des Kunden. Es ist nicht an einen einzelnen PC gebunden: Jeder Client im Netzwerk kann einen freien Platz nutzen, bis alle belegt sind.

Das System besteht aus zwei Programmen, die auf demselben PC (dem Server) installiert werden:

• AV_LicenseServer.exe — läuft als Windows-Dienst im Hintergrund, immer aktiv (auch ohne angemeldeten Benutzer). Er beantwortet die Anfragen der Clients im Netzwerk. Er hat keine grafische Oberfläche.
• AV_LicenseManager.exe — die Verwaltungskonsole: dient zum Starten/Stoppen des Dienstes, zum Einsehen des Protokolls und zur Verwaltung der Aktivierungsdatei. Sie muss nicht geöffnet bleiben: Der Server funktioniert unabhängig davon.

Die Clients (SPC, SPP usw., installiert auf anderen PCs im Netzwerk) verbinden sich beim Start über das Netzwerk (TCP) mit dem Server, fordern eine Lizenz an und halten sie durch ein periodisches Signal ("Heartbeat") aktiv, solange sie geöffnet bleiben.

2. Voraussetzungen

• Windows mit Administratorrechten für die Installation (erforderlich zum Registrieren des Windows-Dienstes und zum Schreiben in Program Files).
• Der als Server gewählte PC muss im lokalen Netzwerk eine feste oder reservierte IP-Adresse haben (bei einer Änderung müssen alle Clients neu konfiguriert werden). Empfohlen wird die Zuweisung über eine DHCP-Reservierung am Router oder eine statische Konfiguration.
• Keine weiteren Softwarevoraussetzungen: Das Installationsprogramm enthält alles Nötige.

3. Installation

1. Das Installationsprogramm <yyyymmdd>_AV_LicenseServer_x64.exe (aus dem Kit in Kit\Output\ erstellt; der Name beginnt mit dem Erstellungsdatum, z. B. 20261010_AV_LicenseServer_x64.exe) auf den als Server vorgesehenen PC kopieren und ausführen.
2. Die Anfrage nach Administratorrechten (UAC) bestätigen.
3. Im Assistenten, auf der Seite mit den optionalen Aufgaben:
   • „Install and start the AV License Server Windows service" — standardmäßig aktiviert. Aktiviert lassen, um den Dienst sofort zu starten; nur deaktivieren, um die Dateien zu installieren, ohne den Dienst bereits zu aktivieren.
   • „Create a desktop icon for AV License Manager" — standardmäßig deaktiviert, praktisch, wenn die Verwaltung häufig von diesem PC aus erfolgt.
4. Installation abschließen. Wenn der Dienst installiert wurde, führt das Installationsprogramm Folgendes aus:
   • registriert und startet ihn (interner Name AV_LicenseServer, in services.msc als „AV License Server" sichtbar);
   • öffnet automatisch die Ausnahme in der Windows-Firewall für AV_LicenseServer.exe, beschränkt auf die Netzwerkprofile Domäne und Privat (nicht Öffentlich) — ohne diese Ausnahme könnten Clients auf anderen PCs den Server nicht erreichen (siehe §8).
5. Installierte Dateien in C:\Program Files\AV License Server\:
   • AV_LicenseServer.exe (der Dienst)
   • AV_LicenseManager.exe (die Konsole — ihre Verknüpfungen im Startmenü/auf dem Desktop sind so eingestellt, dass sie bereits als Administrator starten, was zur Steuerung des Dienstes erforderlich ist)
   • AV_LicenseServer.ini — Beispielkonfiguration mit Standardwerten (Port=7788 usw.); wird durch ein späteres Update niemals überschrieben.
   • AV_LicenseServer_Manual.html — dieses Handbuch, auch über das Startmenü erreichbar („AV License Server Manual“).
6. An diesem Punkt ist der Server aktiv, aber ohne aktivierte Lizenz: Die Aktivierungsdatei Code.txt des Kunden (§4) muss installiert werden, bevor reale Clients eine Lizenz erhalten können. Bis dahin versuchen Clients trotzdem, sich zu verbinden, und erhalten automatisch eine 30-tägige Testphase (siehe §7).

4. Aktivierung: die Datei Code.txt

Code.txt ist die Datei, die festlegt, welche Produkte auf diesem Server aktiviert sind, wie viele gleichzeitige Arbeitsplätze und bis wann. Sie ist kundenspezifisch und an die Hardware des Server-PCs gebunden (funktioniert nicht, wenn sie auf einen anderen PC kopiert wird).

4.1 Aktivierungscode anfordern

Im Reiter Licenses von AV License Manager erkennt die Schaltfläche „Code request" automatisch die beiden Hardware-Kennungen dieses PCs (SystemID und NetworkID) und öffnet den Browser auf der Arolo-Seite, um den Code anzufordern, wobei diese bereits vorausgefüllt sind. Ein manuelles Abschreiben ist nicht nötig.

4.2 Erhaltenen Code installieren

Sobald die Datei Code.txt (per E-Mail oder auf anderem Weg) von demjenigen erhalten wurde, der die Aktivierung erzeugt:

1. AV License Manager öffnen, Reiter Licenses.
2. Auf „Select Code.txt..." klicken und die erhaltene Datei auswählen: Sie wird validiert und automatisch in den Ordner des Servers kopiert.
3. Die Daten (Kunde, aktivierte Produkte, Arbeitsplätze, Ablaufdaten) erscheinen sofort in der Liste, schreibgeschützt.
4. Dienst neu starten (Reiter Service → Stop, dann Start, oder die Schaltfläche Refresh status zur Statusprüfung): Code.txt wird vom Server nur beim Start gelesen — die Installation bei geöffneter App hat keine Auswirkung auf bereits laufende Lizenzen, solange der Dienst nicht neu gestartet wird.

Die Schaltfläche „Remove license file" entfernt die aktuelle Aktivierung (nur zum Ersetzen verwenden; ohne Code.txt kann keine reale Lizenz vergeben werden, nur die Testphase).

4.3 Inhalt der Datei

Für jedes Produkt: Name, maximal autorisierte Version, Anzahl der gleichzeitigen Arbeitsplätze, Ausstellungsdatum und Ablaufdatum (oder „kein Ablauf"), sowie die freigeschalteten optionalen Funktionen des Produkts (Optionen, z. B. ResidualAnalysis und CutOptimization für SPC; alle oder keine). Die Datei ist auf der Festplatte verschlüsselt: Beim Öffnen mit einem Texteditor ist nichts Lesbares zu sehen.

5. AV License Manager: tägliche Nutzung

Drei Hauptelemente, alle im Reiter Service:

• Kopfzeilen-Beschriftung — zeigt Name, installierte Version von AV License Server, und die IP-Adresse:Port, mit der sich Clients verbinden müssen (z. B. Service: AV_LicenseServer (AV License Server) v26.10.28.0 - 192.168.0.31:7788). Dies ist der Wert, der bei der Konfiguration jedes Clients verwendet werden muss (§6).
• Dienststatus (Running / Stopped / not installed), alle 2 Sekunden aktualisiert, mit den Schaltflächen:
  • Start / Stop — startet oder stoppt den Dienst.
  • Install service / Uninstall service — registriert oder entfernt den Windows-Dienst (normalerweise bereits vom Installationsprogramm erledigt; nur für manuelle Neuinstallationen erforderlich).
  • Refresh status — aktualisiert den Status sofort, ohne auf den Timer zu warten.
• Log — die letzten Zeilen von AV_LicenseServer.log, mit manueller oder automatischer Aktualisierung alle 2 Sekunden, sowie eine Schaltfläche zum Öffnen des Log-Ordners im Explorer. Nützlich, um zu verstehen, warum ein Client keine Lizenz erhält (der genaue Ablehnungsgrund wird immer hier protokolliert).

Alle Vorgänge am Dienst erfordern Administratorrechte: Werden sie verweigert, bietet die App an, sich mit erhöhten Rechten neu zu starten.

Der Reiter Licenses zeigt die Daten der aktiven Code.txt sowie die Schaltflächen zum Anfordern eines neuen oder Installieren eines erhaltenen Codes (siehe §4). Die Spalte Available zeigt für jedes Produkt, wie viele Lizenzen gerade frei sind: Plätze abzüglich der verwendeten und der ausgeliehenen Lizenzen (siehe §7.1). Sie wird beim Öffnen des Reiters oder mit Refresh vom laufenden Dienst abgefragt und zeigt zum Beispiel 3 of 5 oder 2 of 5 (1 borrowed); 0 (expired), wenn die Lizenz des Produkts in Code.txt abgelaufen ist; n/a (service not running) bei gestopptem Dienst; n/a (restart the service) für ein Produkt einer neuen Code.txt, die der Dienst noch nicht geladen hat (§4.2). Die Spalte Options zeigt die durch Code.txt freigeschalteten optionalen Funktionen jedes Produkts: All (alle), None (keine) oder deren Liste (z. B. ResidualAnalysis, CutOptimization).

Der Reiter Borrowed listet die derzeit ausgeliehenen Lizenzen auf (siehe §7.1): Produkt, Benutzer, Computer, Ausleihdatum, Ablaufdatum und verbleibende Tage. Er ist schreibgeschützt — eine Ausleihe endet nur, wenn der Client sie zurückgibt oder sie abläuft — und wird beim Öffnen des Reiters oder mit Refresh aktualisiert.

6. Clients konfigurieren (SPC, SPP, ...)

Jede Client-Anwendung hat eine Einstellungsdatei (z. B. settings.xml) mit einem Knoten wie:

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

• Server: die IP-Adresse des Server-PCs, diejenige, die im Reiter Service von AV License Manager angezeigt wird (siehe §5) — niemals 127.0.0.1/localhost, wenn der Client auf einem anderen PC als der Server läuft (das würde nur zufällig funktionieren, wenn Client und Server auf derselben Maschine laufen: siehe §8).
• Port: der auf dem Server konfigurierte Port (AV_LicenseServer.ini, Standard 7788) — muss übereinstimmen.
• Product: der in Code.txt erwartete Produktname (Groß-/Kleinschreibung wird nicht unterschieden).

Sollte sich die IP-Adresse des Servers in Zukunft ändern (neuer PC, umkonfiguriertes Netzwerk), muss sie auf allen Clients aktualisiert werden.

7. Verwaltung der Client-Lizenzen

• Beim Start verbindet sich der Client mit dem Server und fordert eine Lizenz für sein Produkt/seine Version an. Ist ein Platz frei (und das Produkt in Code.txt aktiviert), erhält er ihn; andernfalls erhält er einen Fehler (z. B. „kein Platz verfügbar").
• Während der Nutzung sendet der Client alle 30 Sekunden ein Signal („Heartbeat"), um zu bestätigen, dass er noch aktiv ist, und die Lizenz aufrechtzuerhalten.
• Beim (normalen) Schließen gibt der Client die Lizenz explizit frei, die sofort wieder für einen anderen Benutzer verfügbar wird.
• Bei Absturz, Stromausfall oder getrenntem Netzwerkkabel: Fällt die TCP-Verbindung ab, gibt der Server die Lizenz sofort frei; bleibt die Verbindung hingegen „hängen", ohne dass weitere Heartbeats gesendet werden, gibt der Server sie trotzdem nach HeartbeatTimeoutSec frei (Standard 90 Sekunden, konfigurierbar in AV_LicenseServer.ini). In der Praxis bleibt ein Platz nie lange durch einen Client blockiert, der verschwunden ist, ohne sich ordnungsgemäß zu trennen.
• Testphase: Wird das angeforderte Produkt aus irgendeinem Grund nicht aktiviert (keine Code.txt, Produkt nicht aufgeführt, Hardware stimmt nicht überein, abgelaufen...), erhält der Client trotzdem eine 30-tägige Testphase ab dem Erstellungsdatum seiner eigenen ausführbaren Datei, ohne Platzbegrenzung. Sie kann nicht durch Installieren/Entfernen von Code.txt „zurückgesetzt" werden: Der Bezugspunkt ist fest an den Build des Clients gebunden.
• Warnung bei bevorstehendem Ablauf: Eine reale (nicht Test-)Lizenz, die bald abläuft (konfigurierbarer Schwellenwert, Standard 15 Tage), löst beim Client eine nicht blockierende Warnung aus — die Lizenz wird trotzdem gewährt.
• Lizenzinhaber: Eine reale Lizenz zeigt auch den Namen des Kunden an, auf den sie registriert ist (aus Code.txt), den der Client in seiner Oberfläche anzeigen kann.
• Produktoptionen: Eine reale Lizenz teilt dem Client auch mit, welche optionalen Funktionen des Produkts freigeschaltet sind (Options in Code.txt, siehe §4.3); die Client-Anwendung aktiviert nur diese. Während der Testphase sind alle Optionen aktiv. Eine ausgeliehene Lizenz behält die Optionen, die sie zum Zeitpunkt der Ausleihe hatte.

Server gestoppt oder neu gestartet: Der Lizenzstatus wird vom Dienst im Arbeitsspeicher gehalten, daher kennt er nach einem Neustart die belegten Arbeitsplätze nicht mehr. Bereits laufende Client-Programme arbeiten weiter (die Lizenz wird nur beim Start geprüft) und melden sich beim nächsten Heartbeat (innerhalb von 30 Sekunden) automatisch erneut an und belegen wieder einen Platz, ohne manuellen Eingriff. Damit sie ihn wiederfinden, hält der Server nach einem Neustart 40 Sekunden lang die Plätze der zuvor verbundenen Clients reserviert: Ein neuer Client, der in diesem Zeitfenster startet, wird aufgefordert, es in einigen Sekunden erneut zu versuchen. Ist keine gültige Lizenz verfügbar (der Server bleibt etwa 90 Sekunden lang nicht erreichbar, oder andere Benutzer haben in der Zwischenzeit alle Plätze belegt), zeigen SPC und SPP eine Meldung an: SPC deaktiviert anschließend seine Bedienelemente, genau wie beim Start mit ungültiger Lizenz, und aktiviert sie von selbst wieder, sobald die Lizenz zurück ist (der Client versucht es alle 30 Sekunden erneut); SPP wird geschlossen. Um dies zu vermeiden, den Server außerhalb der Arbeitszeit neu starten.

7.1 Arbeiten außerhalb des Netzwerks: ausgeliehene Lizenzen

Ein Benutzer, der außerhalb des Büros arbeiten muss (Laptop beim Kunden, zu Hause, unterwegs), kann vor dem Verlassen eine Lizenz ausleihen:

• Ausleihen (noch im Netzwerk): In der Client-Anwendung den Befehl zum Ausleihen wählen und die Anzahl der Tage angeben. Der Server reserviert diesem Computer für diesen Zeitraum einen Platz und übergibt ihm ein signiertes Ticket, das auf dem Computer gespeichert wird. Der Server gewährt höchstens MaxBorrowDays Tage (Standard 30, Schlüssel in AV_LicenseServer.ini; 0 deaktiviert das Ausleihen) und nie über das Ablaufdatum der Lizenz in Code.txt hinaus. Testlizenzen können nicht ausgeliehen werden.
• Außerhalb des Netzwerks: Der Client startet und arbeitet normal, ohne den Server zu erreichen, bis die Ausleihe abläuft. Das Ticket gilt nur auf dem Computer, für den es ausgestellt wurde, kann nicht verändert werden und wird ungültig, wenn die Systemuhr zurückgestellt wird.
• Der Platz bleibt belegt: Solange die Lizenz ausgeliehen ist, zählt der Server diesen Platz als belegt, auch nach einem Neustart des Dienstes; er steht anderen Benutzern also nicht zur Verfügung. Ausgeliehene Lizenzen werden im AV License Manager auf der Registerkarte Borrowed angezeigt.
• Zurück im Netzwerk: Der Client wechselt von selbst wieder zum Server, auf denselben ausgeliehenen Platz. Um den Platz früher freizugeben, den Befehl zur Rückgabe im Client verwenden (der Server muss erreichbar sein).
• Ablauf: Wird die Lizenz nicht zurückgegeben, gibt der Server den Platz am Ende der Ausleihe automatisch frei, und im selben Moment wird das Ticket auf dem Computer ungültig. Ein verlorener oder defekter Computer behält seinen Platz daher bis zum Ablauf der Ausleihe: Er kann nicht früher freigegeben werden, daher die Anzahl der Tage mit Bedacht wählen.

7.2 Ohne License Server: Einzelplatzlizenz

Ein einzelner Computer, der keinen License Server verwendet (z. B. ein Unternehmen mit nur einem PC), kann mit einer Einzelplatzlizenz (Stand-alone) lizenziert werden: eine Datei (.lic), die ein Produkt nur auf diesem Computer freischaltet, ohne Server, Netzwerk oder Plätze.

• Anfordern: Im Fenster License der Client-Anwendung, Bereich Stand-alone license, kopiert die Schaltfläche Copy den Computer code in die Zwischenablage: Diesen an Ihren Lieferanten senden, der die Datei .lic ausstellt (Produkt, maximale Version, Optionen, Ausstellungsdatum und Ablaufdatum oder kein Ablauf).
• Installieren: Im selben Bereich auf Import license... klicken und die erhaltene Datei auswählen. Sie wird geprüft (dieser Computer, dieses Produkt, Datum, Version) und in %ProgramData%\AV_License\ gespeichert, gültig für alle Benutzer des Computers; sie wird sofort verwendet, und ein eventuell belegter Netzwerkplatz wird freigegeben. Eine neben der ausführbaren Datei des Clients abgelegte Datei <Produkt>.lic wird ebenfalls verwendet.
• Verwendung: Beim Start sucht der Client zuerst die Einzelplatzlizenz; ist keine vorhanden oder ist sie nicht verwendbar, kontaktiert er wie gewohnt den License Server (Netzwerklizenz, Ausleihe, Testphase). Mit einer Einzelplatzlizenz funktionieren die Warnung vor dem baldigen Ablauf, der Lizenzinhaber und die Produktoptionen wie bei einer Netzwerklizenz; eine Ausleihe ist nicht nötig und wird abgelehnt.
• Schutz: Die Datei gilt nur auf dem Computer und für das Produkt, für die sie ausgestellt wurde, kann nicht verändert werden und wird ungültig, wenn die Systemuhr zurückgestellt wird. Ist sie vorhanden, aber nicht verwendbar (abgelaufen, für einen anderen Computer ausgestellt...), zeigt der Client den Grund an.
• Entfernen: Remove license löscht sie vom Computer; der Client kehrt dann zum License Server zurück.

8. Netzwerk und Firewall

Der Server lauscht auf allen Netzwerkschnittstellen des PCs (nicht auf einer einzelnen Adresse), deshalb gilt:

• von einem Client auf demselben PC wie der Server funktionieren sowohl die Netzwerk-IP (z. B. 192.168.0.31:7788) als auch 127.0.0.1:7788 (Loopback);
• von einem Client auf einem anderen PC funktioniert nur die Netzwerk-IP-Adresse des Servers — niemals 127.0.0.1, was auf den Client selbst verweisen würde.

Die Windows-Firewall auf dem Server-PC muss eingehende Verbindungen auf diesem Port zulassen, sonst können sich entfernte Clients nicht verbinden (Symptome siehe §10). Das Installationsprogramm erstellt diese Ausnahme automatisch (beschränkt auf Domäne/Privat, nicht Öffentlich — passend zu einem Dienst, der nur für das Firmen-LAN gedacht ist). Sie muss nur manuell neu erstellt werden, wenn:

• der Dienst ohne das offizielle Kit installiert wurde;
• die Ausnahme manuell oder durch ein Zurücksetzen der Firewall entfernt wurde;
• der Server-PC mit einem als „Öffentlich" statt „Privat"/„Domäne" eingestuften Netzwerk verbunden ist (in diesem Fall gilt die Ausnahme nicht: das Netzwerkprofil in Windows unter Einstellungen > Netzwerk und Internet prüfen).

Befehl zum manuellen (Wieder-)Erstellen, als Administrator auf dem Server-PC auszuführen (Pfad anpassen, falls anderswo installiert):

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. Aktualisierung

Das neue Installationsprogramm (<yyyymmdd>_AV_LicenseServer_x64.exe) auf dem Server-PC wie bei einer Erstinstallation ausführen: Sie überschreibt die ausführbaren Dateien, rührt aber nicht die vorhandene AV_LicenseServer.ini oder Code.txt an (Konfiguration und Aktivierung des Kunden bleiben unangetastet). Der Dienst wird gestoppt, die Dateien aktualisiert und der Dienst automatisch neu gestartet, sofern die entsprechende Aufgabe aktiviert bleibt.

10. Fehlerbehebung

11. Kurzreferenz

• Standardport: TCP 7788 (konfigurierbar in AV_LicenseServer.ini, Schlüssel Port).
• Name des Windows-Dienstes: AV_LicenseServer (in services.msc als „AV License Server" angezeigt).
• Typischer Installationsordner: C:\Program Files\AV License Server\.
• Hauptdateien: AV_LicenseServer.exe, AV_LicenseManager.exe, AV_LicenseServer.ini, Code.txt, AV_LicenseServer.log.
• Heartbeat-Timeout: standardmäßig 90 Sekunden (Schlüssel HeartbeatTimeoutSec).
• Testphase: 30 Tage ab dem Build des Clients, fest, nicht konfigurierbar.
• Warnung bei bevorstehendem Ablauf: standardmäßig 15 Tage (Schlüssel ExpiryWarningDays).
• Aufbewahrung der Protokolle: standardmäßig 15 Tage (Schlüssel LogRetentionDays).
• Ausgeliehene Lizenzen: standardmäßig höchstens 30 Tage (Schlüssel MaxBorrowDays, 0 = deaktiviert); Zustand in AV_LicenseServer.borrows gespeichert.
• Einzelplatzlizenz: %ProgramData%\AV_License\<Produkt>.lic (oder neben der ausführbaren Datei des Clients); kein License Server nötig (§7.2).