<!-- Mini Howto Sendmail+UUCP                                           -->
<!-- Ecrit par Jamal Hadi Salim (jamal@glcom.com ou hadi@cyberus.ca)    -->
<!-- Traduction : Franck Lesage (lesage@pulp.eu.org)                    -->

<!doctype linuxdoc system>

<article>

<title>Mini-HOWTO Sendmail+UUCP
<author>Hadi Salim, <tt>jamal@glcom.com ou hadi@cyberus.ca</tt>
<date>25 octobre 1997

<toc>

<sect>Introduction.<p>
Après m'être finalement calmé et après avoir lu le FM (le Livre de la
Chauve Souris, pour être précis) j'ai résolu l'énigme de Caramilk&nbsp;!
Les étapes suivantes ont été testées avec les binaires fournis dans la
RedHat. Peut-être devrais-je soumettre aussi ces astuces au mainteneur de
la FAQ Sendmail dans la mesure où il n'y a aucune mention d'interconnexion
entre UUCP et Sendmail dedans. 

<sect1>Ce que ce document essaye de vous montrer<p>
Comment configurer une simple machine, dénotée par <tt>me.com</tt> dans
l'exemple, ne possédant aucun accès direct à Internet pour router le
courrier électronique pour vous via sendmail et UUCP vers une 'machine plus
intelligente' i.e.&nbsp;: votre ISP.
Vous pouvez optionellement configurer cette machine pour fournir d'autres
machines i.e.&nbsp;: vous êtes leur 'machine intelligente' (NDT&nbsp;:
référée par smarthost dans le reste du document) ou encore passerelle. 

<sect1>Ce que ce document ne vous dit pas<p>
J'ai reçu un nombre incroyable de questions concernant des sujets dépassant
le cadre de ce HOWTO. Le but de ce document n'est pas de les décrire, donc
merci d'essayer de ne pas m'envoyer de questions sur ce qui suit&nbsp;:


<sect2>Comment configurer UUCP.<p>
Consultez une des nombreuses références bien faites, telles ques&nbsp;:

UUCP HOWTO (Vince Shakan)

Using and managing UUCP (Ed Revin et al -- éditions O'Reilly) qui est je
pense la meilleure référence sur UUCP

Linux Network Administrator Guide (Olaf Kirch)


<sect2>Comment configurer le DNS.<p>
Consultez une des nombreuses références bien faites, telles ques&nbsp;:
  
Caching named mini howto (Nicolai Langfeldt)

The bat book (Sendmail;Costalles, Allman, Rickert&nbsp;; éditions O'Reilly)

DNS and BIND (Editions O'Reilly)

TCP/IP Network Administration (Hunt, Craig&nbsp;; éditions O'Reilly)

Linux Network Administrator Guide (Olaf Kirch)

sendmail Theory and Practice (Avolio et Vixie&nbsp;; éditions Digital press)

<sect2>Comment configurer des bases de données (autres que la mailertable)
 pour fonctionner avec sendmail.<p>
Consultez une des nombreuses références bien faites, telles ques:

The bat book (Sendmail&nbsp;; Costalles, Allman, Rickert -- éditions O'Reilly)

TCP/IP administration (Editions O'Reilly)

Sendmail Theory and Practice (Avolio et Vixie&nbsp;; éditions Digital press)

Documentations attachées à sendmail

<sect2>Comment écrire ou modifier des ensembles règle ou des mailers<p>
Toutes les références du dessus en XXX

Vous pouvez aussi trouver de l'aide dans les <tt>groupes de nouvelles</tt> suivants:

comp.mail.sendmail
comp.mail.uucp
comp.os.linux.networking

<tt>Canaux IRC</tt>

&num;linux, &num;unix

<sect>La configuration<p>
C'est pour un système, hypothétiquement appelé <tt>me.com</tt>, dont le
courrier est envoyé uniquement via UUCP. <tt>mysmarthost</tt> est
le nom de la machine de mon FAI tel qu'il est configuré dans <tt>le fichier
uucp sys</tt> et <tt>me.com</tt> est le nom de machine que nous utilisons ou
sous lequel nous sommes connus dans les enregistrements MX sur Internet.
<tt>mysmarthost</tt> est connecté à Internet. Nous nous moquons
vraiment de savoir comment, nous savons juste qu'elle sait comment nous y
conduire.
<tt>me.com</tt>, dont la configuration que nous décrivons dans l'exemple,
alimente les sites <tt>down.com</tt> et <tt>system1.org</tt> et leurs
sous-noeuds. <tt>me.com</tt> se connecte à <tt>down.com</tt> via TCP/IP et
se connecte à <tt>system1.org</tt> via une connexion UUCP directe par une
ligne téléphonique.
La description de la configuration est indiquée çi-dessous&nbsp;:

<verb>
        ------------------------
        |                       |
        |     Internet          |
        |                       |
        -----------------------
                    |
                    | Ligne dédiée à PPP utilisant TCP-IP
                    |
                -------------
                |            |
                |mysmarthost | Serveur de noms autoritaire pour 
                |            | *.me.com, *.down.com, *.system1.org
                |            |
                --------------
                    |
                    | UUCP par réception ligne téléphonique pour
                    | system1.org, *.system1.org,*.down.com, down.com
                    | ainsi que me.com et *.me.com
                 ------------
                | * *****  *  |
   ------------ | * me.com *  | ------
                | *        *  |      |
   |            | * *****  *  |      |
   |             ------------        |
   |UUCP via ligne téléphonique      | uucp via TCP/IP
   |                                 |
 -----------                  -----------
|           |                |           |
|system1.org|                | down.com  |-------
|           |                |           |      |
 ----------                  ------------       |
     |                                          |
     |                                          |
     |                                          |
     | LAN&nbsp;: smtp vers le noeud            | UUCP ligne téléphonique
     |                                          |
-----------------                             ----------------
|               |                             |              |
|Sous-noeuds de |                             | Réseau local |
|de system1     |                             | de down      |
|               |                             ----------------
-----------------
</verb>

Prérequis

<tt>1)</tt> Si vous avez déjà un DNS qui marche ou avez un pointeur sur un
DNS (dans votre /etc/resolv.conf) et avez une connexion directe au réseau
alors passez cette partie. Vous êtes sauf. Vous n'avez pas de choses
"intelligentes" à faire.<newline>

<tt>2)</tt> Si vous êtes sur une machine utilisant uucp pour le courrier
alors vous n'avez pas vraiment besoin de compiler bind/resolv dans
sendmail&nbsp;;

Comment survivre à la mise sous forme canonique sur une machine indépendante
sans DNS

<sect1>PARTIE I<p>
Si vous prenez un sendmail pré-compilé avec BIND dedans vous pouvez toujours
y arriver (comme c'est le cas avec le sendmail de RedHat).

<tt>a)</tt> Vous référer à ma solution pour ça basée sur le fichier m4
décrit (mon favori). Essayez d'utiliser cette option à moins que vous teniez
à b) ou c) ci-dessous. OU

<tt>b)</tt> Si vous me contactez je pourrais vous fournir une version non
compilée avec BIND (8.8.5). Peut-être que RedHat devrait considérer la fourniture de
deux binaires sendmail (comme slackware) un avec BIND et l'autre sans BIND.
OU 

<tt>c)</tt> La solution la plus rapide pour avoir un sendmail sans bind est
d'éditer les lignes de <tt>src/conf.h</tt> ci-dessous comme je l'ai montré&nbsp;:

<tt>&num; ifndef NAMED_BIND conf.h:&num; define NAMED_BIND 0 /* use Berkeley
Internet Domain Server */</tt>

<sect1>PARTIE II<p>
Sendmail devrait cependant normallement insister à faire les requêtes de
noms pour résoudre la partie machine en utilisant <tt>gethostbyaddr()</tt>
pour chaque mail qu'il envoie (même si vous lui dites de ne pas mettre les
noms sous forme canonique).

<tt>a)</tt> utiliser une adresse IP de la <tt>RFC1597</tt>
(10.0.0.0-10.255.255.255, 172.16.0.0-172.31.255.255,
192.168.0.0-192.168.255.255)
Editez <tt>/etc/hosts</tt> et ajoutez ce qui suit comme exemple pour la
machine myhost <tt>10.0.0.1 myhost.me.com myhost</tt> OU

<tt>b)</tt> Si vous utilisez NIS (et NIS est compilé dans sendmail comme
cela semble être le cas dans la RedHat.) assurez vous que le fichier
<tt>/etc/nsswitch.conf</tt> contienne&nbsp;:
<tt>hosts: files dns</tt> et dans <tt>/etc/hosts</tt> et ajoutez ce qui suit
comme exemple pour la machine myhost [toujours en utilisant l'adressage IP
de la RFC1597] <tt>10.0.0.1 myhost.me.com myhost</tt>

<tt>NOTE&nbsp;: </tt> Dans a) et dans b) ci-dessus il est vital que vous
listiez le long (complètement qualifié) dans le fichier /etc/hosts utilisé.
i.e la ligne doit être <tt>10.0.0.1 myhost.me.com</tt> et NON <tt>10.0.0.1
myhost</tt> vous aurez aussi besoin de définir la macro sendmail <tt>&dollar;j</tt>
pour qu'elle contienne <tt>myhost.me.com</tt>
ajoutez ce qui suit à votre fichier <tt>/etc/sendmail.cf</tt> après qu'il
ait été généré <tt>Dmyhost.me.com</tt> (ou vous pouvez utiliser
<tt>MASQUERADE_AS(myhost.me.com)</tt> dans le fichier <tt>.mc</tt>
ci-dessous)

<tt>NOTE</tt>&nbsp;!!!!! <tt>myhost</tt> comme nom de domaine est donné à titre
d'exemple&nbsp;; vous n'avez pas à l'utiliser tel quel. Choisissez-vous votre
propre nom de machine si vous n'en avez pas déjà un.

<tt>2)</tt> Assurez-vous que vous avez makemap et qu'il est capable de
supporter hash et/ou le format plus commun dbm ou même le format btree (La
version RedHat ne supporte pas dbm). Makemap est normallement distribué avec
sendmail.

<sect1>CONFIGURATION (le fichier mc)<p>

<tt>I)</tt> créez votre fichier .mc avec votre éditeur favori&nbsp;; j'appellerai
ce fichier <tt>my.mc</tt>

<tt>a) Pas de DNS -- machine indépendante</tt>

   <tt>include(`../m4/cf.m4')</tt><newline>
   <tt>VERSIONID(`me.com setup with uucp created by xxxx --no dns ')</tt><newline>
   <tt>dnl OSTYPE(linux)</tt><newline>
   <tt>FEATURE(nodns)dnl</tt><newline>
   <tt>FEATURE(nocanonify)dnl</tt><newline>
   <tt>FEATURE(always_add_domain)dnl</tt><newline>
   <tt>FEATURE(mailertable, hash /etc/mailertable)dnl</tt><newline>
   <tt>MAILER(local)dnl</tt><newline>
   <tt>MAILER(smtp)dnl</tt><newline>
   <tt>MAILER(uucp)</tt><newline>
   <tt>define(`SMART_HOST', uucp-dom:mysmarthost)</tt><newline>

Dissequons ceci&nbsp;:

<tt>include(`../m4/cf.m4')</tt> requiert l'inclusion de la macro m4 qui se
trouve dans ../m4/cf.m4 afin de résoudre certaines choses.

<tt>VERSIONID(`me.com setup with uucp created by xxxx --no dns ')</tt>
C'est utilisé pour distinguer les différentes versions du fichier .cf que
vous pourriez finir par créer.

<tt>OSTYPE(linux)</tt> Ca sert à définir/redéfinir les choses spécifiques à
Linux. Il est prudent de l'avoir ici.

<tt>FEATURE(nodns)dnl</tt> Cela veut dire que nous n'avons pas de serveur
DNS (comme nous n'utilisons uucp que pour le mail. Sendmail doit être
compilé pour ne pas utiliser bind). C'est devenu obsolète. Je vais le
laisser ici juste au cas où vous utiliseriez une version plus ancienne de
sendmail.

<tt>FEATURE(nocanonify)dnl</tt> Cela veut dire Ne passez pas les addresses à
la règle <tt>&dollar;[ ... ]&dollar;</tt> pour la mise en forme canonique. Normallement si
vous avez BIND compilé dans sendmail, il essayerait et développerait
l'alias/l'adresse IP en un nom canonique grâce au DNS. Vous n'en avez pas
besoin si tout ce que vous avez ne sont que des approvionnements par UUCP
i.e.&nbsp;: vous avez une machine indépendante.
 
<tt>FEATURE(always_add_domain)dnl</tt> Ceci ajoute le nom de domaine local
même au mail local. Ce n'est pas nécessaire mais j'aime bien&nbsp;; <tt>Ce n'est
peut-être pas prudent dans la mesure où les spammeurs, avec une
configuration appropriée, peuvent vous embêter.</tt>
me.com n'est pas connecté au réseau via tcp/ip donc c'est sans danger.

<tt>FEATURE(mailertable, hash /etc/mailertable)dnl</tt> Le fichier
<tt>/etc/mailertable</tt> sera une base de donnée <tt>hashée</tt> où nous
allons stocker les informations de routage de certains sites. Si vous
n'approvisionez personne vous n'en avez pas besoin. J'en dirai plus
là-dessus plus tard. Si vous vouliez utiliser le format <tt>dbm</tt> vous
auriez <tt>FEATURE(mailertable, dbm /etc/mailertable)dnl</tt> Si vous
vouliez utiliser le format <tt>btree</tt> vous auriez
<tt>FEATURE(mailertable, btree /etc/mailertable)dnl</tt>

<tt>MAILER(local)dnl MAILER(smtp)dnl MAILER(uucp)</tt> Ce sont les mailers
que nous utilisons.

<tt>define(`SMART_HOST', uucp-dom:mysmarthost)</tt> Notre smarthost 
est chez notre FAI, il est défini dans le fichier
<tt>sys</tt> comme <tt>system mysmarthost</tt>. Tous les messages
que nous ne pouvons pas traiter (i.e&nbsp;: ceux dont les domaines ou les
mailers nous sont étrangers) seront envoyés à notre smarthost/FAI qui
s'en débrouillera. Notez que nous utilisons uucp-dom
comme mailer uucp. Ce mailer particulier utilise des règles de
réécritures de type smtp.

<tt>b) Avec DNS</tt>

   <tt>include(`../m4/cf.m4')</tt><newline>
   <tt>VERSIONID(`me.com setup with uucp created by xxxx --dns enabled')dnl</tt><newline>
   <tt>OSTYPE(linux)</tt><newline>
   <tt>FEATURE(always_add_domain)dnl</tt><newline>
   <tt>FEATURE(mailertable, hash /etc/mailertable)dnl</tt><newline>
   <tt>MAILER(local)dnl</tt><newline>
   <tt>MAILER(smtp)dnl</tt><newline>
   <tt>MAILER(uucp)</tt><newline>
   <tt>define(`SMART_HOST', uucp-dom:mysmarthost)</tt><newline>
 
<tt>II) Crééz votre fichier sendmail.cf</tt>

<tt>a)</tt> Sauvegardez votre ancien fichier <tt>/etc/sendmail.cf</tt><newline>
<tt>b)</tt> Remplacez votre fichier sendmail.cf avec le nouveau&nbsp;: <tt>m4
my.mc /etc/sendmail.cf</tt><newline>
<tt>c)</tt> Verifiez que le fichier sendmail.cf a été correctement créé sur
les bases de vos spécifications.<newline>
Les quelques problèmes que j'ai eus sont&nbsp;: <tt>le mailer uucp-dom
manquant</tt> C'était parceque je n'avais pas mis le mailer smtp. En fait,
j'ai compris que c'est important de le mettre avant l'uucp.<newline>

<tt>III) Crééz votre fichier /etc/mailertable</tt><newline>
Si vous n'alimentez pas de sites uucp vous pouvez omettre cette étape.
<newline>
<tt>a) crééz/éditez le fichier /etc/mailertable</tt>
exemple de fichier /etc/mailertable&nbsp;:

   <tt>system1.org uucp-dom:system1</tt><newline>
   <tt>.system1.org uucp-dom:system1</tt><newline>
   <tt>down.com uucp-dom:down</tt><newline>
   <tt>up.down.com  error: Host is unknown at me.com</tt><newline>
   <tt>.down.com uucp-dom:down</tt><newline>
   <tt>.me.com error: Host unknown at me.com</tt><newline>

Cela veut dire que tout ce qui est adressé à <tt>system1.org</tt> ou à
<tt>*.system1.org</tt> et que nous recevons sera envoyé à <tt>system1</tt>
en utilisant <tt>uucp-dom</tt> en autres termes nous faisons le routage de
mail pour <tt>*.system1.org</tt>; idem pour <tt>down.com</tt> et ses
sous-noeuds sauf en ce qui concerne le filtrage additionnel&nbsp;; nous renvoyons
tout mail pour le sous-noeud de down <tt>up.down.com</tt> en utilisant
le mailer <tt>error</tt> intégré à sendmail avec le message <tt>"Host is
unknown at me.com"</tt>&nbsp;; Tout ça parceque l'administrateur de
<tt>down.com</tt> nous l'a demandé. Pour renvoyer les sous-domaines
qui nous sont inconnus nous utilisons la dernière ligne de mailertable (ce
que sont nous les sous-noeuds par défaut).

<tt>b)</tt> créez la base de données avec <tt>makemap</tt>

si vous utilisez <tt>hash</tt>&nbsp;:
<tt>makemap hash /etc/mailertable &lt; /etc/mailertable</tt>
si vous utilisez <tt>dbm</tt>&nbsp;:
<tt>makemap dbm /etc/mailertable &lt;/etc/mailertable</tt>
si vous utilisez <tt>btree</tt>&nbsp;:
<tt>makemap btree /etc/mailertable &lt;/etc/mailertable</tt>

à faire à chaque fois que vous modifiez le fichier.

<tt>IV) Redémarrez sendmail</tt>

<tt>V) Testez sendmail</tt>
<tt>i)</tt> sendmail -bv user@destination
<tt>ii)</tt> utilisez sendmail -bt et entrez plusieurs adresses en utilisant
la règle 3,0 pour voir où elles arrivent et les différentes règles et
cheminements "cf" pris.
<tt>Vous y êtes&nbsp;!</tt>

<sect>A faire<p>
<tt>1)</tt> Ajouter des informations sur la mise en place du système down.com
(afin de montrer comment prendre en compte de ces noeuds smtp)
<tt>2)</tt> Ajouter des informations sur comment mettre en place la
distribution de news via UUCP (INN de préférence). Cela nécessitera
peut-être de changer le titre du document.

</article>
