Guide des fichiers de log

Où trouver les fichiers de log des gestionnaires de licences

Avant d’analyser l’utilisation des licences, les refus, les sessions ou les pics d’utilisation simultanée, vous devez disposer du bon fichier de log provenant de votre gestionnaire de licences. Ce guide explique où trouver les logs les plus courants et comment ils sont généralement activés.

Les chemins et les paramètres exacts peuvent varier selon l’éditeur, le produit, le système d’exploitation et la méthode d’installation. Si votre environnement est administré par une autre équipe, vérifiez avec l’administrateur du serveur de licences avant de modifier les paramètres du service.

Commencez par le log existant

Dans de nombreux environnements, la journalisation des licences est déjà activée. Avant de modifier quoi que ce soit, vérifiez le service du serveur de licences, l’outil d’administration de l’éditeur ou le fichier de configuration afin d’identifier l’emplacement du log actuellement généré.

Dans la mesure du possible, utilisez une copie du fichier de log pour l’analyse. Évitez de modifier ou de déplacer des logs actifs pendant que le serveur de licences fonctionne, sauf si la documentation de l’éditeur indique que cela est sans risque.

Effectuez les changements de service ou de configuration pendant une fenêtre de maintenance. Sauvegardez les fichiers de configuration avant de modifier les paramètres du gestionnaire de licences.

Log de debug FlexLM / FlexNet Publisher

Dans les environnements FlexLM et FlexNet Publisher, le fichier le plus souvent utilisé pour une analyse rapide est le log de debug généré par lmgrd et le vendor daemon.

Où le trouver

Sous Windows, vérifiez LMTOOLS ou la configuration du service de licences. Dans LMTOOLS, ouvrez l’onglet Config Services et recherchez le champ intitulé "Path to the debug log file".

Emplacements courants possibles :

  • C:\ProgramData\FLEXlm\lmgrd\debug.log
  • Un dossier propre à l’éditeur sous C:\ProgramData
  • Un chemin personnalisé défini par l’éditeur du logiciel ou par l’administrateur des licences

Sous Linux ou dans les installations en ligne de commande, vérifiez la commande de démarrage, le fichier de service ou le script d’initialisation pour repérer une commande lmgrd utilisant l’option -l.

Exemple : lmgrd -c /path/to/license.dat -l +/var/log/flexlm/vendor-debug.log

Comment le générer ou l’activer

Si le log de debug n’est pas configuré, définissez un chemin de log dans LMTOOLS ou démarrez lmgrd avec l’option -l. L’ajout de + devant le chemin du log signifie généralement que les nouvelles entrées sont ajoutées au fichier au lieu de l’écraser.

Exemple : lmgrd -c /path/to/license.dat -l +/path/to/debug.log

Redémarrez le service de licences pendant une fenêtre de maintenance si la configuration du service a été modifiée.

Quel fichier importer

Importez le log de debug contenant les lignes d’activité des licences, comme les checkouts, les check-ins, les refus, les horodatages et les messages du vendor daemon. Si vous vous attendez à voir des refus mais qu’ils n’apparaissent pas, vérifiez si le fichier d’options de l’éditeur désactive ou filtre la journalisation des refus.

Report log RLM

Pour Reprise License Manager, le meilleur fichier pour analyser l’utilisation est généralement le report log RLM, et non le log de debug général.

Où le trouver

La génération du report log RLM se configure normalement dans le fichier d’options ISV. Ce fichier peut être référencé dans la ligne ISV du fichier de licence, ou placé à côté du fichier de licence en utilisant le nom de l’éditeur.

Recherchez une ligne qui commence par : REPORTLOG

Exemple : REPORTLOG +/var/log/rlm/vendor-report.log std

Comment le générer ou l’activer

Ajoutez une ligne REPORTLOG dans le fichier d’options ISV. Utilisez + devant le chemin du fichier si vous voulez que le serveur ajoute les nouveaux enregistrements au lieu d’écraser le fichier.

Exemples : REPORTLOG +/var/log/rlm/vendor-report.log std REPORTLOG +/var/log/rlm/vendor-report-detailed.log detailed

Le format standard suffit généralement pour les rapports courants. Le format detailed peut inclure des informations plus précises sur les heures de checkout et de check-in.

Après avoir modifié le fichier d’options, relisez la configuration ou redémarrez le service RLM selon votre procédure habituelle d’administration des licences.

Quel fichier importer

Importez le report log RLM s’il est disponible. Il est conçu pour le reporting d’utilisation et peut contenir les checkouts, les check-ins, les refus, les horodatages et d’autres enregistrements d’activité des licences.

Log d’utilisation Sentinel RMS

Pour Sentinel RMS, le fichier pertinent est généralement le log d’utilisation créé par Sentinel RMS License Manager.

Où le trouver

Le nom et l’emplacement du log d’utilisation sont généralement contrôlés par les options de démarrage du License Manager ou par une configuration propre à l’éditeur. Certains déploiements Windows utilisent un fichier nommé lservsta, mais ce n’est pas garanti pour tous les produits.

Vérifiez :

  • Les options de démarrage du service Sentinel RMS License Manager
  • La documentation de l’éditeur pour l’application protégée
  • Les éventuels fichiers de configuration du gestionnaire de licences
  • Le dossier serveur utilisé par l’éditeur du logiciel

Comment le générer ou l’activer

Activez la journalisation de l’utilisation conformément aux instructions de configuration Sentinel RMS fournies par l’éditeur. Si la journalisation étendue est disponible et adaptée à votre environnement, elle peut fournir des détails plus utiles sur les utilisateurs et les hôtes.

Évitez de modifier le service de licences actif en dehors d’une fenêtre de maintenance.

Quel fichier importer

Importez le log d’utilisation Sentinel RMS qui enregistre les demandes de licence, les restitutions, les refus, l’activité commuter ainsi que les événements de démarrage ou d’arrêt du serveur de licences.

Logs DSLS Dassault Systèmes

Pour Dassault Systèmes License Server, les logs DSLS sont générés par le processus serveur DSLS et par sa configuration de service.

Où le trouver

Commencez par identifier le dossier d’installation du serveur DSLS.

Emplacements de commande par défaut courants :

Windows : C:\Program Files\Dassault Systemes\DS License Server\win_b64\code\bin

Linux : /usr/DassaultSystemes/DSLicenseServer/linux_a64/code/bin

Le serveur peut écrire les logs dans son dossier de log par défaut ou dans un dossier personnalisé indiqué au démarrage du service.

Comment générer le log ou contrôler son emplacement

DSLS peut être démarré avec des options permettant de contrôler la journalisation.

Exemple : DSLicSrv -startServer -logDir C:\DSLSLogs -logFileSize 20 -compressLog

Sous Windows, DSLS fonctionne souvent comme un service. Vous pouvez consulter la commande actuelle du service depuis une invite de commandes en mode administrateur : sc.exe qc "DS License Server"

Si vous modifiez les options du service DSLS, redémarrez le service pendant une fenêtre de maintenance.

Quel fichier importer

Importez le fichier de log DSLS qui contient l’activité pertinente du serveur de licences pour la période à analyser. Si vous ne savez pas quel fichier choisir, commencez par le log serveur principal du répertoire de logs DSLS configuré.

Logs de licences Altair ALM

Altair License Manager utilise des logs transactionnels de licences pour le reporting d’utilisation. Ils sont différents du log opérationnel ou du log de debug classique.

Où le trouver

Vérifiez le répertoire d’installation d’Altair License Manager et le fichier alus.conf. Les paramètres des logs transactionnels sont contrôlés par cette configuration, et les fichiers de log d’utilisation sont généralement écrits dans le répertoire de données ALM.

Dossiers courants possibles :

  • data/sent
  • data/detailed

Comment le générer ou l’activer

Vérifiez la valeur ALUS_LOG_LEVEL dans alus.conf.

Niveaux de journalisation courants :

  • 0 -- aucune journalisation de l’utilisation
  • 1 -- logs d’utilisation anonymes
  • 2 -- logs d’utilisation anonymes et détaillés

Si vous avez besoin d’informations sur les utilisateurs, les hôtes ou d’un reporting détaillé, les logs détaillés sont généralement plus utiles que les logs anonymes. Redémarrez le service de licences pendant une fenêtre de maintenance si la configuration de journalisation est modifiée.

Quel fichier importer

Importez le log d’utilisation transactionnel, pas seulement le log opérationnel du serveur. Le log opérationnel ou de debug est utile pour le dépannage, mais le log d’utilisation transactionnel est généralement la meilleure source pour analyser l’utilisation des licences.

Logs de debug LM-X

Pour LM-X License Manager, le fichier pertinent est généralement le log LM-X License Server. Selon la configuration, ce log peut inclure les checkouts, les check-ins, les refus, les avertissements et d’autres activités du serveur.

Où le trouver

Le moyen le plus simple de trouver le log est d’utiliser LM-X License Server Client. Ouvrez l’onglet Log File pour afficher, rechercher et télécharger le log du serveur de licences.

Le chemin du log peut aussi être configuré dans le fichier de configuration du serveur de licences LM-X. Certaines installations écrivent un fichier de log par défaut dans le répertoire du serveur de licences.

Exemples de configuration courants : LOG_FILE = C:\Program Files\lmx-server.log LOG_FILE = /home/user1/lmx-serv.log

Comment le générer ou l’activer

Utilisez LM-X License Server Client ou le fichier de configuration LM-X pour activer la journalisation et définir l’emplacement du fichier de log. Si elle est disponible, la journalisation étendue peut fournir davantage de détails.

Après avoir modifié les paramètres de journalisation, redémarrez le serveur de licences LM-X si l’outil de configuration l’exige.

Quel fichier importer

Importez le fichier de log du serveur de licences LM-X. Si plusieurs logs existent, choisissez celui qui couvre la période que vous souhaitez analyser.

Quel log utiliser ?

Gestionnaire de licences Meilleur fichier à importer Principal emplacement à vérifier
FlexLM / FlexNet PublisherLog de debugLMTOOLS, commande du service ou lmgrd -l
RLMReport logFichier d’options ISV avec REPORTLOG
Sentinel RMSLog d’utilisationOptions de démarrage du License Manager ou configuration de l’éditeur
DSLSLog serveur DSLSRépertoire de logs DSLS ou options de démarrage du service
Altair ALMLog d’utilisation transactionnelalus.conf et répertoire de données ALM
LM-XLog du serveur de licencesLM-X License Server Client ou fichier de configuration

Avant d’importer le log

Avant d’importer un fichier de log, vérifiez qu’il couvre bien la période que vous souhaitez analyser. Par exemple, si vous avez besoin d’une analyse mensuelle, assurez-vous que le log contient le mois complet et qu’il n’a pas été archivé trop tôt par rotation.

Vérifiez également si les noms d’utilisateur, les noms d’hôte, les noms de projet ou les noms de Feature sont sensibles dans votre organisation. Si nécessaire, utilisez une copie anonymisée du log.

FAQ

Dois-je arrêter le serveur de licences pour copier un fichier de log ?

En général, non. Dans de nombreux cas, vous pouvez copier le fichier de log courant et analyser la copie. Ne déplacez, ne renommez et ne supprimez pas un fichier de log actif, sauf si la documentation de l’éditeur indique que cela est sans risque.

Dois-je importer un log de debug ou un report log ?

Utilisez le fichier qui contient l’activité réelle des licences. Pour FlexLM, il s’agit souvent du log de debug. Pour RLM, le report log est généralement plus adapté. Pour Altair ALM, utilisez le log d’utilisation transactionnel. Pour Sentinel RMS, utilisez le log d’utilisation.

Pourquoi les refus n’apparaissent-ils pas dans mon log ?

Les refus peuvent être absents si le gestionnaire de licences n’a pas été configuré pour les journaliser, si le mauvais fichier a été sélectionné, si la période pertinente est manquante, ou si un fichier d’options ou de configuration de l’éditeur supprime ces enregistrements.

Puis-je analyser un ancien log archivé par rotation ?

Oui, si le log archivé est un fichier texte dans un format pris en charge par l’analyseur et qu’il contient la période que vous souhaitez examiner.

Que faire si je ne trouve pas le bon fichier ?

Vérifiez d’abord la configuration du service du serveur de licences. Si vous ne trouvez toujours pas le fichier, demandez à l’éditeur du logiciel, à votre administrateur de licences ou contactez NYBS Consulting pour vous aider à identifier la bonne source de log.

Prêt à analyser votre log de licences ?

Importez le bon fichier et générez des rapports clairs.

Une fois le bon fichier identifié, importez-le dans License Log Analysis pour générer des rapports clairs sur l’utilisation, les refus, les utilisateurs actifs, les sessions, les heatmaps et le taux d’utilisation.