Automatisierte Konfiguration während der Installation (Licensing.ini)

Die Licensing.ini ist eine Konfigurationsdatei, die es Administratoren ermöglicht, die Einstellungen des ETAS-Lizenzmanagers (LiMa) bei der Installation eines ETAS-Produkts (z.B. INCA) automatisch vorzunehmen.

Dieser Prozess macht es überflüssig, dass eine Person nach der Installation Einstellungen wie Lizenzserver oder Ausleihoptionen manuell konfigurieren muss. Es vereinfacht die Softwareverteilung und stellt sicher, dass die Software von Anfang an mit den richtigen Lizenzeinstellungen arbeitet.

Wie die Datei funktioniert

Speicherort: Für jedes Produkt, das eine elektronische Lizenzierung verwendet, gibt es eine Datei Licensing.ini im Produktverzeichnis des Installationsprogramms (z. B. ..\Packages\INCA\Licensing.ini).
Format: Die Datei ist eine einfache Textdatei im INI-Format. Alle Einstellungen gehören in den Bereich [Lizenzierung].
Anmerkungen: Das System ignoriert alle Zeilen, die mit einem Semikolon (;) beginnen. Sie können diese Zeilen verwenden, um Kommentare hinzuzufügen.

Wenn das Softwarepaket bereits auf dem Rechner installiert ist, gilt Folgendes:

Die in der .ini-Datei angegebenen Werte überschreiben die vorhandenen Einstellungen. Wurde z. B. die automatische Ausleihfunktion zuvor manuell deaktiviert, wird sie durch einen entsprechenden Eintrag in der .ini-Datei wieder aktiviert.

Wenn ein Parameter nicht explizit in der .ini-Datei festgelegt ist, bleibt die aktuelle Einstellung unverändert. Dies ist z.B. der Fall, wenn eine neue Installation über eine bestehende INCA-Installation durchgeführt wird und die neue .ini-Datei einige, aber nicht alle dieser Parameter definiert.

Wichtige Parameter

In diesem Abschnitt werden die verfügbaren Parameter erläutert. Das System verlangt, dass die Werte in einfachen Anführungszeichen stehen (z. B. "true", "60", "C:\Temp").

ImmediateBorrow

ImmediateBorrow setzt den Wert auf true oder false.

BEISPIEL

LicenseFileName

LicenseFileName gibt den Pfad zu einer Lizenzdatei (.lic) an. Das Installationsprogramm kopiert diese Datei während des Installationsvorgangs automatisch auf den lokalen Rechner.

BEISPIEL

LicensesToBorrow

LicensesToBorrow definiert eine Liste von Lizenzen (Features) für die automatische Ausleihe. Trennen Sie die Merkmalsnamen durch Leerzeichen.

BEISPIEL

BorrowExpiryMode

BorrowExpiryMode löst eine einmalige Ausleihe nach der Installation aus. Die Art und Weise, wie das Enddatum eines Kredits berechnet wird, wird durch den Wert Interval oder Date definiert.

BEISPIEL

(Wenn Sie Intervall als Wert verwenden, müssen Sie die Option BorrowExpiryInterval setzen. Weitere Informationen finden Sie unter BorrowExpiryInterval.

BEISPIEL

(Wenn Sie Intervall als Wert verwenden, müssen Sie die Option BorrowExpiryDate setzen. Weitere Informationen finden Sie unter BorrowExpiryDate.

BorrowExpiryInterval

Legt die Anzahl der Tage für eine einmalige Ausführung der Ausleihe fest. Nur gültig, wenn BorrowExpiryMode = 'Interval'.

BEISPIEL

BorrowExpiryDate

Legt das Enddatum der Ausleihaktion fest. Nur gültig, wenn BorrowExpiryMode = 'Interval'. Das Format ist "jjjj-mm-tt".

BEISPIEL

BorrowAutomaticExtensionInterval

BorrowAutomaticExtensionInterval gibt die Anzahl der Tage für die Ausleihfrist an (z. B. 60 Tage), wenn die automatische Ausleihe aktiviert ist (siehe AutoborrowActive). In der LiMa-Schnittstelle entspricht dies der Spalte Entleihintervall (in Tagen).

BEISPIEL

Der Wert 60 verlängert die Ausleihe, so dass das Enddatum heute + 60 Tage ist.

ExecuteBorrowAutomaticExtensionInterval

ExecuteBorrowAutomaticExtensionInterval legt fest, wie viele Tage vor Ablauf der Leihfrist das System versucht, die Lizenz automatisch um ein weiteres Intervall zu verlängern, wenn Autoborrow aktiv ist (siehe AutoborrowActive). In der LiMa-Schnittstelle entspricht dies der Spalte Verlängerungszeitraum (in Tagen).

BEISPIEL

AutoborrowActive

AutoborrowActive legt fest, ob der Modus der automatischen Ausleihe aktiv ('true') oder inaktiv ('false') ist. Die in BorrowAutomaticExtensionInterval und ExecuteBorrowAutomaticExtensionInterval definierten Werte legen das genaue Verhalten fest.

AutoborrowCutterActive

Falls der Flexera Lizenzserver ausgeliehene Einträge vergisst, wird im interaktiven Modus der so genannte Cutter ausgelöst. Es erscheint ein Pop-up-Dialog, in dem Sie gefragt werden, ob Sie das ausgeliehene Objekt aus der Registrierung entfernen möchten. Im Falle eines automatisierten Modus wie dem autoborrow-Modus ist dieser interaktive Modus nicht erwünscht.

Um diese Situation automatisch zu behandeln, setzen Sie AutoborrowCutterActive = 'true' in der Datei Licensing.ini.

Wenn dieser Parameter aktiviert ist, behandelt das System automatisch den spezifischen Lizenzserverfehler (-124). Anstatt ein Pop-up-Fenster anzuzeigen, wird der ungültige Borgen-Eintrag im Hintergrund aus der Registrierung entfernt. Durch diese Bereinigung kann der autoborrow-Vorgang ohne Unterbrechung fortgesetzt und eine neue Lizenz erfolgreich ausgeliehen werden.

CustomLicenseFolder

CustomLicenseFolder definiert einen eigenen Ordner, in dem LiMa nach Lizenzdateien sucht.

BEISPIEL

Ports

Der LiMaServer.exe-Prozess startet standardmäßig auf Verbindungen an Port 32200. Da das Ausleihen von Lizenzen eine benutzerspezifische Aktion ist, startet das System für jedes aktive Konto eine eigene LiMaServer-Instanz, anstatt es als einen einzigen Systemdienst laufen zu lassen.

Um mehrere gleichzeitige Sitzungen auf demselben Rechner zu unterstützen, z. B. wenn ein Build-Agent wie Jenkins parallel zu einer interaktiven Desktop-Sitzung läuft, können Sie einen Bereich verfügbarer Ports definieren.

Während der Installation geben Sie die Ports in der Datei Licensing.ini durch eine durch Leerzeichen getrennte Liste an:

BEISPIEL

Wenn zusätzliche Ports nicht explizit definiert sind, sucht LiMa automatisch nach dem nächsten verfügbaren Port für alle nachfolgenden Instanzen.

Sie können die Anschlusskonfiguration nach der Installation direkt in im Windows-Registry ändern.

Öffnen Sie das Windows-Registry.
Navigieren Sie zu dem LiMa-Schlüssel unter Wow6432Node.
Erstellen oder ändern Sie die Zeichenkette " Ports".
Geben Sie die Anschlussnummern durch ein Semikolon getrennt ein (z. B. 32200;32201;32202).

ActivationIdentifiers

ActivationIdentifiers spezifiziert die Lizenzaktivierung während der Installation für Lizenzen, die auf FlexNet Embedded basieren.

Um mehrere Lizenzen gleichzeitig zu aktivieren, geben Sie eine durch Leerzeichen getrennte Liste mit den Bezeichnungen der Lizenzen an.

BEISPIEL

ActivationMode

ActivationMode löst eine automatische Online-Aktivierung während der Installation aus.

Note
Für eine erfolgreiche Online-Aktivierung benötigen Sie eine funktionierende Internetverbindung mit Zugang zum ETAS-Lizenzportal.

BEISPIEL

ActivationMode='online'

ActivationPath

ActivationPath definiert den Standardordner für die Speicherung der Anfrage- und Antwort-Bin-Dateien.

BEISPIEL

LiMaOption.exe Tool

Während die Datei Licensing.ini verwendet wird, um die Einstellungen während der Produktinstallation zu konfigurieren, können Sie mit dem Befehlszeilentool LiMaOption.exe dieselben Einstellungen nach der Installation ändern. Seit LiMa Version 1.8.6 können Sie die Werte aus dem Optionsdialog über dieses Tool oder über Einträge in der Datei Licensing.ini konfigurieren.

Verwendung des LiMaOption-Tools

Sie finden das Tool im bin-Ordner des LiMa-Installationsverzeichnisses:

C:\Program Files\Common Files\ETAS\Licensing\bin\

Um weitere Einzelheiten zu erfahren, öffnen Sie eine Eingabeaufforderung in diesem Verzeichnis und führen Sie den folgenden Befehl aus:

Die zulässigen Optionen werden angezeigt.

Option	Erläuterung
	Hilfe anzeigen
	Aktuellen Status aller Eigenschaften anzeigen
	Anzeige und Migration von FNP- zu FNE-Artikeln
	Wert '0' aus, Wert '1' ein
	Wert '0' bis '3' für mögliche Wiederholungsversuche beim Checkout
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert '0' aus, Wert '1' ein
	Wert wie JJJJ-MM-TT
	Wert wie 'aus', 'einmal', 'immer'

Beispiel für die Datei Licensing.ini

Das Installationsprogramm benötigt die Abschnittsüberschrift [Licensing], um die Einstellungen in der Datei Licensing.ini korrekt zu erkennen und anzuwenden.

Es ist zwar zulässig, dass der Abschnitt keine Konfigurationsparameter enthält, doch wird die Datei ohne diese in eckige Klammern eingeschlossene Kopfzeile als ungültig betrachtet.

Kopieren