$Id: uucp.faq,v 1.10 2003/12/26 14:00:46 eumel Exp $

News & Mails mit Germany.Net UUcp (GNUU)

Inhalt:
[1] Allgemeines
[2] UUCP-AGENT
[3] Taylor_UUCP (Unix)
[4] andere UUCP-Systeme
[5] OpenXP (Windows)
[6] INN als Newsserver (Version 2.2/Unix)
[7] Hamster (Windows)
[8] Sendmail als MTA (Unix)
[9] Exim als MTA (Unix)


[1] Allgemeines:

Bei Arcor besteht jetzt die Moeglichkeit, News und Mails via UUCP
over TCP/IP zu beziehen. Bei UUCP werden die Daten in komprimierte
Batchfiles abgelegt und koennen vom UUCP-Host zum eigenen Rechner
ueber eine beliebige TCP/IP-Verbindung uebertragen werden.
Eine Einwahl bei Arcor ist zur Nutzung dieses Dienstes nicht
unbedingt notwendig, sondern kann von ueberall erfolgen. Durch die
Komprimierung der Daten mit verschiedenen Packern
(compress,gzip,bzip2,szip) verringert sich das Transfervolumen auf ein
Minimum und spart somit wertvolle Onlinezeit. Fuer den Newszugang
stehen ca. 5000 Newsgruppen zur Verfuegung.

ftp://ftp.arcor.de/pub/news/uucp.gnuu.de/newsgroups

Die UUCP-Mails werden auf eigene Subdomain weitergeleitet. Diese hat die
Form <site>.gnuu.de.
"site" steht dabei fuer eine UUCP-Site, was ueblicherweise die
arcor-Faxnummer darstellt. Also z.B.

6913304003903.gnuu.de

Die persoenliche Faxnummer erfaehrt man aus dem arcor-UMS-System
(z. B. http://www.arcor.de/ums/ums_titel.jsp).
Die UserID kann in der Subdomain auch durch einen Namen belegt werden,
wie etwa

dragon.gnuu.de

Wenn man einen eigenen Namen statt UserID nutzen will, genuegt eine
Nachricht an news@arcor-online.net. Es wird dann geprueft, ob der Name
noch frei ist und in die Konfiguration eingetragen.
Auf diese Subdomain koennen beliebig viele eMailadressen angelegt
werden. Diese Mailadressen werden auf dem eigenen Rechner verwaltet.
Hinweis: Der Name der Subdomain ist nur ein Alias auf den numerischen
UUCP-Namen. Das UUCP-System muss auch weiterhin mit dem numerischen
Namen (z.B. 691330304003903) verwendet werden. Anderenfalls werden
Verbindungen mit Fehlermeldung  "you are unknown to me" zurueckgewiesen.

Accounting:

Anmeldung als User auf http://www.arcor.de/register/reg_01.jsp
Freischaltung fuer UUCP auf http://www.arcor.de/mps/xnews/treff_newsgr_04.jsp
(Dieser Vorgang dauert systembedingt bis zu einer halben Stunde).
Status abfragen fuer UUCP auf http://www.arcor.de/newsstatus

[2] UUCP-AGENT:
Nach erfolgter Freischaltung kann man auf 
http://uucp.gnuu.de/cgi-bin/uucpagent2
seine Site einrichten. Rufen Sie dazu die Startseite http://www.gnuu.de/ auf.
Als Login/Passwort verwendet man seine arcor-Faxnummer und dem
dazugehoerigen Passwort (z.B. 6913304003903).
Kompression und Batchgroesse sind auf Defaultwerte eingestellt.
Die maximale Artikelgroesse des newsfeeds und maximale Crossposts
kann man ebenfalls variieren.
In "Pathexcludes" gehoert der Name des lokalen
Newssystems rein, wenn man nicht seine eigenen Artikel neu zugestellt
haben will. In "Hierachien" ist schon ein Minimalfeed fuer die
Gruppen germanynet.ALL eingerichtet.
Weitere Gruppen kann man nach folgender Syntax einrichten:

!*,arcor.*,\
de.comm.provider.*,de.comm.chatsystems,\
de.talk.*,!de.talk.misc,\
rec.*,@rec.talk.*\

Ausrufezeichen stellen also eine Verneinung dar, Sternchen sind
Sammelbezeichnung fuer eine Unterhierachie. Das "@" vor einem
Pattern
verhindert das Feeden von crossgeposteten Artikeln in diese Hierarchie.
Alle Eintraege sind mit Komma getrennt, jede Zeile endet mit einem
Backslash.
Es koennen alle Gruppen subscribed werden, die auf 
ftp://ftp.arcor.de/pub/news/uucp.gnuu.de/newsgroups
angegeben sind.
Der Fullfeed hat unkomprimiert pro Tag eine Groesse von 200 MB,
de.ALL pro Tag 30 MB.
Die Konfiguration wird aller 30 Minuten abgeglichen, wenn keine Fehler
aufgetreten sind. 
Die Zeit zum Erstellen der Batchfiles laesst sich unter "Batchtime"
auswaehlen. Default wird aller 30 Minuten ein Batchfiles gepackt. 
Weitere Zyklen sind:
Aller 5 Minuten (jeweils 05,10,15,20...)
Aller 30 Minuten (zur halben und zur vollen Stunde)
Aller 60 Minuten (zur vollen Stunde)
Aller 12 Stunden (um 1 Uhr und 13 Uhr)
Einmal pro Woche (Freitag 23:59 Uhr)

Batchfiles stehen fuer 21 Tage zum Abruf zur Verfuegung gestellt und
werden danach geloescht.

Systemvoraussetzungen:

lokales UUCP-System (Taylor_UUCP, Kendra o.a.)
lokales News-System (INN, CNEWS, Hamster)
lokales Mailsystem (sendmail, exim, Hamster)

Wir beschreiben die Konfiguration an verschiedenen Programmpaketen, die
unter allen Linux- und Unixderivaten zur Verfuegung stehen. Mit GNUU
bieten wir ein Baukasten an, bei dem sich jeder die fuer ihn
optimale Anwendung zusammensetzen kann.
Selbst das lokale UUCP-System muss nicht unbedingt konfiguriert werden.
Die gepackten Batchfiles fuer News stehen zum Beispiel auf
ftp://uucp.gnuu.de zur Verfuegung.

[3] Taylor_UUCP (Unix):
Dazu kann man sich von ftp://ftp.arcor.de/pub/unix/uucp-1.06.1.tar.gz
Taylor_UUCP herunterladen. Nach dem Uebersetzen und der Installation
sind folgende Einstellungen erforderlich:

Datei call:
# <Remotesystem> <arcorfaxnummer> <arcorpasswort>
# Falls ein "Fully qualified domain name" (FQDN) benoetigt wird,
# kann man <user>.news.arcor.de verwenden
# Beispiel: paul.news.arcor.de
uucp.gnuu.de 6913304003903 password

Datei config:
# <name des lokalen Systems>
nodename 6913304003903

Datei port:
# <Beschreibung der Schnittstellen>
port    tcp
type    tcp

Datei sys:
# Loginnamen und Passwort aus der Datei 'call' lesen
call-login      *
call-password   *
time            any
system          uucp.gnuu.de
called-login    6913304003903
commands        rnews rmail rbsmtp rcsmtp rgsmtp
command-path    /usr/local/news/bin /usr/bin /usr/local/bin
protocol        t
port            tcp

Taylor-UUCP laeuft auf allen bekannten Unix/Linux/BSD-Systemen und
ist frei als Sourcecode verfuegbar.
Vom UUCP werden die Batchdateien an ein lokales Newssystem
verfuettert (CNews, Dnews, INN, Hamster).

Nach einer Stunde kann man also schon mal "uucico -s uucp.gnuu.de"
aufrufen und sich die ersten Batches runterladen.

[4] andere UUCP-Systeme:
Fuer Windows und Apple Macintosh gibt es von der Firma Kendra
Electronics Wonderworks ein UUCP-System (http://www.kew.com/kendra).
Erfahrungen liegen dazu leider noch nicht vor.

[5] OpenXP (Windows):
Ein anderer Client fuer UUCP ist OpenXP
(http://www.openxp.de/). OpenXP laeuft im DOS-Mode auch auf allen
Windowssystemen. Im Programmpaket sind alle notwendigen Tools zum
Empfang und Versand von UUCP-Mails und UUCP-News dabei. OpenXP basiert
auf Crosspoint und ist nicht nur im Usenet vielseitig einsetzbar. Zur
Konfiguration fuer UUCP kopiert man die Datei uucp.scr aus dem Ordner
"Beispiele" in das Stammverzeichnis. 
Nach Programmstart waehlt man aus dem Menue "Edit/Boxen" die Option
"Neu" aus. Als Netztyp entscheidet man sich fuer "RFC/UUCP".
Die naechsten Konfigurationsschritte sind anhand eines Beispiels
erlaeutert:

Boxname: pauls-box
Username: paul
Kommentar: Pauls UUCP-Box
Realname: Paul Mustermann
Domain: .gnuu.de
Serverdomain: .gnuu.de
eMail-Adr.: paul@691330304003903.gnuu.de
FQDN: 691330304003903.gnuu.de

OpenXP fragt dann, ob diese Box als Stammbox eingerichtet werden soll.
Dies kann man im Menuepunkt "Edit/Systems" tun (einfach die Box mit <F2>
aus dem Auswahlmenue fuer Systemnamen einstellen, fertig).
Weiter im Menue "Edit/Boxen" unter "pauls-box" den Menuepunkt "Edit"
auswaehlen. Es erscheinen mehrere Auswahlfelder:
Edit/Point:
Login: 691330304003903 UUCP-Name: 691330304003903
Passwort: <Arcor-Passwort>
Modus: TCP/IP <F2>    Hostname: uucp.gnuu.de Port: 540
Das Fenster schliesst sich nach Bestaetigen aller Felder mit <OK>
automatisch. 
Edit/Modem: 
Hier sind keine Einstellungen notwendig, da die Verbindung ueber TCP/IP
und einer bereits bestehenden Internetverbindung hergestellt wird.
Edit/Namen:
Hier erscheinen nochmal die Angaben zu pauls-box.
Edit/UUCP:
Hier sind keine Angaben notwendig.
Edit/Diverses:
Script: uucp.scr

Fertig! Nach Bestaetigen aller Angaben mit <OK> kann man ueber den
Menuepunkt "Netcall/Einzeln" die Verbindung zum UUCP-Host herstellen.
Bei erfolgreichem Login werden News und Mails automatisch in
verschiedene Ordner einsortiert und koennen dort bearbeitet werden.

[6] INN als Newsserver (Version 2.2/Unix):
INN ist bei manchen Linuxdistributionen schon dabei und brauch nicht
extra kompiliert werden. Wer sich dennoch die neuesten Sources besorgen
moechte, kann dies gern auf ftp://ftp.isc.org/ tun.
Auf ftp://ftp.arcor.de/pub/mirrors/ftp.isc.org/inn/ sollte sich auch 
immer das neueste Release befinden. 
Das erforderliche active- und newsgroups-File kann man
sich von ftp://ftp.arcor.de/pub/news/uucp.gnuu.de/
runterladen und im Unterverzeichnis ~news/db ablegen.
Entweder kuerzt man es auf die zu lesenden Gruppen
oder belaesst es in der Form und baut sich mit
"makehistoy -o" eine neue history-Datenbank.


inn.conf:
Hier sind vor allem die verwendeten Host- und Pathnamen wichtig, da
diese bei eigenen Artikeln im Header erscheinen. Unter server, pathhost
und fromhost sollte man seinen eigenen FQDN eintragen, z.B.
user.news.arcor.de oder 6913304003903.gnuu.de, wenn man den
Mailzugang mit nutzt. Alle anderen Einstellung sind erstmal irrational
und koennen spaeter geaendert werden.

newsfeeds:
Diese Datei ist fuer den Outgoing-Feed zustaendig, also die
Artikel, die
das eigene System wieder verlassen sollen. Neben dem "ME"-Eintrag sollte
dort mindestes ein Upstream und zwar der zum UUCP-Host vorhanden sein,
Beispiel:

uucp.gnuu.de/uucp.gnuu.de\
           :*,!junk,!local\
           :Tf,Wnb,B4096/1024:

Im Outgoingverzeichnis wird dann eine Batchdatei mit dem Namen
uucp.gnuu.de angelegt, die wir spaeter mit "sendbatch
uucp.gnuu.de" an das UUCP-System verfuettert. Bei "uucico -s
uucp.gnuu.de" werden automatisch alle Batches vom Host abgeholt UND
auch hingeschickt.
Wichtig ist hier der Pathexclude "uucp.gnuu.de", da sonst
alle eingehenden Artikel ans lokale Newssystem gegeben werden und auch
wieder ins Outgoing gebatcht werden (Vorsicht: Gefahr von Dupes!)

nnrp.access
In dieser Datei wird festgelegt, wer auf den Newsserver als Client
zugreifen darf:

localhost:Read Post:::*

Dies sollte als Einstellung genuegen. Mit inncheck kann man die
Konfigurationsfiles checken und mit rc.news den INN starten. Weitere
Konfiguration und tageliche Pflege des INN wuerden hier zu weit
gehen - dazu gibt es umfangreiche Informationen in der Dokumentation
oder der FAQ (news.software.nntp).

[7] Hamster (Windows):
Variante 1: FTP
Dazu gibt es eine Anleitung unter
http://home.germany.net/avehrenb/uucpscr/hamuucp.html
In grundlegender Funktionsweise werden die Batchfiles per FTP abgeholt
und an den Hamster weiterverfuettert. 
Variante 2: UUCP
Ein echter Hamster-UUCP-Betrieb fuer News und Mail ist unter
http://home.arcor.de/ufh/h2u/ beschrieben.

[8] Sendmail als MTA (Unix):
Zuerst installiert man das Programm "bsmtp" - mit diesem Programmpaket
ist das Ausliefern an den lokalen MTA und das Batchen der Mails
ueberhaupt moeglich. Das Programm befindet sich unter
ftp://ftp.arcor.de/pub/linux/misc/
BSMTP muss beim lokalen MTA bekanntgemacht werden. Dies geschieht
in der
Datei /etc/mail/linux.mc mit dem Eintrag "MAILER(`bsmtp')dnl" und dem
anschliessenden Uebersetzen mit dem m4-Konverter:
m4 /usr/share/sendmail/m4/cf.m4 linux.mc > /etc/sendmail.cf
Das Feature "mailertable" ist normalerweise schon aktiviert. In die
Datei /etc/mailertable traegt man ein:


.                       bsmtp:uucp.gnuu.de

Mit "makemap hash /etc/mail/mailertable.db < /etc/mail/mailertable" und
Neustart von sendmail sind alle Einstellungen aktiv.
Wenn jetzt ueber den eigenen Rechner Mails versendet werden, so
sollten
diese in der Queue von bsmtp und nicht in der von smtp landen.
Wem das zu kompliziert ist, der kann bei SuSe auch die vorhandene
UUCP-Konfigurationsdatei verwenden. Dort wird das unkomprimierte
uucp-dom(rmail) verwendet und man nutzt nur den Vorteil der Batchfiles
aus. In dieser Konfigurationdatei muss nur (zum Beispiel mit YAST)
"uucp.gnuu.de" als UUCP-Smarthost eingetragen werden. Die
Installation von bsmtp ist so hier nicht notwendig, da bei uucp-dom
sendmail direkt mit uux kommuniziert - die Mails landen also direkt im
UUCP-Spool und koennen mit "uucico -s uucp.gnuu.de" direkt versendet
werden.

Auf uucp.gnuu.de sind 4 verschiedene Packer installiert:

compress (rcsmtp)
gzip (rgsmtp)
bzip2 (rbsmtp)
szip (rssmtp)

Die ersten 2 Packer sind standardmaessig bei SuSe dabei. Die
anderen 2
kann man sich unter ftp://ftp.arcor.de/pub/linux/misc/
runterladen und aequivalent installieren.

Durch den Aufruf "/usr/local/libexec/batcher rgsmtp uucp.gnuu.de"
werden die Mails bei BSMTP aus der Queue in Batchfiles gepackt und so
zum Versand vorbereitet.

[9] Exim als MTA (Unix):
Empfang von e-mail

Als erstes muss ein symbolischer Link auf das exim-binary mit dem Namen
'rsmtp' erstellt werden. War auf der Box vorher schon ein anderer MTA
installiert, der nicht sauber entfernt wurde, kann es sein, dass
bereits ein rsmtp-binary existiert -- das muss natuerlich vorher
geloescht werden. [AFAIK wird bei exim's "make install" rsmtp nicht
automatisch mit eingerichtet.]

Wenn exim z.B. nach /usr/lib/exim/bin/ installiert wurde, sieht der
Befehl dazu ueblicherweise so aus:

ln -s /usr/lib/exim/bin/exim /usr/lib/exim/bin/rsmtp

Nicht komprimierte mail kann nun schon empfangen werden, es muss uuxqt
nur noch gestattet werden rsmtp auch auszufuehren.  ueblicherweise
fuegt
man hierzu "/usr/lib/exim/bin/" dem "command-path" in /etc/uucp/sys
zu, und erweitert "commands" um den Befehl "rsmtp". Fertig!

Sollen z.B. mit bzip2 komprimierte mails empfangen werden, muss noch
ein kleines Script zu diesem Zweck erstellt werden. Das Script sieht
fuer bzip2 komprimierte mail folgendermassen aus:

#!/bin/sh
/usr/bin/bunzip2 | /usr/sbin/rsmtp

Das ganze speichert man ueblichwerweise nach /usr/local/sbin/rbsmtp
ab
(der Pfad ist frei waehlbar, der Dateiname ist durch die
Kompressionsmethode s.u. vorgegeben).
Nun muss man uuxqt auch noch erlauben diese
Datei auszufuehren.
Danach sehen die entsprechenden Anweisungen in /etc/uucp/sys so aus:
| system          uucp.gnuu.de
| command-path    /usr/lib/news/bin/ /usr/bin /usr/local/sbin
| commands        rnews rsmtp rbsmtp
Andere Kompressionsalgorithmen koennen in gleicher Weise
hinzugefuegt
werden, dabei unterscheidet sich nur der Dateiname des scripts (und
statt bunzip muss natuerlich ein anderer Entpacker verwendet
werden ;)
-- fuer jeden Packer sein eigenes Script:
compress (rcsmtp)
gzip (rgsmtp)
bzip2 (rbsmtp)
szip (rssmtp)
Die Kompression laesst sich via Web-Interface waehlen.

Versand von e-mail
Die andere Richtung ist eigentlich auch ganz einfach einzurichten. Als
erstes muss der Systemname exim bekannt gemacht werden, damit mails an
user@<site>.gnuu.de nicht wieder nach germany.net weitergeleitet
werden:
| # main
| local_domains = localhost:<site>.gnuu.de

Setzen von Envelope-FROM mit trusted_user

| trusted_users = root:mail:uucp

Nun zuerst wieder die Variante ohne Komprimierung:

| # transports
| uucp_rsmtp:
|   driver = pipe
|   batch = all
|   bsmtp = all
|   bsmtp_helo = true
|   command = "/usr/bin/uux - -r $host!rsmtp"
|   pipe_as_creator = true
|   prefix = ""
|   timeout = 10m
|
| # routers
| smarthost:
|   driver = domainlist
|   transport = uucp_rsmtp
|   route_list= "* uucp.gnuu.de"

und nun die Variante mit bzip2-Komprimierung:

| # transports
| uucp_rbsmtp:
|   driver = pipe
|   batch = all
|   bsmtp = all
|   bsmtp_helo = true
|   command = "/usr/local/sbin/rbexim $host"
|   log_fail_output = true
|   pipe_as_creator = true
|   prefix = ""
|   timeout = 10m
|
| # routers
| smarthost:
|   driver = domainlist
|   transport = uucp_rbsmtp
|   route_list= "* uucp.gnuu.de"

Es fehlt natuerlich noch /usr/local/sbin/rbexim, das sieht so aus:

| #!/bin/sh
| PATH=/usr/local/sbin:/usr/local/bin:/usr/bin:/sbin:/usr/sbin
| /usr/bin/bzip2 | /usr/bin/uux - -r $1!rbsmtp

Andere Kompressionsmethoden koennen nach obigem Muster
hinzugefuegt
werden. ;)

Empfang/Versand der Batches

Nach dem Herstellen der Verbindung zum Internet werden sie genau wie
die Newsbatches mit "uucico -s uucp.gnuu.de" uebertragen.
Einkommende Mailbatches werden von den mitgelieferten transmitter-
Programmen an den MTA bzw. den Batcher weitergereicht. Dort koennen
sie weiter von einem MDA wie procmail verarbeitet oder in lokale
Mailfaecher einsortiert werden.
Die Mailbatches werden erst beim Einloggen ins UUCP-System gebatcht und
stehen deshalb nicht per FTP zur Verfuegung.
Um eigene News und Mails nach uucp.gnuu.de zu versenden, muessen diese
vor dem Aufruf von uucico gebatcht und eventuell komprimiert werden 
(usr/local/libexec/batcher g-rgsmtp uucp.gnuu.de;
"/usr/local/news/bin/sendbatch -g uucp.gnuu.de)


Hilfe zum Einrichten eines UUCP-Systems finde man hier in
germanynet.uucp. Bitte genaue Problembeschreibung mit Logauszuegen
angeben.

Viel Spass im Usenet :-)