Skip to main content

Konfiguration

Die Konfiguration des CODESYS Mass Licenser erfolgt über eine Konfigurationsdatei. Die Datei muss den Namen CML.cfg haben und im Verzeichnis C:\ProgramData\CODESYS CML\configuration\ liegen.

Ohne die Konfigurationsdatei startet das Add-on CODESYS Mass Licenser nicht.

Wichtig

Um die CFG-Datei zu erstellen, werden Administratorrechte benötigt.

Grundsätzlich gib es zwei unterschiedliche Lizenzkonfigurationen:

  • Konfiguration für ein Lizenzticket, das lediglich eine Lizenz enthält.

  • Konfiguration für ein Lizenzticket für eine Bundle-Lizenz für mehrere Produkte

    Eine Bundle-Lizenz umfasst immer mehrere, nicht identische Produkte. Ein Beispiel dafür ist eine applikationsbasierte Laufzeitsystem-Lizenz (CODESYS Control Basic). Diese Bundle-Lizenz enthält standardmäßig auch die Lizenz zum Betrieb der TargetVisu und der WebVisu (CODESYS Visualization S) und die Lizenz für den Betrieb der Symbolkonfiguration, des Kommunikationsverwalters und des Datenquellenmanagers (CODESYS Communication S). Sie enthält keine Lizenz für den Betrieb einer Soft-SPS.

Beispiel 1. Beispiel

Konfigurationsdatei für die Lizenztypen Einzellizenz und Bundle-Lizenz

Einzellizenz

Bundle-Lizenz

{
    "Settings" : [
        { "Username" : "admin" },
        { "Password" : "admin" },
        { "LicenseCentralUrl" : "https://license.codesys.com/gateways"},
        { "GatewayAddress" : "192.168.101.67" },
        { "FilterDeviceId" : "0x8041"},
        { "FilterNodeName" : "^MyDevice-*"},
        { "LogVerbose" : false},
        { "ConnectTimeout" : 0},
        { "LogRotateEntries" : 10000},
        { "KeepUserDB" : false },
        { "LicenseDongle" : false },
        { "LicensesFillLevel" : 10 },
        { "LicensesFillLevelAction" : "<FilePath>" },
    ],
    "Licenses" : [
        {
            "LicenseName" : "1stlicense",
            "LicenseFile" : "%APPDATA%\\CODESYS CML\\licenses\\CML_TestA_LicenseA.txt",
            "LicenseFirmCode"    : 6000437,
            "LicenseProductCode" : 20000,
            "LicenseFeatureMap"  : "",
        },
        {
            "LicenseName" : "2ndlicense",
            "LicenseFile" : "%APPDATA%\\CODESYS CML\\licenses\\CML_TestA_LicenseB.txt",
            "LicenseFirmCode"    : 6000437,
            "LicenseProductCode" : 20001,
            "LicenseFeatureMap"  : "0004",
         }
    ]
} 
{
    "Settings" : [
        { "Username" : "admin" },
        { "Password" : "admin" },
        {"LicenseCentralUrl" : "https://license.codesys.com/gateways"},
        { "GatewayAddress" : "192.168.101.67" },
        { "FilterDeviceId" : "0x8041"},
        { "FilterNodeName" : "^MyDevice-*"},
        { "LogVerbose" : false},
        { "ConnectTimeout" : 0},
        { "LogRotateEntries" : 10000},
        { "KeepUserDB" : false },
        { "LicenseDongle" : false },
        { "LicensesFillLevel" : 10 },
        { "LicensesFillLevelAction" : "<FilePath>" },
    ],
    "Licenses" : [
        {
            "LicenseName" : "1stlicense",
            "LicenseFile" : "%APPDATA%\\CODESYS CML\\licenses\\CML_TestA_LicenseA.txt",
            "LicenseFirmCode"    : 6000437,

            "LicenseBundle" :    [
                {
                    "LicenseProductCode" : 12290,
                    "LicenseFeatureMap"  : "2000"
                },
                {
                    "LicenseProductCode" : 12291,
                    "LicenseFeatureMap"  : "0800"
                },
                {
                    "LicenseProductCode" : 12292,
                    "LicenseFeatureMap"  : "0200"
                }
            ]
        }
    ]
}

Tipp

Weitere Beispiele finden Sie nach der Installation unter C:\ProgramData\CODESYS CML\configuration\.



Parameterbeschreibung

Parameter

Beschreibung

Standardwert

Datentyp

Optional

Username

Benutzername, mit dem der CODESYS Mass Licenser die temporäre Nutzerverwaltung anlegt

CMLTool

STRING

Ja

Password

Passwort, mit dem der CODESYS Mass Licenser die temporäre Nutzerverwaltung anlegt

Seriennummer des Gerätes

STRING

Ja

GatewayAddress

Adresse des Gateways, über die die Steuerungen erreichbar sind

Localhost

STRING

Ja

FilterDeviceId

Filter für die Geräte-ID

Nur Geräte mit passender ID werden vom CODESYS Mass Licenser berücksichtigt. Für hexadezimale Werte geben Sie das Präfix 0x an. Sie können die Werte entweder der Gerätebeschreibung entnehmen oder durch einen Scan in CODESYS ermitteln.

STRING

Ja

FilterNodeName

Filter für den Gerätenamen

Nur Geräte mit passenden Namen werden vom CODESYS Mass Licenser berücksichtigt. C#-Regex-Ausdrücke sind erlaubt.

STRING

Ja

LogVerbose

Detaillierungsgrad der Logausgabe

FALSE: Keine Details

TRUE: Ausgabe mit Details

FALSE

BOOL

Ja

ConnectTimeout

Erlaubte Zeitdauer für die Herstellen einer Verbindung

20 Sekunden

Integer

Ja

LogRotateEntries

Anzahl der Einträge, die in der Logdatei gespeichert werden

Danach werden die Einträge überschrieben.

Integer

Ja

KeepUserDB

Gibt an, ob der durch Username und Password definierte Anwender nach dem Lizenzierungsvorgang erhalten bleibt

Diese Einstellung sollte aus Sicherheitsgründen nur für Geräte mit bereits vorkonfigurierter Benutzerverwaltung verwendet werden. Andernfalls bleibt die hier konfigurierte Benutzerverwaltung, die nicht vom Anwender direkt erstellt wurde, bestehen.

FALSE

BOOL

Ja

LicenseDongle

Gibt an, ob die Lizenz auf einen Wibu Lizenz-Dongle gespielt wird

Am Gerät darf jeweils nur ein Dongle gesteckt sein. Standardmäßig wird die Lizenz in einen Softcontainer gespielt.

FALSE

BOOL

Ja

LicensesFillLevel

Gibt eine Mindestanzahl verfügbarer Lizenzen an, unterhalb derer eine Warnung ausgegeben wird.

10

Integer

Ja

LicensesFillLevelAction

Gibt einen Pfad zu einer ausführbaren Datei an, die augerufen wird, sobald die Mindestanzahl verfügbarer Lizenzen unterschritten wird.

String

Ja

Unter dem Feld "Licenses" tragen sie die Lizenzen ein, die sie auf den Steuerungen aktivieren möchten. Dazu sind einige Parameter nötig:

Parameter

Beschreibung

LicenseName

Name der Lizenz

Dieser Parameter dient lediglich der Differenzierung in Log-Ausgaben.

LicenseFile

Verzeichnis, in dem die Textdateien mit den jeweiligen Lizenzen abgelegt sind

Diese muss existieren, damit der CODESYS Mass Licenser startet.

LicenseFirmCode

Firmcode der jeweiligen Lizenz

Die Firmcodes sind in nachfolgender Tabelle gelistet.

LicenseProductCode

Produktcode der jeweiligen Lizenz

Die Produktcodes sind in nachfolgender Tabelle gelistet.

LicenseFeatureMap

Feature-Map der jeweiligen Lizenz

Die Feature-Maps sind in nachfolgender Tabelle gelistet.

LicenseBundle

Parameter für Bundle-Lizenzen

LicenseFeatureMap und LicenseProductCode müssen bei Bundle-Lizenzen gruppiert unter diesem Eintrag eingetragen werden.

Wichtig

Beachten Sie, dass für eine erfolgreiche Lizenzierung mit dem CODESYS Mass Licenser alle Lizenzen den gleichen Firmcode haben müssen.

Wenn sich bereits ein Lizenzcontainer auf Ihrem Gerät befindet, stellen Sie sicher, dass die einzuspielenden Lizenzen den gleichen Firmcode haben. Außerdem müssen Sie den CODESYS Mass Licenser ebenfalls mit dem Firmcode des vorhandenen Lizenzcontainers konfigurieren.

Wichtig

Für detaillierte Informationen und eine aufgeschlüsselte Liste aller Lizenzen und der zugehörigen Firm- und Productcodes wenden Sie sich bitte an sales@codesys.com.