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