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 : la version de l'application défini sur le produit (3.4)
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 tomcat.
   • Rajouter les configurations suivantes sur le fichier context du client

context

<Environment name="publicKey" VALUE="30819f300d06092a864886f70d010101050003818d003081893032301006072a8648ce3d02002EC311215SHA512withECDSA106052b81040006031e00040848f81ff48efc127006c48d9be63b6884feadfd08e81ff9d2c17dabG02818100a984e7228e4e3ee156b682e01803d3a63e57e334eada727fcc1f8202a9bf23d7b33bec78fbaf0845f7be818f1c41b511d01a4caa7c1b649a21a7c44bbea63b827f8768122b7ceccff1c539d13a23d1e84c3279f39823b39c0e5e77003eca1f7203RSA4102413SHA512withRSA0d56cf6094c98c226f0171425f27f9dafdb3818599c62ca4ac8f0b7b90dc6b250203010001" 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

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