Unterabschnitte


1.1 OPT_MTGCAPRI - Die ISDN-Remote-CAPI für fli4l

1.1.1 Einleitung

Das OPT_MTGCAPRI stellt eine ISDN-Remote-CAPI auf fli4l zur Verfügung, wodurch ISDN-CAPI basierende Anwendungen, auf verschiedenen Rechnern in einem Netzwerk ausgeführt werden können, ohne dass in jedem eine ISDN-Karte eingebaut sein muss. Die ISDN-Karte des Routers wird also quasi im Netzwerk geteilt.
Das OPT_MTGCAPRI stellt dabei nur die Integration des Linux-CAPRI-Servers der Firma mtG (http://www.mtg.de/) in die für fli4l benötigte Infrastruktur dar.


Wichtig: Leider ist es aus Lizenz-Gründen nicht möglich, die Binärdateien des mtG-CAPRI-Servers beizulegen!


Darum müssen diese von der mtG-Webseite heruntergeladen und im fli4l Basisverzeichnis entpackt werden. Genaueres dazu im Abschnitt Installation.

1.1.2 Copyright

Die Client-Installations-Anleitung ist der Original Dokumentation des mtG-Capriservers entnommen und unterliegt somit dem Copyright der Firma mtG.

1.1.3 Voraussetzung

1.1.4 Installation

Benötigt werden mtG-CAPRI-Server für Linux v.1.5.4 oder höher und mtG-CAPRI-Client v.1.5.2 oder höher. Diese können hier heruntergeladen werden:
http://www.mtg.de/servlet?do=un_dls_soft_capri_lzv&lang=germ
Dort befindet sich auch die Original Dokumentation.
Den Inhalt der capri_ls_v154_i386-uClibc-0.9.28.tar.gz in das Verzeichnis 'fli4l-3.1.4/opt/files/usr/local' entpacken, konfigurieren, fli4l bauen, fertig.

1.1.4.1 Steuerung des Servers an der Console

Folgende Befehle sind an der Konsole oder auch per SSH möglich:

1.1.5 Konfiguration

OPT_MTGCAPRI

Standard-Einstellung: OPT_MTGCAPRI='no'

Mit der Einstellung 'yes' wird der Capriserver aktiviert.

MTGCAPRI_START

Standard-Einstellung: MTGCAPRI_START='yes'

Hier könnt ihr bestimmen ob der mtG-CAPRI-Server beim Booten eures Routers gestartet werden soll.

MTGCAPRI_PORT

Standard-Einstellung: MTGCAPRI_PORT='20000'

Dieser Wert ist frei wählbar, sollte aber im Normalfall nicht unter 10000 liegen, um mögliche Konflikte zu vermeiden. Er muss außerdem dem Client mitgeteilt bzw. dort in der Datei capri.ini eingetragen werden.


Wichtig: Man sollte darauf achten, dass dieser Port in der base.txt nicht für Verbindungen aus dem Internet freigegeben wird!

MTGCAPRI_TRACELEVEL

Standard-Einstellung: MTGCAPRI_TRACELEVEL='1'

Der Trace-Level gibt den Aufzeichnungsumfang an. Die möglichen Werte des Trace-Levels sind:


Wichtig: Ein Hochsetzen des Trace-Levels sollte nur im Fehlerfall passieren, da relativ große Dateien entstehen können und dadurch die Performance von mtG-CAPRI, sinkt. Damit können unter Umständen bei zeitkritischen Anwendungen (z.B. Fax) Probleme entstehen.

MTGCAPRI_TRACEFILE

Standard-Einstellung: MTGCAPRI_TRACEFILE='/var/log/capri.trc'

Das Tracefile dient dem Server zur Aufzeichnung der Aktivitäten. Der Name und Ort der Datei ist frei wählbar.

MTGCAPRI_LOGFILE

Standard-Einstellung: MTGCAPRI_LOGFILE='/var/log/caprilog.txt'

Der Name der Log-Datei kann ebenfalls geändert werden.

MTGCAPRI_MULTIPLEBIND

Standard-Einstellung: MTGCAPRI_MULTIPLEBIND='no'

Erlaubt passives Zuordnen (Binden) von mehreren Clients zu einer Rufnummer auf dem Server. Mit MTGCAPRI_MULTIPLEBIND='no' warten mehrere Clients auf der gleichen Rufnummer auf eingehende Rufe. Mit MTGCAPRI_MULTIPLEBIND='no' ist eine Rufnummer nur inem Client zugeordnet.

MTGCAPRI_USER_N

Standard-Einstellung: MTGCAPRI_USER_N='1'

Hier wird die Anzahl der Benutzer festgelegt.

MTGCAPRI_USER_x_SERVICE

Standard-Einstellung: MTGCAPRI_USER_x_SERVICE='all'

Hier werden die Dienste festgelegt, die der Benutzer in Anspruch nehmen darf. Mögliche Werte sind: all, fax23, fax4, data64, telefon.
Man kann mehrere Dienste durch ein Leerzeichen getrennt angeben.
Beispiel: MTGCAPRI_USER_x_SERVICE='telefon fax23'

MTGCAPRI_USER_x_OWN_NUMBERS

Standard-Einstellung: MTGCAPRI_USER_x_OWN_NUMBERS='all'

Hier wird festgelegt auf welche Telefon-Nummern sich der Benutzer passiv binden darf. Mögliche Werte sind:

MTGCAPRI_USER_x_OWN_NUMBERS_LIST

Standard-Einstellung: MTGCAPRI_USER_x_OWN_NUMBERS_LIST=''

Hier werden, bei der Einstellung MTGCAPRI_USER_x_OWN_NUMBERS='partial', die Nummern festgelegt, die der Benutzer benutzen darf. Mehrere Nummern müssen durch ein Leerzeichen getrennt werden.
Beispiel: MTGCAPRI_USER_x_OWN_NUMBERS_LIST='12345 12346'

MTGCAPRI_USER_x_INCOMING_NUMBERS

Standard-Einstellung: MTGCAPRI_USER_x_INCOMING_NUMBERS='all'

Hier wird festgelegt, welche Nummern von außen Verbindung mit dem Server aufnehmen können. Mögliche Werte sind:

MTGCAPRI_USER_x_INCOMING_NUMBERS_LIST

Standard-Einstellung: MTGCAPRI_USER_x_INCOMING_NUMBERS_LIST=''

Hier werden, bei der Einstellung MTGCAPRI_USER_x_INCOMING_NUMBERS='partial', die Nummern festgelegt, die von außen Verbindung mit dem Server aufnehmen können. Mehrere Nummern müssen durch ein Leerzeichen getrennt werden.
Beispiel: MTGCAPRI_USER_x_INCOMING_NUMBERS_LIST='0172123456 0511'

MTGCAPRI_USER_x_OUTGOING_NUMBERS

Standard-Einstellung: MTGCAPRI_USER_x_OUTGOING_NUMBERS='all'

Hier wird festgelegt, welche Nummern von außen Verbindung mit dem Server aufnehmen können. Mögliche Werte sind:

MTGCAPRI_USER_x_OUTGOING_NUMBERS_LIST

Standard-Einstellung: MTGCAPRI_USER_x_OUTGOING_NUMBERS_LIST=''

Hier werden, bei der Einstellung MTGCAPRI_USER_x_OUTGOING_NUMBERS='partial', die Nummern festgelegt, die von außen Verbindung mit dem Server aufnehmen können. Mehrere Nummern müssen durch ein Leerzeichen getrennt werden.
Beispiel: MTGCAPRI_USER_x_OUTGOING_NUMBERS_LIST='0900 0180'

MTGCAPRI_USER_x_TIME_XX

Standard-Einstellung: MTGCAPRI_USER_x_TIME_XX='0:0 0:0'

Hier werden die Zeiten festgelegt zu denen der Benutzer die CAPI benutzen darf (Montag-Sonntag).
Hier ein paar Beispiele:

            '0:0 0:0'     - keine zeitliche Einschränkung
            '9:0 17:30'   - nur von 09:00 bis 17:30 Inanspruchnahme möglich
            '24:00 24:00' - keine Inanspruchnahme möglich

1.1.6 Installation der mtG-CAPRI-Client-Software

Bei der Client-Installation muß zwischen einem Windows95- und einem WindowsNT-basierten System differenziert werden, da durch Unterschiede in der Systemarchitektur verschiedene Dateien benötigt werden.

Bei der Einrichtung des mtG-CAPRI-Client ist folgender wichtiger Punkt zu beachten:
Falls auf dem Rechner schon eine CAPI-Anwendung (mit anderen Worten: eine lokale ISDN-Karte) installiert ist bzw. installiert war und sich noch eine der folgenden dll-Dateien auf der Festplatte befindet, müssen diese vor der mtG-CAPRI-Installation entfernt werden: capi20.dll und capi2032.dll; beide befinden sich im Normalfall im System-Verzeichnis.

Sollte dies der Fall sein, ist einer der beiden folgenden Wege zu beschreiten:

a) Deinstallation der ISDN-Karte und Überprüfung, ob die Dateien capi20.dll und capi2032.dll entfernt wurden.
b) Umbenennen dieser Programmbibliotheken, falls man zu einem späteren Zeitpunkt die lokale ISDN-Karte wieder aktivieren, und damit mtG-CAPRI deaktivieren, will. Das Umbenennen führt zum Deaktivieren der Treiber der eingebauten Karte.

Im Normalfall können nämlich diese Dateien vom Wise Installation System während der Installation nicht überschrieben werden (es werden außer der Versionsnummer auch noch andere Herstellerangaben überprüft), Wise Installation System könnte die Installation nicht korrekt durchführen.

1.1.6.1 Anpassung der Initialisierungsdatei capri.ini des mtG-CAPRI-Client

Die Datei capri.ini dient der Initialisierung des mtG-CAPRI-Client, u.a. der Identifizierung des Servers, zu dem die Verbindung aufgebaut werden muß und sollte folgende Eintragungen haben:
[CAPRI]
SERVERNAME = Remote:Thor
PORTNUMBER = 20000
TRACELEVEL = 0
TRACEFILE = c:\tmp\capri.trc
FLOWCTRL = 7

[CAPRI]

Die Kopfzeile der Datei darf nicht geändert werden.

SERVERNAME

Hinter 'Remote:' muß der Alias des Servers für das TCP/IP Netzwerk stehen (entsprechend dem Eintrag der Host-Datei und der mtG-CAPRI-Server-Datei capri.cfg).

PORTNUMBER

Dieser Eintrag muß mit dem in der Server-Datei capri.cfg übereinstimmen.

TRACELEVEL

Der Wert des Trace-Levels beträgt im Normalfall für den mtG-CAPRI-Client '0'.
Die möglichen Werte sind:


Wichtig: Ein Hochsetzen des Trace-Levels sollte nur im Fehlerfall passieren, d a relativ große Dateien entstehen können und dadurch die Performance von mtG-CAPRI sinkt. Damit können unter Umständen bei zeitkritischen Anwendungen (z.B. Fax) Probleme entstehen.

TRACEFILE

Pfad und Name der Trace- (Aufzeichnungs-) Datei, die von mtG-CAPRI angelegt wird. Der Eintrag kann editiert werden (hier: capri.trc).

FLOWCTRL

Es wird eine Flußkontrolle beim Versenden von Datenpaketen durchgeführt.
Mögliche Werte sind:

Es sind höhere Werte als 7 möglich, werden aber nicht empfohlen. Die CAPI-Spezifikation sieht einen Wert von 7 vor.

1.1.6.2 Testen des Clients

Die mitgelieferten Programme caprit32.exe (für 32bit-Umgebung) und caprit16.exe (für 16bit-Umgebung) werden per Doppelklick gestartet. Im Normalfall erscheint die Meldung 'mtG-CAPRI Test war erfolgreich'. Erscheint hingegen die Meldung 'mtG-CAPRI Test schlug fehl', sollten folgende Punkte geprüft werden:

Eine CAPI-Applikation (z.B. T-Online) sollte erst dann vom Client aus gestartet werden, wenn dieser Test erfolgreich absolviert wurde.

1.1.6.3 Fehlermeldungen von CAPI-Anwendungen

Die Fehlermeldungen von CAPI-Anwendungen (wie z.B. T-Online, FritzFax etc.) sind für den Fall gedacht, dass eine ISDN-Karte mit entsprechender Software lokal im jeweiligen Rechner installiert ist. Ihre Texte sind daher unter mtg-CAPRI, oft irreführend.

Beispiele:

Die Meldung 'Treiber für CAPI 2.0 auf diesem Rechner nicht installiert' bedeutet, dass die CAPI (jetzt aber im Zusammenspiel von Client und Server) nicht funktionsfähig ist. Im Zusammenhang mit mtG-CAPRI, kann das beispielsweise heißen, daß zwar auf dem Client alles in Ordnung ist, die Netzverbindung zum Server aber unterbrochen oder der Server gar nicht in Betrieb ist.

T-Online gibt etwa folgende Fehlermeldung aus, wenn der Benutzer nicht auf dem Server authentisiert wurde: 'Cannot initialise DDE (WSOCK32)'.

Wenn der Server-Name auf dem Client falsch angegeben ist, kommt die Meldung 'Ergebnis des Verbindungsaufbaus: Der für den ISDN-Betrieb nötige CAPI-Treiber fehlt oder ...'.

Bei solch 'kryptischen' Meldungen wird daher empfohlen:

Das Fli4l-Team
31. Dezember 2007