✎ licence4j [cynod]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== 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 tomcat.
    * Rajouter les configurations suivantes sur le fichier context du client

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

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International