Fix typo.
[dragonfly.git] / share / examples / isdn / contrib / anleitung.ppp
1 $FreeBSD: src/share/examples/isdn/contrib/anleitung.ppp,v 1.1.2.1 2001/08/10 14:59:47 obrien Exp $
2 $DragonFly: src/share/examples/isdn/contrib/anleitung.ppp,v 1.2 2003/06/17 04:36:57 dillon Exp $
3
4 i4b Anleitung für syncPPP Internet-Zugang und Anrufbeantworter
5 unter FreeBSD 2.2.x mit Teles.S0/16.3-Karte
6 ===============================================================
7
8 by Stefan Herrmann <stefan@asterix.webaffairs.net>
9
10
11 Installation
12 ------------
13 1)  Neues Verzeichnis "/usr/src/i4b" anlegen.
14
15 2)  Ins Verzeichnis "/usr/src/i4b" wechseln und Sourcen entpacken.
16
17 3)  Ins Verzeichnis "FreeBSD" wechseln und den Befehl "sh install.sh ausführen:
18     z.B. "root@asterix[0]/usr/src/i4b/FreeBSD # sh install.sh"
19
20     Wenn auf eine neuere Version von i4b gewechselt wird, zuerst
21     "sh uninstall.sh" ausführen, dann erst "sh install.sh"
22
23 4)  Dann ins Verzeichnis "/usr/src/i4b" (zurück-)wechseln und die Befehle
24     "make depend", "make" und "make install" ausführen.
25
26 5)  Nun muß der kernel mit neuen Optionen versehen werden. Dazu wird an die
27     Kernel-Konfigurationsdatei im Verzeichnis "/sys/i386/conf" folgendes ans
28     Ende hinzugefügt:
29
30 # i4b passive ISDN cards support (isic - I4b Siemens Isdn Chipset driver)
31 # note that the ``options'' and ``device'' lines must BOTH be defined !
32
33 # Teles S0/16.3 
34 options         "TEL_S0_16_3"
35 device          isic0 at isa? port 0xd80 net irq 5 flags 0x04 vector isicintr
36
37 # i4b passive cards D channel handling
38 # Q.921
39 pseudo-device   "i4bq921"
40 # Q.931
41 pseudo-device   "i4bq931"
42
43 # common passive and active layer 4
44 # layer 4
45 pseudo-device   "i4b"
46
47 # userland driver to do ISDN tracing (for passive cards oly)
48 pseudo-device   "i4btrc"        4
49 # userland driver to control the whole thing
50 pseudo-device   "i4bctl"
51 # userland driver for access to raw B channel
52 pseudo-device   "i4brbch"       4
53 # userland driver for telephony
54 pseudo-device   "i4btel"        2
55 # network driver for IP over raw HDLC ISDN
56 pseudo-device   "i4bipr"        4
57 # enable VJ header compression detection for ipr i/f
58 options         IPR_VJ
59 # network driver for sync PPP over ISDN
60 pseudo-device   "i4bisppp"      4
61 pseudo-device   sppp            4
62
63 6)  Danach wird der kernel durch Eingabe der Befehle "make depend", "make" und
64     "make install" im Verzeichniss "/usr/src/sys/compile/<CONFIG>" neu
65     übersetzt und installiert.
66
67 7)  Nach dem Booten kann man dann mit dem Befehl "dmesg" überprüfen, ob die
68     Karte korrekt erkannt wurde und alle erforderlichen Treiber installiert
69     sind.
70
71
72 Konfiguration
73 -------------
74 8)  Die Konfiguration von i4b wird hauptsächlich im Verzeichnis "/etc/isdn"
75     druchgeführt, dort sucht der isdnd beim Start auch seine Konfigurations-
76     datei "isdnd.rc". Da vorgenanntes Verzeichnis nach der Installation aber
77     noch leer ist, kopiert man zuerst die Beispieldateien aus dem Verzeichnis
78     "/etc/isdn/samples" nach "/etc/isdn".
79
80 9)  Die Datei "isdnd.rc" enthält schon recht aussagekräftige Kommentare zu den
81     einzelnen Optionen, weitere Informationen erhält man mit "man isdnd.rc" und
82     "man isdnd".
83
84 10) Für syncPPP und Anrufbeantworter sind nur die Sektionen "SYSTEM",
85     "telephone answering" und "example for sPPP" notwendig, die Sektion
86     "IP over ISDN example" kann dafür also entfernt werden.
87
88 11) Für den automatisierten Start des isp0 Interfaces und des isdnd erstellt
89     man nun ein Start-Skript. Dazu kopiert man die Datei
90     "/usr/src/i4b/etc/rc.isdn-PPP" nach "/etc/rc.isdn" und paßt sie
91     entsprechend an. Man beachte hierbei auch die FAQ "/usr/src/i4b/FAQ", die
92     Tips für die richtige Eintragung der IP-Adressen bereithält.
93
94 12) Der Anrufbeantworter wird dadurch aktiviert, daß das entsprechende
95     Programm, das in "/etc/isdn/isdnd.rc" hinter dem Eintrag "answerprog = "
96     steht, aufgerufen wird. Wird dort kein Pfad angegeben, wird das Programm
97     im Verzeichniss "/etc/isdn" erwartet. Beispiele solcher Programme findet
98     man wiederum im Verzeichnis "/etc/isdn/samples". Sie nennen sich
99
100     "answer"            Nur Ansagetext abspielen, keine Aufzeichnungsmöglichkeit.
101     "record"            Ansage wird abgespielt, nach Piep-Ton kann gesprochen
102                         werden.
103     "tell"              Als Ansagetext wird die anrufende Nummer gesprochen, keine
104                         Aufzeichnung.
105     "tell-record"       Anrufende Nummer als Ansagetext, nach Piep-Ton kann ge-
106                         sprochen werden.
107     "isdntel.sh"        Ansagetext und Aufzeichnung; mittels dem Programm "isdntel"
108                         hat man die Kontrolle übe die Aufzeichnungen im Ver-
109                         zeichniss "/var/isdn". Siehe auch "man isdntel" und
110                         "man isdntelctl".
111
112     Diese Programme müssen an die eigenen Wünsche angepaßt werden. Leider gibt es
113     kein mitgeliefertes Programm, mit dem man so auch den Ansagetext aufsprechen
114     kann. Das ist aber nicht allzuschlimm, da man nur das Programm "record" dafür
115     etwas anpassen muß (Ansagetexte beep und msg auskommentieren). Damit die Anrufe
116     aufgezeichnet werden können, muß zuerst noch das Verzeichnis "/var/isdn"
117     angelegt werden. Dort werden dann alle Aufzeichnungen obiger Programme gespeichert.
118
119 13) Man sollte sich auch noch die man-Pages der Programme "isdnd", "isdnctl",
120     "isdnd_acct", "isdndebug" und "isdntrace" zu Gemüte führen.
121
122
123 Betrieb
124 -------
125 14) Der syncPPP Zugang zum Provider wird einfach mit dem Aufruf von
126     "/etc/rc.isdn" initialisiert. Jegliche Aktivitäten ins Internet (also z.B.
127     ein "ping 141.1.1.1") starten die Verbindung. Wenn in "/etc/isdn/isdnd.rc"
128     beim Eintrag "unitlengthsrc = " "rate" angegeben wurde, wird die Verbindung
129     kurz bevor die nächste Einheit begonnen wird, beendet. Informationen über
130     die Einheiten werden aus der Datei "/etc/isdn/isdnd.rates" ausgelesen
131     (Beispiele sind in "/etc/isdn/samples").
132
133     Mit "/etc/rc.isdn [restart|stop]" kann i4b entweder neu gestartet (z.B. zum
134     Einlesen der geänderten Konfiguration aus "isdnd.rc") oder beendet werden.
135
136 15) Für den Anrufbeantworter muß nur der "isdnd" gestartet sein. Ein
137     ankommender Anruf wird dann automatisch angenommen (je nach den Einträgen
138     in "/etc/isdn/isdnd.rc").
139      
140 16) Informationen über die Verbindung erhält man sowohl in "/var/log/messages",
141     also auch in "/var/log/isdnd.log" (so der isdnd mit der Option "-l"
142     gestartet wird) bzw. auf dem aktuellen tty (wenn der isdnd mit der Option
143     "-f" gestartet wird).