===== Lizenzdatei USB =====

Eine Lizenzdatei, die für den Einsatz mit der USB-Software-Management-Konsole gedacht ist, wird im Tag **<spelic>** mit dem Attribut **version** (alles Kleinbuchstaben) gekennzeichnet. Dies ist das eindeutige Unterscheidungsmerkmal.

Eine NET-Lizenz lässt sich durch Umbenennung dieses Attributs leicht für den Gebrauch mit der USB-Software-Management-Konsole konvertieren.

Eine Beschreibung des Lizenzierungsprozesses und der USB-Konsole befindet sich hier im Wiki: [[print2forms:lizenzierung:lizenzierung|Lizenzierung]].

Ein typischer Anfang einer USB-Lizenzdatei ist nachfolgend abgebildet:
\\
\\
<code xml>
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE spelic PUBLIC "-//SPE Systemhaus GmbH/lic/V1.0//DTD spelic V1.0//EN" "spelic.dtd">
<!-- ===================================================================================
== NICHT AENDERN  NICHT AENDERN  NICHT AENDERN  NICHT AENDERN  NICHT AENDERN
== DO NOT CHANGE  DO NOT CHANGE  DO NOT CHANGE  DO NOT CHANGE  DO NOT CHANGE
==================================================================================== -->
<spelic version="1.0" type="1">
  <license name="main" from="2018-01-01 00:00:00" until="2022-06-30 23:59:59">
    <value name=".Version">3.9999</value>
    <value name=".Granule">420</value>
    <value name=".SequenceID">4</value>
    <value name=".Bound">400</value>
    <value name=".CustomID">436207799</value>
    <value name=".HashCount">20</value>
    <value name=".HashHold">180</value>
    <value name=".MaxResponse">500</value>
    <value name="Subscription">2020-12-31</value>
    <value name="Copyright">2020 SPE Systemhaus GmbH</value>
    <value name="Company">SPE Systemhaus GmbH</value>
  </license>
</code>
\\
Im Tag **<license>** gibt es zwei Attribute mit dem Namen **from** und **until**. Das sind beides Zeitpunkte im Format 'YYYY-MM-DD HH:MM:SS', die die Gültigkeitsdauer der Lizenzdatei festlegen. Fehlt **until** gilt die Lizenz unbefristet. Liegt **from** in der Zukunft, kann diese Lizenz erst ab diesem Zeitpunkt genutzt werden. Fehlt **from** gilt die Lizenz ab sofort.

Das Tag **<value>** mit dem Namenattributwert **.Version** dient zur Fortschreibung der Versionsnummern der Management-Konsolen, Es schaltet alte Versionen der Konsole ab. Der aktuelle Wert **3.9999** sollte immer beibehalten werden.

Das Tag **<value>** mit dem Namenattributwert **.Granule** bestimmt die Gültigkeitsdauer einer erteilten Lizenz. Der angegebene Wert multipliziert mit 14 ergibt die Dauer in Minuten - hier also 98 Minuten. Nach Ablauf dieser Zeit muss eine neue Lizenzanfrage gestellt werden. ((Es gibt noch einige sehr alte (c4p) Konverter in alten Installationen, die diesen Wert nicht berücksichtigen, sondern mit jeder Netzwerkverbindung eines Druckauftrags eine Lizenzanfrage stellen.\\ \\ ))

Das Tag **<value>** mit dem Namenattributwert **.SequenceID** dient ebenfalls zur Fortschreibung unterschiedlicher Versionen der Lizenzdatei. Ursprünglich wurde der Wert eingeführt, um durch das Hochzählen dieses Wertes bei der USB-Konsole den roten Schlüssel immer wieder für weitere 30 Tage freischalten zu können. Er kann aber auch dazu verwendet werden, den Umfang einer Lizenz zu reduzieren. Nach einmaligem Gebrauch einer Lizenzdatei mit der Sequenznummer x sind alle Lizenzdateien mit einer niedrigeren Sequenznummer ungültig. Der Kunde muss im Falle einer Reduktion die Log-Datei der Konsole als Nachweis für die Nutzung der reduzierten Lizenzdatei liefern.

Das Tag **<value>** mit dem Namenattributwert **.Bound** bestimmt, welchen Build das Konsolen-Programm mindestens haben muss. Damit kann die Nutzung alter Versionen der Konsolen unterbunden werden.

Das Tag **<value>** mit dem Namenattributwert **.CustomID** ist die eigentliche Lizenznummer. Bei der USB-Konsole ist dies die Nummer, die auch im USB-Schlüssel hinterlegt ist. Bei der lokalen und der NET-Konsole kann diese Nummer weitestgehend frei bestimmt werden. Sie sollte aber eindeutig sein. Aus diesem Grund sollte sie hochgezählt werden oder das Datum sollte in die Nummer integriert werden. Bei (p2f) wird jedes Objekt im p2fRoot-verzeichnis mit dieser Nummer gekennzeichnet. Das verhindert, dass XML-Dateien zwischen den Kunden hin- und hergetauscht werden.

Das Tag **<value>** mit dem Namenattributwert **.HashCount** bestimmt, wie oft eine Lizenz ihre Identität (i.d.R. IP- und MAC-Adresse) wechseln darf, bevor das als Lizenzverletzung gewertet wird. Das ist bei der Inbetriebnahme von Installationen von Bedeutung, wenn noch nicht alles wirklich fixiert ist.

Das Tag **<value>** mit dem Namenattributwert **.HashHold** bestimmt die Wartedauer bis zur Erteilung einer neuen Lizenz nach einer festgestellten Lizenzverletzung. Der angegebene Wert multipliziert mit 14 ergibt die Dauer in Minuten - hier also 42 Minuten. Für diese Dauer ist der verletzende Konverter blockiert. Fehlt dieses Tag, ist die Wartedauer die aus **.Granule**. Die Wartedauer kann abgekürzt werden, indem die Konsole angehalten und neu gestartet wird.

Das Tag **<value>** mit dem Namenattributwert **.MaxResponse** definiert die maximale Wartezeit auf Antworten in der Kommunikation mit dem USB-Schlüssel in Millisekunden. Dieser Wert ist eventuell von Bedeutung, wenn die USB-Schlüssel über USB-Extender angebunden sind, und diese sehr langsam sind. Der Wert sollte nur im Notfall angepasst werden. ((Dieser Wert ist bei lokalen und NET-Lizenzen ohne Bedeutung.\\ \\ ))

Das Tag **<value>** mit dem Namenattributwert **Subscription** ist das Datum des Ablaufs einer eventuell abgeschlossenen Subskriptionsvereinbarung in der Form 'YYYY-MM-DD'. Dieses Datum wird von Programmen abgerufen, um zu entscheiden, ob bestimmte Funktionen ausgeführt werden dürfen oder eben nicht. Damit wird sichergestellt, dass Fehlerkorrekturen im Rahmen einer Garantie ausgeliefert werden können, auch wenn keine Subskriptionsvereinbarung besteht. Inzwischen herausgebrachte neue Funktionen stehen diesen Kunden dann trotz neuer Programme nicht zur Verfügung.

Das Tag **<value>** mit dem Namenattributwert **Copyright** dient lediglich zur Kennzeichnung.

Das Tag **<value>** mit dem Namenattributwert **Company** enthält eine kurze Beschreibung des Lizenznehmers, in der Regel der Firmenname. Dieser wird im Kontrollfeld von (c4p) und (p2f) in der Titelleiste angezeigt.
\\
\\
Der Installer für die USB-Software-Management-Konsole ist über die Download-Seiten von (c4p) und (p2f) verfügbar.
\\
\\