Sie sind auf Seite 1von 13

3S Licensing Manager Anwenderdokumentation

Copyright 2004, 2006 by 3S - Smart Software Solutions GmbH Alle Rechte vorbehalten.

Fr Hinweise auf Fehler und Verbesserungsvorschlge zum vorliegenden Dokument sind wir jederzeit dankbar.

Herausgeber: 3S - Smart Software Solutions GmbH Memminger Strae 151 D-87439 Kempten Tel. +49/ 831/ 5 40 31 - 0 Fax +49/ 831/ 5 40 31 - 50

Dokumentversion: Stand:

1.2 03.02.2006

Inhalt

Inhalt
1 Lizenzmanagement mit dem 3S Licensing Manager 2 Installation und Start 3 Bedienung 3.1 3.2 3.3 4 Hinweise 1-1 2-2 3-1 Der Startdialog ................................................................................................... 3-1 Der Add License Wizard .................................................................................... 3-2 Der Edit License Wizard..................................................................................... 3-5 4-1

3S Licensing Manager

1 - Lizenzmanagement mit dem 3S Licensing Manager

Lizenzmanagement mit dem 3S Licensing Manager


Der Lizenz-Manager "3S Licensing Manager" wird zusammen mit einer 3S-Anwendung installiert und dient zur Verwaltung der 3S-Lizenzen auf dem Rechner. Er bietet: eine bersicht aller auf dem Rechner vorliegenden 3S-Lizenzinformationen einen Wizard zum Anfordern einer neuen Lizenzen (Add License) einen Wizard zur Anforderung einer aktualisierten bzw. modifizierten Lizenz (Edit License) eine Funktion zur Installation einer 3S-Lizenz auf Basis einer *.3sl-Datei

Der Lizenz-Manager arbeitet auf Basis der Lizenzinformation, die in einer modulzugehrigen Datei (*.3sm) bzw. z.B. bei Bibliotheken implizit zur Verfgung steht. Sie umfasst die folgende Punkte: Identitt, Version, Titel, Hersteller, Bezugsmglichkeit, detaillierte Beschreibung, Preisinformation zum Modul, sowie bestimmte Attribute der Lizenzierung wie beispielsweise Anzahl der zugelassenen Benutzer und Laufzeit. Die Lizenzinformation wird in der Regel automatisch whrend der Installation eines 3S-Moduls auf dem Rechner abgelegt, bei Bibliotheken zum Zeitpunkt des ersten Einbindens in ein Projekt. Ab diesem Zeitpunkt ist die Lizenzinformation im Lizenz-Manager bekannt. Die Module werden in der Regel zunchst im Demo-Modus mit einer in der Lizenzinformation definierten Laufzeit verfgbar sein. Eine Lizenz (die Bezeichnung fr "lizenziert" in der Lizenzinformation ist modulabhngig, meist: Voll-Modus oder Licensed Modus) muss dann, wenn bentigt, nachtrglich beantragt und installiert werden. Die Lizenzinformation fr ein Modul kann auch explizit durch das Einlesen der *.3sm-Datei im LizenzManager auf dem Rechner angelegt werden: Funktion 'Install License'. Eine Lizenzprfung erfolgt bei lizenzpflichtigen Modulen beim Start, bzw. bei Bibliotheken beim Einbinden in ein CoDeSys Projekt.

Lizenzpflichtige 3S Software Module Neben den 3S-Modulen wie z.B. ENI Server, CoDeSys SP PLCWinNT, CoDeSys SP RTE, CoDeSys HMI, SoftMotion, WebServer und div. Bibliotheken knnen auch nicht von 3S erstellte, herstellerspezifische Bibliotheken der Lizensierungspflicht unterworfen sein.

3S Licensing Manager

1-1

2 - Installation und Start

Installation und Start


Der Lizenzmanager (3S Licensing Manager) wird bei der Installation Programmiersystems bzw. eines lizenzpflichtigen 3S-Moduls mit installiert. Er kann danach aus dem CoDeSys Start-Men gestartet werden, aber auch . aus dem Meldungsdialog, der bei einer negativ verlaufenen Lizenzprfung beim Starten eines 3S-Moduls bzw. beim Einfgen einer lizenzpflichtigen Bibliothek in CoDeSys ausgegeben wird. aus der Fehlermeldung, die beim bersetzen eines CoDeSys Projekts ausgegeben wird, wenn eine Bibliothek verwendet wird, fr die keine gltige Lizenz installiert ist.: Ein Doppelklick auf die Fehlermeldung im Meldungsfenster (bzw. Befehl 'Nchster Fehler' oder <F4>) ffnet zunchst den Dialog 'Lizenz-Information', aus dem zum Lizenz-Manager Startdialog gelangt werden kann. im License Management Dialog von ENI Admin oder ber die Schaltflche 'License Management' im Service-Dialog von ENI Control ber den Menbefehl 'License' im CoDeSys SP RTE-Men, das ber einen Mausklick auf das RTE-Symbol in der Taskleiste geffnet werden kann. des CoDeSys

3S Licensing Manager

2-2

3 - Bedienung

3
3.1

Bedienung
Der Startdialog
Der Startdialog des 3S Licensing Managers zeigt in einer Tabelle alle lizenzpflichtigen Module an, die entweder im Demo-Modus auf dem Rechner verfgbar sind oder fr die bereits eine Lizenz installiert wurde. (Wird ein lizenzpflichtiges Modul in CoDeSys verwendet, bevor eine Lizenz vorliegt, ist es in der Regel im Demo-Modus verfgbar.) Die Eintrge sind mit Icons gekennzeichnet: Demoversion bzw. Lizenzpflichtige Version, fr die keine Lizenz installiert ist und die gltige Laufzeit noch nicht berschritten ist. ber 'Add License' kann eine Lizenz erstmalig beantragt werden Demoversion bzw. Lizenzpflichtige Version fr die keine Voll-Lizenz installiert ist, deren Laufzeit jedoch berschritten ist. ber 'Add License' kann eine Lizenz erstmalig beantragt werden Lizenzpflichtige Version, Lizenz installiert und gltig ber 'Edit License' kann eine modifizierte Version der Lizenz beantragt werden Lizenzpflichtige Version, Lizenz installiert, aber nicht mehr gltig ber 'Edit License' kann ein Update der Lizenz, ggfs. modifiziert, beantragt werden

Auerdem werden folgende Angaben aus den Lizenzinformationen angezeigt: Module: Mode: Der Name des lizenzierten Moduls Angabe, ob es sich um eine Demo- oder lizenzierte Version handelt. Die mglichen Modus-Bezeichnungen sind abhngig von der Lizenzinformation. Beispielsweise wird fr den ENI Server die Bezeichnung "Licensed" verwendet, wenn eine Lizenz installiert ist, bei anderen Modulen oder Bibliotheken dagegegen z.B. "Voll". Restlaufzeit fr die Demo- bzw. Lizenzversion in Tagen

Expires:

Runs left: Diese Anzeige ist momentan ohne Funktion, es wird immer 'unlimited' angegeben. Die Schaltflchen : Add License Fhrt zum Add License Wizard, mit Hilfe dessen Sie fr das in der Liste markierte Modul eine erstmalige Lizenz beantragen knnen, fr das also die Lizenzinformation auf dem Rechner angelegt ist, aber bisher noch keine Lizenz installiert war. Sie knnen dabei auch gleich eine Modifikation der Standard-Feature-Werte der Lizenz beantragen. Install License Installieren einer Lizenz (Lizenzinformation ist also noch nicht im Lizenz-Manager sichtbar) auf Basis einer *.3sl-Datei. Whlen Sie diese Schaltflche, wenn sie fr ein Modul eine Lizenz per Email angefordert hatten (Add License bzw. Edit License Wizard) und nun vom Lizenzgeber eine Datei <module name>.3sl geschickt bekommen haben, die den Lizenzschlssel (License key) enthlt. Diese Datei kann mit dem hier verfgbaren Standarddialog zum ffnen einer Datei eingelesen werden. Markieren Sie dazu vorher das Modul in der Auswahlliste und drcken Sie 'Install License'.

3S Licensing Manager

3-1

3 - Bedienung

Whlen Sie dann die erhaltene *.3sl-Datei aus und drcken die Schaltflche 'ffnen'. Daraufhin schliet der Dialog, die Lizenz ist installiert und im Lizenz-Manager sichtbar. Beachten Sie: Wenn Sie die Lizenz per Telefon angefordert hatten, knnen Sie sie nicht mit der 'Install License' - Funktion installieren. In diesem Fall muss der Lizenzschlssel per Hand im Dialog des 'Add License' bzw. 'Edit License'-Wizards eingegeben werden. Edit License Fhrt zum Edit License Wizard, mit dem fr das in der Liste markierte Modul, also fr eine bereits installierte Lizenz ein Update bzw. eine in den Feature-Werten modifizierte Version angefordert werden kann. View License Hier erhalten Sie einen Dialog, der in drei Registerblttern die komplette Lizenzinformation zum in der Liste markierten Modul anzeigt: License (Modulname, Lizenzmodus Demo oder Voll, Laufzeit), Features (Zielsystem, fr die das Modul zugelassen ist) und Module (Modul-ID, Kurzbeschreibung, Manufacturer, Vendor, Preisinformation)

3.2

Der Add License Wizard


Dieser Wizard dient dem Beantragen einer Lizenz fr ein Modul, fr das bisher noch keine auf dem Rechner installiert wurde. D.h. die Lizenzinformation ist auf dem Rechner angelegt, das Modul aber bisher nur ggfs. im Demo-Modus verwendbar. Der Wizard wird im Lizenzmanager ber die Schaltflche Add License gestartet. ber die Schaltflche Weiter knnen Sie nacheinander folgende Dialoge durchlaufen: 1. 'Select module': Alle lizenzpflichtigen 3S-Module und Bibliotheken auf Ihrem Rechner werden aufgelistet. In der Auswahlbox bei 'Detailed information' knnen die Lizenzinformationen 'Description' (Kurzbeschreibung), 'Manufacturer' (Hersteller), 'Vendor' (Verkufer) und 'Pricing information' (Preisinformation) abgerufen werden, die vom Ersteller des Moduls eingetragen wurden. Soll die Lizenzinformation fr ein weiteres Modul explizit hinzugefgt werden, weil sie aus irgendeinem Grund noch nicht im Lizenzmanager bekannt ist, kann ber die Schaltflche Further modules die zugehrige Beschreibungsdatei (*.3sm) ausgewhlt und eingelesen werden.

3-2

3S Licensing Manager

3 - Bedienung

2. 'Edit features': Der Dialog enthlt eine Tabelle mit den Modul-Lizenzparametern (Feature list), die beim Erstellen des Moduls in der Lizenzinformation festgelegt wurden. Bei Bedarf knnen vor Beantragen der Lizenz diese Parameter noch verndert werden.

Die Spalten: Feature: Current value: Desired value:

Art des Features (z.B. Target range: Zielsystem Ids, fr die die Lizenz gilt) Der aktuell gesetzte Wert, z.B. "42" als Target Id fr Feature 'Target range' Durch einen Doppelklick auf dieses Feld wird ein Editierrahmen geffnet, wo bei Bedarf ein gewnschter neuer Wert fr das Feature eingegeben werden kann; die Eingabe-Syntax fr mehrere Target IDs: strichpunktseparierte Liste bzw. Bereichsangaben mit Bindestrich, z.B. "14;15;18-20"

Unterhalb der Tabelle werden zum aktuell markierten Tabelleneintrag der Datentyp (Type) und eine Kurzbeschreibung zur Bedeutung des Eintrags angegeben. Mit der Schaltflche Weiter gelangen Sie zum Dialog

3. 'Choose activation method'

Whlen Sie hier den Weg der Lizenzanforderung:

Activate via mail / Save license request to disk siehe unter 4.a Bitte whlen Sie mglichst diesen Weg, um eine fehlerfreie bertragung der Anforderungs- und Lizenzdaten zu erleichtern ! Activate via phone Activate an emergency license siehe unter 4.b Diese Option ermglicht in zeitkritischen Situationen eine unmittelbare Lizensierung ohne mit dem Hersteller Kontakt aufnehmen zu mssen. (Eine emergency license ist nur 14 Tage gltig und muss

3S Licensing Manager

3-3

3 - Bedienung

dann durch eine regulre ersetzt werden, die ber einen der oben beschriebenen Wege vom Hersteller anzufordern ist.) Sie gelangen direkt zum Finish emergency license Dialog. Sobald dieser ber Fertigstellen geschlossen wurde, ist das Modul lizensiert. 4.a Wenn Sie die Lizenz via mail anfordern wollen, erscheint als nchstes der Dialog 'Enter customer information' Geben Sie hier die entsprechenden Kontakt-Informationen ein und besttigen mit Weiter. Es folgt der Dialog 'Finish' Bei Lizenz-Anforderung per email wird nun automatisch eine email generiert, die an den Lizenzverwalter adressiert ist und im Anhang eine Datei <modulename>.3sr mit den ntigen Angaben enthlt. Die Anforderungsdatei *.3sr kann zustzlich im lokalen Dateisystem abgelegt werden. Aktivieren Sie dazu Option Save to disk und whlen Sie den Speicherort aus: ffnet den Standard-Dialog zum Speichern einer Datei. Schlieen Sie dann den Finish-Dialog mit Fertigstellen. Sobald Sie spter per email in einer *.3sl-Datei den angeforderten Lizenzschlssel (License key) erhalten haben, whlen Sie die Schaltflche Install License, um die Lizenz auf Ihrem Rechner zu installieren (siehe Kapitel 3.1). 4.b Wenn Sie die Lizenz via phone (per Telefon) anfordern wollen, folgt der Dialog 'Provide information during the phone call', der die Informationen enthlt, die Sie fr das Gesprch mit dem Lizenzgeber bentigen: Telefonnummer, Modul-Id, gewnschte nderungen der Standardwerte der Lizenz-Features (aus Dialog 'Edit features'), Request-Key (dient der zustzliche Abprfung der Konsistenz von vorgenommenen und angegebenen Feature-nderungen). Falls Sie eine Kundennummer haben, halten Sie auch diese bereit (Customer ID).

Wenn dieser Dialog mit Weiter geschlossen wird, erhalten Sie den Dialog

3-4

3S Licensing Manager

3 - Bedienung

'Finish' wo Sie den beim Telefongesprch vom Lizenzverwalter erhaltenen Lizenzschlssel (License Key) eintragen und mit Fertigstellen besttigen. Daraufhin wird die Lizenz automatisch auf Ihrem Rechner installiert.

3.3

Der Edit License Wizard


Dieser Wizard dient der Anforderung einer modifizierten Lizenz oder eines Lizenz-Updates. Das heit, Sie haben fr das Modul bereits eine Lizenz auf ihrem Rechner installiert, bentigen aber eine Vernderung deren Features oder eine Erneuerung (Update), weil die Lizenz abgelaufen ist. Der Wizard kann im 3S License Manager ber die Schaltflche Edit License gestartet werden. Die Dialoge: 1. 'Welcome' 2. 'Edit features' Infos zur Bedienung des Wizards Der Dialog entspricht dem, der im 'Add License Wizard' enthalten ist, siehe Kapitel 3.2. Hier ist eine Neudefinition der in der bisherigen Lizenz gltigen Feature-Werte mglich. siehe ebenfalls Kapitel 3.2, Add License Wizard

3. 'Choose activation method' und 4. 'Finish'

3S Licensing Manager

3-5

4 - Hinweise

Hinweise
Es ist ratsam, sich die fr Module und Bibliotheken erhaltenen Lizenzschlssel zu notieren und aufzubewahren, so dass die Lizenzen im Falle einer korrupten Lizenzdatenbank ggfs. neu installiert werden knnen. In seltenen Fllen schlgt die Lizenzanforderung per Email fehl, weil der anfordernde Rechner nicht wie der 3S License Manager mit dem Standard-Email-Client arbeitet. Stellen Sie dann bitte eine telefonische Anforderung bzw. schreiben Sie die Anforderungsdaten in eine explizit erstellte Email. Von Vorteil ist in diesem Fall, wenn Sie die Anforderungsdatei via Option Save license request to disk (siehe Kap. 3.2, Punkt 3) im lokalen Dateisystem abgelegt haben. Lizenzbertragungen auf einen anderen Rechner sind nicht mglich. Falls die Notwendigkeit besteht, ggfs. weil ein alter durch einen neuen Rechner ersetzt werden muss, setzen Sie sich bitte mit dem Lizenzgeber in Verbindung.

3S Licensing Manager

4-1