UniCon Software GmbH

UniCon 

Software GmbH 

Dokumentation 

FELICS 2.x 

Floating Extended Licence Server 

26.9.1997

Die Firma UniCon und die Autoren können für fehlerhafte Angaben und deren 

Folgen weder eine juristische noch irgendeine Haftung übernehmen. Für 

Verbesserungsvorschläge und Hinweise auf Fehler sind die Autoren dankbar. 

Die Autoren: 

Andreas Flick, Volker Milde und Klaus Straßner 

Die genannten Produktnamen sind eingetragene Warenzeichen der jeweiligen 

Hersteller. 

UniCon Software GmbH Karlsruhe

1997 UniCon Software GmbH 

Die vorliegende Dokumentation ist urheberrechtlich geschützt. Alle Rechte sind 

vorbehalten. Kein Teil dieser Dokumentation darf ohne unsere Genehmigung in 

irgendeiner Form kopiert werden. 

Technische Änderungen vorbehalten. 

Texte und Abbildungen wurden mit größter Sorgfalt erarbeitet. Wir können jedoch für 

eventuell verbliebene fehlerhafte Angaben und deren Folgen weder eine juristische 

Verantwortung noch irgendeine Haftung übernehmen. 

Die genannten Produktnamen sind eingetragene Warenzeichen der jeweiligen 

Eigentümer.

Vorwort 

Vielen Dank für Ihr Vertrauen und Ihre Entscheidung für UniCon Produkte. 

UniCon - Kommunikationsprodukte verbinden ein Höchstmaß an Funktionalität 

mit einem Höchstmaß an Bedienerkomfort. 

Damit Ihnen die Einarbeitung in diese Produkte und die tägliche Arbeit noch 

leichter von der Hand geht, haben wir dieses Handbuch entwickelt. Trotz der 

detaillierten technischen Beschreibungen in diesem Handbuch können nicht 

alle Fragen abgedeckt werden, insbesondere wenn Komponenten fremder 

Hersteller zur Kommunikation eingesetzt werden. In solchen Fällen nehmen 

Sie bitte Kontakt mit unserem qualifizierten Support auf. 

FELICS, der Floating Extended Licence Server, überwacht dynamisch die 

Nutzung von Software in Novell und TCP/IP-Netzwerken. Das Softwarepaket 

umfaßt die Client- und Serverkomponenten. Als Serverplattformen werden 

Netware-Server, Windows-NT, OS/2 sowie Unix-Systeme unterstützt. Die 

Clientsoftware ist auf Windows 3.x / 95 / NT, OS/2 und Unix verfügbar. 

Mit dem Konzept der Knotenlizenzierung (Software-Dongle) kann das 

Lizenzmanagement auch ohne zentralen Lizenzserver und ohne 

Netzwerkanbindung eingesetzt werden. 

Im Hinblick auf die Verfügbarkeit der Lizenzen stellt die Backup-Fähigkeit (ab 

Version 2.30) eine weitere wichtige Funktionalität dar. 

In diesem Handbuch sind Installation, Konfiguration, Bedienung und 

Schnittstellen für Softwareentwickler beschrieben.

INHALTSVERZEICHNIS 

1 Lizenzmanagement ..................................................................................1 

1.1 Mit FELICS..............................................................................................1 

1.2 Mit Knotenlizenzierung (Software-Dongle)..............................................2 

2 FELICS ......................................................................................................3 

2.1 Installation...............................................................................................4 

2.1.1 UNIX .........................................................................................4 

2.1.2 NOVELL-Server ........................................................................5 

2.1.3 Windows-NT .............................................................................5 

2.2 Starten und Beenden ..............................................................................6 

2.2.1 UNIX .........................................................................................6 

2.2.2 NOVELL....................................................................................7 

2.2.3 Windows-NT .............................................................................8 

2.3 Konfiguration (felics.ini)...........................................................................9 

2.4 Diagnose (felics.log)..............................................................................10 

2.5 Backup-Lizenzserver.............................................................................11 

3 FELICS-Tools..........................................................................................13 

3.1 Installation.............................................................................................13 

3.2 Lizenzierung mit FELICS ......................................................................14 

3.2.1 BRANDLI (Unix)......................................................................14 

3.2.2 REMBRAND (Windows) .........................................................18 

3.3 Monitoring mit FELICS ..........................................................................19 

3.3.1 RAMON (Unix) ........................................................................19 

3.3.2 WRAMON (Windows) .............................................................21 

3.4 Lizenzierung mit Knotenlizenzierung ....................................................22 

4 FELICS-Agent .........................................................................................23 

4.1 UNIX (felicscltd) ....................................................................................24 

4.2 Windows 3.x (ucwatch) .........................................................................25 

4.2.1 Installation...............................................................................25 

4.2.2 Automatische Installation WATCHPUB (Novell).....................26 

4.3 Windows NT (NTfelclt) ..........................................................................27 

4.3.1 Freiwillige Lizenzierung (NTclte).............................................29

4.4 Windows95 / Win32s (NTfelclt) ............................................................ 30 

4.4.1 Freiwillige Lizenzierung (NTclte) ............................................ 30 

5 FELICS-SDK ........................................................................................... 31 

5.1 Allgemeines Konzept............................................................................ 31 

5.2 Technisches Konzept ........................................................................... 32 

5.3 UNIX ..................................................................................................... 33 

5.3.1 Installation .............................................................................. 33 

5.3.2 Application Programmers Interface (API)............................... 34 

FELICS_init .................................................................... 34 

FELICS_quit ................................................................... 34 

FELICS_getlicence......................................................... 35 

FELICS_freelicence........................................................ 35 

5.3.3 Beispielprogramm .................................................................. 36 

5.4 WINDOWS 3.x ..................................................................................... 37 

5.4.1 Installation .............................................................................. 37 


FELICS_init .................................................................... 38 

FELICS_quit ................................................................... 38 



FELICS_sdkversion........................................................ 40 


5.5 WINDOWS-NT / 95 und Win32s .......................................................... 42 

5.5.1 Installation .............................................................................. 42 


FELICS_init .................................................................... 43 

FELICS_quit ................................................................... 43 



FELICS_sdkversion........................................................ 45 


5.6 Schlüsselgenerator WLIPRI (Windows) ............................................... 47 

5.6.1 DDE-Schnittstelle ................................................................... 48 

Abbildungsverzeichnis 

Index

UniCon Lizenzmanagement 

1 Lizenzmanagement 

FELICS basiert auf dem Client-Server-Konzept. Die zentrale Rolle spielt dabei 

der Lizenzserver, der auf dem jeweiligen Serversystem (Unix, Netware, 

Windows-NT) installiert ist und der die Lizenzvergabe überwacht. Auf jedem 

Client-Rechner existiert genau eine Instanz (FELICS-Agent), die eine 

Kommunikationsbeziehung zum Lizenzserver aufrechterhält. Jede 

lizenzierungspflichtige Anwendung auf einem Client-Rechner wendet sich an 

diesen Agenten. Der FELICS-Agent sollte deshalb beim Start des jeweiligen 

Client-Rechners aktiviert werden. 

1.1 Mit FELICS 

Der Einsatz eines zentralen Lizenzservers hat folgende Vorteile: 

• zentrale Verwaltung und Überwachung von Lizenzen 

• bedarfsgesteuerte Lizenzvergabe (floating licence) 

Lizenz Lizenz 

Lizenz 

FELICS-Agent 

FELICS 

licence.db 

Abbildung 1: Lizenzmanagement mit FELICS 

Lizenz Lizenz 

Lizenz 

FELICS-Agent 

Mit den FELICS-Tools stehen komfortable Werkzeuge zur Administration des 

Lizenzservers bereit. Die Anbindung eigener Software an den FELICS- 

Agenten ist mit dem FELICS-SDK einfach und problemlos. 

1

Lizenzmanagement UniCon 

1.2 Mit Knotenlizenzierung (Software-Dongle) 

Die Knotenlizenzierung ergänzt das bisherige Lizenzmanagement. Damit kann 

ggfs. auf den Einsatz eines zentralen Lizenzservers verzichtet werden, z.B. 

wenn kein Netzwerk vorhanden ist. Bei der Knotenlizenzierung übernimmt der 

FELICS-Agent die Lizenzvergabe und -überwachung: 

Die Eingabe von Lizenzen erfolgt mit den entsprechenden FELICS-Tools auf 

jedem Knotenrechner. Alle lizenzierungspflichtigen Anwendungen können 

diesen Lizenzierungsmodus uneingeschränkt und ohne Anpassung nutzen. 

2 

Lizenz Lizenz 

Lizenz 

FELICS-Agent 

Lizenz Lizenz 

Lizenz 

FELICS-Agent 

Abbildung 2: Lizenzmanagement mit Knotenlizenzierung

UniCon FELICS 

2 FELICS 

Mit dem Floating Extended Licence Server (FELICS) haben Sie die 

Möglichkeit, Software im Netz beliebig oft zu installieren, ohne Lizenzen zu 

erwerben. Beim Starten holen sich die Programme eine Berechtigung beim 

Lizenzserver. Dieser verwaltet die Lizenzen in seiner Lizenzdatenbank 

licence.db. 

Mit Hilfe der Programme REMBRAND (Windows) und BRANDLI (Unix) 

können Lizenzen in die Datenbasis eingetragen bzw. gelöscht werden. Hierfür 

ist ein Lizenzschlüssel notwendig, den Sie vom Lieferanten der 

entsprechenden Software erhalten. Wollen Sie die Anzahl der Lizenzen eines 

Produktes erhöhen, brauchen Sie nur den entsprechenden Schlüssel 

einzugeben. Der Lizenz-Server ist ohne erneutes Starten über die neue 

Anzahl der Lizenzen informiert. Haben Sie Softwareprodukte auf 

unterschiedlichen Rechnern installiert, können alle Produkte ihre Berechtigung 

an einem einzigen Server holen, vorausgesetzt, dieser ist über die 

Netzwerkprotokolle IP oder IPX zu erreichen. 

Mit der vorliegenden Version wurde auch die Möglichkeit der freiwilligen 

Lizenzierung geschaffen. Damit können Sie Lizenzen für Standardsoftware 

frei vergeben und jederzeit den Anforderungen anpassen. 

Wenn Sie sich für das Lizenzierungsmodell der Knotenlizenzierung (Software- 

Dongle) entschieden haben, benötigen Sie keinen Lizenzserver. In diesem 

Fall lesen Sie bitte weiter im Kapitel “FELICS-Tools”. 

3

FELICS UniCon 

2.1 Installation 

Da sich die Installationsprozeduren unter den verschiedenen Betriebssystemen 

unterscheiden, werden sie im folgenden getrennt beschrieben. 

2.1.1 UNIX 

Nach der Installation finden Sie alle Dateien im Verzeichnis '/usr/felics'. 

Die FELICS-Installationsdiskette liegt entweder im tar-Format oder im DOS- 

Format vor (für Unix-Rechner ohne eigenes Diskettenlaufwerk). 

Zum Installieren des Lizenz-Servers führen Sie folgende Schritte aus: 

Bei SUN-Sparc Systemen müssen Sie zuerst den Vol-Daemon mit dem kill- 

Kommando abschalten (kill vold). 

4 

tar-Diskette 

cd / 

tar xvf /dev/fd0 (bzw. Laufwerk wie bei Ihnen installiert) 

DOS-Diskette 

Senden Sie die Datei felics.tz (felicss.tz bei FELICS mit SDK) binär zu 

Ihrem Unix-Rechner. 

Dort rufen Sie folgende Kommandos auf: 

mv felics.tz felics.tar.Z 

uncompress felics.tar 

cd / 

tar xvf felics.tar 

cd /usr/felics 

./felics.install 

Wenn gewünscht, wird der Lizenzserver durch dieses Script automatisch 

gestartet. Der Start kann jedoch auch später erfolgen (siehe "Starten und 

Beenden").


2.1.2 NOVELL-Server 

Die Installation erfolgt mit Hilfe eines Windows-Programms. Dabei müssen 

das Novell-Systemverzeichnis (z.B. f:\system) und das FELICS- 

Arbeitsverzeichnis (z.B. f:\felics) angegeben werden. Das Arbeitsverzeichnis 

sollte auf der Systemplatte liegen. Während der Ausführung der Installation 

sind für beide Verzeichnisse Schreibrechte notwendig. Sie sollten deshalb als 

Supervisor bzw. Admin angemeldet sein. 

Führen Sie zur Installation folgende Schritte unter Windows aus: 

a:setup 

Das Installationsprogramm führt Sie durch die Installation. 

Nach korrekter Installation kann der Lizenzserver nun an der Konsole des 

Novell-Servers gestartet werden (siehe "Starten und Beenden"). 

2.1.3 Windows-NT 

Zur Installation benötigen Sie Schreibrechte im Windows-Verzeichnis bzw. im 

Windows-Systemverzeichnis. Außerdem müssen Sie berechtigt sein, NT- 

Dienste einzurichten. Führen Sie zur Installation folgende Schritte unter 

Windows-NT aus: 

a:setup 

Das Installationsprogramm führt Sie durch die Installation. 

Nach korrekter Installation ist der Lizenzserver als Dienst auf Ihrem NT-Server 

installiert worden. Aktivieren Sie in der Systemsteuerung das Symbol 

"Dienste". Markieren Sie den Dienst "FELICS" und stellen Sie unter der Option 

[Startart..] folgende Parameter ein: 

Startart 

[•] Automatisch 

Anmelden als 

[•] Systemkonto 

[•] interaktive Beziehung mit Desktop erlauben 

Der Start erfolgt ebenfalls über die Dienstverwaltung von Windows-NT (siehe 

"Starten und Beenden"). 

5


2.2 Starten und Beenden 

Durch das Beenden des Lizenzservers werden bereits erteilte Lizenzen nicht 

nachträglich entzogen. Bereits lizenzierte Programme laufen also unbehelligt 

weiter. 

Der Lizenzserver selbst muß mit einem Lizenzschlüssel freigeschaltet werden. 

Wenn dies noch nicht geschehen ist, startet FELICS im sogenannten 

'administration mode'. In diesem Fall geben Sie nach dem Start zunächst Ihre 

FELICS-Lizenz mit dem Programm BRANDLI (Unix) oder REMBRAND 

(Windows) ein (siehe Kapitel "Lizenzierung"). 

Wenn Sie die entsprechende FELICS-Lizenz noch nicht erworben haben, 

können Sie dennoch das SDK (Software Development Kit) testen (siehe 

Kapitel "SDK"). 

2.2.1 UNIX 

Der Lizenzserver kann nur mit root-Berechtigung gestartet bzw. beendet 

werden. Standardmäßig befindet sich der Lizenzserver unter /usr/felics. Wenn 

Sie ein anderes Arbeitsverzeichnis verwenden wollen, muß vor dem Start die 

Umgebungsvariable FELICSENV gesetzt werden. 

Starten: 

6 


./felics 

Beenden: 


./felics end 

Neustart: 


./felics restart


2.2.2 NOVELL 

Bevor Sie den Lizenzserver starten, vergewissern Sie sich, daß die System- 

NLM ipxs.nlm und spxs.nlm geladen sind. Geben Sie dazu einfach die 

Kommandos ‘load ipxs.nlm’ und ‘load spxs.nlm’ an der Konsole Ihres 

Novell-Servers ein. Der Start des Lizenzservers FELICS kann jetzt erfolgen: 

Starten: 

load felics 

Tragen Sie das Kommando in die Datei autoexec.ncf ein, um den 

Lizenzserver beim Systemstart automatisch zu laden. 

Das Arbeitsverzeichnis muß nur angegeben werden, wenn es vom 

Standardwert abweicht (/SYS:/FELICS). 

Beenden 

unload felics 

7


2.2.3 Windows-NT 

Das Starten und Beenden erfolgt über die Dienstverwaltung von Windows-NT. 

Aktivieren Sie innerhalb der Systemsteuerung das Symbol "Dienste" (oder 

"Services"). 

Starten: 

8 

In der angezeigten Liste markieren Sie den Dienst FELICS und 

betätigen den Schalter "Starten": 

Abbildung 3: FELICS-Dienst 

Bei korrektem Start des Lizenzservers wechselt der Status des 

Dienstes auf "Gestartet". 

Beenden: 

Das Beenden des Lizenzservers erfolgt analog mit dem Schalter 

"Beenden". 

Um den Lizenzserver aus der Dienstverwaltung zu löschen, rufen Sie das 

Programm mit dem Kommandozeilen-Parameter ‘remove’ auf: 

z.B.: c:\win32app\felics\ntfelics.exe remove


2.3 Konfiguration (felics.ini) 

Die Konfiguration des Lizenzservers wird durch die Textdatei felics.ini (früher 

felics.cnf) im FELICS-Arbeitsverzeichnis festgelegt. 

Folgende Parameter können gesetzt werden: 

Client-Überwachungsmechanismus 

Um den Absturz eines lizenzierten Programmes oder den Ausfall eines Client- 

Rechners (z.B. durch Abschalten) zu erkennen, fordert der Lizenzserver alle 

FELICS-Agenten in regelmäßigen Abständen auf, sich zu melden. Dieser 

sogenannte Alive-Mechanismus kann durch folgende Parameter konfiguriert 

werden: 

MAXALIVE= Bleibt diese Anzahl von Alive-Aufforderungen von einem 

Agenten unbeantwortet, so werden dessen Lizenzen 

wieder freigegeben. 

Standardwert ist MAXALIVE=3 . 

ALIVEFREQ= Intervall (in Sekunden), in dem die Alive-Aufforderungen 

an die Client-Rechner verschickt werden. Standardwert 

ist ALIVEFREQ=20 . 

Der maximale Zeitraum, den FELICS benötigt, um einen Ausfall zu erkennen, 

beträgt also MAXALIVE * ALIVEFREQ Sekunden. 

Diagnose 

Die Statusinformation, die FELICS laufend in die Datei felics.log (siehe Kapitel 

"Diagnose") protokolliert, kann zu Diagnosezwecken mit diesem Schalter 

erweitert werden: 

DEBUG= 0: keine erweiterte Ausgabe 

1: erweiterte Ausgabe in felics.log 

Backup-Funktion 

Der Backup-Server (siehe Kapitel „Backup-Lizenzserver“) gewährleistet die 

Verfügbarkeit der Lizenzen bei Ausfall des Master-Lizenzservers. Die 

folgenden Parameter werden nur von einem Backup-Server (FELICS mit 

FELICSB-Lizenz) verwendet. 

MFELICS= Hostname eines Master-FELICS, dessen Ausfall 

überwacht werden soll. Der Parameter kann mehrmals 

angegeben werden, d.h. ein Backup-Server kann 

PONG= 

mehrere Lizenzserver überwachen.. 

Zeitintervall (Sekunden), in dem der Ausfall des/der 

überwachten Master-Lizenzserver überprüft wird. 

Standardwert ist 20 Sekunden. 

Beispiel: felics.ini 

9


MAXALIVE=3 

ALIVEFREQ=20 

DEBUG=0 

Beispiel: felics.ini des Backup-Lizenzservers ucfelics3 

MAXALIVE=3 

ALIVEFREQ=20 

DEBUG=0 

MFELICS=ucfelics1 

MFELICS1=ucfelics2 

PONG=30 

RECONNECT=20 

2.4 Diagnose (felics.log) 

Solange der Lizenzserver aktiv ist, werden alle wichtigen Daten in die 

Textdatei felics.log im FELICS-Arbeitsverzeichnis protokolliert. Wenn diese 

Datei ihre maximale Größe erreicht hat, wird der Schreibvorgang wieder am 

Anfang fortgesetzt. 

Standardmäßig enthält die Datei nur die wichtigsten Ereignisse der 

Lizenzierung. Es kann in manchen Fällen jedoch sinnvoll sein, den erweiterten 

Modus zu aktivieren (siehe Kapitel "Konfiguration"). Sie erhalten dann 

ausführliche Status-Informationen des Lizenzservers. 

NOVELL 

Beachten Sie, daß die Datei im Novell-Umfeld nicht direkt eingesehen werden 

kann. Dies ist nur mit einer Kopie der Datei möglich: 

copy felics.log felics.txt 

edit felics.txt 

Windows-NT 

Hier haben Sie die Möglichkeit, alle Status-Informationen des Lizenzservers 

zusätzlich in das Fenster des Lizenzservers auszugeben. Geben Sie beim 

Start des FELICS-Dienstes den Startparameter 'show' an. 

10


2.5 Backup-Lizenzserver 

Mit der Version 2.30 wurde eine weitere wichtige Funktionalität in das 

bewährte Lizenzmanagement FELICS integriert. Die Verfügbarkeit der 

erworbenen Lizenzen, auch bei Ausfall des Lizenzservers, kann jetzt durch 

den Einsatz eines Backup-Lizenzservers jederzeit gewährleistet werden. Der 

Backup-Lizenzserver stellt eine zweite Instanz dar, die im Bedarfsfall die 

Arbeit des eigentlichen Lizenzservers übernimmt, bis dieser wieder 

einsatzbereit ist. 

Konzept 

Der Backup-Server wird auf einem zweiten Rechner installiert und gestartet. 

Dabei handelt es sich um die gleiche Software wie auf dem Primärsystem. Der 

Lizenzserver wurde jedoch durch eine FELICSB-Lizenz als Backup-Server 

konfiguriert. Durch den Parameter MFELICS in der Datei felics.ini (siehe 

Kapitel „FELICS-Konfiguration“) ist dem Backup-Lizenzserver der eigentliche 

Lizenzserver (Master-FELICS) bekannt. 

FELICS 

Der Backup-Server steht in 

ständigem Kontakt mit einem oder 

mehreren Master-Servern 

(eingetragen in felics.ini) und 

überwacht laufend deren 

Funktionsfähigkeit. Alle zur 

Lizenzvergabe notwendigen 

Informationen werden permanent 

vom Master-FELICS zum Backup- 

FELICS übermittelt. 

Der Ausfall des Master-FELICS wird vom Backup-Server in einer 

konfigurierbaren Zeit automatisch bemerkt (PONG-Parameter in felics.ini). 

FELICS 

Agent 

Agent 

Agent 

Agent 

FELICS 

Backup 

FELICS 

Backup 

Er verständigt zunächst alle 

Agenten und informiert sie über die 

neue Serveradresse. 

11


12 

Agent 

Agent 

FELICS 

Backup 

Die Agenten fordern von jetzt an alle 

Lizenzen vom Backup-Server an. Neu 

gestartete Agenten kennen den Backup- 

Server aufgrund ihrer eigenen lokalen 

Konfiguration. Der Agent versucht nach 

dem Start zuerst seinen Master-FELICS 

zu erreichen. Gelingt ihm das nicht, 

wendet er sich an den Backup-Server. 

Der Backup-Server fungiert jetzt als vollwertiger Lizenzserver. Es können 

Lizenzen mit REMBRAND oder BRANDLI eingetragen oder gelöscht werden. 

Für andere Master-Lizenzserver steht der Backup-Server jedoch nicht mehr 

zur Verfügung. In dieser Situation prüft der Backup-Server jede Minute, ob der 

Master-FELICS wieder einsatzbereit ist. 

Wird der ursprüngliche Master-FELICS wiedererkannt, werden alle Lizenz- 

Statusinformationen an diesen übermittelt, die Agenten werden verständigt, 

der Lizenzserver geht wieder in den Backup-Modus. 

Konfiguration 

Alle Lizenz-Komponenten (FELICS und FELICS-Agenten) müssen in der 

Version 2.30 oder höher vorliegen. Der Master-FELICS benötigt keine 

Änderung seiner Konfiguration. Der Backup-Server ist auf auf einem zweiten 

Rechner zu installieren und mit einer FELICSB-Lizenz auszurüsten. In seiner 

Konfigurationsdatei felics.ini sind die Eintragungen MFELICS und PONG 

anzupassen (siehe „FELICS-Konfiguration“). Beim Start des Backup- 

Lizenzservers muß der Master-FELICS erreicht werden können. 

In die Konfiguration der FELICS-Agenten wird der Backup-Server an 

entsprechender Stelle hinzugefügt (siehe „FELICS-Agent“ ).

UniCon FELICS-Tools 

3 FELICS-Tools 

Diese Programme ermöglichen Ihnen den komfortablen Zugang zu den 

Informationen des Lizenzservers FELICS. Sie gestatten den Zugriff auf die 

Lizenzdatenbank (BRANDLI, REMBRAND, WBRANDLI) oder helfen bei der 

Ermittlung des aktuellen Lizenzbedarfs (RAMON, WRAMON). Die FELICS- 

Tools enthalten ebenso das FELICS-SDK für Windows 3.x zur Anbindung 

eigener Software an den Lizenzserver. 

Sie können sich bei Installation der FELICS-Tools für das Lizenzmodell der 

Knotenlizenzierung (Software-Dongle) entscheiden, wenn Sie ein Lizenzmanagement 

ohne zentralen Lizenzserver FELICS und ohne Netzwerkanbindung 

einsetzen wollen (siehe Kapitel „Lizenzmanagement“). 

3.1 Installation 

Die Programme RAMON und BRANDLI sind im Lieferumfang des 

FELICS/Unix enthalten (siehe "FELICS-Installation"). 

Installieren Sie die Windows-Komponenten mit Hilfe des Installationsprogramms 

auf der FELICS-Tools - Diskette: 

a:setup 

Sie benötigen auf Ihrem PC eine Netzwerkunterstützung mit TCP/IP- 

Winsockets oder Netware (nicht bei Knotenlizenzierung). 

Das Installationsprogramm erzeugt die Programm-Gruppe "FELICS-Tools" mit 

den entsprechenden Programmsymbolen. 

13

FELICS-Tools UniCon 

3.2 Lizenzierung mit FELICS 

Das FELICS-Lizenzmanagement unterscheidet zwischen Pflichtlizenzen und 

freiwilligen Lizenzen. Pflichtlizenzen sind Lizenzen, die Sie von einem 

Softwareproduzenten für dessen Produkt erwerben. Diese Lizenzen erhalten 

Sie in Form eines Lizenzschlüssels. 

Freiwillige Lizenzen vergibt der Systemadministrator für Standardsoftware, um 

deren Einsatz zu begrenzen. Diese Lizenzen können beliebig erhöht oder 

verringert werden. 

3.2.1 BRANDLI (Unix) 

Mit BRANDLI steht Ihnen ein leistungsfähiges UNIX-Programm zur Verfügung, 

welches Ihnen die komfortable Eingabe von Pflichtlizenzen in Form von 

Lizenzschlüsseln erlaubt. 

Aufruf: /usr/felics/brandli 

Nach dem Start (die Ausführung ist nur mit root-Berechtigung möglich) 

erhalten Sie folgende Maske: 

Abbildung 4: BRANDLI-Hauptmenü 

14


Um ein Produkt zu lizenzieren, wählen Sie "L". Sie werden dann zur Eingabe 

des Schlüssels aufgefordert: 

Abbildung 5: BRANDLI - Eingabe Produkt-Schlüssel 

Bei korrekter Eingabe des Schlüssels erhalten Sie folgende Bestätigung: 

15


Abbildung 6: BRANDLI Lizenz-Bestätigung 

Ist ein Lizenzserver aktiv, wird er von BRANDLI unmittelbar über die Änderung 

informiert. 

BRANDLI ist außerdem in der Lage, die Einträge der Lizenzdatenbank 

anzuzeigen und damit eine komplette Übersicht aller erworbenen Lizenzen zu 

bieten. Sie erreichen dies durch Auswahl "D" des Hauptmenüs: 

16


Abbildung 7: BRANDLI-Produktübersicht 

17


3.2.2 REMBRAND (Windows) 

Mit REMBRAND verwalten Sie von Ihrem Windows-Arbeitsplatz Ihre 

Pflichtlizenzen und freiwilligen Lizenzen. Starten Sie das Programm über das 

Programmsymbol der Programmgruppe FELICS-Tools. Stellen Sie jedoch 

sicher, daß der Lizenzserver gestartet wurde. 

Abbildung 8: REMBRAND 

Wichtig: Sie können freiwillige Lizenzen nur dann vergeben, wenn Sie über 

eine FELICSE-Lizenz (FELICS für Endanwender) verfügen. 

REMBRAND verfügt über eine ausführliche Online-Hilfe, der Sie weitere 

Erläuterungen entnehmen können. 

18


3.3 Monitoring mit FELICS 

Die Monitorprogramme RAMON(Unix) und WRAMON(Windows) informieren 

Sie laufend über den aktuellen Lizenzbedarf. Beide Programme setzen einen 

aktiven Lizenzserver voraus. 

3.3.1 RAMON (Unix) 

RAMON (Running Application MONitor) ist ein Zusatzprodukt, um laufende 

Applikationen zu "beobachten". Zur Freischaltung dieses Produktes 

benötigen Sie einen Lizenzschlüssel. 

Geben Sie folgendes Kommando ein: 

/usr/felics/ramon 

Es erscheint folgende Maske: 

Abbildung 9: RAMON-Infofenster 

Mit dem Kommando "m" kommen Sie in den Monitor-Modus. RAMON 

aktualisiert sich automatisch. 

19


Wählen Sie zwischen zwei Darstellungen mit der Funktion Option "o": 

1. alle aktiven Applikationen und zusätzliche Information wie z.B. 

Stationsname und Hostname, auf dem die Applikation aktiv ist. 

2. Die Anzahl aller aktiven Applikationen nach Applikation sortiert und die 

Auslastung der erworbenen Lizenzen. 

Abbildung 10: RAMON-Monitorfenster 

Mit dem Kommando "q" verlassen Sie den Monitor. 

20


3.3.2 WRAMON (Windows) 

Mit WRAMON (Windows Running Application MONitor) "beobachten" Sie 

laufende Applikationen und ermitteln so den genauen Bedarf Ihrer Lizenzen. 

Starten Sie WRAMON mit dem Programmsymbol in der Programmgruppe 

"FELICS-Tools". Stellen Sie vorher sicher, daß der Lizenzserver gestartet 

wurde. 

Abbildung 11: WRAMON 

WRAMON ist mit einer umfassenden Online-Hilfe ausgerüstet, die Ihnen die 

Funktionen genau erläutert. 

21


3.4 Lizenzierung mit Knotenlizenzierung 

Bei der Knotenlizenzierung (Software-Dongle) werden die Lizenzschlüssel 

lokal auf jedem Knotenrechner mit Hilfe des Programms WBRANDLI in die 

Datei ucwatch.ini eingetragen. Die Lizenzschlüssel, die Sie erhalten haben, 

sind nur für den jeweiligen Knotenrechner (identifiziert durch die Host-ID) 

gültig. Sie erhalten die Host-ID Ihres Rechners, indem Sie das Programm 

UCHOSTID der FELICS-Tools aufrufen. Auch WBRANDLI zeigt die Host-ID in 

der Titelzeile an: 

Abbildung 12: Lizenzierung mit WBRANDLI 

Wählen Sie 

[Neu] um eine Lizenz in Form eines Lizenzschlüssels einzugeben. Sie 

können den zugehörigen Produktnamen selbst bestimmen. Die 

Lizenzen stehen unmittelbar nach der Eingabe zur Verfügung. 

[Ändern] um den Produktnamen zu ändern; 

[Löschen] um die Lizenzen eines Produkts zu löschen; 

[Beenden] um das Programm zu beenden. 

Wichtig: Jeder Knotenrechner muß durch Eingabe einer FELICSN-Lizenz 

(Produkt-Id 66) freigeschaltet werden. 

22

UniCon FELICS-Agent 

4 FELICS-Agent 

FELICS basiert auf dem Client-Server-Konzept. Die zentrale Rolle spielt dabei 

der Lizenzserver, der auf dem jeweiligen Serversystem (Unix, Netware, 

Windows-NT) installiert ist. Auf jedem Client-Rechner existiert genau eine 

Instanz (FELICS-Agent), die eine Kommunikationsbeziehung zum Lizenzserver 

aufrechterhält. Jede lizenzierungspflichtige Anwendung auf einem 

Client-Rechner wendet sich an diese Instanz. Der FELICS-Agent sollte 

deshalb beim Start des jeweiligen Client-Rechners aktiviert werden. 

Windows-PC Unix 

Anwendung 

Produkt-Id x 

Anwendung 

Produkt-Id y 

UDP/IP 

IPX 

Anwendung 

Produkt-Id x 

Novell / Unix 

licence.db 

msgqueue 

ucwatch watch.dll felicscltd 

FELICS 

Abbildung 13: FELICS-Agenten 

Anwendung 

Produkt-Id y 

23

FELICS-Agent UniCon 

4.1 UNIX (felicscltd) 

Sie erhalten den FELICS-Agenten entweder bei Installation des FELICS-SDK 

oder zusammen mit der Software von Fremdherstellern, die ihre Software mit 

FELICS schützen. Der Agent übernimmt die komplette Kommunikation mit 

FELICS. Wir empfehlen deshalb, den Dämon beim Systemstart zu aktivieren 

(in /etc/rc). 

Programmparameter: 

felicscltd -s -k -d 

-s geben Sie hier den Hostnamen Ihres Lizenzservers an. 

Sofern Sie einen Backup-Lizenzserver einsetzen, muß dieser 

ebenfalls angegeben werden( z.B. felicscltd -s ucfelics -s ucfelicsb) 

-k optionale Angabe eines Message-Queue-Keys. Standardmäßig wird 

FELICS_MSQ (siehe FELICS-SDK/UNIX) verwendet. 

-d schaltet die Traceausgabe des Agenten ein. Die Trace-Konfiguration 

erfolgt in der Datei /usr/felicscltd.cnf. Beispiel: 

TRACEFILE = 

TRACELEVEL= 

TRACEFILE_COUNT= 

TRACEFILE_SIZE= 

Beispiel: 

TRACEFILE = felicscltd.log 

TRACELEVEL = 5 

TRACEFILE_COUNT = 2 

TRACEFILE_SIZE = 500000 

Wichtig: Der FELICS-Agent kann nur unter root-Berechtigung gestartet 

werden. 

Sollte es notwendig sein, den Dämon zu beenden, ist dies mit einem Signal 

15 möglich. 

24


4.2 Windows 3.x (ucwatch) 

Neben der Server-Komponente (FELICS) ist auf jedem PC, der in das 

Lizenzmanagement eingebunden werden soll, der FELICS-Agent UCWATCH 

zu installieren. UCWATCH unterrichtet Ihren Lizenzserver über Ereignisse, die 

für die freiwillige Lizenzierung von Bedeutung sind (z.B. Starten und Beenden 

von Windows-Applikationen). Sollte es zu einer Lizenzüberschreitung 

kommen, wird der Anwender über ein Meldungsfenster informiert. 

UCWATCH setzt voraus, daß der PC über eine Netzwerkanbindung mit 

TCP/IP-Winsockets oder SPX/IPX-Netware verfügt. 

Alternativ können Sie sich bei der Installation auch für die Knotenlizenzierung 

(Software-Dongle) entscheiden. Hier wird auf die Verwendung eines 

Lizenzservers und einer Netzwerkanbindung verzichtet. Der Agent übernimmt 

dann das Lizenzmanagement selbst. 

4.2.1 Installation 

Der FELICS-Agent ist in den FELICS-Tools enthalten und wird mit diesem 

Installationsprogramm installiert. Dabei werden die UCWATCH-Programmteile 

in das FELICS-Tools-Verzeichnis kopiert: 

watch.dll: Dynamische Funktions-Bibliothek 

ucwatch.exe: Agent 

toolhelp.dll: Windows-Werkzeugbibliothek 

ucwatch.ini: Konfigurationsdatei 

Vor dem ersten Start des Agenten muß der Name des Lizenzservers (und 

ggfs. der des Backup-Servers) in der Konfigurationsdatei ucwatch.ini (im 

Windowsverzeichnis) eingetragen werden (nicht bei Modus Knotenlizenzierung): 

Beispiel ucwatch.ini (Agent mit FELICS): 

[UCWATCH] 

FELICS=192.92.1.1 primärer Lizenzserver 

FELICS1=192.92.1.5 1. Backup-Server (optional) 

FELICS2=192.92.1.6 2. Backup-Server (optional) 

: 

oder 

[UCWATCH] 

FELICS=NWSERVER 

25


Stellen Sie nun sicher, daß das Programm ucwatch.exe beim Start von 

Windows automatisch gestartet wird (Eintrag in win.ini): 

Beispiel win.ini: 

[windows] 

run=UCWATCH.EXE 

Starten Sie Windows neu. 

4.2.2 Automatische Installation WATCHPUB (Novell) 

Im Novell-Umfeld besteht die Möglichkeit, den im Kapitel "Installation" 

beschriebenen Vorgang zu automatisieren. Mit Hilfe des Programms 

watchpub.exe werden die UCWATCH-Dateien beim Login-Vorgang des 

Benutzers in dessen Windows-Verzeichnis kopiert und die win.ini modifiziert. 

Aufruf: watchpub -w -u 

-w das angegebene Arbeitsverzeichnis muß folgende Dateien enthalten: 

ucwatch.ini, ucwatch.exe, watch.dll, toolhelp.dll 

-u die Änderungen in der win.ini des Aufrufers werden wieder 

rückgängig gemacht. 

Folgende Vorgehensweise wird empfohlen: 

• Kopieren Sie zunächst die UCWATCH-Programmteile und das Programm 

watchpub.exe in ein geeignetes Novell-Serverzeichnis 

(z.B. /SYS:/PUBLIC/WATCH). 

• Editieren Sie dort die Datei ucwatch.ini wie im Kapitel "Installation" 

beschrieben. 

• Tragen Sie watchpub.exe in das System-Loginscript ein: 

#/sys:/public/watch/watchpub -w /sys:/public/watch 

Watchpub.exe kann ohne Folgen mehrfach aufgerufen werden. 

26


4.3 Windows NT (NTfelclt) 

Ebenso wie der Lizenzserver selbst wird der FELICS-Agent als NT-Dienst 

eingerichtet. Die Installation erfolgt mit dem FELICS-Installationsprogramm. 

Vor dem ersten Start des Agenten ändern Sie die Startart des Dienstes wie 

folgt: 

Startart 

[•] Automatisch 

Anmelden als 

[•] Systemkonto 

[•] interaktive Beziehung mit Desktop erlauben 

Abbildung 14: FELICS-Agent Dienst 

Danach kann der Dienst mit der Dienstverwaltung von Windows-NT gestartet 

und beendet werden. Wir empfehlen die Startart "Automatisch" zu verwenden, 

damit der Agent beim Systemstart aktiviert wird. 

27


Der FELICS-Agent wird in der Datei UCWATCH.INI im Windowsverzeichnis 

konfiguriert. Dort geben Sie, soweit durch die Installation noch nicht 

geschehen, den Namen des Lizenzservers und ggfs. den Namen des Backup- 

Lizenzservers an: 

Beispiel ucwatch.ini: 

[UCWATCH] 

FELICS=ntserver primärer Lizenzserver 

FELICS1=ntserver2 1. Backup-Server (optional) 


: 

SHOW= 

Wenn Sie sich bei Installation des FELICS-Agenten für die Knotenlizenzierung 

entschieden haben, verwendet der Agent diese Ini--Datei zur Speicherung der 

erworbenen Lizenzen, der Name des Lizenzservers wird ignoriert. 

Dienst-Startparameter: 

show Zu Debug-Zwecken wird der FELICS-Agent sichtbar. 

Kommandozeilen-Parameter: 

Aufruf: ntfelclt.exe [ remove | install ] 

install installiert die Exe-Datei als FELICS-Agent-Service. 

Die Exe-Datei muß mit vollständigem Pfad angegeben werden. 

Beispiel: 

ntfelclt.exe install c:\win32app\felics\ntfelclt.exe 

remove löscht den FELICS-Agent-Dienst aus der Dienstverwaltung von 

Windows-NT. 

ntfelclt.exe remove 

28


4.3.1 Freiwillige Lizenzierung (NTclte) 

Mit Hilfe des Zusatzprogramms NTCLTE kann der FELICS-Agent zur Überwachung 

und Lizenzierung von Standard-Software (Winword, Access usw.) 

eingesetzt werden. NTCLTE überwacht den Aufruf jeder Windows-Anwendung 

und fordert ggfs. eine Lizenz an. Kommt es zu einer Lizenzüberschreitung, so 

wird der Anwender durch ein Mitteilungsfenster informiert und die Ausführung 

der Windows-Anwendung wird abgebrochen: 

Abbildung 15: Lizenzüberschreitung 

Aufruf: ntclte 

Der Aufruf sollte im Login-Skript des Benutzers erfolgen. Das Programm setzt 

einen laufenden FELICS-Agenten (Ntfelclt) voraus und ist für den Anwender 

nicht sichtbar. 

Windows-Applikationen werden anhand ihres Modulnamens (z.B. 

MSACCESS) identifiziert und lizenziert (siehe REMBRAND). Zur Ermittlung 

des Modulnamens einer Windows-Anwendung kann das Programm 

NTWINAPP verwendet werden, das mit dem FELICS-Agenten geliefert wird. 

Hinweis: Die FELICS-E Funktion muß auf dem Lizenzserver durch einen 

Lizenzschlüssel freigeschaltet werden. 

29


4.4 Windows95 / Win32s (NTfelclt) 

Unter Windows95 / Win32s kann der FELICS-Agent/NT verwendet werden, 

die Installation erfolgt demnach mit dem FELICS/NT-Installationsprogramm. 

Der Agent kann allerdings nicht als Dienst eingerichtet werden, sondern sollte 

in die Autostart-Gruppe aufgenommen werden. Beim Aufruf muß der 

Parameter ‘noservice’ angegeben werden: 

Aufruf: ntfelclt.exe /noservice 

Der FELICS-Agent wird in der Datei UCWATCH.INI im Windowsverzeichnis 

konfiguriert. Dort geben Sie, soweit durch die Installation noch nicht 

geschehen, den Namen des Lizenzservers (und ggfs. den des Backup- 

Servers) an: 

Beispiel ucwatch.ini: 

[UCWATCH] 

FELICS=ntserver primärer Lizenzserver 



: 

SHOW= 

Wenn Sie sich bei Installation des FELICS-Agenten für die Knotenlizenzierung 

entschieden haben, verwendet der Agent diese Ini--Datei zur Speicherung der 

erworbenen Lizenzen, der Name des Lizenzservers wird dann ignoriert. 

4.4.1 Freiwillige Lizenzierung (NTclte) 

Der FELICS-Agent übernimmt auch die Lizenzierung der Standardsoftware 

(Winword, Access ...). Dazu muß zusätzlich das Programm NTCLTE gestartet 

werden (siehe „Windows-NT -> Freiwillige Lizenzierung“). 

30

UniCon FELICS-SDK 

5 FELICS-SDK 

5.1 Allgemeines Konzept 

Mit dem Floating Extended Licence Server (FELICS) haben Sie die 

Möglichkeit, Software im Netz beliebig oft zu installieren, ohne Lizenzen zu 

erwerben. Beim Starten holt sich die Anwendung über den FELICS-Agenten 

eine Berechtigung beim Lizenz-Server. 

Zur dynamischen Lizenzierung wertet der Lizenzserver die Lizenzdatenbank 

aus. Diese enthält die Informationen zu allen lizenzierten Produkten. Die 

Aufnahme der Lizenzen in die Datenbank erfolgt durch den Endanwender mit 

Hilfe eines Lizenzschlüssels. Der Schlüssel beinhaltet eine Produkt-Id, die 

Anzahl der Lizenzen und ggfs. die Dauer der Gültigkeit der Lizenzen. Nur der 

Hersteller der Software ist in der Lage, für die entsprechende Produkt-Id 

Schlüssel zu generieren (siehe Kapitel „Schlüsselgenerator“). Produkt-Ids sind 

weltweit eindeutig und werden von UniCon vergeben. Ein Lizenzschlüssel ist 

nur für den Server/Node gültig, für den er generiert wurde. 

UniCon 

Produkt- 

Freigabe 

Software-Hersteller Kunde 

Freigabe-Schlüssel WLIPRI 

FELICS-Schlüssel 

Abbildung 16: Schlüsselübermittlung 

Lizenz-Schlüssel 

FELICS-Schlüssel 

BRANDLI / 

REMBRAND 

licence.db 

FELICS 

Werden weitere Lizenzen geordert, kann der Endbenutzer mit einem neuen 

Schlüssel im laufenden Betrieb des Lizenzservers die Lizenzanzahl für sein 

Produkt aktualisieren. 

Die lizenzierungspflichtige Applikation (Client) holt bei FELICS (Lizenz-Server) 

eine Startberechtigung ein und gibt beim Beenden die Lizenz wieder frei. 

Solange die Anwendung aktiv ist, ist die Lizenz vergeben. Nach Freigabe der 

Lizenz steht diese netzwerkweit wieder zur Verfügung. Die Kommunikation 

zwischen Applikation und Lizenzserver wird von dem FELICS-Agenten 

komplett übernommen. 

31

FELICS-SDK UniCon 

Wird die Applikation unsachgemäß beendet, z.B durch Abschalten des Client- 

Rechners, wird nach einer konfigurierbaren Zeit die Lizenz automatisch 

freigegeben. 

Wird der Lizenz-Server beendet, bleiben die laufenden Applikationen davon 

unberührt. Nach Neustart des Lizenz-Servers werden die aktiven 

Applikationen automatisch wiedererkannt. 

5.2 Technisches Konzept 

Auf jedem Client-Rechner existiert genau eine Instanz (FELICS-Agent), die 

eine Kommunikationsbeziehung zum Lizenzserver aufrechterhält. Jede 

lizenzierungspflichtige Anwendung auf einem Client-Rechner wendet sich 

über das SDK an diese Instanz, die dafür folgende Dienste zur Verfügung 

stellt: 

INIT: Initialisiert die Kommunikation zum Agenten und zum 

Lizenzserver 

GETLICENCE: Fordert eine Lizenz für eine Produkt-Id an 

FREELICENCE: Gibt die Lizenz einer Produkt-Id wieder frei 

QUIT: Beenden der Kommunikationsbeziehung zum Agenten 

Der Lizenzserver überwacht in einem konfigurierbaren Intervall alle FELICS- 

Agenten und damit alle Anwendungen (ALIVE-Mechanismus). Werden 

Anwendungen bzw. komplette Clients unsachgemäß beendet (z.B Programmbzw. 

Systemabsturz), schaltet der Lizenzserver alle entsprechenden Lizenzen 

wieder frei. 

Bei einem Systemabsturz des Server-Rechners werden nach dem 

Wiederanlauf alle aktiven Lizenzen netzwerkweit erkannt und eingetragen. 

Laufende Applikationen werden dadurch nicht beeinträchtigt. 

Hinweis: Nach Installation des SDK können Sie zunächst die Produkt-Id 

4711 (DEMO-Produkt) für Ihre eigenen Anwendungen verwenden. 

FELICS stellt für dieses Produkt 2 Lizenzen zu Testzwecken zur 

Verfügung. 

32


5.3 UNIX 

Das SDK unter Unix umfaßt derzeit folgende Komponenten: 

Software-Entwicklung: 

wlipri: Schlüsselgenerator für Produktschlüssel 

(WINDOWS) 

felicslib.a: Funktions-Bibliothek (UNIX) 

felicslib.h: Header-File (UNIX) 

felicscltd: FELICS-Agent (UNIX) 

sdkbsp.c: Beispielprogramm (UNIX) 


Bevor Sie die Installation vornehmen, vergewissern Sie sich, daß der 

Lizenzserver aktiv ist. Sofern Sie noch keinen FELICS-Lizenzschlüssel 

erworben haben, verwenden Sie bei der Programmierung die Produkt-Id 4711 

(DEMO-Produkt). FELICS vergibt dafür 2 Lizenzen. 

Die Installation der Unix-Komponenten erfolgt innerhalb der FELICS- 

Installation (siehe Kapitel "FELICS-Installation"). Alle Dateien werden dabei in 

das Verzeichnis /usr/felics kopiert. Anschließend kopieren Sie die für die 

Softwareentwicklung wichtigen Dateien (felicslib.a, felicslib.h) in die entsprechenden 

Verzeichnisse und starten den FELICS-Agenten felicscltd (siehe 

Kapitel "felicscltd"). 

Mit dem Schlüsselgenerator WLIPRI (Windows) können Sie für Ihre Produkte 

Lizenzschlüssel erzeugen (siehe Kapitel "Schlüsselgenerator WLIPRI"). Dafür 

empfehlen wir die Einrichtung eines Windows-Programmsymbols zum Start 

mit dem entsprechenden Arbeitsverzeichnis. 

33


5.3.2 Application Programmers Interface (API) 

Die Bibliothek "felicslib.a" ermöglicht jeder Anwendung die einfache und 

komfortable Kommunikation mit dem Lizenzserver FELICS über den FELICS- 

Agenten. Prototypen und Konstanten sind in felicslib.h enthalten. 

Wichtig: Vor der Benutzung ist sicherzustellen, daß der FELICS-Agent unter 

Unix aktiv ist (z.B. beim Systemstart durch rc-File starten). 

FELICS_init 

Prototyp: extern int FELICS_init ( unsigned long msg ) 

Parameter: msg: Message-Queue-Key, wird für die Kommunikation 

mit dem FELICS-Agenten unter Unix benötigt (z.B 

FELICS_MSQ). 

Rückgabewert: 0: ok 

2: Lizenzserver nicht erreichbar 

-1: Fehler kann über errno abgefragt werden 

Beschreibung: 

Die Funktion muß zur Initialisierung der Kommunikationsbeziehung der 

Anwendung zum FELICS-Agenten aufgerufen werden. Die Adresse des 

Lizenzservers wird durch den Agenten bestimmt. 

FELICS_quit 

Prototyp: extern void FELICS_quit ( void ) 

Parameter: - 

Rückgabewert: - 

Beschreibung: 

Die Verbindung zum FELICS-Agenten wird wieder aufgehoben, die 

Ressourcen werden freigegeben. Alle Lizenzen, die zu diesem Zeitpunkt 

durch die Anwendung (Prozeß) noch nicht freigegeben wurden, werden 

automatisch freigegeben. 

34


FELICS_getlicence 

Prototyp: 

extern int FELICS_getlicence ( unsigned long productid, char *text ) 

Parameter: productid: Produktidentifikator 

text: zusätzlicher Text, der die Anwendung 

beschreibt. Der Text muß innerhalb einer 

Anwendung eindeutig sein 

( z.B. "Sitzung 1" ). 

Max. Länge: FELICS_MAXTEXT. 


1: Keine Lizenz mehr verfügbar 



Beschreibung: 

Veranlaßt den FELICS-Agenten, die gewünschte Lizenz für die Anwendung zu 

belegen. Die Lizenz bleibt solange belegt, bis die Funktion 

FELICS_freelicence oder FELICS_quit aufgerufen wird. Kann die Lizenz nicht 

belegt werden, bleibt der Anwendung die Reaktion darauf freigestellt 

(Benutzerausgaben, Terminieren usw.). 

FELICS_freelicence 

Prototyp: 

extern int FELICS_freelicence ( unsigned long productid, char *text ) 


text: zusätzlicher Text, der beim 

FELICS_getlicence verwendet wurde. 




Beschreibung: 

Die spezifizierte Lizenz wird wieder freigegeben. 

35


5.3.3 Beispielprogramm 

Das folgende Beispiel veranschaulicht die Einfachheit der Lizenzanforderung 

und Lizenzfreigabe: 

#include 

#include 

#include 

#include "felicslib.h" 

int main (void); 

int main() 

{ 

int rc; 

char buf[FELICS_MAXTEXT]; 

rc = FELICS_init(FELICS_MSQ); 

switch (rc) { 

case -1: 

perror("FELICS_init"); 

exit(1); 

case 2: 

fprintf(stderr, "FELICS not running!\n"); 

exit(1); 

case 0: 

break; 

} 

sprintf(buf, "Hallo Test from FELICS-SDK (%d)", getpid()); 

rc = FELICS_getlicence(4711L, buf); 

switch(rc) { 

case -1: 

perror("Error from FELICS_getlicence "); 

FELICS_quit(); 

exit(1); 

case 0: 

fprintf(stderr, "got licence\n"); 

break; 

case 1: 

fprintf(stderr, "no free licence\n"); 


exit(0); 

case 2: 

fprintf(stderr, "FELICS not available\n"); 


exit(0); 

break; 

} 

/* do your work here */ 

sleep (10); 

if (FELICS_freelicence(4711L, buf) < 0) { 

perror("Error from FELICS_freelicence"); 


exit(1); 

} 


return 0; 

} 

36


5.4 WINDOWS 3.x 

Das SDK unter Windows 3.x umfaßt folgende Komponenten: 

Software-Entwicklung: 

wlipri: Schlüsselgenerator für Produktschlüssel 

(WINDOWS) 

watch.dll: Dynamische Funktions-Bibliothek (WINDOWS) 

watch.lib: Statische Anbindung der watch.dll (WINDOWS) 

watchs.lib: Statische Bibliothek mit Zusatzfunktionen 

watch.h: Header-File (WINDOWS) 

ucwatch.exe: FELICS-Agent (WINDOWS) 

bsp.c: Beispielprogramm (WINDOWS) 

toolhelp.dll: Dynamische Windows-Werkzeugbibliothek 

toolhelp.lib: Statische Windows-Werkzeugbibliothek 

Die Dateien ucwatch.exe, watch.dll, toolhelp.dll sind unbedingt notwendig, um 

die Funktionen des FELICS-Agenten zu gewährleisten. Sie müssen deshalb 

mit ausgeliefert werden. 


Installieren Sie, soweit noch nicht geschehen, Ihren Lizenzserver FELICS 

(siehe Kapitel "FELICS-Installation"). 

Sofern Sie noch keinen FELICS-Lizenzschlüssel erworben haben, verwenden 

Sie bei der Programmierung die Produkt-Id 4711 (DEMO-Produkt). FELICS 

vergibt dafür 2 Lizenzen. 

Die Installation der Windows-Komponenten erfolgt innerhalb der FELICS- 

Tools Installation (siehe Kapitel "FELICS-Tools-Installation"). Anschließend 

kopieren Sie die für die Softwareentwicklung wichtigen Dateien (ucwatch.exe, 

toolhelp.dll, toolhelp.lib, watch.dll, watch.lib, watch.h) in die entsprechenden 

Entwicklungsverzeichnisse. Konfigurieren und starten Sie nun den Agenten 

"ucwatch" unter Windows (siehe Kapitel "FELICS-Agent Windows"). 





37



Die Bibliothek "watch.dll" ermöglicht jeder Anwendung die einfache und 

komfortable Kommunikation mit dem Lizenzserver FELICS über den FELICS- 

Agenten. Prototypen und Konstanten sind in watch.h enthalten. 

Wichtig: Vor der Benutzung ist sicherzustellen, daß der Agent ucwatch.exe 

unter Windows aktiv ist. 

FELICS_init 

Prototyp: extern int FELICS_init ( void ) 

Parameter: - 



-1: Fehler 

Beschreibung: 


Anwendung zum FELICS-Agenten aufgerufen werden. Der Name des 

Lizenzservers wird durch Konfiguration des Agenten (in ucwatch.ini) bestimmt. 

FELICS_quit 


Parameter: - 


Beschreibung: 



durch die Anwendung (Prozeß) noch nicht freigegeben wurden, werden 

automatisch freigegeben. 

38



Prototyp: 

extern int FELICS_getlicence ( unsigned long productid, LPSTR *text ) 








1: Keine Lizenz mehr verfügbar 

-1: Fehler 

Beschreibung: 



FELICS_freelicence oder FELICS_quit aufgerufen wird. Kann die Lizenz nicht 

belegt werden, bleibt der Anwendung die Reaktion darauf freigestellt 

(Benutzerausgaben, Terminieren usw.). 


Prototyp: 

extern int FELICS_freelicence ( unsigned long productid, LPSTR *text ) 





-1: Fehler 

Beschreibung: 


39


FELICS_sdkversion 

Prototyp: extern int FELICS_sdkversion ( LPSTR dllname, 

WORD *version, 

LPSTR description) 

Parameter: dllname: Name der SDK-DLL, deren Version ermittelt 

werden soll. Es kann NULL angegeben werden. 

Dann wird der Default-Name WATCH.DLL verwendet. 

40 

version: Zeiger auf eine Puffervariable zur Aufnahme der 

SDK-Versionsnummer. Bei Angabe von NULL wird 

der Parameter ignoriert. Das höherwertige Byte 

enthält die Hauptversionsnummer, das niederwertige 

Byte die Unterversionsnummer. 

description: Puffer zur Aufnahme einer kurzen Versionsbeschreibung. 

Der Puffer muß vom aufrufenden 

Programm allokiert werden und sollte min. 64 

Bytes lang sein. Geben Sie NULL an, wird der 

Parameter ignoriert. 

Rückgabewert: FELICS_OK: SDK-DLL wurde geprüft und die 

Version ermittelt. 

FELICS_BADSDK: Die SDK-DLL unterstützt diese 

Funktion nicht oder es handelt sich 

um eine nicht authorisierte Bibliothek 

eines Fremdherstellers. 

Beschreibung: 

Die Funktion ermittelt die aktuelle SDK-Version und prüft gleichzeitig die SDK- 

DLL auf ihre Authentizität. 

Hinweis: Aus Sicherheitsgründen finden Sie diese Funktion nicht in der 

SDK-DLL (WATCH.DLL), sondern in der statischen Bibliothek 

WATCHS.LIB, mir der Sie Ihr Programm binden müssen.



Das folgende Beispiel veranschaulicht die Einfachheit der Lizenzanforderung 

und Lizenzfreigabe: 

#include 

#include 

#include "windows.h" 

#include "watch.h" 

int PASCAL WinMain(HANDLE, HANDLE, LPSTR, int); 

#define DEBUG(a) MessageBox((HWND)NULL,(LPSTR)a,(LPSTR)"BEISPIEL",MB_OK) 

#define PRODUCTID 4711L 

int PASCAL WinMain(hInstance, hPrevInstance, lpCmdLine, nCmdShow) 

HANDLE hInstance; 

HANDLE hPrevInstance; 

LPSTR lpCmdLine; 

int nCmdShow; 

{ 

int rc; 


if ( FELICS_sdkversion(NULL,NULL,NULL) != FELICS_OK ) 

{ 

DEBUG("FELICS-SDK DLL invalid"); 

return FALSE; 

} 

rc = FELICS_init(); 

switch (rc) 

{ 

case -1: 

DEBUG("FELICS_init() failed"); 

return FALSE; 

case 2: 

DEBUG("FELICS unreachable"); 

return FALSE; 

case 0: 

break; 

} 

sprintf(buf, "Instanz=%d", hInstance); 

rc = FELICS_getlicence ( PRODUCTID, buf ); 

if ( rc == 0 ) 

{ 

DEBUG("got licence"); 

} 

else 

{ 

DEBUG("no free licence"); 


return FALSE; 

} 

} 

rc = FELICS_freelicence( PRODUCTID, buf ); 

DEBUG("licence freed"); 


return TRUE; 

41


5.5 WINDOWS-NT / 95 und Win32s 

Das SDK besteht derzeit aus folgenden Komponenten: 

42 

NTWATCH.dll: Dynamische Funktions-Bibliothek (Windows-NT) 

NTWATCH.lib: Statische Anbindung der NTWATCH.dll 

NTWATCHS.lib: Statische Bibliothek mit Zusatzfunktionen 

WATCH.h: SDK Header-File 

ntbsp.c: Beispielprogramm (Windows-NT) 

ntbsp.exe: Beispielprogramm (Windows-NT) 

wlipri: Schlüsselgenerator für Produktschlüsselist in den 

FELICS-Tools/Windows enthalten 


Bevor Sie die Installation vornehmen, vergewissern Sie sich, daß der 

Lizenzserver aktiv ist. Sofern Sie noch keinen FELICS-Lizenzschlüssel 

erworben haben, verwenden Sie bei der Programmierung die Produkt-Id 4711 

(DEMO-Produkt). FELICS vergibt dafür 2 Lizenzen. 

Die Installation der Windows-Komponenten erfolgt innerhalb der FELICS- 

Installation (siehe "FELICS-Installation/Windows-NT"). 





Die Verbindung zum Lizenzserver kann nur über den FELICS-Agenten für 

Windows-NT hergestellt werden. Stellen Sie deshalb sicher, daß der Agent 

aktiv.



Die Kommunikation mit dem Lizenzserver FELICS wird über einfache und 

komfortable Funktionen der NTWATCH.dll abgewickelt. Prototypen, Konstanten 

und Variablen befinden sich WATCH.h . 

FELICS_init 

Prototyp: extern int FELICS_init ( HWND hwnd, UINT msg) 

Parameter: hwnd: Wenn der Agent beendet wird, erhält dieses 

Fenster die angegebene Windows-Message. 

Wird diese Funktionalität nicht benötigt, kann 

NULL angegeben werden. 

msg: Meldung, wenn der Agent beendet wird. Dieser 

Parameter wird nur ausgewertet, wenn hwnd != 

NULL ist. 

Rückgabewert: FELICS_OK: ok 

FELICS_NO_SERVER: Lizenzserver nicht erreichbar 

FELICS_NO_AGENT: Agent nicht erreichbar 

Beschreibung: 


Anwendung zum FELICS-Agenten aufgerufen werden. 

FELICS_quit 


Parameter: - 


Beschreibung: 



durch den Prozeß noch nicht freigegeben wurden, werden automatisch 

freigegeben. 

43



Prototyp: 

extern int FELICS_getlicence ( unsigned long productid, char *text ) 







Rückgabewert: FELICS_OK: Lizenz erhalten 

FELICS_NO_LICENCE: Keine Lizenz mehr 

verfügbar 


FELICS_NO_SERVER: Lizenzserver nicht 

erreichbar 

Beschreibung: 



FELICS_freelicence oder FELICS_quit aufgerufen wird oder der Prozeß sich 

beendet. Kann die Lizenz nicht belegt werden, bleibt der Anwendung die 

Reaktion darauf freigestellt (Benutzerausgaben, Terminieren usw.). 


Prototyp: 

extern int FELICS_freelicence ( unsigned long productid, char *text ) 




Rückgabewert: FELICS_OK: Lizenz freigegeben 


FELICS_NO_SERVER: Lizenzserver nicht 

erreichbar 

Beschreibung: 


44



Prototyp: 

extern int FELICS_sdkversion ( LPSTR dllname, 

WORD *version, 

LPSTR description) 

Parameter: dllname: Name der SDK-DLL, deren Version ermittelt 

werden soll. Es kann NULL angegeben werden. 

Dann wird der Default-Name NTWATCH.DLL 

verwendet. 

version: Zeiger auf eine Puffervariable zur Aufnahme der 

SDK-Versionsnummer. Bei Angabe von NULL, wird 

der Parameter ignoriert. Das höherwertige Byte 

enthält die Hauptversionsnummer, das niederwertige 

Byte die Unterversionsnummer. 

description: Puffer zur Aufnahme einer kurzen Versionsbeschreibung. 

Der Puffer muß vom aufrufenden 

Programm allokiert werden und sollte min. 64 

Bytes lang sein. Geben Sie NULL an, wird der 

Parameter ignoriert. 

Rückgabewert: FELICS_OK: SDK-DLL wurde geprüft und die 

Version ermittelt. 

FELICS_BADSDK: Die SDK-DLL unterstützt diese 

Funktion nicht oder es handelt sich 

um eine nicht authorisierte Bibliothek 

eines Fremdherstellers. 

Beschreibung: 

Die Funktion ermittelt die aktuelle SDK-Version und prüft gleichzeitig die SDK- 

DLL auf ihre Authentizität. 

Hinweis: Aus Sicherheitsgründen finden Sie diese Funktion nicht in der SDK- 

DLL (NTWATCH.DLL), sondern in der statischen Bibliothek 

NTWATCHS.LIB, mir der Sie Ihr Programm binden müssen. 

45



#include 

#include 

#include "windows.h" 

#include "watch.h" 

int PASCAL WinMain(HANDLE, HANDLE, LPSTR, int); 

#define DEBUG(a) MessageBox((HWND)NULL,(LPSTR)a,(LPSTR)"BEISPIEL",MB_OK) 

#define PRODUCTID 4711L 

int PASCAL WinMain(hInstance, hPrevInstance, lpCmdLine, nCmdShow) 

HANDLE hInstance; 

HANDLE hPrevInstance; 

LPSTR lpCmdLine; 

int nCmdShow; 

{ 

int rc; 


if ( FELICS_sdkversion(NULL,NULL,NULL) != FELICS_OK ) 

{ 

DEBUG("FELICS-SDK DLL invalid"); 

return FALSE; 

} 

rc = FELICS_init(NULL,0); 

switch (rc) 

{ 

case FELICS_NO_AGENT: 

DEBUG("FELICS-Agent unreachable"); 

return FALSE; 

case FELICS_NO_SERVER: 

DEBUG("FELICS unreachable"); 

return FALSE; 

case 0: 

break; 

} 

46 

} 

default: 

DEBUG("FELICS_init() failed"); 

return FALSE; 

sprintf(buf, "Instanz=%d", hInstance); 

rc = FELICS_getlicence ( PRODUCTID, buf ); 

if ( rc == 0 ) 

{ 

DEBUG("got licence"); 

} 

else 

{ 

DEBUG("no free licence"); 


return FALSE; 

} 

rc = FELICS_freelicence( PRODUCTID, buf ); 

DEBUG("licence freed"); 


return TRUE;


5.6 Schlüsselgenerator WLIPRI (Windows) 

WLIPRI ist der Schlüsselgenerator, mit dem Sie die Lizenzschlüssel für Ihren 

Kunden generieren können. 

Abbildung 17: Schlüsselgenerator WLIPRI 

Der Schlüssel wird aufgrund der eindeutigen Adresse (Host-ID) des Lizenzservers, 

der Produkt-Id, der Lizenzenanzahl und ggfs. des Gültigkeitsdatums 

generiert. Mit dem Schalter "pro Aufruf" wird festgelegt, daß jeder Aufruf der 

Anwendung eine Lizenz belegt. Der Schalter "pro Arbeitsplatz" erlaubt den 

mehrfachen Aufruf der Applikation auf einem Client bei Vergabe einer 

einzigen Lizenz. Nach Eingabe der Daten wählen Sie "Erzeugen". Sie erhalten 

nun den gewünschten Schlüssel. Dieser wird außerdem in der Datei 'lipri.log' 

protokolliert und für die Weiterverarbeitung (z.B. FAX) in die Zwischenablage 

kopiert. 

Wichtig: Sie können nur Produkt-Ids verwenden, die von UniCon Software 

für Sie freigegeben wurden. Benötigen Sie eine weitere Produkt-Id, 

so fordern Sie den für die Freischaltung nötigen Schlüssel von 

UniCon an. 

Der Schlüsselgenerator verwaltet alle Produkt-Ids, welche Sie von UniCon 

erhalten haben in der 'products.db' (im Arbeitsverzeichnis). Parallel dazu 

generiert WLIPRI die Datei 'newprod' (im Arbeitsverzeichnis), die Sie Ihrem 

Endkunden ausliefern können. 

47


5.6.1 DDE-Schnittstelle 

Ab Version 2.02 verfügt der Schlüsselgenerator WLIPRI über eine DDE- 

Schnittstelle und kann somit von jeder DDE-fähigen Windows-Anwendung 

kontrolliert werden. Dies ermöglicht automatisierte Lizenzierungsvorgänge 

(z.B. in Verbindung mit einem Datenbanksystem und einer Textverarbeitung). 

Die DDE-Funktionen entnehmen Sie folgender Tabelle: 

Topic: "System" 

Initiate WLIPRI DDE-Verbindung herstellen 

Terminate Verbindung beenden 

Execute CreateKey Lizenzschlüssel erzeugen aufgrund der 

eingestellten Daten 

Execute Quit Wlipri beenden 

Execute Hide Wlipri unsichtbar 

Execute Show Wlipri in Standardgröße darstellen 

Execute Icon Wlipri als Icon darstellen 

Poke SrvAddr Host-ID des Lizenzservers festlegen. 

Format Host-ID: xxxx-xxxx-xxxx 

Poke Licence Lizenzanzahl einstellen 

Poke Date Setzen eines Testdatums 

Format: dd.mm.yy 

Poke Product Produktnamen festlegen. Der Name 

muß in der Liste der lizenzierten 

Produkte enthalten sein. 

Poke User Name des Bearbeiters 

Poke Order Auftragsnummer 

Poke TAN TAN kann angegeben werden, wird 

ansonsten aus der konfigurierten TAN- 

Liste ermittelt. 

Request Key Lizenzschlüssel abrufen. Erzeugt wird 

der Schlüssel mit CreateKey. 

48

Abbildungsverzeichnis 

ABBILDUNG 1: LIZENZMANAGEMENT MIT FELICS 1 

ABBILDUNG 2: LIZENZMANAGEMENT MIT KNOTENLIZENZIERUNG 2 

ABBILDUNG 3: FELICS-DIENST 8 

ABBILDUNG 4: BRANDLI-HAUPTMENÜ 14 

ABBILDUNG 5: BRANDLI - EINGABE PRODUKT-SCHLÜSSEL 15 

ABBILDUNG 6: BRANDLI LIZENZ-BESTÄTIGUNG 16 

ABBILDUNG 7: BRANDLI-PRODUKTÜBERSICHT 17 

ABBILDUNG 8: REMBRAND 18 

ABBILDUNG 9: RAMON-INFOFENSTER 19 

ABBILDUNG 10: RAMON-MONITORFENSTER 20 

ABBILDUNG 11: WRAMON 21 

ABBILDUNG 12: LIZENZIERUNG MIT WBRANDLI 22 

ABBILDUNG 13: FELICS-AGENTEN 23 

ABBILDUNG 14: FELICS-AGENT DIENST 27 

ABBILDUNG 15: SCHLÜSSELÜBERMITTLUNG 31 

ABBILDUNG 16: SCHLÜSSELGENERATOR WLIPRI 47

A 

Agent .........................................23 

ALIVEFREQ.................................9 

Alive-Mechanismus......................9 

Arbeitsverzeichnis ...................6; 7 

B 

Backup-Lizenzserver9; 11; 24; 25; 28; 30 

BRANDLI .............................13; 14 

C 

Client-Komponente....................32 

D 

DDE ...........................................49 

Debug ..........................................9 

Diagnose .....................................9 

F 

FELICS ........................................3 

Beenden...................................6 

Diagnose................................10 

Installation................................4 

Starten .....................................6 

FELICS für Endanwender..........25 

felics.ini......................................10 

felics.log.....................................10 


Unix........................................35 

Windows 3.x...........................39 

Windows-NT ..........................45 


Unix........................................35 

Windows 3.x...........................39 

Windows-NT ..........................45 

FELICS_init 

Unix........................................34 

Windows 3.x...........................38 

Windows-NT ..........................44 

FELICS_quit 

Unix........................................34 

Windows 3.x...........................38 

Windows-NT ..........................44 


Windows 3.x.......................... 40 

Windows-NT.......................... 46 

FELICS-Agent............... 23; 24; 32 

felicscltd .................................... 24 

FELICS-Dienst ............................ 5 

FELICSE ............................. 29; 30 

FELICSENV ................................ 6 

felicslib.a ................................... 34 

FELICS-SDK ............................. 31 

FELICS-Tools............................ 13 

freiwillige Lizenz.................. 14; 25 

K 

Knotenlizenzierung................ 2; 22 

L 

Lizenzauslastung ...................... 19 

Lizenzbedarf.............................. 19 

Lizenzdatenbank....................... 31 

Lizenzierung.............................. 14 

Lizenzmanagement..................... 1 

Lizenzschlüssel......................... 14 

Lizenzserver.............................. 32 

Lizenzüberschreitung................ 25 

Logdatei .................................... 10 

M 

MAXALIVE .................................. 9 

Monitor ...................................... 19 

N 

NTCLTE .................................... 29 

NT-Dienst.............................. 8; 27 

NTfelclt................................ 27; 30 

NTWINAPP ............................... 29

P 

Pflichtlizenz ............................... 14 

Produkt-Id.................................. 31 

R 

RAMON............................... 13; 19 

REMBRAND........................ 13; 18 

S 

Schlüsselgenerator ................... 48 

SDK........................................... 31 

Unix ....................................... 33 

Win32s .................................. 43 

Windows 3.x .......................... 37 

Windows95............................ 43 

Windows-NT ..........................43 

Software Development Kit .........31 

T 

Trace ...........................................9 

U 

UCWATCH ................................25 

UNIX-SDK..................................33 

W 

WATCHPUB ..............................26 

WBRANDLI................................22 

WINDOWS-SDK..................37; 43 

WLIPRI ......................................48 

WRAMON............................13; 21

UniCon Software GmbH

Erfolgreiche ePaper selbst erstellen

Template löschen?

Als Template speichern?