mirror of
https://github.com/mbirth/wiki.git
synced 2024-12-27 23:24:06 +00:00
308 lines
10 KiB
Markdown
308 lines
10 KiB
Markdown
---
|
|
title: Gemeinschaft Asterisk PBX
|
|
language: de
|
|
layout: default
|
|
created: 2009-10-08 01:35:01 +0200
|
|
updated: 2009-10-08 20:54:42 +0200
|
|
toc: true
|
|
tags:
|
|
- know-how
|
|
- software
|
|
- asterisk
|
|
- telephony
|
|
- gemeinschaft
|
|
---
|
|
* [kempgen.net](http://www.kempgen.net/gemeinschaft/gemeinschaft-installation-trunk.html) --- Anleitung zur manuellen Installation
|
|
* in der `sounds-wav-to-alaw.sh` muss beim `sox`-Befehl der Parameter **`-w`** in **`-2`** geändert werden
|
|
* [belug.de](http://www.belug.de/hilfe/howtos/fcpci/) --- Kompilieren des fcpci-Moduls
|
|
* [kerneltrap.org](http://kerneltrap.org/mailarchive/linux-netdev/2009/6/7/5890033) --- `capi_ctr_reseted()` heißt jetzt `capi_ctr_down()` (muss geändert werden!)
|
|
|
|
|
|
Allgemeine Bedienung
|
|
====================
|
|
|
|
Benutzer an Telefon anmelden
|
|
----------------------------
|
|
|
|
Bei den Provisioning-fähigen Telefonen:
|
|
|
|
* Hörer abheben
|
|
* `*0<Durchwahl>` eintippen
|
|
* nach Aufforderung Kennwort eintippen (bei uns üblicherweise `1234`)
|
|
* Telefon evtl. rebooten
|
|
|
|
|
|
Anrufergruppe beitreten
|
|
-----------------------
|
|
|
|
Damit das Telefon richtig klingelt, folgenderweise der Anrufergruppe **100** beitreten:
|
|
|
|
* Hörer abheben
|
|
* `*5<Queue-Nr.>` eintippen (bei uns die `100`)
|
|
* auflegen
|
|
|
|
|
|
Rauswählen ohne 0
|
|
=================
|
|
|
|
In der MySQL-Datenbank `asterisk` in der Tabelle `gates` sind die Wählstrings hinterlegt. Standard (und nicht über GUI
|
|
änderbar) ist folgender:
|
|
|
|
mISDN/g:{gateway}/{number:1}
|
|
|
|
d.h., von der Rufnummer wird immer die erste Stelle abgeschnitten. In den neueren Versionen werden aber generell alle
|
|
nicht intern vorhandenen Rufnummern an das ausgehende Routing übergeben. Somit kann man durch eine Änderung in der
|
|
Datenbank den Wählstring auf
|
|
|
|
mISDN/g:{gateway}/{number}
|
|
|
|
ändern und hat dann den gewünschten Effekt. [Google Groups Thread](http://groups.google.de/group/gemeinschaft-users/browse_thread/thread/2ceb4e5afdd50375)
|
|
|
|
|
|
Anruferidentifizierung
|
|
======================
|
|
|
|
Vorgesehen ist, dass dies auf dem Telefon passiert. Daher gibt es momentan keine Funktionalität in dieser Richtung,
|
|
die direkt im Asterisk den Anrufernamen aus einer Tabelle sucht.
|
|
|
|
Da wir mit Queues arbeiten, muss dieser Aufruf vor dem Weiterleiten des ankommenden Anrufs in den Queue passieren.
|
|
Ein geeigneter Ort ist der `to_queue:`-Abschnitt in der `e-internal.ael` - direkt über dem `Queue()`-Aufruf:
|
|
[Google Groups Thread](http://groups.google.de/group/gemeinschaft-users/browse_thread/thread/cf4683c6a9081ae2)
|
|
|
|
~~~
|
|
else {
|
|
Set(ring_instead_of_moh=);
|
|
Progress(); // SIP: "183 Session Progress" with early media
|
|
}
|
|
// Die folgende Zeile ist neu:
|
|
AGI(/opt/gemeinschaft/dialplan-scripts/in-get-callerid.agi,${CALLERID(num)});
|
|
Set(queue_entertime=${EPOCH});
|
|
Queue(${EXTEN},${ring_instead_of_moh},,,${queuetimeout});
|
|
Set(queue_waittime=$[${EPOCH}-${queue_entertime}]);
|
|
Verbose(1,### Tried to enter queue ${EXTEN}\, result: ${QUEUESTATUS}\, waittime: ${queue_waittime});
|
|
~~~
|
|
|
|
Das Script `in-get-callerid.agi` sieht dann in etwa so aus:
|
|
|
|
{% highlight php %}
|
|
#!/usr/bin/php -q
|
|
<?php
|
|
|
|
define( 'GS_VALID', true ); /// this is a parent file
|
|
require_once( dirName(__FILE__) .'/../inc/conf.php' );
|
|
require_once( GS_DIR .'inc/agi-fns.php' );
|
|
|
|
ini_set('implicit_flush', 1);
|
|
ob_implicit_flush(1);
|
|
|
|
$number = trim(@$argv[1]);
|
|
if (empty($number)) die();
|
|
|
|
gs_agi_verbose( '### Number identification for ' . $number );
|
|
|
|
// TODO: Identify number
|
|
|
|
echo 'SET VARIABLE CALLERID(name) ' . gs_agi_str_esc($neuer_name) . "\n";
|
|
|
|
?>
|
|
{% endhighlight %}
|
|
|
|
Wichtig ist noch, dass das AGI-Script ausführbar (`chmod a+x in-get-callerid.agi`) sein und die magische erste Zeile
|
|
haben muss.
|
|
|
|
|
|
Konferenzräume von außen
|
|
========================
|
|
|
|
In der Grundkonfiguration gibt es nur dynamische Konferenzräume, die man mittels <kbd>8</kbd><kbd>8</kbd> *+ Raumnummer*
|
|
anlegen kann. Diese sind allerdings dann nicht von außen erreichbar. Folgenderweise kann man einen Raum von außen
|
|
erreichbar machen: [Google Groups Thread](http://groups.google.de/group/gemeinschaft-users/browse_thread/thread/d79b8b969ae80ef9)
|
|
|
|
In der `meetme.conf` einen neuen statischen Konferenzraum (hier: Nummer 888) anlegen:
|
|
|
|
[rooms]
|
|
conf => 888
|
|
|
|
In der `e-internal.ael` direkt im Kontext `to-internal-users` folgenden Eintrag machen:
|
|
|
|
~~~
|
|
//----------------------------------------------------------
|
|
// Direct to conference
|
|
//----------------------------------------------------------
|
|
20888 => {
|
|
Answer();
|
|
System(wget 'http://192.168.1.245/gemeinschaft/prov/call-init.php?user=ah&to=21888');
|
|
Playback(silence/2);
|
|
MeetMe(888, cM);
|
|
}
|
|
|
|
21888 => {
|
|
Answer();
|
|
MeetMe(888, cM);
|
|
}
|
|
~~~
|
|
|
|
Dadurch werden Anrufe auf der 21888 direkt in den Konferenzraum 888 geschaltet. Anrufe auf der 20888 lassen das Telefon
|
|
vom Benutzer `ah` den Konferenzraum anrufen und schicken den Anrufer danach erst in den Raum. Somit muss man nicht in
|
|
einem stillen Raum auf die Teilnehmer warten.
|
|
|
|
|
|
Aussetzer beim Klingeln der Telefone
|
|
====================================
|
|
|
|
Die Telefone haben nach ca. 10 Sekunden plötzlich für ca. 2 Sekunden aufgehört zu klingeln. In diesen 2 Sekunden kann
|
|
man den Anruf auch nicht annehmen. [Google Groups Thread](http://groups.google.de/group/gemeinschaft-users/browse_thread/thread/a02d0cb376a77953)
|
|
|
|
Ursache ist die Einstellung *Klingelzeit pro Agent* des Queues. Diese ist per default auf 10 Sekunden eingestellt,
|
|
sollte allerdings bei der Einstellung *Alle klingeln gleichzeitig* nicht greifen. Dennoch mach die Anlage nach den
|
|
10 Sekunden eine kurze Pause. Erhöht man den Wert auf z.B. 60 Sekunden, sollte die Pause nicht mehr auftreten.
|
|
|
|
|
|
Status-Monitor
|
|
==============
|
|
|
|
Es gibt 2 Status-Monitore:
|
|
|
|
* <http://192.168.1.245/gemeinschaft/monitor.php?extensions=10-99>
|
|
* <http://192.168.1.245/gemeinschaft/mon/mon.php?extensions=10-99>
|
|
|
|
Der erstere fragt Asterisk alle paar Sekunden über das Manager-Interface ab und erzeugt somit pro Betrachter mehr
|
|
Last. Der zweitere benutzt (via AJAX) den ExtStateDaemon, welcher wie folgt aktiviert werden muss:
|
|
|
|
|
|
Aktivieren des ExtStateD
|
|
------------------------
|
|
|
|
1. Kopieren des init-Scripts nach `/etc/init.d`:
|
|
|
|
cp /usr/src/gemeinschaft/etc/init.d/gs-extstated /etc/init.d/
|
|
|
|
1. Einrichten des automatischen Starts:
|
|
|
|
update-rc.d gs-extstated defaults 90 10
|
|
|
|
1. Starten des Daemons
|
|
|
|
/etc/init.d/gs-extstated start
|
|
|
|
[Google Groups Thread](http://groups.google.com/group/gemeinschaft-users/browse_thread/thread/58af4e988e64cae4?hide_quotes=no#msg_1a966420d40bb2ee)
|
|
|
|
|
|
Anrufbeantworter-Scripting
|
|
==========================
|
|
|
|
`/opt/gemeinschaft/scripts/gs-vm-audio-set`:
|
|
|
|
{% highlight php %}
|
|
#!/usr/bin/php -q
|
|
<?php
|
|
/** @author Markus Birth <mab@silversolutions.de> */
|
|
|
|
define( 'GS_VALID', true ); /// this is a parent file
|
|
define( 'GS_VM_AUDIO_DIR', '/opt/gemeinschaft/vm-rec' ); // path to VM recordings
|
|
define( 'GS_VM_AUDIO_FILEFORMAT', '%1$s-%2$s.alaw' ); // %1$s = extension, %2$s = external|internal
|
|
define( 'GS_VM_AUDIO_SOURCE_DIR', '/ssl' ); // source dir for <filename> (will be appended to GS_VM_AUDIO_DIR)
|
|
|
|
require_once( dirName(__FILE__) .'/../inc/conf.php' );
|
|
include_once( GS_DIR .'lib/getopt.php' );
|
|
include_once( GS_DIR .'inc/gs-lib.php' );
|
|
|
|
|
|
/***********************************************************
|
|
* the shell parameters
|
|
***********************************************************/
|
|
$usage = 'Usage: '. baseName(__FILE__) .' --user=<user> --source=internal|external --file=<filename>';
|
|
|
|
$opts = @getOptsNoMultiples( '',
|
|
array(
|
|
'user=',
|
|
'source=',
|
|
'file='
|
|
),
|
|
$usage
|
|
);
|
|
if (! isSet( $opts['user'] )
|
|
|| ! isSet( $opts['source'] )
|
|
|| ! isSet( $opts['file'] )
|
|
) {
|
|
gs_script_invalid_usage( $usage );
|
|
}
|
|
|
|
|
|
/***********************************************************
|
|
* do stuff
|
|
***********************************************************/
|
|
if (!in_array($opts['source'], array('internal', 'external'))) {
|
|
gs_script_error( 'Please specify only "external" or "internal" as source!' );
|
|
}
|
|
|
|
$srcPath = GS_VM_AUDIO_DIR . GS_VM_AUDIO_SOURCE_DIR . '/' . $opts['file'] . '.alaw';
|
|
if (!file_exists($srcPath)) {
|
|
gs_script_error( 'File "' . $srcPath . '" not found!' );
|
|
}
|
|
$trgPath = GS_VM_AUDIO_DIR . '/' . sprintf(GS_VM_AUDIO_FILEFORMAT, $opts['user'], $opts['source']);
|
|
|
|
if (file_exists($trgPath)) {
|
|
echo 'Warning. Target file "' . $trgPath . '" will be overwritten!' . PHP_EOL;
|
|
}
|
|
|
|
if ( !copy($srcPath, $trgPath) ) {
|
|
gs_script_error( 'Failed to copy "' . $srcPath . '" to "' . $trgPath . '"!' );
|
|
}
|
|
|
|
echo 'Set VM announcement of user ' . $opts['user'] . ' for ' . $opts['source'] . ' calls to "' . $opts['file'] . '".' . PHP_EOL;
|
|
|
|
?>
|
|
{% endhighlight %}
|
|
|
|
|
|
`/opt/gemeinschaft/sbin/do-event`:
|
|
|
|
{% highlight bash %}
|
|
#!/bin/sh
|
|
|
|
GS_DIR=/opt/gemeinschaft/scripts
|
|
GS_USER=99
|
|
GS_QUEUE=100
|
|
GS_SOURCE=external
|
|
LOGFILE=/var/log/gemeinschaft/do-event.log
|
|
|
|
case "$1" in
|
|
mittag)
|
|
$GS_DIR/gs-vm-audio-set --user=$GS_USER --source=$GS_SOURCE --file=mittag 2>&1 >>$LOGFILE
|
|
$GS_DIR/gs-queue-callforward-activate --queue=$GS_QUEUE --source=$GS_SOURCE --case=timeout --active=std 2>&1 >>$LOGFILE
|
|
;;
|
|
momeeting)
|
|
$GS_DIR/gs-vm-audio-set --user=$GS_USER --source=$GS_SOURCE --file=momeeting 2>&1 >>$LOGFILE
|
|
$GS_DIR/gs-queue-callforward-activate --queue=$GS_QUEUE --source=$GS_SOURCE --case=timeout --active=std 2>&1 >>$LOGFILE
|
|
;;
|
|
off)
|
|
$GS_DIR/gs-queue-callforward-activate --queue=$GS_QUEUE --source=$GS_SOURCE --case=timeout --active=no 2>&1 >>$LOGFILE
|
|
$GS_DIR/gs-vm-audio-set --user=$GS_USER --source=$GS_SOURCE --file=default 2>&1 >>$LOGFILE
|
|
;;
|
|
*)
|
|
echo "Usage: $0 {mittag|momeeting|off}"
|
|
exit 1
|
|
;;
|
|
esac
|
|
|
|
exit 0
|
|
{% endhighlight %}
|
|
|
|
|
|
**crontab**:
|
|
|
|
~~~
|
|
MAILTO=mab@intranet.silversolutions.de
|
|
#m h dom mon dow command
|
|
00 10 * * 1 /opt/gemeinschaft/sbin/do-event momeeting
|
|
00 11 * * 1 /opt/gemeinschaft/sbin/do-event off
|
|
00 13 * * 1-5 /opt/gemeinschaft/sbin/do-event mittag
|
|
00 14 * * 1-5 /opt/gemeinschaft/sbin/do-event off
|
|
~~~
|
|
|
|
|
|
*[GUI]: Graphical User Interface
|
|
*[AGI]: Asterisk Gateway Interface
|
|
*[AJAX]: Asynchronous Javascript and XML
|