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.

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").

LicensingInstallationMode

Der Parameter LicensingInstallationMode kann einen der folgenden Werte annehmen:

  • Interactive

  • Automated

  • None

BEISPIEL

LicensingInstallationMode = 'Automated'

Info 

Dieser Modus wird nicht mehr verwendet, da während der Installation die interaktive Lizenzinstallation entfernt wird.

Interactive

Wenn _interactive_mode ausgewählt ist, wird in der späten Phase einer Produktinstallation ein Dialog geöffnet, in dem Sie eine Lizenz suchen und auswählen können.

Info 

Diese interaktive Einstellung führt zu einer zusätzlichen Benutzerinteraktion während der Produktinstallation. Nur wohlüberlegt einsetzen!

Im Falle einer stillen Installation (entweder /s oder /basic oder entsprechende MSI-Parametereinstellung) wird der interaktive Modus unterdrückt (d.h. wird kein Dialog angezeigt).

Automated

Wenn der automatische Modus gewählt wird, werden weitere Parameter ausgewertet und verarbeitet. Wenn Sie nicht den automatischen Modus wählen, haben diese Parameter keine Wirkung:

  • LicenseFileName

  • GeneralLicense

  • CustomerName

  • LicenseSerialNumber

  • LicensesToBorrow

  • BorrowExpiryMode

  • BorrowExpiryDate

  • BorrowExpiryInterval

  • BorrowAutomaticExtensionInterval

  • ExecuteBorrowAutomaticExtensionInterval

  • ImmediateBorrow

ImmediateBorrow

ImmediateBorrow setzt den Wert auf true oder false.

BEISPIEL

ImmediateBorrow = 'true'

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

LicenseFileName = 'D:\Licences\MyLicences.lic'

LicensesToBorrow

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

BEISPIEL

LicensesToBorrow = 'INCA ASCET_MD'

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

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

BEISPIEL

BorrowExpiryMode = 'Date' (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

BorrowExpiryInterval = '70'

BorrowExpiryDate

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

BEISPIEL

BorrowExpiryDate = '2008-11-25'

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

BorrowAutomaticExtensionInterval = '60'

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

ExecuteBorrowAutomaticExtensionInterval = '30'

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

CustomLicenseFolder = 'C:\My_Licenses'

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

Ports = '32200 32201 32202'

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.

  1. Öffnen Sie das  Windows-Registry.

  2. Navigieren Sie zu dem LiMa-Schlüssel unter Wow6432Node.

  3. Erstellen oder ändern Sie die Zeichenkette " Ports".

  4. 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

ActivationIdentifiers ='aaaa-0000-1111-2222-bbbb-0‘

ActivationMode

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

Info 

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

Aktivierungspfad = 'C:\temp\lima_activation'

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\

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

    LiMaOption.exe --help

    Die zulässigen Optionen werden angezeigt.

Option

Erläuterung

--help

Hilfe anzeigen

--show

Aktuellen Status aller Eigenschaften anzeigen

--show_migration arg

Anzeige und Migration von FNP- zu FNE-Artikeln

--autoborrow_cutter_active arg

Wert '0' aus, Wert '1' ein

--checkout_retries arg

Wert '0' bis '3' für mögliche Wiederholungsversuche beim Checkout

--refresh_at_startup arg

Wert '0' aus, Wert '1' ein

--remaining_days_visible arg

Wert '0' aus, Wert '1' ein

--skip_on_hostdown arg

Wert '0' aus, Wert '1' ein

--remember_windows arg

Wert '0' aus, Wert '1' ein

--offline_mode arg

Wert '0' aus, Wert '1' ein

--autoborrow_visible arg

Wert '0' aus, Wert '1' ein

--operating_version_visible arg

Wert '0' aus, Wert '1' ein

--reparse_descriptions arg

Wert '0' aus, Wert '1' ein

--policy_type_visible arg

Wert '0' aus, Wert '1' ein

--serial_number_visible arg

Wert '0' aus, Wert '1' ein

--offline_mode_end_date arg

Wert wie JJJJ-MM-TT

--upgrade_mode arg

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 
[Licensing]
; format: absolute file path to license file
;LicenseFileName = 'c:\temp\somelicensefilename.lic'
; format: LicenseName1 LicenseName2 use blanks to separate licenses
;LicensesToBorrow = ‘INCA’
; format: Modes 'Interval' and 'Date' are possible
;BorrowExpiryMode = 'Interval'
; format: yyyy-mm-dd
;BorrowExpiryDate = '2022-02-10'
; format: number of days
;BorrowExpiryInterval = '100'
; format: number of days
;BorrowAutomaticExtensionInterval = '100'
; format: number of days when automatic borrow extension is perfomed.
;ExecuteBorrowAutomaticExtensionInterval = '1'
; format: a boolean string 'true' or 'false' defines if auto borrow extension is active
;AutoborrowActive = 'true'
; format: a list of ports separated by blanks, an empty string resets to one single port 32200
;Ports = '32200 32201 32202'
; format: a list of activation identifiers separated by blanks
;ActivationIdentifiers='abcd efgh ijkl'
; format: use this flag to enable automatic online activation
;ActivationMode='online'
; format: an absolute path to the location, where request and response bin files are stored
;ActivationPath='an absolute path'
; format: a boolean value which defines if an autoborrow task shall cut invalid value of borrow information automatically
;AutoborrowCutterActive = 'true'
; format: a number out of 0, 1, 2, 3 ,which defines the amount of retries during checkout
;CheckoutRetries = '3'
; format: a boolean which defines the refresh/update of all features during GUI launch
;RefreshAtStartup = 'true'
; format: a boolean value which defines if the remaining day information column is visible
;RemainingDaysVisible = 'false'; format: a boolean value which defines the skip of further checks in case the license server is down
;SkipOnHostdown = 'true'
; format: a boolean value which defines if the geometry of the LiMa GUI is preserved
;RememberWindows = 'false'
; format: a boolean value which defines if the offline mode is active, this has to be used in conjunction with the parameter 'OfflineModeEndDate'
;OnOfflineMode = 'false'
; format: a boolean value which defines if autoborrow related columns are visible
;AutoborrowVisible = 'false'
; format: a boolean value which defines if the operating version of a feature is visible
;OperatingVersionVisible = 'false'
; format: a boolean value which defines if the license description files (xml files) are reread during F5 (update/refresh inside Gui)
;ReparseDescriptions = 'false'
; format: a boolean value which defines if the column related to the policy type (e.g. Flexnet Embedded (FNE), Flexnet Publisher (FNP)) is visible
;PolicyTypeVisible = 'false'
; format: a boolean value which defines if the serial number/activation id is shown in a column
;SerialNumberVisible = 'false'
; format: the offline mode end date in the form YYYY-MM-DD
;OfflineModeEndDate = '2022-02-10'