Configuration automatisée lors de l'installation (Licensing.ini)

Le fichier Licensing.ini est un fichier de configuration qui permet aux administrateurs de prédéfinir automatiquement les paramètres de l'ETAS License Manager (LiMa) lors de l'installation d'un produit ETAS (par exemple, INCA).

Ce processus élimine la nécessité pour toute personne de configurer manuellement des paramètres tels que les serveurs de licences ou les options d'emprunt après l'installation. Il simplifie le déploiement du logiciel et garantit que le logiciel fonctionne avec les paramètres de licence corrects dès le départ.

Fonctionnement du fichier

• Emplacement : Pour chaque produit utilisant une licence électronique, il existe un fichier Licensing.ini dans le répertoire du produit d'installation (par exemple, ..\NPackages\NLicensing.ini).

• Format: Le fichier est un simple fichier texte au format INI. Tous les paramètres relèvent de la section [Licences].

• Commentaires : Le système ignore toute ligne commençant par un point-virgule ( ;). Vous pouvez utiliser ces lignes pour ajouter des commentaires.

Si le progiciel est déjà installé sur la machine, la procédure suivante s'applique :

Les valeurs spécifiées dans le fichier .ini remplacent les paramètres existants. Par exemple, si la fonction d'emprunt automatique a été précédemment désactivée manuellement, une entrée correspondante dans le fichier .ini la réactive.

Si un paramètre n'est pas explicitement défini dans le fichier .ini, le paramètre actuel reste inchangé. C'est le cas, par exemple, si une nouvelle installation est effectuée sur une installation INCA existante, et que le nouveau fichier .ini définit certains de ces paramètres, mais pas tous.

Paramètres

Cette section décrit les paramètres disponibles. Le système exige que les valeurs soient placées entre guillemets simples (par exemple, « true », « 60 », « C:\Temp »).

LicensingInstallationMode

Le paramètre LicensingInstallationMode peut prendre l'une des valeurs suivantes :

• Interactive

• Automated

• None

Interactive

Si le mode _interactif_ est sélectionné, une boîte de dialogue s'ouvre dans la dernière phase de l'installation du produit, dans laquelle vous pouvez rechercher et sélectionner une licence.

Dans le cas d'une installation silencieuse (soit /s ou /basic ou le paramètre MSI correspondant), le mode interactif est supprimé (c.-à-d. aucun dialogue n'est affiché).

Automated

Si le mode automatisé est sélectionné, d'autres paramètres seront évalués et traités. Si vous ne choisissez pas le mode automatisé, ces paramètres n'ont aucun effet :

• LicenseFileName

• GeneralLicense

• CustomerName

• LicenseSerialNumber

• LicensesToBorrow

• BorrowExpiryMode

• BorrowExpiryDate

• BorrowExpiryInterval

• BorrowAutomaticExtensionInterval

• ExecuteBorrowAutomaticExtensionInterval

• ImmediateBorrow

ImmediateBorrow

ImmediateBorrow fixe la valeur à true ou false.

LicenseFileName

LicenseFileName indique le chemin d'accès à un fichier de licence (.lic). Le programme d'installation copie automatiquement ce fichier sur la machine locale au cours de la procédure d'installation.

LicensesToBorrow

LicensesToBorrow définit une liste de licences (fonctionnalités) pour l'emprunt automatique. Séparez les noms des caractéristiques par des espaces.

BorrowExpiryMode

BorrowExpiryMode déclenche un emprunt unique après l'installation. Le mode de calcul de la date de fin d'un emprunt est défini par la valeur Interval ou Date.

BorrowExpiryInterval

Définit le nombre de jours pour une exécution unique de l'emprunt. Uniquement valable si BorrowExpiryMode = 'Interval'.

BorrowExpiryDate

Définit la date de fin de l'action d'emprunt. Valable uniquement si BorrowExpiryMode = 'Date'. Le format est "aaaa-mm-jj".

BorrowAutomaticExtensionInterval

BorrowAutomaticExtensionInterval spécifie le nombre de jours pour la période d'emprunt (par exemple, 60 jours), si l'emprunt automatique est actif (voir AutoborrowActive). Dans l'interface LiMa, cela correspond à la colonne Intervalle d'emprunt (en jours).

ExecuteBorrowAutomaticExtensionInterval

ExecuteBorrowAutomaticExtensionInterval détermine combien de jours avant l'expiration de la période d'emprunt le système tente de renouveler automatiquement la licence pour un autre intervalle, si l'emprunt automatique est actif (voir AutoborrowActive). Dans l'interface LiMa, cela correspond à la colonne Période de renouvellement (en jours).

AutoborrowActive

AutoborrowActive définit si le mode d'emprunt automatique est actif ("true") ou inactif ("false"). Les valeurs définies dans BorrowAutomaticExtensionInterval et ExecuteBorrowAutomaticExtensionInterval spécifient le comportement détaillé.

AutoborrowCutterActive

Si le serveur de licences Flexera oublie des entrées empruntées, le "cutter" est activé en mode interactif. Une boîte de dialogue apparaît, dans laquelle il vous est demandé si vous souhaitez supprimer l'élément emprunté du registre. Dans le cas d'un mode automatisé comme autoborrow, ce mode interactif n'est pas souhaité.

Pour gérer cette situation automatiquement, définissez AutoborrowCutterActive = 'true' dans le fichier Licensing.ini.

Lorsque ce paramètre est activé, le système traite automatiquement l'erreur spécifique du serveur de licences (-124). Au lieu d'afficher une fenêtre contextuelle, il supprime silencieusement l'entrée d'emprunt invalide du registre en arrière-plan. Ce nettoyage permet au processus d'autoborrow de se dérouler sans interruption et d'emprunter avec succès une nouvelle licence.

CustomLicenseFolder

CustomLicenseFolder définit un dossier personnalisé dans lequel LiMa recherche les fichiers de licence.

Ports

Le processus LiMaServer.exe écoute les connexions sur le port 32200 par défaut. L'emprunt de licence étant une action spécifique à l'utilisateur, le système lance une instance LiMaServer distincte pour chaque compte actif, au lieu de l'exécuter en tant que service système unique.

Pour prendre en charge plusieurs sessions simultanées sur la même machine, par exemple lorsqu'un agent de construction comme Jenkins s'exécute en parallèle avec une session de bureau interactive, vous pouvez définir une série de ports disponibles.

Lors de l'installation, spécifiez les ports dans le fichier Licensing.ini en utilisant une liste séparée par des espaces :

Si des ports supplémentaires ne sont pas explicitement définis, LiMa recherchera automatiquement le prochain port disponible pour toutes les instances suivantes.

Vous pouvez modifier la configuration du port directement dans le registre Windows après l'installation.

1. Ouvrez le registre Windows.

2. Naviguez jusqu'à la clé LiMa sous Wow6432Node.

3. Créez ou modifiez la valeur de chaîne nommée Ports.

4. Saisissez les numéros de port séparés par un point-virgule (par exemple, 32200;32201;32202).

ActivationIdentifiers

ActivationIdentifiers spécifie l'activation de la licence pendant l'installation pour les licences basées sur FlexNet Embedded.

Pour activer plusieurs licences simultanément, fournissez une liste de leurs identifiants séparés par des espaces.

ActivationMode

ActivationMode déclenche une activation automatique en ligne lors de l'installation.

ActivationPath

ActivationPath définit l'emplacement du dossier par défaut pour le stockage des fichiers bin de demande et de réponse.

Outil LiMaOption.exe

Alors que le fichier Licensing.ini est utilisé pour configurer les paramètres lors de l'installation du produit, l'outil de ligne de commande LiMaOption.exe vous permet de modifier ces mêmes paramètres après l'installation. Depuis la version 1.8.6 de LiMa, vous pouvez configurer les valeurs du dialogue d'options via cet outil ou via des entrées dans le fichier Licensing.ini.

Utilisation de l'outil LiMaOption

L'outil se trouve dans le dossier bin du répertoire d'installation de LiMa :

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

1. Pour plus de détails, ouvrez une invite de commande dans ce répertoire et exécutez la commande suivante :

   LiMaOption.exe --help

   Les options autorisées sont affichées.

Exemple de fichier Licensing.ini

Le programme d'installation a besoin de l'en-tête de la section [Licensing] pour identifier et appliquer correctement les paramètres du fichier Licensing.ini.

Bien qu'il soit acceptable que la section ne contienne aucun paramètre de configuration, le fichier est considéré comme invalide sans cette ligne d'en-tête entre crochets.

[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'