「Asterisk 24」の版間の差分
編集の要約なし |
|||
| (同じ利用者による、間の6版が非表示) | |||
| 3行目: | 3行目: | ||
[[カテゴリ:pjsip]] | [[カテゴリ:pjsip]] | ||
Asterisk | Asterisk 24.0.0が2026年11月5日(現地時間)リリースされました。<br> | ||
:メンテナンス終了は2030年10月15日 | :メンテナンス終了は2030年10月15日 | ||
:セキュリティフィックス提供終了は2031年10月 | :セキュリティフィックス提供終了は2031年10月 | ||
| 12行目: | 12行目: | ||
新機能についてはすでにAsterisk 20,22にバックポートされているため目立った機能の追加はありません。<br> | 新機能についてはすでにAsterisk 20,22にバックポートされているため目立った機能の追加はありません。<br> | ||
主に安定性・安全性の改善、修正等が主要な変更となっています。<br> | 主に安定性・安全性の改善、修正等が主要な変更となっています。<br> | ||
<br> | |||
新しい機能としてはchan_wbesocketがありますが、これはすでにAsterisk 20,22にバックポートされていますので使えます(細かい仕様変更等は調査中)。 | |||
==削除されたもの== | ==削除されたもの== | ||
===users.conf=== | |||
users.confによる設定は削除されました。すべてのチャネルドライバは個別の設定ファイルで構成する必要があります。<br> | |||
===DeadAGI=== | |||
Asterisk 15から非推奨だったDeadAGIが完全に削除されました。<br> | |||
===VALID_EXTEN,QUEUE_MEMBER_COUNT=== | |||
ファンクションから削除されました。<br> | |||
===Music on Hold (MoH)仕様変更=== | |||
古い random オプションと application= の r フラグが削除されました。今後は sort=random を使用します。<br> | |||
===Voicemail 仕様変更=== | |||
maxmessage と minmessage が削除され、代わりに maxsecs と minsecs を使用します。<br> | |||
===Logger CLI=== | |||
rotatetimestamp が削除され、rotatestrategy に置き換わりました。CLIコマンドの no debug channel も削除されています。<br> | |||
===その他=== | ===その他=== | ||
| 29行目: | 43行目: | ||
==インストール== | ==インストール== | ||
===前提となるパッケージ類=== | ===前提となるパッケージ類=== | ||
GCC、G++(GNU-C++)、OpenSSL、Ncurses、bison、カーネルソース(DAHDIを使う場合)、libxml2、SQLite3、libuuid-devel<br> | |||
dnsutilsは使う人がいるかもなので追加。libsrtp2はブラウザフォン対応用、libunboundはRTX/NVRで直収のため。<br> | |||
Debianで説明します。<br> | |||
apt -y install build-essential libedit-dev uuid-dev libxml2-dev libncurses-dev libsqlite3-dev sqlite3 libssl-dev subversion git net-tools dnsutils libsrtp2-dev libunbound-dev | |||
Asteriskの基本的な部分は上記のパッケージ追加で問題ないと思います。なおJanssonはAsteriskのバンドルでインストールしますので、configure時に指定します。<br> | |||
Asterisk 22と同様の環境でコンパイルできました。<br> | |||
===Asteriskソースの入手=== | ===Asteriskソースの入手=== | ||
Asterisk 24のソースは以下からダウンロードできます。なお asterisk-24-current.tar.gz が最新バージョンへのシンボリックリンクとなっていますので、これをダウンロードすれば最新バージョンが入手できます。 | |||
http://downloads.asterisk.org/pub/telephony/asterisk/ | |||
展開するディレクトリはどこでもかまいませんが、ここでは/usr/src/とします。 | |||
# cd /usr/src | |||
# wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-24-current.tar.gz | |||
入手したら展開しておきます。展開すると現在のAsteriskのバージョンのディレクトリに展開されます。以降それぞれの作業は、それぞれの展開したサブディレクトリで行います。 | |||
# tar zxvf asterisk-24-current.tar.gz | |||
# cd asterisk-24.x.x | |||
===Asteriskのコンパイルとインストール=== | ===Asteriskのコンパイルとインストール=== | ||
基本的にconfigureしてmakeするだけですが、Janssonをバンドルで行うので以下のオプションでconfigureします。。 | |||
# ./configure --with-jansson-bundled | |||
<BR> | |||
以前のバージョンからアップグレードを行う場合、変更されたモジュール類が多いので、一旦、以前のモジュールをディレクトリごと名前変更してバックアップしてからインストールしてください。<BR> | |||
mv /usr/lib/asterisk/module /usr/lib/asterisk/module.20.bak | |||
あとはコンパイルとインストールを行うだけです(新規インストールの場合)。 | |||
# make | |||
# make install | |||
# make samples | |||
# make config | |||
これで新規インストールは完了します。最後の make config で起動時に自動起動するようになります。<br> | |||
'''アップグレード時の注意''':以前のバージョンからアップグレードする場合、/etc/asterisk の設定ファイル類をバックアップしてから行ってください。make samplesすると /etc/asterisk の内容を上書きしてしまいます。アップグレード時は make installするだけで事足りることが多いです。(make configはシステムのスタートアップファイル類を更新するので大きな変更がない場合には更新の必要はありません。 | |||
===日本語音声のインストール=== | ===日本語音声のインストール=== | ||
Asteriskの本体に付随する日本語音声は古いためGoogle TTSで合成した日本語音声(トーキー)を用意してあります(Asterisk 18ベース)。githubに用意してありますのでご利用ください。<br> | Asteriskの本体に付随する日本語音声は古いためGoogle TTSで合成した日本語音声(トーキー)を用意してあります(Asterisk 18ベース)。githubに用意してありますのでご利用ください。<br> | ||
| 45行目: | 88行目: | ||
==ユーザの追加と設定== | ==ユーザの追加と設定== | ||
Asteriskをasterisk:asteriskで起動させるために以下のようにグループ/ユーザを追加します。UID,GIDの5060は単なる趣味です。 | |||
addgroup --gid 5060 asterisk | |||
adduser --uid 5060 --gid 5060 asterisk --disabled-password | |||
Asteriskの実行ユーザ/グループは /etc/defaults/asterisk を編集します。以下の部分のコメントを外します。 | |||
# Uncomment the following and set them to the user/groups that you | |||
# want to run Asterisk as. NOTE: this requires substantial work to | |||
# be sure that Asterisk's environment has permission to write the | |||
# files required for its operation, including logs, its comm | |||
# socket, the asterisk database, etc. | |||
AST_USER="asterisk" <==ここと | |||
AST_GROUP="asterisk" <==ここ | |||
ディレクトリ/ファイル類の権限も調整しておきましょう。 | |||
chown -R asterisk:asterisk /var/log/asterisk | |||
chown -R asterisk:asterisk /var/lib/asterisk | |||
chown -R asterisk:asterisk /var/spool/asterisk | |||
chown -R asterisk:asterisk /usr/lib/asterisk | |||
chown -R asterisk:asterisk /etc/asterisk | |||
これでsystemctlで起動すればAsteriskが動くはずです。 | |||
==サンプル設定ファイルと応用例== | ==サンプル設定ファイルと応用例== | ||
Asterisk 20以降用に大幅に書き直しました。<br> | Asterisk 20以降用に大幅に書き直しました。<br> | ||
2026年11月20日 (金) 16:11時点における最新版
Asterisk 24.0.0が2026年11月5日(現地時間)リリースされました。
- メンテナンス終了は2030年10月15日
- セキュリティフィックス提供終了は2031年10月
概要
Asterisk 24は最新のAsteriskのメジャーリリースで、Asterisk 22同様にLTS(Long Term Support:通常4年)になります。
Asterisk 22からの変更点で重要なもの
新機能についてはすでにAsterisk 20,22にバックポートされているため目立った機能の追加はありません。
主に安定性・安全性の改善、修正等が主要な変更となっています。
新しい機能としてはchan_wbesocketがありますが、これはすでにAsterisk 20,22にバックポートされていますので使えます(細かい仕様変更等は調査中)。
削除されたもの
users.conf
users.confによる設定は削除されました。すべてのチャネルドライバは個別の設定ファイルで構成する必要があります。
DeadAGI
Asterisk 15から非推奨だったDeadAGIが完全に削除されました。
VALID_EXTEN,QUEUE_MEMBER_COUNT
ファンクションから削除されました。
Music on Hold (MoH)仕様変更
古い random オプションと application= の r フラグが削除されました。今後は sort=random を使用します。
Voicemail 仕様変更
maxmessage と minmessage が削除され、代わりに maxsecs と minsecs を使用します。
Logger CLI
rotatetimestamp が削除され、rotatestrategy に置き換わりました。CLIコマンドの no debug channel も削除されています。
その他
細かい変更点等は公式を参照のこと。
https://docs.asterisk.org/Asterisk_24_Documentation/WhatsNew/
注意
- SIPチャネル要注意
- SIPチャネルはAsterisk 22以降でPjSipが標準となりました。chan_sipはソースも配布されず完全に廃止されました。
- Macro廃止
- Asterisk 22以降ではMacroが完全廃止されました。Gosub/Returnへの書き換えが必要です。
- extenでMacroを多用している例は多いので24へ移行する場合には対応してください。
インストール
前提となるパッケージ類
GCC、G++(GNU-C++)、OpenSSL、Ncurses、bison、カーネルソース(DAHDIを使う場合)、libxml2、SQLite3、libuuid-devel
dnsutilsは使う人がいるかもなので追加。libsrtp2はブラウザフォン対応用、libunboundはRTX/NVRで直収のため。
Debianで説明します。
apt -y install build-essential libedit-dev uuid-dev libxml2-dev libncurses-dev libsqlite3-dev sqlite3 libssl-dev subversion git net-tools dnsutils libsrtp2-dev libunbound-dev
Asteriskの基本的な部分は上記のパッケージ追加で問題ないと思います。なおJanssonはAsteriskのバンドルでインストールしますので、configure時に指定します。
Asterisk 22と同様の環境でコンパイルできました。
Asteriskソースの入手
Asterisk 24のソースは以下からダウンロードできます。なお asterisk-24-current.tar.gz が最新バージョンへのシンボリックリンクとなっていますので、これをダウンロードすれば最新バージョンが入手できます。
http://downloads.asterisk.org/pub/telephony/asterisk/
展開するディレクトリはどこでもかまいませんが、ここでは/usr/src/とします。
# cd /usr/src # wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-24-current.tar.gz
入手したら展開しておきます。展開すると現在のAsteriskのバージョンのディレクトリに展開されます。以降それぞれの作業は、それぞれの展開したサブディレクトリで行います。
# tar zxvf asterisk-24-current.tar.gz # cd asterisk-24.x.x
Asteriskのコンパイルとインストール
基本的にconfigureしてmakeするだけですが、Janssonをバンドルで行うので以下のオプションでconfigureします。。
# ./configure --with-jansson-bundled
以前のバージョンからアップグレードを行う場合、変更されたモジュール類が多いので、一旦、以前のモジュールをディレクトリごと名前変更してバックアップしてからインストールしてください。
mv /usr/lib/asterisk/module /usr/lib/asterisk/module.20.bak
あとはコンパイルとインストールを行うだけです(新規インストールの場合)。
# make # make install # make samples # make config
これで新規インストールは完了します。最後の make config で起動時に自動起動するようになります。
アップグレード時の注意:以前のバージョンからアップグレードする場合、/etc/asterisk の設定ファイル類をバックアップしてから行ってください。make samplesすると /etc/asterisk の内容を上書きしてしまいます。アップグレード時は make installするだけで事足りることが多いです。(make configはシステムのスタートアップファイル類を更新するので大きな変更がない場合には更新の必要はありません。
日本語音声のインストール
Asteriskの本体に付随する日本語音声は古いためGoogle TTSで合成した日本語音声(トーキー)を用意してあります(Asterisk 18ベース)。githubに用意してありますのでご利用ください。
※core-sounds.txtを確認したところ、18と20,22,24で音声の差異は無いようです。
git clone https://github.com/takao-t/asterisk-sound-ja.git
tarでまとめたものを展開します。
cd asterisk-sound-ja cp core-sound-ja.tgz /var/lib/asterisk/sounds/. cd /var/lib/asterisk/sounds/ tar zxvf core-sound-ja.tgz
これで sounds/ja の下に日本語音声ファイル類が入ります。LANGUAGE系の設定をjaにすると日本語音声が使えます。
日本語文法に必要なパッチ類を以前提供していましたが、現在ではAsterisk本体にマージされているため文法はLANGUAGEの設定のみで対応できます。
ユーザの追加と設定
Asteriskをasterisk:asteriskで起動させるために以下のようにグループ/ユーザを追加します。UID,GIDの5060は単なる趣味です。
addgroup --gid 5060 asterisk adduser --uid 5060 --gid 5060 asterisk --disabled-password
Asteriskの実行ユーザ/グループは /etc/defaults/asterisk を編集します。以下の部分のコメントを外します。
# Uncomment the following and set them to the user/groups that you # want to run Asterisk as. NOTE: this requires substantial work to # be sure that Asterisk's environment has permission to write the # files required for its operation, including logs, its comm # socket, the asterisk database, etc. AST_USER="asterisk" <==ここと AST_GROUP="asterisk" <==ここ
ディレクトリ/ファイル類の権限も調整しておきましょう。
chown -R asterisk:asterisk /var/log/asterisk chown -R asterisk:asterisk /var/lib/asterisk chown -R asterisk:asterisk /var/spool/asterisk chown -R asterisk:asterisk /usr/lib/asterisk chown -R asterisk:asterisk /etc/asterisk
これでsystemctlで起動すればAsteriskが動くはずです。
サンプル設定ファイルと応用例
Asterisk 20以降用に大幅に書き直しました。