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 clés

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

ImmediateBorrow

ImmediateBorrowt fixe la valeur à true ou false.

EXEMPLE

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.

EXEMPLE

LicensesToBorrow

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

EXEMPLE

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.

EXEMPLE

(Si vous utilisez Interval comme valeur, vous devez définir l'option BorrowExpiryInterval. Pour de plus amples informations, voir BorrowExpiryInterval.

EXEMPLE

(Si vous utilisez la valeur Interval, vous devez définir l'option BorrowExpiryDate. Pour de plus amples informations, voir BorrowExpiryDate.

BorrowExpiryInterval

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

EXEMPLE

BorrowExpiryDate

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

EXEMPLE

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

EXEMPLE

La valeur 60 prolonge l'emprunt de sorte que la date de fin soit aujourd'hui + 60 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).

EXEMPLE

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.

EXEMPLE

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 :

EXEMPLE

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.

Ouvrez le registre Windows.
Naviguez jusqu'à la clé LiMa sous Wow6432Node.
Créez ou modifiez la valeur de chaîne nommée Ports.
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.

EXEMPLE

ActivationMode

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

Note
Pour que l'activation en ligne réussisse, vous devez disposer d'une connexion internet opérationnelle et d'un accès au portail de licences ETAS.

EXEMPLE

ActivationMode='online'

ActivationPath

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

EXEMPLE

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\

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

Les options autorisées sont affichées.

Option	Explication
	Afficher l'aide
	Afficher l'état actuel de tous les biens
	Afficher et effectuer la migration des articles FNP vers FNE
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" à "3" pour les tentatives possibles lors de l'encaissement
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur "0" désactivée, valeur "1" activée
	Valeur comme AAAA-MM-JJ
	Valeur telle que "désactivé", "une fois", "toujours

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.

Copier