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.

Étape 1 : Se connecter au Serveur de licence

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.

Étape 2 : Démarrage de l'application de gestion

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

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

Executer la commande suivante pour lancer l’application java -jar LICENSE4J-License-Manager.jar

Étape 3 : Créer un produit

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 :

Cliquer sur Database Storage

Sélectionner le menu product

Cliquer Create new product.

Étape 4 : Créer une nouvelle licence

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 :

Se positionner sur le produit pour lequel nous souhaitons créer une licence et faire un clique droit

Choisir Generate new licence.

Étape 5 : Renseigner le client

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

Renseigner les champs du formulaire user information (les champs full name et Registered to sont obligatoirement).

Cliquer sur suivant

Étape 6 : Renseigner le type de licence

Se positionner sur la section license type

Cocher License Text

Faire suivant

Étape 7 : Renseigner les attributs et la durée de la validitée

Renseigner les champs suivantes :

Licence quality : 1 (Exemple)

Valid product edition : Professional

Valid product version : la version de l'application défini sur le produit (3.4)

Licence validity period : 1000 (Exemple)

Maintenance period : 1000 (Exemple)

Faire suivant

Étape 8 : Renseigner les paramètres d'activation

Cocher activation required

Activation period : 0 (Exemple)

Allowed activation account : 1 (Exemple)

Dans le liste déroulante Activation return, sélectionner License Text

Cocher Reject License Désactivation

Cocher Set activated license text generation time to activation time

Cocher Check Any

Cocher Hostname

Cocher Ethernet Adress

Cocher System Disk volume UUID

Cocher HDD Serial Number

Faire suivant

Étape 9 : Ajouter un paramètre personnalisé

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 :

nbTerm : Prends une valeur numérique représentant le nombre de terminaux actifs autorisés pour cette licence.

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.

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

Étape 10 : Validation et obtention la licence

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.

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.

Étape 11 : Obtention de la clé publique

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.

Étape 12 : Configuration context application

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

Creer une fichier text sous le format suivant licence_nomClient.l4j

Mettre dans ce fichier la licence copier précédemment sur le serveur de licence

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

<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 insérer coller la clé publique sur la variable publicKey

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