Changes

===Aperçu et description===

===Aperçu et description===

Ce document est destiné à servir de description en "langage clair" du système de gabarit (template) de SME server. Reportez-vous à la page [[SME_Server:Documentation:Developers_Manual#Configuration_file_templates|Gabarit (template) de fichiers de configuration]] du [[SME_Server:Documentation:Developers_Manual|Guide du Developeur pour SME server]] pour une description plus technique.

Ce document est destiné à servir de description en « langage clair » du système de gabarit (template) du serveur Koozali SME. Reportez-vous à la page [[SME_Server:Documentation:Developers_Manual#Configuration_file_templates|gabarit (template) de fichiers de configuration]] du [[SME_Server:Documentation:Developers_Manual|guide du dévelopeur pour le serveur SME,]] pour une description plus technique.

Le système gabarit est unique au serveur SME. Il est utilisé pour créer les fichiers de configuration standard dans /etc/... en conjonction avec l'événement ''expand-template''.

Le système de gabarit est unique au serveur SME. Il est utilisé pour créer les fichiers de configuration standard dans /etc/... en conjonction avec l'événement ''expand-template''.

Les gabarits sont constitués de fragments qui s'additionnent pour créer le fichier de configuration tout entière. Le code dans fragments de gabarits peut avoir une valeur par défaut en l'absence d'une valeur spécifique dans la db (base de données).

Les gabarits sont constitués de fragments qui s'additionnent pour créer le fichier de configuration tout entier. Le code dans les fragments de gabarits peut avoir une valeur par défaut en l'absence d'une valeur spécifique dans la db (base de données).

Afin de déterminer quels paramètres de base de données sont pris en compte par le code du fragment de gabarit, ou quelles sont les valeurs par défaut, reportez-vous (c'est à dire lisez) au code qui est dans les fragments de gabarit, ou dans les fragments de gabarit personnalisé associé à un fichier /etc/file.conf

Afin de déterminer quels paramètres de base de données sont pris en compte par le code du fragment du gabarit, ou quelles sont les valeurs par défaut, reportez-vous (c'est-à-dire lisez) au code qui est dans les fragments du gabarit, ou dans les fragments du gabarit personnalisé associé à un fichier /etc/file.conf.

   

   

Regardez dans /etc/e-smith/templates/ et /etc/e-smith/templates-custom/ et leurs sous-dossiers à la recherche des fragments de gabarit associés aux fichiers de configuration d’intérêt comme /etc/file.conf.

Regardez dans /etc/e-smith/templates/ et /etc/e-smith/templates-custom/ et leurs sous-dossiers pour la recherche des fragments de gabarit applicables à un fichier de configuration particulier comme /etc/file.conf.

Les changements de configuration sont faites dans le gestionnaire de serveur (server-manager), ou par les paramètres de base de données en ligne de commande supplémentaires, ou en adaptant le code qui génère les paramètres de configuration. Ce code est dans les gabarits (templates). Les gabarits sont composés de fragments. Ce ne sont pas des fichiers de configuration réguliers, ils sont le code qui génère une partie (c'est à dire un fragment) des fichiers de configuration.

{{Note box |type=Note :| le serveur SME utilise les fichiers de configuration dans le dossier /etc/ comme n'importe quel autre système Linux. Ne pas modifier directement les fichiers de configuration dans le dossier /etc/ (comme on le ferait dans une distro Linux standard).}}

Les fichiers de configuration dans le dossier /etc/ sont créés à partir du code dans les fragments de gabarits et les valeurs par défaut dans les fragments de gabarits principaux et la base de données de configuration interne dans /etc/e-smith/templates/.

 

Les fichiers de configuration dans le dossier /etc/ sont créés à partir du code dans les fragments de gabarits et par les valeurs par défaut dans les fragments de gabarits principaux et la base de données de configuration interne dans /etc/e-smith/templates/.

Le code dans les fragments de gabarits recherche également des valeurs dans les différentes bases de données dans /home/e-smith/db/ (quand le code a été écrit pour s'appuyer sur les paramètres de bases de données).

Le code dans les fragments de gabarits recherche également des valeurs dans les différentes bases de données dans /home/e-smith/db/ (quand le code a été écrit pour s'appuyer sur les paramètres de bases de données).

  expand-template /etc/file.conf

  expand-template /etc/file.conf

Vous aurez probablement besoin de relancer le service affecté en utilisant :  

pour les services supervisés :

  sv t /service/servicename

  sv t /service/servicename

Certains signaux d’événement combinent l'utilisation de gabarits et le redémarrage du service

Certains signaux d’événement combinent l'utilisation de gabarits et le redémarrage du service :

  signal-event email-update

  signal-event email-update

ou l'un des nombreux signaux tout autre événement en fonction de la tâche que vous faites.

ou l'un des nombreux autres signaux d'événement applicable à la tâche que vous effectuez.

En cas de doute de gabarit à développer et de service à redémarrer, il y a un une commande "maîtresse" qui permettra d'appliquer tous les gabarits et de redémarrer tous les services, avec pour effet de réinitialiser tous les les paramètres de configuration. Il est sécuritaire de le faire à tout moment en utilisant

En cas de doute sur le gabarit à développer et de service à redémarrer, il y a un une commande « maîtresse » qui permettra d'appliquer tous les gabarits et de redémarrer tous les services, avec pour effet de réinitialiser tous les les paramètres de configuration. Il est sécuritaire de le faire à tout moment en utilisant

  signal-event post-upgrade

  signal-event post-upgrade

  signal-event reboot

  signal-event reboot

Pour effectuer un changement personnalisé de gabarit, copiez le fragment d'intérêts existants dans sous le répertoire /etc/e-smith/templates/ dans le dossier correspondant sous /etc/e-smith/templates-custom/ en conservant la même structure de dossier. Éditez le fragment copié avec les modifications désirées, puis appliquez le gabarit au fichier de configuration et redémarrez le service affecté comme décrit au dessus.

Pour effectuer un changement personnalisé de gabarit, copiez le fragment intéressant existant dans sous le répertoire /etc/e-smith/templates/ dans le dossier correspondant sous /etc/e-smith/templates-custom/ en conservant la même structure de dossier. Éditez le fragment copié avec les modifications désirées, puis appliquez le gabarit au fichier de configuration et redémarrez le service affecté comme décrit ci-dessus.

Vous pouvez aussi créer un nouveau fragment de gabarit quand le fragment souhaité n'existe pas déjà. Vous aurez à lui trouver un nom correspondant à l'ordre alphanumérique adapté à la position à laquelle vous voulez que votre nouveau paramètre occupe au milieu des autres fragments dans le fichier de configuration /etc/xxxx . Attention À bien créer ce fragment dans /etc/e-smith/templates-custom/ et non dans /etc/e-smith/templates/ qui est réservé aux fragments par défaut.

Vous pouvez aussi créer un nouveau fragment de gabarit quand il n'en existe pas déjà un d'utilisable pour la tâche envisagée. Vous aurez à lui trouver un nom correspondant à l'ordre alphanumérique adapté à la position que vous voulez que votre nouveau paramètre occupe au milieu des autres fragments dans le fichier de configuration /etc/xxxx . Attention À bien créer ce fragment dans /etc/e-smith/templates-custom/ et non dans /etc/e-smith/templates/ qui est réservé aux fragments par défaut.

===Pourquoi tout cela dans la conception de SME ?===

===Pourquoi tout cela dans la conception de SME ?===