From f21cf000f6c4bce988fa22cf12595f76181e22c8 Mon Sep 17 00:00:00 2001 From: akool Date: Fri, 31 Dec 1999 15:07:10 +0000 Subject: [PATCH] removed obsolete HOWTO --- HOWTO | 430 ---------------------------------------------------------- 1 file changed, 430 deletions(-) delete mode 100644 HOWTO diff --git a/HOWTO b/HOWTO deleted file mode 100644 index b1f28280..00000000 --- a/HOWTO +++ /dev/null @@ -1,430 +0,0 @@ -isdn4k-utils - HOWTO - Andreas Kool - 31-Mar-97 - 23:53 - -*************************************************************************** -** Dieses Dokument wendet sich z.Zt. vor allem an all diejenigen, die es ** -** nicht abwarten koennen, und sich die neuen isdn4k-utils ->PRE ALPHA ! ** -** aus dem CVS-Baum ausgecheckt haben. ** -** ** -** Es handelt sich um ein gerade entstehendes Programmpaket - daher ** -** sind alle Fehlerhinweise, Verbesserungsvorschlaege etc. sehr gerne ** -** gesehen, Anfragen bzgl. "ich bekomme das nicht kompiliert" jedoch ** -** koennen in diesem Fruehstadium leider *nicht* beantwortet werden! ** -*************************************************************************** - -Dieses Dokument versucht, jedem den Einstieg in die neuen isdn4k-utils -so einfach wie moeglich zu machen. - -Fuer alte isdnlog-Hasen wirkt die neue Version sicherlich erst einmal -wie ein Kulturschock ... soo schlimm wird es aber gar nicht! - -Um die Benutzung aller Utilities rund um isdn4linux auch fuer Neueinsteiger -so einfach wie irgend moeglich zu machen, haben wir versucht, alle -Tools ineinander zu verzahnen, und ueber eine einzige, gemeinsame -Konfigurationsdatei steuerbar zu machen. - -Mit folgenden Schritten kommt man in den Genuss von isdnlog-2.99.2: - - -1. Es sollten als Vorbedingung Linux-2.0.29 nebst isdn4kernel-2.0.29.5 - installiert werden. isdnlog-2.99.2 arbeitet zwar auch mit aelteren - Versionen von isdn4linux zusammen, jedoch entgehen einem dadurch - viele neue Features, und ausserdem wurde isdnlog-2.99.2 primaer - in dieser Umgebung getestet - daher koennen Probleme mit - frueheren Versionen nicht ausgeschlossen werden. - - -2. Die isdn4k-utils auspacken: - - $ cd /usr/src - $ tar xzf isdn4k-utils.tar.gz - -3. Die grundsaetzlichen Betriebsmodi einstellen: - - $ cd isdn4k-utils - $ make config - - Es erscheint nun ein interaktives Konfigurationsmenue, in dem die - gewuenschten Programme/Optionen angewaehlt werden koennen. - - Besonderes Augenmerk sollte (neben dem Freischalten von isdnlog ;-) - folgenden Einstellungen gelten: - - #define I4LCONFDIR "/etc/isdn" - - hier wird angegeben, in welchem Verzeichnis alle Configurations- - Dateien untergebracht werden sollen. Wer alles wie frueher - belassen will, traegt hier "/etc/isdnlog" ein. - Die Developer von isdn4linux haben sich jedoch auf das - zukuenftige Verzeichnis "/etc/isdn" geeinigt. - - # export LIBAREA=1 - isdnlog soll mit dem neuen AVON-Verzeichnis von - Ullrich von Bassewitz (uz@musoftware.com) - arbeiten. Dies sollte _immer_ eingeschaltet werden. - - # export POSTGRES=1 - isdnlog soll alle Verbindungsinformationen auch in - eine SQL-Relation eintragen. Dies darf nur eingeschaltet werden, - wenn postgres95 einsatzbereit installiert ist! - -Zur Zeit sind die naechsten beiden Schalter ueberfluessig, da der -xisdn voruebergehend aus der Distribution genommen wurde!!!! - # export NEED_GDBM=1 - Falls man _nicht_ LIBAREA=1 eingeschaltet hat, und zudem - keine Datei "/usr/lib/libdbm.a", dafuer aber "/usr/lib/libgdbm.a" - besitzt, muss dieser Schalter aktiviert werden. - - # export NEED_ICE=1 - Wer sich das X11-Frontend "xisdn" erstellen moechte, kann hiermit - steuern, ob auch die Bibliotheken "libICE.so" sowie "libSM.so" - hinzugelinkt werden muessen - - # export OLD_I4L=1 - Wer nicht bereit ist, den aktuellen Stand von isdn4linux - einzusetzen, kann hiermit die Unterstuetzung fuer isdn4linux - _kleiner_ Rev: 1.31/1.24/1.33 freischalten. - Dadurch wird u.a. CHARGEINT unmoeglich! - - # export ISDN_NL=1 - Hiermit wird die gesamte Gebuehrenauswertung auf die Niederlande - umgeschaltet. Dieser Schalter muss also in den Niederlanden - eingeschaltet werden. - - # export ISDN_CH=1 - Hiermit wird die gesamte Gebuehrenauswertung auf die Schweiz - umgeschaltet. Dieser Schalter muss also in der Schweiz - eingeschaltet werden. - - -4. Nun kann alles kompiliert und installiert werden: - - $ make - $ make install - - Waehrend der Compiler arbeitet bietet sich die Wartezeit geradezu - an, um ein wenig im README von isdnlog zu schmoeckern ;-) - - ACHTUNG: Der Schritt "make install" terminiert einen evtuell gerade - aktiven alten isdnlog! Um nicht zu viele Verbindungsinformationen - zu verlieren, sollten daher die folgenden Schritte zuegig - durchgefuehrt werden! - - -5. Vorbereiten des ersten Start des neuen isdnlog: - - Einige wenige Command-Line-Switches von isdnlog wurden erweitert: - - - Das Argument von "-v" wurde erweitert - - Bei "-m", "-l" sowie "-x" wurden marginale Aenderungen durchgefuehrt - - Das Argument von "-h" wurde geaendert - - Wer diese Schalter verwendet, sollte sich daher die entsprechende - Beschreibung im "isdnlog/README" durchlesen, und seine - Angaben entsprechend korrigieren. - - Der neue isdnlog arbeitet mit einer vollstaendig anderen - Konfigurationsdatei. - Diese wird automatisch aus der bestehenden generiert. - Es wird das alte Verzeichnis "etc/isdnlog" nach "etc/isdn" umkopiert. - - isdnlog-2.99.2 versucht daher beim ersten Start, die alte - Konfigurationsdatei "isdnlog.conf" in die neue Syntax umzuwandeln. - Dieses passiert automatisch mit make install - Es werden in dieser Version alle Telefonnummern in der Datei callerid.conf - ausgelagert, so dass die isdn.conf sehr klein wird. - -6. Erster Start des neuen isdnlog: - - Nach diesen Vorbereitungen kann isdnlog-2.99.2 nun endlich gestartet - werden. - - Im folgenden unterstelle ich mal, das isdnlog folgendermassen - aufgerufen wird (so betreibe ich isdnlog hier): - - isdnlog -nsS -v13 -t2 -w1 -m0x17f7 -l7 -h5:3 -H5 -22 /dev/isdnctrl0 - - isdnlog sollte sich - je nach eingestelltem Ausgabekanal - auf - der Konsole oder dem syslog in etwa folgendermassen melden: - - isdnlog Version 2.99.2 loaded - (ISDN subsystem with ISDN_MAX_CHANNELS > 16 detected - x active channels - (Data versions: iprofd=0x04 net_cfg=0x02 /dev/isdninfo=0x01) - - Nun sollte als erste Funktionspruefung z.b. der Hoerer des Telefons - abgenommen, und wieder aufgelegt werden. - Es sollte die Meldung - - (HiSax driver detected) - - auftauchen. Ist dies nicht der Fall, muss geprueft werden, ob mittels - - $ telesctrl ID 1 4 - - das D-Kanal logging des Hisax-Treibers eingeschaltet wurde. - - Kurz danach sollten die D-Kanal-Meldungen erscheinen: - -22.Feb 12:26:53 * Calling ? with ? BEARER: Speech, CCITT standardized coding -22.Feb 12:26:53 * Calling ? with ? 64 kbit/s, Circuit mode -22.Feb 12:26:53 * Calling ? with ? G.711 A-law -22.Feb 12:26:53 * Calling ? with Phone HLC: CCITT -22.Feb 12:26:53 * Calling ? with Phone HLC: Telefonie -22.Feb 12:26:53 * Calling ? with Phone CHANNEL: BRI, B1 gefordert -22.Feb 12:26:53 * Calling ? with Phone PROGRESS: Location: Local:public net -22.Feb 12:26:53 * Calling ? with Phone PROGRESS: Inband Information available -22.Feb 12:26:56 Calling ? with Phone Normal call clearing -22.Feb 12:26:56 Calling ? with Phone HANGUP - - Die angezeigten Informationen koennen je nach Telefon, Telefonanlage - sowie isdnlog-Konfigurationsdatei von obigem Beispiel abweichen, - aber irgend etwas in dieser Art muss auftauchen - sonst stimmt - etwas grundlegendes nicht! - - Neben diesen direkten Meldungen muss isdnlog-2.99.2 sowohl einen - Eintrag in der "/var/log/isdn.log" vorgenommen, als auch - die Protokolldatei "/tmp/isdnctrl0" fortgeschrieben haben. - - -7. Nachbearbeitung der neuen Konfigurationsdatei - - Nachdem isdnlog-2.99.2 nun offensichtlich arbeitet, ist es an der Zeit, - die gerade automatisch neu erstellte Konfigurationsdatei zu ueberarbeiten. - - Die Syntax erschliesst sich einem eigentlich von alleine, eine naehere - Beschreibung findet sich im "isdnlog/README" - - Die Umwandlung von alte auf neue Syntax ist leider ausser Stande, - die eingestreuten Kommentare (-> Zeilen mit "#") zu uebernehmen. - Daher muessen diese von Hand uebernommen werden. - - In der Section [GLOBAL] - werden automatisch mit make install die beiden Eintraege - COUNTRYCODE = +49 - AREACODE = xxxx - eingefuegt, wenn vorher diese Daten im Menue eingegeben wurden. - - Nachdem die neue Konfigurationsdatei fuer gut befunden wurde, sollte - die alte Konfigurationsdatei "isdnlog.conf" geloescht werden, da - isdnlog sonst staendig versuchen wuerde, die alte in die neue - Syntax umzustellen (allerdings nur, wenn die alte Datei ein neueres - Datum hat, als die neue) - - Wer bis hier gekommen ist, kann ein lautes "puuuh, geschafft!" - ausstossen! Nun ist es endlich an der Zeit, - - -7.1 Es gibt nun zwei (oder sogar drei!?!) neue Konfigurationsdateien: - /etc/isdn/isdn.conf - /etc/isdn/callerid.conf - ~/.isdn - Wobei sich in der "isdn.conf" nur noch die rein auf isdnlog beziehenden - Eintraege befinden, und in der "callerid.conf" die von isdnlog und - (bald!?!) vbox gemeinsam verwendeten Eintraege! - - -8. Die neuen Features von isdnlog erkunden - - - mit dem ersten neuen Feature, der neuen Konfigurationsdatei - wurde man ja bereits ausgiebig konfrontiert. - Dazu gibt es nun ein neues Programm "isdnconf" zur komfortablen - Beauskunftung - siehe dazu "isdnlog/README" - - - isdnlog arbeitet nun durchgaengig mit "full qualified" Telefonnummern, - d.h. alle Telefonnummern werden _nur_noch_ in der Form - - - - behandelt. Zum Beispiel wuerde die Nummer "4711" in Frankfurt, - Deutschland so "+49 69 4711" dargestellt werden. - - - isdnlog arbeitet nun mit der neuen Library "areacode-1.01" von - Ullrich von Bassewitz (uz@musoftware.com) - - Eine ausfuehrliche Beschreibung dazu findet sich in - "areacode/areacode.doc" - - Diese Library ersetzt das alte "AVON" Verzeichnis der frueheren - isdnlog-Versionen. Sie bietet folgende Vorteile: - - - sehr aktuelle Ortsnetz-Daten - - Daten fuer Deutschland, Schweiz, Oesterreich, Funknetze, 0180- - 0190- usw. enthalten - - wesentlich schneller - - eine einzige, UNIX-weit gemeinsame Bibliothek fuer Vorwahlen. - Per heute unterstuetzen - - isdnlog - - vbox - - ESTIC - diese Library, weitere Applikationen werden sicherlich folgen! - - Wer unbedingt auf seine AVON besteht, kann diese natuerlich - weiterverwenden. Dieses muss dann allerdings im Menu angegeben werden. - - - chargeint (auflegen kurz vor dem naechsten Gebuehrenimpuls) ist - mittlerweile offizieller Bestandteil von isdn4linux, und damit - aus dem "Patch" Stadium heraus. Die Steuerung durch isdnlog - wurde verfeinert - siehe dazu den "-h" Schalter - - - isdnlog-2.99.2 bietet 4 verschiedene Moeglichkeiten, die Kosten - gegenueber der .T... sowie dem jeweiligen Internet-Provider - zu begrenzen: - - - Watchdog: - isdnlog-2.99.2 erkennt Fehlverhalten von isdn4linux, und - terminiert es rechtzeitig. - (Neuer Schalter "-Hx" -> wenn seit mehr als "x" - Gebuehreneinheiten kein Datentransfer mehr feststellbar ist, - wird isdn4linux abgewuergt - wenn es sein muss, mit einem - Reboot der ganzen Maschine) - - - CHARGEMAX: - Hiermit kann definiert werden, wieviel Geld (in DM) man - maximal gewillt ist, pro Tag zu vertelefonieren. - Wird diese Grenze ueberschritten, wird isdn4linux - abgewuergt (neuer Eintrag CHARGEMAX in der "isdn.conf") - - - CONNECTMAX: - Hiermit kann definiert werden, welche maximale Verbindungszeit - man pro Monat haben moechte (ich habe dort die Freistunden - meines Provider's eingetragen) - Wird diese Grenze ueberschritten, wird isdn4linux - abgewuergt (neuer Eintrag CONNECTMAX in der "isdn.conf") - - - BYTEMAX: - Hiermit kann definiert werden, wieviel Byte man pro Monat - maximal saugen will (fuer Provider, die ein maximales - Kontingent in Byte definieren). - Wird diese Grenze ueberschritten, wird isdn4linux - abgewuergt (neuer Eintrag BYTEMAX in der "isdn.conf") - - - isdnlog-2.99.2 besitzt eine Anbindung an die SQL-Datenbank postgres95. - Wird diese freigeschaltet, traegt isdnlog-2.99.2 jede Verbindung nicht - nur in die "/var/log/isdn.log", sondern auch in eine SQL-Relation ein. - Beschreibung dazu siehe "isdnlog/README" - - - isdnlog-2.99.2 unterstuetzt nun den neuen "City Weekend Tarif" - Wer das bei der .T... beantragt hat, muss isdnlog mit der neuen - Option "-F" starten - - ACHTUNG: Im "City Weekend Tarif" sind die AOC-D / AOC-E Meldungen - (Gebuehreninfos) der VSt *definitiv* falsch! - (Siehe Kleingedrucktes auf dem Antrag ...) - Daher sind die Aussagen von "isdnrep" hierzu natuerlich - auch "falsch" ! - Die Steuerung des "CHARGEINT" von seiten isdnlog ist - jedoch richtig! - - - isdnlog kann nun (incl. "ChargeInt" Feature) in den Niederlanden - eingesetzt werden, da Ad Aerts (ad@aasup.nl) isdnlog _vollstaendig_ - an die Niederlande angepasst hat. - - - isdnlog-2.99.2 versteht eine Menge neuer D-Kanal-Frames, von denen einige - in den vergangenen Monaten Bestandteil manchmal heftiger Diskussionen - waren: - - - COLP - - CLIP - - Rufumleitung - - Wie mir leider erst in den letzten Tagen bekannt wurde, kann isdnlog-2.99.2 - mit dem neuen Feature "Rueckruf bei besetzt" noch _nicht_ umgehen. - Hierzu werde ich einen Patch nachliefern, sofern mir die VSt Giessen - dieses Feature *endlich* freischaltet! - - Entgegen frueheren Versionen verbucht isdnlog-2.99.2 jedoch ihm unbekannte - FACILITY-Frames nicht mehr mit teilweise astronomischen Gebuehren. - - Daneben dekodiert isdnlog-2.99.2 nun vollstaendig die Elemente - - Bearer capability - - Channel identification - - Progress indicator - - Notification indicator - - High layer compatibility - aus, und kann die zahlreichen neuen Informationen bei Bedarf anzeigen. - - - isdnlog-2.99.2 zeigt nun die exakte Dauer (in Sekunden) bis zum naechsten - berechneten (also genauen - fuer chargeint verwendeten) Gebuehrenimpuls - an: - - Calling EUnet with HDLC I=883,1Kb 5,8Kb/s O= 40,5Kb 272,6 b/s H#7= 12s - ------------------------------------------------------------------^^^^^^^^ - - Bedeutet: Wir befinden uns gerade in dem 7. Gebuehrentakt, noch exakt - 12 Sekunden bis zum faellig werden der naechsten DM 0,12 - - - isdnlog-2.99.2 bietet nun den neuen Schalter "-Axxx" an. Hiermit - kann angegeben werden, welche Ziffern oder Zahlen man an einer - Telefonanlage vorwaehlen muss, um "ein Amt" zu bekommen. - Dadurch wird isdnlog in die Lage versetzt, diese wieder - herauszurechnen, womit die Falschmeldungen bzgl. den Vorwahlen - vermieden werden koennen. - - - Unterstuetzung einer zweiten, falsch angeschlossenen Teles-Karte - Wie mittlerweile allgemein bekannt, konnte isdnlog bislang die - Informationen von anderen Geraeten am S0-Bus (Telefon, Fax, Modem) - nicht mitbekommen. - - Dagegen wurde mittlerweile eine Loesung erarbeitet: - Falls man sich eine zweite Teles-Karte entsprechend dem - Schaltbild in "isdnlog/README" einbaut, und isdnlog mit - dem neuen Schalter "-2x" startet, bekommt isdnlog nun - alle D-Kanal-Frames mit, und kann daher auch alle Informationen - lueckenlos anzeigen. - Wird fuer "x" 2 eingesetzt, also "isdnlog -22", zeigt isdnlog - sogar direkt jede Ziffer an, die man z.b. an einem Telefon - eintippt. - - Um Missverstaendnissen vorzubeugen: - - diese zweite Karte kann *nicht* zur Kommunikation eingesetzt - werden - sie spielt *nur* noch Monitor - - - die "-2" Option bedeutet nicht, das isdnlog nun mit mehr - als 2 B-Kanaelen umgehen kann! isdnlog arbeitet nach wie - vor nur mit einem Basis-Anschluss (BRI) zusammen. - Gleichwohl koennen nun mehrere isdnlog's parallel betrieben - werden (pro Basis-Anschluss einer), da sich die einzelnen - isdnlog's nun nicht mehr gegenseitig in's Gehege kommen. - - - isdnlog-2.99.2 haelt die Log-Datei "/var/log/isdn.log" nun nicht - mehr staendig offen. Daher kann diese nun zu einem beliebigen - Zeitpunkt verschoben oder geloescht werden. Danach _muss_ diese - Datei jedoch wieder leer angelegt werden - (cp /dev/null /var/log/isdn.log) ! - - -So, nun wuensche ich allen viel Spass mit dem neuen isdnlog-2.99.2 - nicht -ohne mich bei den Leuten zu bedanken, die viele freie Stunden in die -Weiterentwicklung von isdnlog gesteckt haben: - Stefan Luethje (luethje@sl-gw.lake.de) - Karsten Keil (isdn4@temic-ech.spacenet.de) - Fritz Elfert (fritz@isdn4linux.de) - Ullrich von Bassewitz (uz@musoftware.com) - Hardy Buchholz (hardy@Kool.f.EUnet.de) - Ad Aerts (ad@aasup.nl) - Markus Leist (markus@hal.dirnet.com) -und ganz besonders bei Dr.-Ing. Joachim Goeller, der mich beim -Verstehen des ISDN-D-Kanal's unzaehlige Male beraten hat! - -Abschliessend nochmals die Bitte: Wer Probleme mit isdnlog-2.99.2 -hat, sollte zu allererst dieses HOWTO, das "isdnlog/README" -sowie die einschlaegigen FAQ's zu isdn4linux studieren. - -Nur wer so nicht weiterkommt, schreibe uns eine email an - - isdnlog@Kool.f.EUnet.de - -Diese sollte auf jeden Fall als Mindestausstattung: - - - die "isdn.conf" - - die Aufruf-Parameter von isdnlog - - die Versionen von Linux, isdn4linux, HiSax-Treiber - - einen Ausschnitt der "/tmp/isdnctrl0" - -enthalten. - -Bitte bedenkt, das wir auf dieser Mailing-Liste mittlerweile taeglich -eine Unzahl von Anfragen erhalten, und auch unser Tag leider nur 24 Stunden -hat! - - -Andreas Kool (akool@Kool.f.EUnet.de)