Génération des licences avec licence 4J et déploiement sur le serveur

Le présent guide comporte les étapes à suivre pour la génération de licences avec l’outil licence 4J - Licence Manager qui est installé sur un serveur distant.

Pour accéder au serveur de licence, faire la demande à l’équipe Infra qui vous fournira sur ce point les informations nécessaires pour vous connecter par VNC au serveur de licence installé sur une distribution Linux disposant d’une interface graphique.

Une fois connecté sur le serveur, merci de procéder comme suite :

1. Se positionner via ligne de commande terminal, sur le répertoire ou se trouve le JAR de l'application licence cd opt/licence4J-licence-manager
2. Executer la commande suivante pour lancer l’application java -jar LICENSE4J-License-Manager.jar

Le produit représente la solution sur laquelle une gestion des licences doit être effectuée. Pour ce faire, merci de procéder comme suite :

1. Cliquer sur Database Storage
2. Sélectionner le menu product
3. Cliquer Create new product

Pour créer une nouvelle licence, un produit doit être déjà créé et disponible sur l’application licence4J Licence Manager. Pour ce faire, merci de faire comme suite :

1. Se positionner sur le produit pour lequel nous souhaitons créer une licence et faire un clique droit
2. Choisir Generate new licence

Une fois sur generate new licence, passer à l'étape suivante :

1. Renseigner les champs du formulaire user information (les champs full name et Registered to sont obligatoirement).
2. Cliquer sur suivant

1. Se positionner sur la section license type
2. Cocher License Text
3. Faire suivant

Renseigner les champs suivantes :

1. Licence quality : 1 (Exemple)
2. Valid product edition : Professional
3. Valid product version : 3.4 (la version de l'application défini sur le produit)
4. Licence validity period : 1000 (Exemple)
5. Maintenance period : 1000 (Exemple)
6. Faire suivant

1. Cocher activation required
2. Activation period : 0 (Exemple)
3. Allowed activation account : 1 (Exemple)
4. Dans le liste déroulante Activation return, sélectionner License Text
5. Cocher Reject License Désactivation
6. Cocher Set activated license text generation time to activation time
7. Cocher Check Any
8. Cocher Hostname
9. Cocher Ethernet Adress
10. Cocher System Disk volume UUID
11. Cocher HDD Serial Number
12. Faire suivant

Nous pouvons ajouter des paramètres composés d’une clé et d’une valeur associée à la licence pour un comportement spécifique sur un produit. Pour le cas de CYNOD, merci de trouver ci-dessous les paramètres concernés :

1. nbTerm : Prends une valeur numérique représentant le nombre de terminaux actifs autorisés pour cette licence.
2. mode : les valeurs possibles sont production et test . Décrit le type d’environnement dans lequel la licence sera installée, UAT ou en Production.
3. authorizedTerminals : Ce paramètre permet de renseigner la liste des numéros IMEI des terminaux autorisés pour cette licence.

NB : Les numéros IMEI doivent être séparés par des virgules (,) et ne doivent pas contenir d’espaces vides. (Ex :123456789012347,987654321098743,…)

1. Pour valider la création de la licence, poursuivre les étapes de création en appuyant sur Next puis valider la licence après vérification de la conformité des informations avec le bouton Finish.

1. Pour obtenir la licence générée, se positionner sur la licence générée ⇒ ouvrir le menu contextuel pour copier le texte de licence ou directement utiliser l’option Export pour obtenir la licence.

Les clés publiques des produits à partager et à renseigner sur les différentes instances des applications se trouvent sous le menu Product. Pour les consulter, il est nécessaire de se positionner sur le produit en question au préalable.

Pour ce faire, merci de procéder comme suite :

1. Creer une fichier text sous le format suivant licence_nomClient.l4j
2. Mettre dans ce fichier la licence copier précédemment sur le serveur de licence
3. Creer un ticket support sur le projet IT Production contenant les instructions ci-dessous pour une prise en charge :
   • Placer le fichier licence_nomClient.l4j joint dans le ticket, au niveau du répertoire /conf du serveur tomcat.
   • Rajouter les configurations suivantes sur le fichier context du client

context

<Environment name="publicKey" VALUE="Valeur de la clé publique précédemment copié" TYPE="java.lang.String"  override="true"/>
<Environment name="licenseTextPath" VALUE= Le bon chemin du répertoire /conf + "/licence_nomClient.l4j" TYPE="java.lang.String"  override="true"/>
<Environment name="productID" VALUE="Cynod" TYPE="java.lang.String"  override="true"/>
<Environment name="productEdition" VALUE="Professional" TYPE="java.lang.String"  override="true"/>
<Environment name="productVersion" VALUE="3.4" TYPE="java.lang.String"  override="true"/>
<Environment name="licenseActivationUrl" VALUE="https://licence.sensoft-labs.com/autoactivate" TYPE="java.lang.String"  override="true"/>
<Environment name="licenseOnlineAvailabilityUrl" VALUE="https://licence.sensoft-labs.com/checkavailability" TYPE="java.lang.String"  override="true"/>

NB : Merci de mettre le bon chemin menant vers le fichier licence au niveau de la variable licenseTextPath et coller la clé publique précédemment copié sur la variable publicKey

Pour autoriser un TPE à opérer sur le réseau, il faudra mettre à jour la liste des terminaux autorisés authorizedTerminals mentionné à l'étape 9. Merci de procéder comme suite :

1. Se connecter au serveur de licence
2. Faire un clique droit sur le produit de licence précédemment créé
3. Cliquer Modify ⇒> Full (with license string change)
4. Faire suivant jusqu'à l'étape 9 décrit précédemment
5. Faire un clique droit sur authorizedTerminals et cliquer sur le bouton edit
6. Rajouter le/les codes IMEI sur le champ tout en respectant la règle de nomenclature
7. Faire suivant jusqu'a la fin et terminer les modifications
8. Faire à nouveau un clique droit sur le produit et cliquer sur view
9. Copier la nouvelle licence généré dans un nouveau fichier licence_nomClient.l4j
10. Creer un ticket IT sur Redmine pour une mise à jour du fichier sur le serveur

NB : Il est obligatoire de demander dans le ticket IT, le redémarrage de l'instance Cynod pour appliquer la mise à jour

Pour plus d’informations sur cet outil et ses fonctionnalités, merci de vous référer à la documentation officielle de licence4j : ​​https://www.license4j.com/documents/license-manager-gui/.