Service Windows

Le service Windows (Q-ENGINE_service.exe) peut être enregistré ou supprimé en tant que service via une ligne de commande.

Pour cela, saisissez dans l'invite de commandes Windows le nom de l'application suivi du paramètre.

Il est préférable d'ouvrir l'invite de commandes avec des droits d'administration, sinon la saisie ne pourra pas enregistrer ou supprimer le service :

Installation du service
- Q-ENGINE_service /i
- Q-ENGINE_service /install
Suppression du service
- Q-ENGINE_service /u
- Q-ENGINE_service /uninstall

Si le programme est démarré sans paramètre, l'application s'exécute dans l'invite de commandes.

Par exemple, toutes les journalisations sont alors également affichées dans l'invite de commandes.

Si l'invite de commandes est fermée ou si l'utilisateur Windows se déconnecte, ce service est également arrêté.

Pour que le service s'exécute indépendamment d'une connexion utilisateur Windows ou d'une invite de commandes,

le service doit être installé comme décrit ci-dessus.

Le service peut ensuite être démarré / arrêté via les paramètres des services Windows ou via la ligne de commande :

net stop "<service>" par exemple : net stop Q-ENGINE_test ou net stop "Q-ENGINE prod"

net start "<service>" par exemple : net start Q-ENGINE_test ou net start "Q-ENGINE prod"

Les guillemets (") ne sont nécessaires que si le nom du service contient des espaces.

Configuration

La configuration du service Windows s'effectue via des réglages dans le fichier Q-ENGINE_service.exe.config.

Les réglages peuvent être effectués à partir de la ligne 22. Il s'agit des suivants :

ServiceName	Le suffixe du nom de service avec lequel le service s'exécute sur le système. Par exemple : _test ou _prod
WaitInSeconds	Le temps en secondes entre les exécutions du service (temps d'attente). Le minimum est de 5 et le maximum de 50. Des valeurs en dehors de cette plage empêcheront le service de s'exécuter.
LicenseKeyPath	Par défaut, le service vérifie son répertoire d'exécution à la recherche d'une licence valide. Si un chemin de répertoire est défini pour la licence, le service vérifie également si une licence valide y est disponible. Par exemple : C:\Q-Matrix™\ Sans licence valide, le service ne peut pas fonctionner.
QPORTAL_URL	Une URL / adresse web permettant d'accéder à Q-PORTAL (si présent / disponible), par exemple : http://localhost/qportal/
DBBackupPath	Un chemin de répertoire pour le stockage temporaire des sauvegardes de base de données, par exemple : C:\tmp\

Pour les variantes de journalisation configurées, le niveau de détail est défini dans l'élément RULES :

    <rules>
      <!-- Debug: minLevel = Trace - Prod: minLevel = Info -->
      <logger name="*" minlevel="Trace" writeTo="debugger" />
      <logger name="*" minlevel="Trace" writeTo="console" />
      <logger name="*" minlevel="Trace" writeTo="file" />
    </rules>

Les niveaux de détail suivants peuvent être définis pour la journalisation :

OFF	Ne journalise aucun événement applicatif
FATAL	Journalise uniquement les événements applicatifs définis comme FATAL
ERROR	Journalise uniquement les événements applicatifs définis comme ERROR et FATAL
WARN	Journalise uniquement les événements applicatifs définis comme WARN, ERROR et FATAL
INFO	Journalise uniquement les événements applicatifs définis comme INFO, WARN, ERROR et FATAL
DEBUG	Journalise uniquement les événements applicatifs définis comme DEBUG, INFO, WARN, ERROR et FATAL
TRACE	Journalise tous les événements applicatifs définis

Le niveau de journalisation est défini à partir de la ligne 42, et le réglage par défaut pour les services utilisés en production est le niveau de détail INFO.