Capi2Name

Bei 'Capi2Name' handelt es sich um einen ISDN-Anrufmonitor der auf die CAPI-Schnittstelle unter Linux aufsetzt, eingehende Gespräche werden in eine 'MySQL'-Datenbank gespeichert und können über ein 'PHP'-Web-Interface mittels Browser angesehen werden. Das 'PHP'-Interface kann jedoch noch mehr, als nur die Anrufe anzeigen, es stellt Statistiken zur Verfügung, wie oft eine Person angerufen hat, oder die gesamte Anrufe per Balkendiagramm. Auch kann ein Adressbuch angelegt werden, oder eine Rückruffunktion, die einen erinnert, bei wem man zurückrufen sollte.
Ist zudem noch 'CapiSuite' auf dem Linux-System installiert, kann 'Capi2Name' mittels eines Interfaces eingegangene Anrufbeantworteraufnahmen über den Web-Browser wiedergeben.

In Folgenden wird kurz die Installation und das Einrichten von 'Capi2Name' unter Debian-Linux beschrieben, dabei wird nur der reine ISDN-Anrufmonitorfunktion betrachtet. Die Integration des Anrufbeantworters von 'CapiSuite' sollte auf der Homepage von 'Capi2Name' nachgelesen werden, da die Installation/Konfiguration sehr stark von der verwendeten 'Capi2Name'-Version abhängig ist.

Installation

Die folgende Beschreibung der Installation von 'Capi2Name' wird unter Debian GNU/Linux 3.1 vorgestellt. Dabei wird davon ausgegangen, dass der Server auf dem 'Capi2Name' laufen soll, schon als 'LAMP'-Server ausgelegt ist, d.h. 'Apache', 'MySQL' und 'PHP' sollten installiert und funktionsfähig sein. Des weiteren sollte natürlich der CAPI-Treiber lauffähig sein. In der folgenden Beispiel-Installation wird für die Datenbank folgende Parameter verwendet:

Datenbank-Name: (database name):                   capi2namedb
Benutzername für die Datenbank (username):      capi
Kennwort für die Datenbank (password):           secret

Capi2Name als Debian-Paket installieren

Die Software 'Capi2Name' kann als Debian-Paket bezogen und installiert werden. Die Vorgehensweise kann wie folgt aussehen:

Zunächst sollte in das Verzeichnis '/tmp' gewechselt werden, um anschließend das Debian-Paket mittels 'wget' herunterzuladen. Mit dem Kommando: 'dpkg -- install' kann nun das Paket installiert werden, eventuelle Abhängigkeiten sollten mittels: 'apt-get -f install' aufgelöst werden.

Nach der Installation ist zunächst die Konfigurationsdatei '/etc/capi2name.conf' anzupassen:

Auszug aus: /etc/capi2name.conf

#############################################
# MYSQL #
#############################################
#Hostname for Mysql:
hostname=localhost
#Username for Mysql:
username=capi
#Password for Mysql:
password=secret
#Databasename for Mysql:
database=capi2namedb
#############################################
# END MYSQL CONFIGURATION #
#############################################

...

Es sind die Parameter 'hostname', 'database', 'username' und 'password' den Werten der Datenbank anzupassen (gelbe Markierung).

Apache-Webserver für Capi2Name vorbereiten

Auch der 'Apache'-Web-Server muss konfigurationstechnisch für 'Capi2Name' fähig sein, d.h. er muss PHP-Skripte interpretieren können, auch Seiten wie 'index.php' sollten sofort beim Wechseln in ein Verzeichnis angezeigt werden. Damit Browser von außen auf die 'Capi2Name'-Seiten zugreifen können, die sich nach der Installation der Software im Verzeichnis '/usr/share/capi2name/' befinden, empfiehlt es sich hierzu ein Alias zu definieren. Das Alias kann z.B. in der '/etc/apache2/sites-available/default' definiert werden und wie folgt aussehen:

Auszug aus: /etc/apache2/sites-available/default

...

        # Alias for Capi2Name
        Alias /capi2name "/usr/share/capi2name"
        <Directory /usr/share/capi2name>
                AllowOverride None
                Options -ExecCGI -Indexes -MultiViews -SymLinksIfOwnerMatch -FollowSymlinks
        </Directory>

</VirtualHost>

MySQL-Datenbank anlegen und initialisieren

Der aufwendigste Teil bei der Installation von 'Capi2Name' ist das Erstellen und Initialisieren der notwendigen MySQL-Datenbank. Hierzu kann separat mit SQL-Befehlen gearbeitet werden, oder mit entsprechenden Tools wie z.B. 'mysql_setpermission' oder 'phpMyAdmin'. Die Benutzer der Datenbank muss 'INSERT/SELECT/UPDATE/DELETE/ALTER/CREATE/DROP'-Rechte für die Datenbank haben. Ein Beispiel-Szenario mittels 'mysql_setpermission', wie eine solche Datenbank zu erstellen ist, ist unter 'Weitere Infos' unten zu finden.

Nach dem die Datenbank erstellt ist, muss diese initialisiert werden. Dazu ist zunächst die Datei: '/usr/share/capi2name/includes/conf.inc.php' anzugepassen.

Auszug aus: /usr/share/capi2name/includes/conf.inc.php

<?php
$sql["host"]                = "localhost";
$sql["dbuser"]              = "capi";
$sql["dbpasswd"]            = "secret";
$sql["db"]                  = "capi2namedb";
$config['domain']           = "www.eusterholz.tld";
$config['capi2name_status'] = "yes";
$config['capisuite']        = "no";
$config['language']         = "de";
/******************************************************************************
*******************************************************************************
Do not edit belong this line
*******************************************************************************
*******************************************************************************
Nach dieser Line nichts mehr aendern
*******************************************************************************
******************************************************************************/
//VERSIONS INFO UND CODENAMEN:
$codenamen="RC-657";
$version="0.6.7.9";
?>

Wichtig ist, dass die Variablen (gelbe Markierung) korrekt für den Datenbankzugriff gesetzt werden.

Mittels eines Browsers kann nun die Initialisierung der Datenbank abgeschlossen werden. Dazu ist die Adresse: 'http://<SERVER>/capi2name/up_inst' einzugeben und dem Link: 'install capi2name database' zu folgen:

Auch in den Formular sind alle Werte für den Benutzer und der Datenbank anzugeben, mit dem Button 'start install' wird nun die Datenbank initialisiert.

Nach Fertigstellung der Initialisierung, sollte dann das komplette Verzeichnis 'up_inst' aus Sicherheitsgründen gelöscht werden:

Administration von Capi2Name

Damit sollte 'Capi2Name' fertig installiert und konfiguriert sein. Damit nun Benutzer 'Capi2Name' nutzen können muss zunächst administriert werden. Der Aufruf für die Administration kann mittels Browser unter der Adresse 'http://<SERVER>/capi2name/admin' erfolgen. Als Passwort ist ebenfalls 'admin' anzugeben:

Nach dem Login-Vorgang sollte zunächst ein neuer Benutzer erstellt werden, der anschließend die Standardoberfläche von 'Capi2Name' nutzen kann.

Nach dem ein Benutzer vom Administrator von 'Capi2Name' erstellt wurde, kann dieser sich unter der Adresse: 'http://<SERVER>/capi2name/' einloggen und die Applikation nutzen.

Linux als SOHO-Server