Skip to main content

FVA-Workbench KnowledgeBase

Lizenzserver

Mit einer Netzwerklizenz kann eine beliebige Anzahl von Benutzern im gleichen Netzwerk gemeinsam auf Produktlizenzen zugreifen. Das Programm "Lizenzserver", das auf einem Server installiert werden muss, steuert die Verteilung der Lizenzen an die Benutzer.

Der Lizenzserver kann im FVA Download-Center heruntergeladen werden.

Installationsvoraussetzungen

  • 64-Bit Windows Betriebssystem

  • Administratorrechte für den Zielrechner

  • 600 MB freier Festplattenspeicher

  • Port 5006 muss in der Firewall freigegeben sein (Eingehend)

  • Der Server verwendet das HTTP Protokoll und sollte daher aus Sicherheitsgründen nur im LAN/Intranet verwendet werden.

  • Schreibrechte im Installationsverzeichnis

Lizenzserver starten

Bei der Installation werden im angegebenen Verzeichnis die Ordner Application und Service angelegt. Der Lizenzserver kann über die Desktopverknüpfung oder im Order Application über die Datei LicServer.exe administriert werden

LicServer_exe.png

Anmelden

Beim ersten Start des Lizenzservers erscheint ein Anmeldedialog.

ErstAnmeldung.png
Tabelle 2. Anmeldedaten für die erste Anmeldung

Benutzername

admin

Passwort

pw

Server Adresse

"Hostname des Lizenz-Servers": "Portnummer"

Beispiel für Server Adresse

BLNSCR2033:5006 oder

194.234.501.200:5006 (IP-Adresse des Servers)



Hinweis

Das Administrator-Passwort sollte nach der ersten Anmeldung geändert werden.

Lizenzen auswählen

Über Lizenz hochladen können mehrere Lizenzen vom Dateityp .lic hinzugefügt werden. In der Übersicht werden für jede Lizenz folgende Informationen angezeigt:

  • ID der Lizenz

  • Maximale Nutzeranzahl

  • Anzahl der Nutzer, die die Lizenz aktuell verwenden

  • Bestelldatum

  • Ablaufdatum

  • Name des Lizenznehmers

Lizenzserver.png

Rechteverwaltung

profiles.png

Im Tab Benutzerverwaltung können einzelne Nutzerprofile angelegt werden. Es muss ein Nutzername und ein Passwort vergeben werden. Damit kann sich der Nutzer bei der Lizenzabfrage in der FVA-Workbench anmelden.

Hinweis

Mehrere Clients können sich über den gleichen Nutzernamen anmelden.

Derselbe Nutzer kann sich mehrmals über den gleichen Host anmelden.

Zusätzlich kann ein Host angelegt werden. Dabei wird zur Anmeldung bei der Lizenzabfrage der Computername verwendet. Es müssen keine Login-Daten eingegeben werden.

profileName.png

Der Computername kann auch ohne Domänensuffix angegeben werden.

FVA-Workbench mit Serverlizenz starten

Um die FVA-Workbench mit einer Floating-Lizenz (Server-Lizenz) zu starten, müssen beim Start folgende Parameter angegeben werden:

Tabelle 3. Anmeldedaten

Lizenztyp

Server-Lizenz

Servername:Port

"Hostname des Lizenz-Servers": "Portnummer"



Sind beide Felder ausgefüllt, kann eine Lizenz im Drop-Down Menü ausgewählt werden.

Die Login-Informationen müssen nur angegeben werden, wenn auf ein Nutzerprofil zugegriffen werden soll. Erfolgt eine Host-Anmeldung müssen keine Anmeldedaten angegeben werden.

startWorkbench.png

Lizenzserver Dienst

Bei der Installation des Lizenzservers wird ein Dienst mit dem Namen FVAWBLicenseService4.1 eingerichtet und im Hintergrund ausgeführt.

Der Dienst kann über das Microsoft Service Control Panel gestartet oder gestoppt werden. Um das Microsoft Service Control Panel zu starten, geben Sie im Windows Suchfeld in der Taskleiste den Befehl services.msc ein.

Monitoring von Sitzungen

Über den Tab "Monitoring" können alle aktiven Sitzungen verfolgt und bei Bedarf getrennt werden.

Die Benutzerstatistik kann im .json Format abgerufen werden, insofern es in den Einstellungen des Servers aktiviert wurde.

Für die Einstellung GET (Unautorisierter Zugriff):

  • Browser: http://"Servername":5006/licserver/stats

  • MS-PowerShell: Invoke-WebRequest http://"Servername":5006/licserver/stats

Für die Einstellung POST (Autorisierter Zugriff):

  • MS-PowerShell: Invoke-WebRequest http://"Servername":5006/licserver/stats -Method POST -Body @{user='admin';pwd='pw'}

Um das Ergebnis der Abfrage in einer Datei zu speichern, kann unter MS-PowerShell folgender Befehl verwendet werden:

  • MS-PowerShell: Invoke-WebRequest http://“Servername":5006/licserver/stats -OutFile C:\out.txt

Monitoring.png

Deinstallation

Bevor der Lizenzserver deinstalliert werden kann, sollte die LicServer.exe beendet werden. Anschließend kann der Server über „Programme und Features“ in der Systemsteuerung deinstalliert werden.

Alle Dateien, die nach der Installation unter C:\FVA\Lizenzserver_4.1_x64 erstellt wurden, bleiben nach der Deinstallation erhalten (z.B. hochgeladene Lizenzen und Einstellungen).

User-Migration bei Update des Lizenzservers

Um die Benutzer von Version 3.3.0/4.0.0 auf den Lizenzserver 4.1.0 zu übertragen, wird die ProfileStore.xml aus dem Installationsverzeichnis des alten Lizenzservers gesichert. (C:\FVA\FVA-Lizenzserver_3.3\Service\data) bzw. (C:\FVA\FVA-Lizenzserver_4.0\Service\data)

Anschließend wird diese Datei nach der Installation des Lizenzservers 4.1.0 in denselben Pfad des neuen Lizenzservers eingefügt.

HTTPS-Verschlüsselung einrichten

Ab Lizenzserver Version 4.2.0 und FVA-Workbench Version 9.0.0 kann die Datenübertragung zwischen Lizenzserver und FVA-Workbench optional über das HTTPS-Protokoll erfolgen.

Um Verbindungen über HTTPS zu ermöglichen, wird ein SSL-Zertifikat benötigt. Für die Verwendung im Intranet oder zu Testzwecken kann ein selbst signiertes Zertifikat erstellt werden.

Zertifikat erstellen

Eigenes Zertifikat erstellen

Das Programm keytool, das Teil der Java JRE ist, kann für die Erstellung verwendet werden. Das Keytool befindet sich im Installationsverzeichnis des Lizenzservers -> jre/bin. Folgende Dateien werden im Folgenden generiert:

  1. fvasslkeystore.jks (Keystore)

  2. localhost.cert (Zertifikat)

  3. clienttrust.jks (Truststore)

Eingabeauforderung im Installationsverzeichnis des Lizenzservers öffnen und folgende Befehle ausführen:

1. fvasslkeystore.jks

keytool -genkey -noprompt -trustcacerts -keyalg RSA -alias localcertificate -keypass changeit -keystore fvasslkeystore.jks -storepass changeit -dname CN=localhost

Der Domainname sollte der Server-Domain entsprechen (hier localhost).

Ausgabe: fvasslkeystore.jks

2. localhost.certlocalhost.cert

keytool -export -keystore fvasslkeystore.jks -alias localcertificate -file localhost.cert -storepass changeit

Ausgabe: clienttrust.jks

3. clienttrust.jks

keytool -import -v -trustcacerts -alias localcert -file localhost.cert -keystore clienttrust.jks -storepass changeit

Ausgabe: clienttrust.jks

Konfiguration

Konfiguration des Lizenzservers

1. Datei fvasslkeystore.jks in das Installationsverzeichnis des Lizenzservers/Services kopieren.

2. Die folgenden 2 Parameter zur Datei FVAWBLicenseService4.2.vmoptions im gleichen Verzeichnis hinzufügen:

-Djavax.net.ssl.keyStore=fvasslkeystore.jks
-Djavax.net.ssl.keyStorePassword=changeit

3. Die HTTP und HTTPS Ports können in der Datei Installationsverzeichnis/Service/data/config.ini angepasst werden:

internationalizing=en_en
[Startup]=
LogFileFolder=C\:\\InstallationTest\\Lizenzserver_4.1_x64\\Service/logs/
protocolUserSessions=false
Port=5006
StartupTime=Tue Jan 16 14\:47\:00 CET 2024-383
generateStatus=POST
Servlet=/licserver/lgt
Log-Filesize=30
HttpsPort=443

Anmerkung

  • Fehlt die HttpsPort Angabe wird kein https-Port geöffnet.

  • Fehlt die Port Angabe wird kein http-Port geöffnet.

4. Datei clienttrust.jks in das Installationsverzeichnis/Application kopieren.

5. Die folgenden 2 Parameter zur Datei LicServer.ini im gleichen Verzeichnis hinzufügen:

-Djavax.net.ssl.trustStore=clienttrust.jks
-Djavax.net.ssl.trustStorePassword=changeit

Konfiguration der FVA-Workbench

1. Datei clienttrust.jks in das Installationsverzeichnis der FVA-Workbench kopieren.

2. Die folgenden 2 Parameter zur Datei FVAWorkbench.ini im gleichen Verzeichnis hinzufügen:

-Djavax.net.ssl.trustStore=clienttrust.jks
-Djavax.net.ssl.trustStorePassword=changeit

Anmeldung am Lizenzserver

login_licserver_https.png

Im Anmeldedialog des Lizenzservers muss im Feld Serveradresse das https-Protokoll und der entsprechende Port angegeben werden.

Java-Laufzeitumgebung

Für den Betrieb des Lizenzservers ist eine Java-Laufzeitumgebung erforderlich. Diese wird standardmäßig mitinstalliert und befindet sich im Installationsverzeichnis im Ordner /jre.

Der Lizenzserver kann auch mit einer Laufzeitumgebung eigener Wahl gestartet werden. Dazu müssen die folgenden Dateien im Installationsverzeichnis angepasst werden:

  1. Installationsverzeichnis/Application/LicServer.ini

  2. Installationsverzeichnis/Service/FVAWBLicenseService4.2.vmoptions

In beiden Dateien muss der Eintrag ../jre/bin/javaw.exe durch den Pfad zur gewünschten Laufzeitumgebung ersetzt werden. Wird der Eintrag weggelassen, wird die im Betriebssystem hinterlegte Laufzeitumgebung verwendet.

Anmerkung

-vm 
../jre/bin/javaw.exe

Der Schlüssel -vm und der dazugehörige Pfad zur JRE müssen in aufeinanderfolgenden Zeilen stehen.

Checkliste zur Fehlerbehebung

Problem: Es kann keine Verbindung zum Lizenzserver hergestellt werden

  1. Überprüfen Sie ob der FVA Lizenzserver Dienst auf dem Server gestartet wurde. Starten Sie hierfür die Windows Anwendung services.msc.

  2. Überprüfen Sie die Version des gestarteten Lizenzserver Dienstes. Für den Lizenzserver 4.1 lautet der Dienstname FVAWBLicenseService4.1.

  3. Verbinden Sie sich mit dem FVA Lizenzserver Client und Ihren Anmeldedaten auf dem Lizenzserver.

  4. Kann keine Verbindung hergestellt werden, überprüfen Sie die Server-URL. Die Server-URL setzt sich folgendermaßen zusammen: serveradress:port/licserver/lgt (Beispiel: http://localhost:5006/licserver/lgt)

  5. Sind Sie sich nicht sicher welcher Port verwendet wird, können Sie ihn Port im Installationsordner des Lizenzservers einsehen bzw. ändern. Öffnen Sie hierfür im Installationsverzeichnis des Lizenzservers/Service/data die Datei config.ini. Unter dem Eintrag Port finden Sie die vom Lizenzserver verwendete Portnummer. Wenn Sie die Portnummer anpassen, müssen Sie den Dienst FVAWBLiceneService4.1 neu starten.

  6. Verbinden Sie sich mit dem FVA Lizenzserver Client. Kann weiterhin keine Verbindung hergestellt werden, versuchen Sie lokal auf dem Server eine Verbindung zum Lizenzserver mit der Addresse: http://localhost:port/licserver/lg herzustellen.

  7. Kann lokal eine Verbindung hergestellt werden aber nicht über einen Remote PC überprüfen Sie gegebenenfalls Ihre Firewall-Einstellungen bzw. die Portfreigabe des Servers.

Problem: Die Lizenz kann nicht auf den Lizenzserver hochgeladen werden

  1. Falls sie mehrere Lizenzserver installiert haben, überprüfen Sie ob der richtige Lizenzserver Dienst gestartet wurde. Für den Lizenzserver 4.1 ist das FVAWBLicenseService4.1.

  2. Starten Sie den Dienst FVAWBLicenseService4.1 neu.

  3. Öffnen Sie das Lizenzfile (.lic) und überprüfen Sie ob beim Eintrag TYPE der Wert FLOATING eingetragen ist.

  4. Öffnen Sie das Lizenzfile und überprüfen Sie ob der Hardware-KEY unter dem Eintrag HOST mit dem Key übereinstimmt den das Hardware Key Tool erzeugt.

  5. Trifft Punkt 3 oder 4 auf Sie zu, wenden Sie sich bitte an den Support. Wir stellen Ihnen eine neue Lizenz aus.

Problem: Die FVA-Workbench meldet nach dem installieren einer neuen Lizenz beim Verbinden Ungültige Lizenz.

  1. Bestätigen Sie das Meldungsfenster mit OK.

  2. Wählen Sie im nun erscheinenden Lizenzauswahldialog die neue Lizenz aus.