「ABS インストール」の版間の差分

2019年4月8日 (月) 10:56時点における版

注意：ABSはクラウド向けではありません。インターネット上に公開しているサーバ上にインストールすることは想定していません。
あくまでもローカル環境向けです。

Asteriskインストール

Asterisk 16のページを参考にソースインストールしてください。
make samples, make configもやっておきます。
/etc/asteriskに展開されるサンプルの設定ファイルは不要なので削除しておきます。

必要なパッケージ類のインストール

Raspbian(Raspberry Pi) Strecthを例に説明します。他のディストリビューションでは読み替えて実行してください。
Apacheとphp,php-mbstringをインストールしておきます。Gitも入れておいてください。

# apt-get -y install apache2 php php-mbstring
# apt-get -y install git

Web UIからファイル編集等を可能にするためAsteriskの実行ユーザをasteriskとし、そのグループにApache(www-data)を追加します。

# adduser -uid 5060 asterisk
# adduser www-data asterisk

/etc/default/asteriskファイルを編集し、以下の2行のコメントを外しておきます。

AST_USER="asterisk"
AST_GROUP="asterisk"

ABS自体のインストール

ABS一式を入手します

# git clone https://github.com/takao-t/abs.git abs
(注:現時点では未公開です。ドキュメントが揃ってから公開します。2019/04/08)

absディレクトリの中のextenを/etc/asteriskに、panelを/var/www/html/abs(例)にコピーします。

# cd abs/exten
# cp -r * /etc/asterisk
# cd ../panel
# mkdir /var/www/html/absp
# cp -r * /var/www/html/absp

ABSのユーザ認証用ファイルをWebからアクセスできない位置に移動します。

# cd /var/www
# mkdir abs
# mv html/abs/userinfo.dat abs/.

ファイルのパーミッションを適切に設定します

# cdown -R www-data:www-data /var/www

Asteriskのファイル類も適切に設定しますが、付属するスクリプトで一気に行うことができます。

# cd /etc/asterisk/scripts
# sh -x ./changemode.sh

ちょっとした内部解説

ABSの基本はAstDBによる動作です。このため通常はextenを書き換える必要はありません。
ABSのUIとAsteriskはAMIで通信しています。このためファイルのパーミッションが適切でなくとも基本的な機能は動作します。
ABS UIのファイル編集機能を使う場合には上記で示したようにWebからAsteriskのファイルが編集できるように調整する必要があります。
AMIはデフォルトでは以下の設定で認証していますので、なるべくデフォルトでは使用せず調整してください。
/etc/asterisk/manager.conf

;ABS Panel接続情報
[abspadmin]
secret = amipass1234
deny=0.0.0.0/0.0.0.0
permit=127.0.0.0/255.0.0.0
read = system,call
write = system,all

上記の例でインストールした場合、/var/www/html/absp/php/amiauth.php

<?php

define('AMIUSERNAME', 'abspadmin');
define('AMIPASSWORD', 'amipass1234');

?>

トランク設定

外線を使用する場合にはトランクを正しく設定しておいてください。トランクは必ず"番号"で着信させます。ひかり電話のHGW,OGW等いくつかのトランクに関しては前処理用のcontextが用意してあります。extensions_incoming.confを参照してください。
最終的には番号を付けて(incoming,番号,1)へ落とせばABSで着信処理ができます。番号がない着信の場合には以下のようにします。

exten => s,1,Goto(incoming,0312345678,1)

こうすれば0312345678で着信したことになります。

AsteriskとWebサーバの起動

# systemctl start asterisk
# systemctl start apache2

Web UIへのアクセス

http://サーバのIPアドレス/absp/ にアクセスするとログイン画面が出る(はず)です。ユーザ名 admin パスワード password でログインできます。

この認証は(見ればわかりますが)簡単なシカケで /var/www/abs/userinfo.dat を見ている(md5)だけです。

Web UIの使い方がよくわからない

おおよそ見ればわかるようにしてあるつもりなのですが、わかりにくい場合にはサンプルの設定を読み込ませてみてください。

# cd /etc/asterisk/scripts
# ./dbrestore.sh < astdb.sample

サンプルの設定が読み込まれるので参考にしてください。
Web UIからの設定反映は即時反映です。ですので着信条件等を変更した場合には即時で反映されますので注意してください。

電話機の設定

ABSでは内線電話機(ピア)は抽象化されているため内線番号と電話機はABSの設定(内線設定)で紐付けます。
電話機を登録する場合には pjsip_wizard.confに記載されているユーザ名(phoneX)とパスワードで登録してください。
ラインキー、固定パークキーを使用する場合にはキーの属性BLFにし、以下の値を設定します。

ラインキー keyX (Xは1～16)
パークキー ParxX (Xは1～8)