Template Tutorial/fr

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 Gabarit (template) de fichiers de configuration du Guide du Developeur pour SME server pour une description plus technique.

Le système gabarit est unique à SME Server. 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).

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

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.

	Note:
	SME Server 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 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.

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

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).

En outre, il y a des fragments de gabarits personnalisés dans le dossier /etc/e-smith/templates-custom/. Le code dans ces fragments de gabarits personnalisés ajoute des paramètres de configuration en plus des paramètres générés par les fragments de gabarit principaux, ou lorsque les fragments de gabarit personnalisés sont nommés de façon identique, ils vont complètement remplacer les paramètres générés par les fragments de gabarit principaux.

Le fichier de configuration /etc/file.conf est généré lorsque vous exécutez la commande suivante :

expand-template /etc/file.conf

Vosu aurrez probablement besoin de relancer le service affecté en utilisant :

sv t /service/servicename

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

signal-event email-update

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

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

signal-event post-upgrade
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.

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.

Pourquoi tout cela dans la conception de SME?

Afin d'avoir des réglages par défaut robustes qui peuvent être facilement remis à leur paramètres de départ en effacement simplement les fragments personnalisés puis appliquer le gabarit et enfin redémarrer le service. Le système reviendra alors à une configuration fonctionnelle.

C'est pour cela que le gabarit principal ne doit JAMAIS être modifié directement, afin que les tous les fragments de code par défaut restent inchangés et intacts.

Vous aurez besoin de localiser les fragments du gabarit d’intérêt et d'en lire le code afin de décider quel fragment vous voulez copier et modifier. Vous pouvez généralement déduire ceci du fichier de configuration que vous essayez de modifier /etc/xxxx c'est à dire que l'un est lié à l'autre.

S'il vous plait faites le tour des différents tutoriels (HowTo) et articles du wiki pour les Contributions qui ont ce type de modification de configuration décris, vous y trouverez ainsi des exemples de pas à pas détaillés qui pourront être appliqués à un besoin particulier( en changeant le nom de service et de fragment et les commandes d'application des gabarits évidemment). Vous pouvez aussi rechercher sur le forum "expand-template" pour de nombreux exemples.

Exemples pratiques spécifiques

Ce qui suit n'est qu'une suite d'exemples, assurez-vous de définir et utiliser les réglages et fragments de gabarit appropriés.

dhcpd.conf

Examinez les fragments du gabarit dans /etc/e-smith/templates/etc/dhcpd.conf et définissez quel fragment vous voulez changer. Disons que vous voulez modifier une valeur qui est dans le fragment 25DomainNameServers (pour les réglages du serveur de DNS), et dans le fragment 25Routers (pour le réglage de passerelle/routeur).

Copiez les fragments dans l'arborescence de gabarits personnalisés (templates-custom)

mkdir -p /etc/e-smith/templates-custom/etc/dhcpd.conf
echo "option domain-name-servers 4.2.2.1;" > /etc/e-smith/templates-custom/etc/dhcpd.conf/25DomainNameServers
echo "option routers 192.168.1.4;" > /etc/e-smith/templates-custom/etc/dhcpd.conf/25Routers

Appliquez le gabarit et redémarrez dhcpd

expand-template /etc/dhcpd.conf
sv t /service/dhcpd

Examinez /etc/dhcpd.conf afin de vérifier si vos changements ont été appliqués.

masq

Examinez les fragments du gabarit dans /etc/e-smith/templates/etc/rc.d/init.d/masq

Disons que vous voulez bloquer l'accès à votre serveur depuis une adresse IP externe et qu'il n'y a pas de fragments qui correspond à vos souhaits. Referez-vous à http://forums.contribs.org/index.php/topic,45495.0.html . Dans ce cas créer un fragment.

Créez un nouveau fragment de gabarit

mkdir -p /etc/e-smith/templates-custom/etc/rc.d/init.d/masq/
nano -w /etc/e-smith/templates-custom/etc/rc.d/init.d/masq/40DenyZombies

Ajoutez ceci au fragment

/sbin/iptables -A INPUT -s 24.71.223.10/32 -j DROP # gaspillage d'espace IP
/sbin/iptables -A INPUT -s 24.64.0.0/13 -j DROP # soutien Telco

Puis sauvegardez et quittez

Ctrl x 
yes

Appliquez le gabarit et redémarrez masq (masquerading)

expand-template /etc/rc.d/init.d/masq
/etc/init.d/masq restart

Vérifiez que vos modifications sont fonctionnelles.

mysql

Q) La réplication du MySQL d'un serveur SME vers un esclave MySQL est elle possible ? Le log binaire est il possible? Si oui, modifiez vous le fichier my.cnf ou autre pour initialiser le log binaire?

R) La première étape consiste à aller sur le site de MySQL et chercher ce que vous voulez faire, voyez http://dev.mysql.com/doc/

Quand vous avez trouvé ce qui a besoin d'être ajouté au fichier /etc/my.cnf , vous pouvez faire les modifications appropriées au travers d'un fragment de gabarit SME personnalisé (templates-custom).

Inspectez les fragments de gabarit dans /etc/e-smith/templates/etc/my.cnf

Définissez quel fragment doit accueillir votre code révisé. Voyez le fragment 000readme pour information.

Si aucun fragment n'est souhaitable, vous aurez à en créer un nouveau. Dans l'exemple suivant remplacez 005mysql par le nom de fragment, existant ou à créer, approprié.

Disons que vous voulez modifier le fragment /etc/e-smith/templates/etc/my.cnf/005mysqld

Créez un nouveau dossier et copier le fragment de gabarit dans le nouveau répertoire personnalisé (ou créez un nouveau fragment de gabarit personnalisé)

mkdir -p /etc/e-smith/templates-custom/etc/my.cnf/
cp /etc/e-smith/templates/etc/my.cnf/005mysqld /etc/e-smith/templates-custom/etc/my.cnf/005mysqld

Éditez afin de faire les additions et changements nécessaires. C'est là que vous faites les modifications en accord avec ce que vous avez déterminé en lisant la documentation de MySQL.

pico -w /etc/e-smith/templates-custom/etc/my.cnf/005mysqld

Sauvegardez et quittez

Ctrl o
Ctrl x

Appliquez le gabarit et redémarrez mysqld

expand-template /etc/my.cnf
sv t /service/mysqld

Vérifier l'état du service

sv s /service/mysqld

Dans cet exemple particulier, il apparait que vous devez autoriser l'accès à votre base MySQL avec le LAN (en local) ou le WAN (vers l'extérieur). Afin de faire ceci vous devrez probablement changer les permissions d'accès à votre base mysql, référez-vous à http://wiki.contribs.org/SME_Server:Documentation:FAQ#Access_MySQL_from_the_local_network http://wiki.contribs.org/SME_Server:Documentation:FAQ#Access_MySQL_from_a_remote_network http://wiki.contribs.org/SME_Server:Documentation:FAQ#Create_MySQL_user.28s.29_with_access_from_other_computers

Vérifiez que vos modifications sont fonctionnelles

Suppression Pour supprimer ces changements personnalisés, vous avez à supprimer le fragment de gabarit personnalisé, appliquer le gabarit et redémarrer le service, comme suit:

rm /etc/e-smith/templates-custom/etc/my.cnf/005mysqld
expand-template /etc/my.cnf
sv t /service/mysqld

Vérifier l'état du service

sv s /service/mysqld

php.ini

Examinez les fragments de gabarit dans /etc/e-smith/templates/etc/php.ini et déterminez quel fragment vous voulez modifier. Disons que vous voulez modifier une valeur qui est dans le fragment 40DataHandling .

Copiez le fragment dans l'arborescence de gabarits personnalisés (templates-custom)

mkdir -p /etc/e-smith/templates-custom/etc/php.ini
cp /etc/e-smith/templates/etc/php.ini/40DataHandling /etc/e-smith/templates-custom/etc/php.ini/40DataHandling

Modifiez le fragment et faites les changements désirés

pico -w /etc/e-smith/templates-custom/etc/php.ini/40DataHandling

Sauvegardez les changements et quittez (appuyer sur les touches en même temps pour chaque ligne ci-dessous)

Ctrl o
Ctrl x

Appliquez le gabarit et redémarrez httpd-e-smith

expand template /etc/php.ini
sv t /service/httpd-e-smith

Vérifiez /etc/php.ini afin de voir si vos changements ont été pris en compte.

httpd.conf

Cet exemple provient d'un message du forum, que vous pouvez trouver ici http://forums.contribs.org/index.php/topic,40336.0.html, où un utilisateur demande comment rediriger les erreurs 404 vers un fichier php.

Faites un dossier pour votre fragment de gabarit personnalisé

mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf

Créez le fragment de gabarit avec vi ou pico

cd /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf
pico S85ErrorPages

ajoutez le texte suivant :

# Add custom error pages here
ErrorDocument 404 /introuvable.html

Sauvegardez et quittez

Ctrl c
Ctrl x

Appliquez le gabarit et redémarrez le service& restart service

expand-template /etc/httpd/conf/httpd.conf
sv t /service/httpd-e-smith

À l'Aide de votre éditeur web préféré, créez la page web souhaitée et sauvegardez la dans le dossier html de l'ibay Primary. (ou de l'ibay de votre choix) avec un nom de fichier comme introuvable.html

Ouvrez ensuite votre navigateur internet et tapez une URL incorrecte (en étant sur que le domaine est valide et pointe vers l'ibay) comme http://www.mondomaine.com/jesaispas et votre nouvelle page d'erreur devrais s'afficher.

Si une page d'erreur est requise pour différent domaines virtuels, créez une nouveau fichier html pour chaque domaine et sauvegardez le dans le dossier html de l'ibay appropriée.

Ce concept s'applique aussi aux autres erreurs communes comme :

400 Mauvaise requête
401 Non autorisé
403 Interdit

Ces erreurs peuvent être pris en charge par les lignes appropriées dans le du fragment de gabarit pour pointer vers des pages adaptées.

Une liste complète des codes d'erreur peut être trouvé ici http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

Vous pouvez ajouter d'autres exemples à cette section.

Quick steps & tips

From http://forums.contribs.org/index.php/topic,45855.0.html

In order to override a SME template, the filename in .../templates-custom/... should to be identical to the filename in .../templates/....

Here's how to go about creating a custom template:

1. Identify the service performing the task I want to customize
2. Identify the configuration file that needs to be customized
3. Change the config file manually
4. Restart the affected service
5. Verify that restarting the service did not return the config file to the original configuration (dnscache, for example, regenerates .../dnscache/root/servers each time the service is restarted)
6. Verify that the change introduced, fixes the problem I am addressing
7. Locate the default template fragment that generates the piece of the config file I want to modify
8. Copy the default template fragment into the appropriate .../templates-custom/... folder tree
9. Edit the .../templates-custom/... copy of the template fragment
10. Use expand-template to regenerate the target config file
11. Verify (using file date and time, or by using a slightly different value for the new parameter than was used in step 3) that the config file now contains the output generated by the new custom template fragement.
12. Re-test
13. Document the operation in the wiki if it seems to me that the info would be useful to others

Not every config option of every program is templated; for example, there is no template (that I can find) to control /var/service/qpsmtpd/config.

Not every template is in the location you might expect (.../qpsmtpd/peers/0 is built using the template fragments in .../qpsmtpd/config/plugins due to the instructions in .../templates.metadata/...).

Not every function is controlled by only one template (or config file) - email attachment size, for example, is affected by settings in qmail, qpsmtpd, php and clamd.

Finally, template fragments are processed alpha-numerically - so be sure that your customizations are inserted into the target config file in a sensible location.

References

See the Howto section for articles on db commands that should give useful additional info ie

http://wiki.contribs.org/DB_Variables_Configuration

and

http://wiki.contribs.org/Useful_Commands

Refer to the Developers Guide for technical information on Templating

http://wiki.contribs.org/SME_Server:Documentation:Developers_Manual#Configuration_file_templates

---