FSBwatch Installation und Konfiguration

Transkript

1 FSBwatch Installation und Konfiguration Version Dezember 2014

2 Copyright , WIBU-SYSTEMS AG, Rüppurrer Straße 52-54, Karlsruhe, Deutschland Gedruckt in Deutschland Alle Rechte vorbehalten. Kein Teil dieser Dokumentation, der dazugehörigen Software und der anderen Bestandteile des beschriebenen Produkts darf ohne schriftliche Genehmigung der Firma Wibu-Systems nachgedruckt, vervielfältigt, in eine andere Sprache übersetzt oder auf elektromagnetischem, optischem, mechanischem oder anderem Wege abgespeichert werden. Diese Dokumentation, die Hardware (CmDongle usw.) und die dazugehörige Software wurden mit großer Sorgfalt erstellt. Dennoch sind Irrtümer nicht auszuschließen. Wibu-Systems weist darauf hin, dass für Fehler innerhalb der Dokumentation, der Hardware oder der Programme seitens des Benutzers keinerlei Haftungsansprüche geltend gemacht werden können. Wibu-Systems behält sich das Recht vor, Programme oder die Dokumentation von Zeit zu Zeit zu ändern, ohne den Benutzer darüber informieren zu müssen. WIBU, CodeMeter, SmartShelter sind geschützte Warenzeichen von Wibu-Systems. Alle anderen in dieser Dokumentation genannten Marken- und Produktnamen sind Handelsnamen, Dienste, Warenzeichen und Firmennamen sind in der Regel durch ihren Inhaber geschützt. Wibu-Systems ist Mitglied im: PCMCIA seit 1993 USB Implementers Forum seit 1997 SD Card Association seit 2007 Bitkom Bundesverband Informationswirtschaft, Telekommunikation und Neue Medien seit 2003 VDMA Verband Deutscher Maschinen- und Anlagenbau e.v. seit 2008 OPC Foundation seit 2012 wie auch Mitglied in den Entwicklerprogrammen von Autodesk, Apple, HP, IBM, Intel und Microsoft. Microsoft Gold Certified Partner Microsoft Embedded Partner Strategic Software Partner Industrial and Medical

3 Inhalt Inhaltsverzeichnis I Version 4 II Sicherheitshinweise 5 III Grundlegende Informationen 6 IV Willkommen 8 V Installation unter Windows, Mac OS X, Linux 9 VI Die Konfigurationsdatei: FSBwatchSettings.xml 11 VII Anstoßen von FSBwatch in der Konsole 16 VIII FSBwatch in der CodeMeter License Central 17 1 Installation in der...17 CodeMeter License Central 2 Manuelles Starten...19 FSBwatch-Kommandozeile 3 Ausführen FSBwatch-Kommandozeile...19 als Cron Job Index 23 3

4 FSBWatch - Installation und Konfiguration Version FSB Watch - Version 1.3, Copyright durch WIBU-SYSTEMS AG, Karlsruhe / Germany Alle Rechte vorbehalten. Wibu-Systems Kontaktinformationen: Adresse: WIBU-SYSTEMS AG Rüppurrer Straße D Karlsruhe Telefon: +49 (0) Internet: support@wibu.com 4

5 Sicherheitshinweise 2 Sicherheitshinweise Die Hardware der WIBU-SYSTEMS AG dient dem Schutz und Lizenzierung digitaler Produkte und wurde entsprechend dem Stand der Technik und den anerkannten sicherheitstechnischen Regeln entwickelt, gefertigt und geprüft. Für weitergehende Informationen zu Zertifizierungen der Hardware siehe die entsprechenden Dokumente auf der Wibu- Systems Webseite ( Beachten Sie bitte die folgenden Sicherheitshinweise: Bitte verwenden Sie die Hardware nur für die in dieser Anleitung beschriebenen bestimmungsgemäßen Art und Weise. Schließen Sie die Hardware nur an die jeweils passende vorgesehene Schnittstelle an. Eine anderweitige Verwendung oder das Öffnen oder eigenständige Reparaturen der Hardware führen eventuell zu Beschädigungen am Produkt oder in dessen Umgebung. Das Verändern der Hardware beeinträchtigt die Produktsicherheit. Achtung Verletzungsgefahr! Im laufenden Betrieb kann sich die Hardware erwärmen - das Erwärmen stellt jedoch einen normalen Betriebsparameter dar. Halten Sie die Hardware von Nässe und hoher Luftfeuchtigkeit fern und vermeiden Sie starke Erschütterungen, Staub, Hitze und direkte Sonneneinstrahlung, um Betriebsstörungen zu vermeiden. Abhängig vom verwendeten Betriebssystem kann die Erkennung der Hardware einige Sekunden beanspruchen. Nach dem beendeten Zugriff auf die Hardware sollte abhängig vom verwendeten Betriebssystem mehrere Sekunden gewartet werden, bevor die Hardware entfernt wird. Andernfalls kann keine sichere Datenspeicherung /Datenübertragung gewährleistet werden. Dieses Produkt ist kein Spielzeug und gehört nicht in Kinderhände. Das Nichtbeachten der Sicherheitshinweise schließt eine Gewährleistung aus. 5

6 FSBWatch - Installation und Konfiguration Grundlegende Informationen Das Handbuch verwendet die folgenden semantischen Auszeichnungen, Texthervorhebungen und Symbole. Formatierungsdefinition Kursiv Arial Narrow Kursiv Arial Narrow Kursiv "Fett Anführungszeichen" "Fett Arial Narrow" GROSSBUCHSTABEN COURIER NEW Courier New Piktogramme Art der Information Produktnamen Wichtige Begriffe Eigenschaftselemente Objekte, die Sie auswählen müssen, wie zum Beispiel Menüs, Schaltflächen, oder Begriffe in einer Liste. Befehlsnamen TASTENBEZEICHNUNGEN AUF DER TASTATUR. ZUM BEISPIEL SHIFT, STRG ODER ALT. Pfadangaben oder Dateinamen Beschreibung Dieses Symbol weist Sie darauf hin, dass wichtige Anweisungen folgen, die Sie unbedingt beachten sollten. Dieses Symbol weist Sie auf zusätzliche Informationen hin, die von generellem Interesse sind, und Sie bei der Benutzung der jeweiligen Anwendung unterstützen. Dieses Symbol weist Sie auf ein Beispiel hin, das Ihnen bei der Umsetzung hilft. Support Unseren Kunden steht ein professionelles Team bestens geschulter Mitarbeiter vom ersten Schritt an zur Seite. Der direkte Kundenkontakt ermöglicht es uns, Wünsche und Anregungen schnell zu erfüllen. Umfangreiche FAQ's für den Endanwender zum Thema CodeM eter finden Sie auf unserer CodeM eter Support-Seite sowie Informationen zum Thema CodeM eter und zu verschiedenen Zusatzprodukten wie CodeM eter Passw ord M anager. Anwender-Support Wibu-Systems stellt eine kostenlose Anwender-Hotline für Ihre Endkunden zur Verfügung. Entwickler (Kundensupport) Sie erreichen uns werktags (Montag bis Freitag) durchgehend von 8.00 bis unter der Telefonnummer oder per unter support@wibu.de. Support-Verträge mit erweiterten Leistungen auf Anfrage. Bitte nennen Sie uns Ihre Kundennummer, damit wir Ihr Anliegen schnellstmöglich bearbeiten können. Support Informationen Zur Bearbeitung benötigen wir folgende Informationen: Art der Implementierung (automatisch/individuell) Betriebssystem Version der installierten CodeM eter -Software Verwendete CodeM eter -Hardware Detaillierte Fehlerbeschreibung Über Wibu-Systems WIBU-SYSTEMS AG wurde 1989 von Oliver Winzenried und Marcellus Buchheit gegründet und bietet als Technologieführer Lösungen zum Schutz und zur Lizenzierung digitaler Produkte an. Die Unabhängigkeit vom eingesetzten Betriebssystem und die Vielfalt von Bauformen der Kopierschutz-Hardware Cm Dongle (USB, PC Card, Express Card 34, Compact Flash Card, SD- und MicroSD-Card, ASIC) ist gleichbedeutend mit Software-, Dokumenten-, Zugriffs- und Medienschutz für Anwendungen vom Smart Phone über Embedded Systeme, Desktop PCs und Server bis zum Cloud Computing. Wibu-Systems beschäftigt aktuell 100 Mitarbeiter, davon 80 am Hauptsitz in Karlsruhe. Als inhabergeführtes Unternehmen ist es finanziell unabhängig und verfolgt die Strategie der nachhaltigen Entwicklung. Höchste Qualität bei Sicherheit, Zuverlässigkeit, Langlebigkeit sowie optimale Beratung und Service ist das Ziel. Die internationalen Aktivitäten des Unternehmens werden von Niederlassungen in Seattle (USA) sowie 6

7 Grundlegende Informationen Schanghai und Peking (China), Verkaufsbüros in Belgien, Großbritannien, den Niederlanden, Portugal und Spanien sowie von Distributoren in über 25 Ländern unterstützt. Mehr als Hersteller weltweit setzen W ibukey und CodeM eter ein. Wibu-Systems hilft Ihnen mehr zu verkaufen, indem der Verlust durch Raubkopien reduziert und durch flexible Lizenzmodelle der Kundenkreis vergrößert wird. CodeM eter in der hardwarebasierten Cm Dongle-Variante bietet einzigartige Funktionen wie das Speichern tausender Lizenzen auch unterschiedlicher Anbieter, die einfache Lizenzübertragung online sowie die Kombination mit Flash- Massenspeicher. Cm ActLicense die software- und aktivierungsbasierte Lösung für Software im Niedrigpreissegment oder für Großunternehmen bindet die Lizenzinformation an Eigenschaften des Kundenrechners. Die CodeM eter License Central hilft dem Hersteller beim Erstellen, Verwalten und Ausliefern von Lizenzen und der Integration in Vertriebsprozesse und ERP- Systeme. Sm artshelter erlaubt den sicheren Schutz von PDF-Dokumenten, Sm artshelter SDL (Secure Data Layer) ermöglicht den Schutz beliebiger Dateien für beliebige Anwendungen. Authentifizierungslösungen umfassen den einfachen und sicheren Zugriff auf Webseiten und den Login für gehostete Anwendungen ( CSSI). Im Media-Bereich werden digitale Videos, Flash-Animationen und Audio-Dateien sicher geschützt. Wibu-Systems ist nach DIN EN ISO 9001:2008 zertifiziert und aktives Mitglied in internationalen und lokalen Verbänden wie BITKOM, VDMA oder SIIA und Standardisierungsgremien wie PCMCIA, USB Implementers Forum und SD Card Association. Wibu-Systems ist Microsoft Gold Certified Partner, Windows Embedded Partner sowie Partner in Entwicklerprogrammen von Apple, Adobe, Autodesk, Wind River und weiteren. Die Produkte wurden bereits mehrfach ausgezeichnet, beispielsweise bei SIIA Codie Awards als "Best Digital Rights Management" Lösung und beim internationalen if Product Design Award. Das Unternehmen ist federführend in Forschungsprojekten mit Hochschulen und anderen Unternehmen, teilweise gefördert vom BMBF und BMWi. Beispiele sind MimoSecco, in welchem eine flexible sichere Middleware-Lösung für Drittanwendungen im Bereich des Cloud Computings entwickelt wird und OpenID/Card, in dem eine Ausgabe von virtuellen Identitäten auf Basis des neuen Personalausweises für beliebige Identitäts-Provider ermöglicht werden soll. So erreichen Sie uns weltweit Deutschland +49 (0) sales@wibu.de USA info@wibu.us China Shanghai +86-(0) info@wibu.com.cn Peking +86 (0) /61 info@wibu.com.cn Großbritannien +44 (0) sales@wibu.co.uk Irland +44 (0) sales@wibu.co.uk Niederlande +31 (0) sales@wibu-systems.nl Frankreich +33 (0) info@wibu.fr Belgien +32 (0) sales@wibu.be Spanien +34 (0) sales@wibu.es Portugal +34 (0) sales@wibu.es Andere Länder +49 (0) sales@wibu.com So erreichen Sie uns weltweit Deutschland +49 (0) sales@wibu.de USA info@wibu.us China Schanghai +86-(0) info@wibu.com.cn Peking +86 (0) /61 info@wibu.com.cn Großbritannien +44 (0) sales@wibu.co.uk Irland +44 (0) sales@wibu.uk.co Niederlande +31 (0) sales@wibu-systems.nl Belgien +32 (0) sales@wibu.be Spanien +34 (0) sales@wibu.es Portugal +34 (0) sales@wibu.pt Andere Länder +49 (0) sales@wibu.com 7

8 FSBWatch - Installation und Konfiguration Willkommen FSBw atch ermöglicht es, Firm Security Boxen (FSB) zu überwachen und auf abgelaufene, nicht mehr gültige Lizenzen zu überprüfen. Die Anwendung liest alle verfügbaren FSBs aus und überprüft dabei den Zustand von Begrenzungszählern (Unit Counter) und Ablaufdaten (Expiration Time). Die Überprüfung basiert auf Grenzwerten, die sich für Zählerstände und Ablaufdaten setzen lassen. Überprüfungen lassen sich für alle FSBs, für einzelne FSBs, Firm Codes oder FSB-Lizenzeinträge durchführen. Die Ergebnisse der Überprüfungen können neben der Anzeige auf der Kommandozeilen-Ebene auch über an ausgewählte Empfänger versandt und, wenn gewünscht, notwendige Lizenzanforderungsdateien (*.WibuCmRAC) angehängt werden. 11 Die Konfiguration von FSBw atch wird über Auszeichnungen innerhalb einer Konfigurationsdatei vorgenommen. 17 Für Informationen zur Verwendung von FSBw atch in der CodeM eter License Central siehe hier. 8

9 Installation unter Windows, Mac OS X, Linux 5 Installation unter Windows, Mac OS X, Linux FSBw atch ist platformunabhängig mit Java programmiert. Daher benötigen Sie zur Verwendung von FSBw atch eine Sun Java-Laufzeitumgebung. Windows Betriebssysteme Für die Installation unter Windows steht ein separates ZIP-Archiv fsbwatchconsole-[version]-i386.zip zur Verfügung. Es enthält die folgenden Verzeichnisse und Dateien. %fsbwatchconsole-[version]% `--lib --mail.jar `--FSBwatchConsole.jar `--FSBwatchConsole_UserGuide.txt `--FSBwatchSettings.xml `--FSBwatchSettings.xsd Zur Installation und Setzen der Java-Umgebungsvariable gehen Sie bitte wie folgt vor: 1. Entpacken des Archives in ein gewünschtes Verzeichnis, z.b. C:\fsbwatchconsole Rechtsklicken auf Computer auf dem Desktop oder im Startmenü. Ein Popup-Menü wird neben den Mauszeiger angezeigt. 3. Wählen Eigenschaften aus dem Menü. Das Control-Panel System Fenster wird geöffnet. 4. Klicken Erweiterte Systemeinstellungen auf der linken Seite des Fensters. Das Fenster Systemeigenschaften öffnet mit der Registerkarte Erweitert sichtbar. 5. Klicken im unteren Bereich des Fensters auf die Umgebungsvariablen... -Schaltfläche. 6. Klicken der Neu -Schaltfläche unter Benutzervariablen. 7. Eingeben von Classpath für Name der Variablen. 8. Angabe des vollständigen Pfades zum Verzeichnis, in das FSBw atch installiert wurde als Wert der Variablen, z.b. C: \fsbwatchconsole Klicken auf OK -Schaltfläche, um die neue Classpath-Variable hinzuzufügen. 10.Klicken auf OK -Schaltfläche, um das Fenster Systemeigenschaften zu schließen. Mac OS X Betriebssysteme Für die Installation unter Mac OS X steht ein separates Debian-Paket fsbwatchconsole-[version]-i386.deb zur Verfügung. Das Paket enthält die folgenden Verzeichnisse und Dateien: %fsbwatchconsole% `--lib --mail.jar `--FSBwatchConsole.jar `--FSBwatchConsole_UserGuide.txt `--FSBwatchSettings.xml `--FSBwatchSettings.xsd Zur Installation unter Mac OS X benötigen Sie eine separate Anwendung, z.b. MacPorts oder FINK. Stellen Sie sicher, dass die Java-Umgebungsvariable in der *.profile-datei eingetragen ist. Linux Betriebssysteme Für die Installation unter Linux steht ein separates Debian-Packet fsbwatchconsole-[version]-i386.deb zur Verfügung, das mit einem geigneten Debian Paket Manager installiert werden kann. Die PATH-Umgebungsvariable wird dabei automatisch gesetzt. Das Paket enthält die folgenden Verzeichnisse und Dateien: %fsbwatchconsole% `--lib --mail.jar `--FSBwatchConsole.jar `--FSBwatchConsole_UserGuide.txt `--FSBwatchSettings.xml 9

10 FSBWatch - Installation und Konfiguration `--FSBwatchSettings.xsd FSBw atch wird in das Verzeichnis /usr/share/fsbwatchconsole installiert. 10

11 Die Konfigurationsdatei: FSBwatchSettings.xml 6 Die Konfigurationsdatei: FSBwatchSettings.xml Die Konfigurationsdatei FSBwatchSettings.xml erlaubt Ihnen, über die Verwendungen von Auszeichnungen, Einstellungen zu Überprüfungen auf abgelaufene, nicht mehr gültige Lizenzen in FSBs vorzunehmen. Die folgende Auflistung zeigt alle Auszeichnungen, die Sie innerhalb der Auszeichnung <FSBwatchSettings> verwenden können. Die fett markierte Auszeichnungen entsprechen der Standardeinstellung und müssen mindestens gesetzt sein. Die Konfigurationsdatei kann sich in drei Bereiche aufteilen: globale Einstellungen für alle FSBs Mail-Optionen 13 Einstellungen für individuelle FSBs, Firm Codes oder FSB-Lizenzeinträge. Einstellungen für alle FSBs (global) Auszeichnung <Subsystem> Beschreibung definiert in welchem Subsystem gesucht werden soll. Es stehen die folgenden Einträge zur Verfügung: local lan locallan sucht nach FSBs, die sich ausschließlich auf demselben PC befinden bzw. derselben VM zugeordnet sind. sucht nach FSBs, die sich ausschließlich im Netzwerk befinden. sucht nach FSB, zunächst auf demselben PC bzw. derselben VM und danach im Netzwerk. <unitcounterlimit > <expirationtimeli mit> definiert die untere Grenze des Begrenzungszählers (Unit Counter) in Einheiten. Wird dieser erreicht, können optional globale Informations - oder Warnnachrichten 12 verschickt werden, wenn Mailserver-Einstellungen vorgenommen wurden und Empfänger angelegt sind. Die Grenze wird für die globale Informationsnachricht gesetzt, für individuelle Nachrichten 13 siehe hier. definiert die untere Grenze des Ablaufdatums (Expiration Time) in Tagen, Wird dieser erreicht, können optional globale Informations - oder Warnnachrichten 12 verschickt werden, wenn Mailserver-Einstellungen vorgenommen wurden und Empfänger angelegt sind. Die Grenze wird für die globale Informationsnachricht gesetzt, für individuelle Nachrichten 13 siehe hier. <generaterac> <serversearchlist> [optional] generiert oder generiert keine Lizenzanforderungsdatei (*.WibuCmRAC) über Setzen des Parameters true oder false. 12 Ist eine -Warnnachricht eingerichtet, wird eine generierte Lizenzanforderungsdatei (*.WibuCmRAC) an die Nachricht angehängt. definiert optional die Verwendung einer Serversuchliste für Zugriffe auf und die Reihenfolge von eingerichteten CodeM eter-netzwerk-server. Beispiel des globalen Bereiches <Subsystem>localLan</Subsystem> <unitcounterlimit>100</unitcounterlimit> <expirationtimelimit>10</expirationtimelimit> <generaterac>true</generaterac> Nach Aufruf der Kommandozeile suchen diese Enstellungen in allen FSBs (zunächst unter der demselben PC bzw. derselben VM und danach im Netzwerk) alle Lizenzeinträge, die den global gesetzten Grenzen des 11

12 FSBWatch - Installation und Konfiguration Begrenzungszählers und des Ablaufdatums entsprechen. Beim Unterschreiten der Grenzen wird eine Lizenzanforderungsdatei (*.WibuCmRAC) erstellt und in das Verzeichnis, in das FSBw atch installiert wurde, abgelegt. Da keine Mail-Optionen gesetzt sind, erfolgt die Ausgabe auf der Kommandozeile bzw. in der Log-Datei im Verzeichnis, in das FSBw atch installiert wurde. Mail-Optionen Diese Einstellungen entsprechen der gesetzten Standard-Auslieferung der Konfigurationsdatei FSBwatchSettings.xml. FSBw atch erlaubt es, das Ergebnis der Kommandozeile auch über separate -Nachrichten zu versenden. In diesem Bereich definieren Sie das E.Mail-Konto, das Sie zum Verschicken aller -Nachrichten verwenden und legen Empfänger- Listen für verschiedene -Typen an. FSBw atch kennt drei verschiedene -Typen: die globale Infomationsnachricht. Sie enthält Informationen über alle gefundenen FSBs. die Firm Code-spezifische Informationsnachricht. Sie enthält Informationen über den entprechend angegebenen Firm Code. die Warnnachricht. Sie enthält Informationen über jeden Lizenzeintrag eines Firm Codes, der die definierten Grenzen erreicht hat. Für jeden Firm Code wird eine individuelle Warnnachricht versendet. Gleichzeitig wird eine Lizenzanforderungsdatei (*.WibuCmRAC) erstellt und an die Nachricht angehängt, wenn dies so konfiguiert ist. Auszeichnung < Account> <SMTPHost> <username> <password> < address> <port> <ssl> <informationmail> Beschreibung dient der Festlegung des Postausgangsservers, über den E.Mail-Nachrichten verschickt werden. Adresse des Postausgangsserver Benutzername Passwort Absender- -Adresse verwendeter Port aktiviert das Sicherheitsprotokoll bei der Anmeldung am Account (true=wird gesetzt, false=wird nicht gesetzt.). gibt eine Liste an Empfängern an, denen Informationsnachrichten zugesandt werden. Als Grundlage für Informationsnachrichten werden entweder die Lizenzeinträge aller gefundenen FSBs oder einzelner Firm Codes verwendet. Die Nachricht enthält einen fest hinterlegten, derzeit noch nicht konfigurierbaren, Nachrichtentext. <warningmail> <recipientto> gibt eine Liste an Empfängern an, denen individuelle Warnnachrichten zugesandt werden. Sie enthält Informationen über jeden Lizenzeintrag eines Firm Codes, der die definierten Grenzen erreicht hat. Für jeden Firm Code wird eine individuelle Warnnachricht versendet. Gleichzeitig wird eine 11 Lizenzanforderungsdatei (*.WibuCmRAC) erstellt und an die Nachricht angehängt, wenn dies so konfiguiert ist Die Nachricht enthälteinen fest hinterlegten, derzeit noch nicht konfigurierbaren, Nachrichtentext. enthält eine beliebige Anzahl an Empfängern. Wird für Infomations- und Warnnachrichten verwendet. 12

13 Die Konfigurationsdatei: FSBwatchSettings.xml Auszeichnung <recipientcc> Beschreibung enthält eine beliebige Anzahl an CC-Empfängern. Wird für Infomations- und Warnnachrichten verwendet. Beispiel der Mail-Optionen < Account> <SMTPHost>smtp.mail.com</SMTPHost> <username>myusername</username> <password>mypassword</password> <port>465</port> <ssl>false</ssl> </ Account> <informationmail> </informationmail> <warningmail> </warningmail> Einstellungen für individuelle FSBs, Firm Codes oder FSB-Einträge FSBw atch erlaubt es, nicht nur global alle Lizenzeinträge aller gefundenen FSBs zu überwachen, sondern auch individuelle FSBs,Frm Codes und FSB-Lizenzeinträge in die Überwachung ein- oder auszuschließen. Dabei können auch die Grenzwerte für Zählerstände und Ablaufdaten sowie Empfängerlisten der -Nachrichten individuell angepasst werden. Auszeichnung <serial> <firmcode> <value> <featuremap> <ignore> <unitcounterlimit> <expirationtimelimit> <generaterac> <informationmail> Beschreibung speztifiziert die Seriennummer einer einzelnen FSB für die individuelle Überfwachung durch FSBw atch. spezifiziert einzelne Firm Codes über Nutzung der <value>-auszeichnung oder einzelne FSB-Lizenzeinträge über Nutzung der <featuremap>- Auszeichnung. Einzelne FSBs, Firm Codes oder FSB-Lizenzeinträge können über die Werte der Auszeichnung aus der Überwachung ein- oder ausgeschlossen werden, Der Wert true schließt einzelne FSBs, Firm Codes oder FSB-Lizenzeinträge aus der Überwachung aus, der Wert false nimmt einzelne FSBs, Firm Codes oder FSB-Lizenzeinträgen in die Überwachung auf. definiert für einzelne FSBs, Firm Codes oder FSB-Lizenzeinträge die untere Grenze des Begrenzungszählers (Unit Counter) in Einheiten. 13 Wird dieser erreicht, kann optional eine Informations - oder Warnnachricht verschickt werden, wenn Mailserver-Einstellungen vorgenommen wurden und Empfänger angelegt sind definiert für einzelne FSBs, Firm Codes oder FSB-Lizenzeinträge die untere Grenze des Ablaufdatums (Expiration Time) in Tagen, 12 Wird dieser erreicht, kann optional eine Informations - oder - Warnnachricht verschickt werden, wenn Mailserver-Einstellungen vorgenommen wurden und Empfänger angelegt sind generiert oder generiert keine Lizenzanforderungsdatei (*.WibuCmRAC) über Setzen des Parameters true oder false. 12 Ist eine -Warnnachricht eingerichtet, wird eine generierte Lizenzanforderungsdatei (*.WibuCmRAC) an die Nachricht angehängt. gibt eine Liste an Empfängern an, denen Informationsnachrichten zugesandt werden. 13

14 FSBWatch - Installation und Konfiguration Auszeichnung <warningmail> Beschreibung Als Grundlage für Informationsnachrichten werden entweder die Lizenzeinträge aller gefundenen FSBs oder einzelner Firm Codes verwendet. Die Nachricht enthält einen fest hinterlegten, derzeit noch nicht konfigurierbaren, Nachrichtentext. gibt eine Liste an Empfängern an, denen individuelle Warnnachrichten zugesandt werden. Sie enthält Informationen über jeden Lizenzeintrag eines Firm Codes, der die definierten Grenzen erreicht hat. Für jeden Firm Code wird eine individuelle Warnnachricht versendet. 11 Gleichzeitig wird eine Lizenzanforderungsdatei (*.WibuCmRAC) erstellt und an die Nachricht angehängt, wenn dies so konfiguiert ist Die Nachricht enthält einen fest hinterlegten, derzeit noch nicht konfigurierbaren, Nachrichtentext. Beispiel für individuelle Einstellungen (FSBs, Firm Codes, FSB-Lizenzeinträge) <FSB> <serial> </serial> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <generaterac>true</generaterac> <ignore>false</ignore> <firmcode> </firmcode> <firmcode> <value>10</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <informationmail> <recipientto>recipient@mail.com</recipientto> </informationmail> <warningmail> <recipientto>recipient@mail.com</recipientto> </warningmail> <generaterac>true</generaterac> <ignore>true</ignore> <featuremap> <value>0x28</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <ignore>false</ignore> </featuremap> <featuremap> <value>0x3ffd7</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <ignore>false</ignore> </featuremap> <value>5010</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <informationmail> <recipientto>recipient@mail.com</recipientto> </informationmail> <warningmail> <recipientto>recipient@mail.com</recipientto> </warningmail> <generaterac>true</generaterac> 14

15 Die Konfigurationsdatei: FSBwatchSettings.xml <ignore>true</ignore> <featuremap> <value>0x1</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <ignore>false</ignore> </featuremap> <featuremap> <value>0x3fffc</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <ignore>false</ignore> </featuremap> <featuremap> <value>0x40000</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <ignore>false</ignore> </featuremap> <featuremap> <value>0x80000</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <ignore>false</ignore> </featuremap> <featuremap> <value>0x100000</value> <unitcounterlimit>5</unitcounterlimit> <expirationtimelimit>5</expirationtimelimit> <ignore>false</ignore> </featuremap> </firmcode> </FSB> 15

16 FSBWatch - Installation und Konfiguration Anstoßen von FSBwatch in der Konsole Zum manuellen Start von FSBw atch gehen Sie bitte wie folgt vor: 1. Wechseln in das Installationsverzeichnis /.../.../fsbwatchconsole. 2. Starten der FSBw atchconsole mit dem Befehl: java -jar FSBwatchConsole.jar. Die Protokollierungseinträge werden Ihnen entweder bereits in der Konsole angezeigt oder aber in der der separaten Datei FSBwatch.log, die sich im Installationsverzeichnis befindet. 11 Ist in der Konfigurationsdatei der Mailversand inklusive Mail-Empfänger eingestellt, werden Informations- oder Warnnachrichten versandt. 16

17 FSBwatch in der CodeMeter License Central Installation in der CodeMeter License Central 8 FSBwatch in der CodeMeter License Central 8.1 Installation in der CodeMeter License Central Für die Installation in der CodeM eter License Central steht ein separates *.deb-packet zur Verfügung, Zur Installation des *.deb-paketes gehen Sie bitte wie folgt vor: 1. Eingeben der W ebm in Adresse in das Adressfeld des Browsers. Die Eingabe folgt dem Muster " wobei Sie die [IP-Adresse] durch die IP- Adresse ersetzen, die Sie nach dem Start der CodeM eterlicense Central auf der Kommandozeilenebene der VM erhalten haben. Wenn Sie einen Proxy für Ihre Browser-Kommunikation verwenden, stellen Sie bitte sicher, dass Sie diese IP- Adresse zu den Ausnahmen hinzugefügt haben. Bitte informieren Sie sich in der Browser-Produktdokumentation, wie Sie Ausnahmen zum Proxy hinzufügen. Die W ebm in-anmeldeseite erscheint: Abbildung 2: W ebm in Login 2. Eingeben der Standardwerte cmlcadmin als Username und CodeMeter als Password und bestätigen der Anmeldung über die "Login"-Schaltfläche. 3. Navigieren links auf den "System Software Packages"-Eintrag. Die gleichnamige Seite erscheint. 4. Auswählen des "From uploaded file"-bereiches und Klicken der "Durchsuchen"-Schaltfläche. 5. Auswählen des deb-paketes im neuen Dialog. 17

18 FSBWatch - Installation und Konfiguration Klicken der "Install"-Schaltfläche. Die Installation wird angezeigt und FSBw atch wird in das Verzeichnis /usr/share/fsbwatchconsole installiert. 18

19 FSBwatch in der CodeMeter License Central Manuelles Starten FSBwatch-Kommandozeile 8.2 Manuelles Starten FSBwatch-Kommandozeile Zum manuellen Start von FSBw atch gehen Sie bitte wie folgt vor: 1. Wechseln in das Verzeichnis /usr/share/fsbwatchconsole. 2. Starten der FSBw atchconsole mit dem Befehl java -jar FSBwatchConsole.jar. Die Protokollierungseinträge werden Ihnen entweder bereits in der Konsole angezeigt oder aber in der der separaten Datei FSBwatch.log, die sich im Installationsverzeichnis befindet. 11 Ist in der Konfigurationsdatei der Mailversand inklusive Mail-Empfänger eingestellt, werden Informations- oder Warnnachrichten versandt. 8.3 Ausführen FSBwatch-Kommandozeile als Cron Job Ein Cron Job ermöglicht es, Befehle oder Skripte periodisch ausführen zu lassen. Damit eignet er sich ausgezeichnet für Aufgaben, die keine Benutzerinteraktion verlangen, wie z.b. auch für FSBw atch. Zum Anlegen eines Cron Jobs gehen Sie bitte wie folgt vor: 1. Eingeben der W ebm in Adresse in das Adressfeld des Browsers. Die Eingabe folgt dem Muster " wobei Sie die [IP-Adresse] durch die IP- Adresse ersetzen, die Sie nach dem Start der CodeM eterlicense Central auf der Kommandozeilenebene der VM erhalten haben. Wenn Sie einen Proxy für Ihre Browser-Kommunikation verwenden, stellen Sie bitte sicher, dass Sie diese IP- Adresse zu den Ausnahmen hinzugefügt haben. Bitte informieren Sie sich in der Browser-Produktdokumentation, wie Sie Ausnahmen zum Proxy hinzufügen. Die W ebm in-anmeldeseite erscheint: 2. Eingeben der Standardwerte cmlcadmin als Username und CodeMeter als Password und bestätigen der Anmeldung über die "Login"-Schaltfläche. 3. Navigieren links auf den "System Scheduled Cron Jobs"-Eintrag. Die gleichnamige Seite erscheint. 4. Klicken auf den "Create a new scheduled cron job"-verweis, um einen einen Cron Job einzurichten. 19

20 FSBWatch - Installation und Konfiguration Eintragen cmlcadmin im Feld "Execute cron job as". 6. Eintragen cd /usr/share/fsbwatchconsole; java -jar FSBwatchConsole.jar im Feld "Command". 7. Eintragen FSBwatchConsole im Feld "Description". 8. Angeben der genauen Ausführmodalitäten des Jobs im Bereich 'When to execute". 9. Klicken der "'Create"-Schaltfläche, um den Cron Job zu erstellen. Die folgende Abbildung zeigt die vorgenommenen Einstellungen. 20

21 FSBwatch in der CodeMeter License Central Ausführen FSBwatch-Kommandozeile als Cron Job Danach erscheint die Cron Job Übersicht eingerichteter Jobs inklusive des eben erstellten, 21

22 FSBWatch - Installation und Konfiguration

23 Index Index - A - Auszeichnung ExpirationTimeLimit 11 ExpirationTimeLimit (individuell) 13 GenerateRAC (global) 11 GenerateRAC (individuell) 13 ignore (individuell) 13 ServerSearchList 11 Subsystem 11 UnitCounterLimit 11 UnitCounterLimit (individuell) 13 - C - CodeMeter Licnse Central Crion Job für FSBwatch 19 Installieren FSBwatch 17 Manuelles Starten FSBwatch 19 - E - Einstellungen individuelle FSBs oder Firm Codes 13 Empfängerliste Informationsnachricht 12 Konfiguration 12 Warnnachricht 12 ExpirationTimeLimit 11 ExpirationTimeLimit (individuell) 13 - G - GenerateRAC (global) 11 GenerateRAC (individuelll) 13 Globale Einstellungen für alle FSBs 11 - I - Informationsnachricht 12 Installation Linux 9 Mac OS X 9 Windows 9 - J - Java PATH-Variable 9 Voraussetzung 9 - K - Konfiguration Ausschließen FSB, Einträge 13 Einschließen FSB, Einträge 13 ExpirationTimeLimit (global) 11 ExpirationTimeLimit (individuell) 13 FSBwatchSettings.xml 11 Informationsnachricht (individuell) 13 Lizenzanforderungsdatei 11 Mail-Einstellungen 12 Serversuchliste 11 Subsystem 11 UnitCounterLimit (global) 11 UnitCounterLimit (individuell) 13 Warnnachricht 12 Warnnachricht (individuell) 14 - L - Lizenzanforderungsdatei 11, 13 - M - Mail-Einstellungen Konfiguration 12 Mail-Optionen 12 - S - ServerSearchList 11 Subsystem 11 Support Wibu-Systems 6 - U - UnitCounterLimit 11 UnitCounterLimit (individuell) 13 - W - Wibu-Systems Support 6 23