Linux Ubuntu

Télécharger le script

Téléchargez le script à partir de ce lien .

Déplacer le script dans un répertoire temporaire

Déplacez le script téléchargé dans un répertoire temporaire (le répertoire personnel de l’utilisateur).

Ajouter l’archive zip du service et le fichier de licence

Placez l’archive zip du service Babel (nommée babel_service_net100_x.y.z.w.zip, où x.y.z.w est la version) et le fichier de licence (babel.licenses) dans le même répertoire temporaire que le script.

Exécuter le script

Exécutez les commandes suivantes pour lancer l’installation.

chmod +x ./BabelLicensingService.sh
sudo <a data-footnote-ref href="#user-content-fn-1">./BabelLicensingService.sh</a>

Copier les fichiers dans le répertoire personnel de l’utilisateur babel

Ouvrez un terminal et exécutez la commande suivante pour copier le fichier ZIP et le fichier de licence à l’emplacement voulu :

cp babel_service_net100_x.y.z.w.zip /home/babel/
cp babel.licenses /home/babel/

Le fichier ZIP qui contient les assemblies du Babel Licensing Service est maintenant disponible dans le répertoire personnel de l’utilisateur « babel » (/home/babel). Vous pouvez poursuivre l’installation et la configuration du Babel Licensing Service à partir des fichiers de ce répertoire.

Créer le dossier d’installation et extraire l’archive

Créez le dossier « svc/babel » sous « /var/www » et extrayez le contenu de l’archive ZIP :

1. Dans la fenêtre du terminal, exécutez la commande suivante pour créer le dossier « svc/babel » sous « /var/www »

sudo mkdir -p /var/www/svc/babel

Votre mot de passe vous est demandé, car « sudo » accorde les privilèges d’administration nécessaires pour créer des répertoires dans le répertoire système.

2. Faites du dossier « babel » qui vient d’être créé le répertoire de travail courant :

cd /var/www/svc/babel

3. Extrayez le contenu de l’archive ZIP dans le répertoire courant (« /var/www/svc/babel ») :

sudo unzip /home/babel/babel_service_net100_x.y.z.w.zip

Ces étapes créent l’arborescence de dossiers nécessaire et extraient le contenu de l’archive ZIP dans le répertoire « /var/www/svc/babel ». Vous pouvez ainsi poursuivre l’installation et la configuration du Babel Licensing Service à l’emplacement approprié.

Copier le fichier de licence

Copiez le fichier de licence « babel.licenses » dans le répertoire « /var/www/svc/babel » avec la commande suivante :

sudo cp /home/babel/babel.licenses /var/www/svc/babel/

Le fichier de licence « babel.licenses » est maintenant installé dans le répertoire « /var/www/svc/babel » ; vous pouvez passer à la configuration de l’utilisateur qui exécutera le Babel Licensing Service.

Définir le propriétaire de l’application

Une fois le fichier de licence « babel.licenses » installé dans le répertoire « /var/www/svc/babel », l’étape suivante consiste à configurer l’utilisateur qui exécutera le Babel Licensing Service. Ici, cet utilisateur est « www-data ».

Pour configurer l’utilisateur, exécutez la commande suivante dans le terminal :

sudo chown www-data:www-data -R /var/www/svc/babel

Cette commande attribue la propriété du répertoire « /var/www/svc/babel » et de son contenu à l’utilisateur et au groupe « www-data ». Avec le bon propriétaire, le Babel Licensing Service peut être exécuté par l’utilisateur approprié, qui peut ainsi accéder aux fichiers et aux répertoires nécessaires et y travailler.

Configurer le service

Pour configurer le Babel Licensing Service et inscrire dans le fichier appsettings.json les paramètres de connexion à la base de données et les autres configurations de l’application, procédez comme suit :

1. Dans une fenêtre de terminal, utilisez la commande suivante pour ouvrir le fichier appsettings.json dans l’éditeur de texte Nano

sudo nano /var/www/svc/babel/appsettings.json

2. Dans le fichier appsettings.json, repérez la section "Database". Réglez la valeur "Provider" sur "MySQL" pour indiquer que vous utilisez MySQL comme fournisseur de base de données

"Database": {
  "Provider": "MySQL"
},

3. Repérez la section "ConnectionStrings". Sous la clé "MySQL", modifiez la chaîne de connexion pour qu’elle corresponde à la configuration de votre serveur MySQL. Mettez à jour les valeurs server, User, Password et Database en conséquence :

"ConnectionStrings": {
  "SQLServer": "",
  "MySQL": "Server=127.0.0.1;User=babel;Password=YourUniquePassword;Database=licenses",
  "SQLite": ""
},

N’oubliez pas de remplacer "YourUniquePassword" par un mot de passe fort de votre choix. Il est vivement recommandé de combiner majuscules, minuscules, chiffres et caractères spéciaux pour créer un mot de passe sûr. Conservez ce mot de passe : il vous servira plus tard, lors de la configuration de la base de données.

4. Si vous le souhaitez, vous pouvez personnaliser d’autres paramètres de l’application. Par exemple, dans la section "Serilog", vous pouvez configurer la journalisation et ajuster le niveau de journalisation minimal :

"Serilog": {
  "Using": [ "Serilog.Sinks.Console", "Serilog.Sinks.File" ],
  "MinimumLevel": {
    "Default": "Information",
    "Override": {
      "Microsoft": "Debug",
      "System": "Debug",
      "Grpc": "Debug"
    }
  },
  ...
},

Pour déboguer des problèmes d’installation, il peut être utile de régler le niveau de journalisation minimal sur Debug. Une fois le service en fonctionnement, vous pouvez revenir au niveau Information ou Warning.

5. Plus bas, dans la section "Application", vous pouvez indiquer le "LicenseFile" (babel.licenses) et personnaliser les valeurs "SigningKey" et "TokenExpiration" selon vos besoins :

"Application": {
  "AdminUsername": "your-admin-user",
  "AdminEmail": "admin@example.com",
  "AdminPassword": "<strong-initial-password>",
  "LicenseFile": "babel.licenses",
  "SigningKey": "Secret Token Key",
  "TokenExpiration": "00:30:00"
},

Remplacez Secret Token Key par votre propre clé. Elle sert à sécuriser la communication entre les applications clientes et le Babel Licensing Service.

6. Pour enregistrer les modifications et quitter Nano, appuyez sur Ctrl + X, puis sur Y pour confirmer les modifications, et enfin sur Enter pour enregistrer le fichier.

Ces étapes configurent le service Babel au moyen du fichier appsettings.json. La configuration mise à jour contient les paramètres de connexion à la base de données et toutes les autres personnalisations que vous avez apportées.

Pour en savoir plus sur le fichier de configuration du Babel Licensing Service, consultez la section Configuration.

Créer la base de données

Il faut créer la base de données « licenses » indiquée dans la chaîne de connexion définie pour le Babel Licensing Service, puis créer l’utilisateur « babel », lui accorder les privilèges sur la base de données et vérifier ses autorisations.

1. Ouvrez un terminal.
2. Connectez-vous à la console MariaDB en tant qu’utilisateur root avec la commande suivante :

sudo mariadb -u root -p

Le mot de passe root vous est demandé.

3. Une fois connecté à la console MariaDB, vous pouvez lister toutes les bases de données existantes avec la commande :

SHOW DATABASES;

4. Pour lister tous les utilisateurs existants, exécutez la requête suivante :

SELECT User FROM mysql.user;

5. Créez la base de données « licenses » avec la commande :

CREATE DATABASE licenses;

6. Créez l’utilisateur « babel » et accordez-lui tous les privilèges sur la base de données « licenses » en exécutant les commandes suivantes :

CREATE USER babel@localhost IDENTIFIED BY 'YourUniquePassword';
GRANT ALL PRIVILEGES ON licenses.* TO babel@localhost;
FLUSH PRIVILEGES;

Remplacez 'YourUniquePassword' par le mot de passe que vous avez défini dans la chaîne de connexion MySQL du Babel Licensing Service.

7. Pour vérifier que l’utilisateur « babel » dispose des autorisations appropriées, vous pouvez utiliser l’instruction suivante :

SHOW GRANTS FOR babel@localhost;

Vous pouvez maintenant quitter la console MariaDB en saisissant la commande quit, puis ENTER.

Au terme de ces étapes, la base de données « licenses » et l’utilisateur « babel » sont créés, les privilèges sur la base de données sont accordés et les autorisations de l’utilisateur sont vérifiées.

Ouvrir un terminal

Ouvrez une fenêtre de terminal.

Accéder au répertoire du service

Accédez au répertoire où se trouve le Babel Licensing Service. Par exemple :

cd /var/www/svc/babel

Exécuter le service

Exécutez la commande suivante pour démarrer le Babel Licensing Service :

dotnet Babel.Licensing.Service.dll

Si tout est correctement configuré, vous voyez le service démarrer. Le journal du terminal affiche des informations sur l’initialisation du service, dont la création des tables dans la base de données, selon le niveau de journalisation choisi dans le fichier appsettings.json.

Surveillez le journal du terminal pour repérer d’éventuels avertissements ou erreurs. En cas de problème, vérifiez que la configuration, les paramètres de connexion à la base de données et les autorisations sont corrects.

Si le Babel Licensing Service démarre correctement, il est prêt à traiter les opérations de licence et à fournir ses services de licences à vos applications.

Ouvrir le fichier de service

Ouvrez un terminal et exécutez la commande suivante pour créer et modifier le fichier de service :

sudo nano /etc/systemd/system/babel.licensing.service

Coller la configuration du service

Collez la configuration suivante dans le fichier :

[Unit]
Description=Babel Licensing Service
 
[Service]
WorkingDirectory=/var/www/svc/babel/
ExecStart=/usr/bin/dotnet /var/www/svc/babel/Babel.Licensing.Service.dll
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=babel-licensing-svc
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
 
[Install]
WantedBy=multi-user.target

Enregistrer le fichier de service

Enregistrez le fichier en appuyant sur Ctrl+O, puis quittez l’éditeur en appuyant sur Ctrl+X.

Démarrer le service

Démarrez le Babel Licensing Service en exécutant la commande suivante :

sudo systemctl start babel.licensing

Vérifier l’état du service

Pour vérifier l’état du service, utilisez la commande suivante :

systemctl status babel.licensing

Cette commande affiche l’état actuel du service, avec les éventuels messages d’erreur ou avertissements :

● babel.service - Babel Licensing Service
     Loaded: loaded (/etc/systemd/system/babel.licensing.service; disabled; vendor preset: enabled)
     Active: active (running) since Fri 2023-05-19 09:24:53 UTC; 1s ago
   Main PID: 2710499 (dotnet)
      Tasks: 17 (limit: 4392)
     Memory: 28.0M
        CPU: 903ms
     CGroup: /system.slice/babel.licensing
             └─2710499 /usr/bin/dotnet /var/www/svc/babel/Babel.Licensing.Service.dll
 
May 19 09:24:57 babel-licensing-svc[2710499]: [09:24:57 DBG] Hosting started

Activer le démarrage automatique

Par défaut, le service n’est pas configuré pour démarrer automatiquement au démarrage du serveur. Pour qu’il démarre automatiquement, exécutez la commande suivante :

sudo systemctl enable babel.licensing

Une fois activé, le service démarre automatiquement après un redémarrage du serveur.