Windows

Suivez ces instructions pour installer et configurer le Babel Licensing Service sous Windows 11.

Prérequis

Pour installer le Babel Licensing Service sous Windows 11, vous devez vous assurer que les prérequis suivants sont remplis.

• Assurez-vous que Windows 11 a été mis à jour vers la dernière version
• Microsoft SQL Server, ou MySQL/MariaDB (le service .NET 10 est testé avec MySQL 8.4 et MariaDB 11.4)
• Le runtime ASP.NET Core correspondant au paquet du service (par exemple .NET 10 pour babel_service_net100_x.y.z.w.zip)
• Paquet ZIP du Babel Licensing Service (par exemple babel_service_net100_x.y.z.w.zip). Le même paquet sert les deux éditions.
• Fichier de licence Babel Licensing en édition Server ou Data Center (babel.licenses)
• Pour exécuter le script d’installation, PowerShell version 7 ou ultérieure est requis

Script d’installation

Le script PowerShell BabelLicensingService.ps1 est conçu pour automatiser l’installation et la configuration du Babel Licensing Service dans les environnements Windows, telles que les décrit cette section.

Avant de lancer l’installation, ce script vérifie que les prérequis sont remplis : privilèges d’administration, version correcte de PowerShell et commande CLI de MariaDB. Il permet d’installer le service et d’en interroger l’état.

Pendant l’installation, il se charge d’extraire l’archive ZIP d’installation, de copier le fichier de licence, de créer la base de données, de modifier appsettings.json pour y inscrire les chaînes de connexion correctes et d’installer le service avec la bonne configuration, ce qui vous évite les erreurs d’une installation manuelle.

Pour utiliser le script BabelLicensingService.ps1, suivez les étapes ci-dessous :

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

Si vous préférez ne pas utiliser le script BabelLicensingService.ps1, la suite de cette page explique pas à pas comment installer le service manuellement.

Fichiers d’installation

Pour installer le Babel Licensing Service, il faut extraire les assemblies et les fichiers de configuration du service du fichier ZIP fourni, babel_service_net100_x.y.z.w.zip, vers le répertoire approprié de votre machine Windows. Les étapes ci-dessous expliquent comment extraire le fichier ZIP avec l’Explorateur Windows vers le répertoire C:\BabelSvc.

Dans l’Explorateur Windows, accédez au dossier où est enregistré babel_service_net100_x.y.z.w.zip.

Les fichiers du Babel Licensing Service contenus dans babel_service_net100_x.y.z.w.zip se trouvent maintenant dans le répertoire C:\BabelSvc.

Fichier de licence

Copiez le fichier de licence babel.licenses dans le dossier d’extraction. Le service peut ainsi accéder aux informations de licence dont il a besoin.

Créer la base de données

Lors de l’installation du Babel Licensing Service, il est indispensable de créer une base de données et un utilisateur dédiés. Les étapes ci-dessous expliquent comment créer la base de données Babel Licensing avec Microsoft SQL Server et avec MySQL MariaDB.

Microsoft SQL Server

Pour gérer les licences du Babel Licensing Service avec SQL Server, il est indispensable de mettre en place une base de données dédiée. Ce guide indique comment configurer la base de données pour qu’elle fonctionne sans accroc.

Lancer SQL Server Management Studio (SSMS)

1. Connectez-vous à votre instance SQL Server.
2. Ouvrez une nouvelle fenêtre de requête pour exécuter les commandes SQL.

Exécuter les commandes SQL suivantes pour créer la base de données et configurer l’utilisateur

-- Create the licenses database
CREATE DATABASE licenses;
GO
 
-- Create a new SQL Server login for the Babel Licensing Service
CREATE LOGIN babel WITH PASSWORD = 'YourUniquePassword';
GO
 
-- Create a database user linked to the login
USE licenses;
CREATE USER babel FOR LOGIN babel;
GO
 
-- Grant the necessary privileges to the user
ALTER ROLE db_owner ADD MEMBER babel;
GO

MySQL MariaDB

HeidiSQL, un outil open source de gestion de bases de données, puissant et simple d’utilisation, peut être utilisé avec MariaDB pour faciliter cette opération. Les étapes ci-dessous expliquent comment créer une base de données avec HeidiSQL et MariaDB.

Commencez par lancer HeidiSQL, puis passez à l’onglet SQL pour exécuter les commandes SQL suivantes :

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

Après avoir exécuté les étapes ci-dessus, vérifiez que la base de données licenses a bien été créée et que l’utilisateur babel dispose des privilèges appropriés. Pour cela, connectez-vous avec les identifiants de l’utilisateur babel et essayez d’accéder à la base de données licenses.

Configurer le Babel Licensing Service

La configuration du Babel Licensing Service est une étape essentielle pour qu’il fonctionne correctement et s’intègre à votre environnement. Elle consiste à modifier le fichier appsettings.json situé dans le dossier d’extraction et à adapter différents paramètres à vos besoins.

Modifier appsettings.json

Accédez au dossier d’extraction et repérez le fichier appsettings.json. Ouvrez-le avec l’éditeur de texte de votre choix et mettez à jour la configuration de la base de données pour qu’elle corresponde au serveur de base de données que vous avez choisi pour la base de données Babel Licensing.

Microsoft SQL Server

Pour installer la base de données Babel Licensing sur Microsoft SQL Server, configurez Database Provider et la chaîne de connexion SQLServer comme suit :

"Database": {
  "Provider": "SQLServer"
},
"ConnectionStrings": {
  "SQLServer": "Data Source=SQLSERVER_INSTANCE_NAME;User Id=babel;Password=YourUniquePassword;Encrypt=false;Initial Catalog=licenses",
  "MySQL": "",
  "SQLite": ""
},

Remplacez SQLSERVER_INSTANCE_NAME par le nom de votre instance SQL Server, tel qu’il apparaît dans SQL Server Object Explorer ou dans votre connexion SQL Server Management Studio (SSMS).

Utilisez pour YourUniquePassword le mot de passe que vous avez défini pour la connexion babel dans Microsoft SQL Server.

MySQL MariaDB

Si vous avez choisi MySQL ou MariaDB pour créer la base de données Babel Licensing, configurez Database Provider et la chaîne de connexion MySQL comme suit :

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

Vérifiez ici que le Provider sous Database est réglé sur MySQL et que la chaîne de connexion MySQL contient l’adresse du serveur, l’utilisateur, le mot de passe et le nom de la base de données appropriés. Remplacez YourUniquePassword par le mot de passe que vous avez défini pour l’utilisateur babel dans MariaDB.

Configurer Kestrel

Dans la section EndpointDefaults, Protocols est réglé sur Http1AndHttp2, ce qui permet au serveur de communiquer avec les protocoles HTTP1 et HTTP2 et le rend compatible avec différents types de clients.

"Kestrel": {
  "EndpointDefaults": {
    "Protocols": "Http1AndHttp2"
  },
  "Endpoints": {
    "gRPC": {
      "Url": "http://*:5005",
      "Protocols": "Http2"
    }
  }
},

La section Endpoints est l’endroit où vous définissez les points de terminaison du service. Ici, un point de terminaison nommé gRPC est configuré avec Url réglé sur http://*:5005, ce qui permet au service d’écouter sur toutes les interfaces réseau disponibles, sur le port 5005. Les Protocols de ce point de terminaison sont réglés sur Http2, ce qui l’optimise pour la communication gRPC.

Lorsque vous configurez Kestrel, vérifiez que les URL et les protocoles indiqués correspondent aux besoins de votre service et à votre environnement réseau, et ajustez-les si nécessaire pour obtenir le comportement et les performances voulus.

Configurer Serilog

Configurez ensuite la section Serilog pour définir les préférences de journalisation :

"Serilog": {
  "Using": ["Serilog.Sinks.Console", "Serilog.Sinks.File"],
  "MinimumLevel": {
    "Default": "Information",
    "Override": {
      "Microsoft": "Warning",
      "System": "Warning",
      "Grpc": "Warning"
    }
  },
  "Enrich": ["FromLogContext", "WithMachineName", "WithThreadId"],
  "WriteTo": [
    {"Name": "Console"},
    {
      "Name": "File",
      "Args": {
        "path": "C:\\BabelSvc\\log.txt",
        "rollingInterval": "Day"
      }
    }
  ]
},

Paramètres de l’application

Enfin, dans la section Application, indiquez les valeurs LicenseFile, SigningKey et TokenExpiration :

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

Ici, LicenseFile doit être réglé sur babel.licenses. Personnalisez SigningKey en remplaçant Secret Token Key par votre propre clé, qui sécurisera la communication entre les applications clientes et le Babel Licensing Service. Ajustez la valeur de TokenExpiration selon vos besoins pour définir la durée de validité du jeton.

Démarrer le Babel Licensing Service

Pour démarrer le Babel Licensing Service avec PowerShell, procédez comme suit :

cd C:\BabelSvc

.\Babel.Licensing.Service.exe

Exécuter en tant que service Windows

Pour que le Babel Licensing Service fonctionne efficacement en arrière-plan et soit disponible à chaque démarrage du système, il est recommandé de l’exécuter en tant que service Windows. Exécuté en tant que service, le Babel Licensing Service fonctionne indépendamment des sessions utilisateur et reste disponible sans interruption.

Pour cela, vous pouvez utiliser la commande New-Service de PowerShell, conçue pour créer l’entrée d’un service Windows dans le registre et dans la base de données des services. Voici la commande adaptée, avec New-Service dans PowerShell :

New-Service -Name "Babel.Licensing" -BinaryPathName "C:\BabelSvc\Babel.Licensing.Service.exe" -DisplayName "Babel Licensing" -StartupType "Automatic" -Description "Babel licensing and reporting network services."

Dans cette commande :

• -Name "Babel.Licensing" indique le nom du service.
• -BinaryPathName ".\Babel.Licensing.Service.exe" définit le chemin du fichier exécutable du service, ici dans le répertoire courant.
• -DisplayName "Babel Licensing" attribue au service un nom d’affichage, celui sous lequel il apparaît dans l’application Services ou dans d’autres interfaces utilisateur.
• -StartupType "Automatic" configure le service pour qu’il démarre automatiquement avec le système.
• -Description "Babel licensing and reporting network services." fournit une description, qui renseigne sur le rôle et le fonctionnement du service.

Cette commande doit être exécutée dans une session PowerShell disposant des privilèges d’administration, afin que le service soit créé et configuré correctement. Après son exécution, le Babel Licensing Service est installé en tant que service Windows et reste disponible en continu sur le système.

Démarrer le service

Start-Service -Name "Babel.Licensing"

Arrêter le service

Stop-Service -Name "Babel.Licensing"

Obtenir l’état du service

Get-Service -Name "Babel.Licensing" 

Désinstaller le service

Get-Service -Name "Babel.Licensing" | Remove-Service

N’oubliez pas d’exécuter ces commandes dans une session PowerShell disposant des privilèges d’administration, pour qu’elles s’exécutent correctement.