VoIP-Info.jp - 利用者の投稿記録 [ja]

ひかり電話ゲートウェイ iGW-N02

2024-12-27T11:49:26Z

アースワークス: 情報提供方法の変更

[[Category:Asterisk]]
[[Category:ひかり電話]]

ひかり電話ゲートウェイ iGW-N02 をご利用いただきありがとうございます。

インストール手順やセットアップ方法、注意事項などのドキュメントは、PDF形式ファイルで提供することにいたしました。

最新の情報はこちらをご覧ください。
https://ews.jp/works/voice-solution/igw-n02/

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-07-12T05:00:44Z

アースワークス: /* サーバー側設定 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=
* CPU は x86_64 系にのみ対応します。
* OS は 64 ビットにのみ対応します。

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| 2ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。

以下に Ubuntu22 と Rocky8 を使用する場合の手順を示します。
systemd-nspawn のインストール前までの手順は省略しております。ご了承ください。

==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

前述の【ライセンス発行】を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-07-12T04:50:53Z

アースワークス: /* システム要件 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=
* CPU は x86_64 系にのみ対応します。
* OS は 64 ビットにのみ対応します。

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| 2ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

前述の【ライセンス発行】を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-06-28T08:53:17Z

アースワークス: /* ダウンロード */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel x86 系（64 ビット）
|-
|
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

前述の【ライセンス発行】を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-06-28T07:29:50Z

アースワークス: /* ダウンロード */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel x86 系（64 ビット）
|-
|
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240613.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

前述の【ライセンス発行】を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-06-18T07:24:10Z

アースワークス: /* システム要件 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel x86 系（64 ビット）
|-
|
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

前述の【ライセンス発行】を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-06-12T07:25:36Z

アースワークス: /* ライセンス設定 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

前述の【ライセンス発行】を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-06-12T07:18:55Z

アースワークス: /* Rocky8 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-06-12T07:17:04Z

アースワークス: /* コンテナ設定 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

前述【アーカイブ展開・コンテナ配置】で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

前述【ネットワーク・NIC設定例】で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-06-12T07:07:36Z

アースワークス: /* アーカイブ展開・コンテナ配置 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

igw-n02-v1.0.tar.gz の部分は、前述の【事前準備】で入手したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N01

2024-05-02T02:08:56Z

アースワークス: /* お問い合わせ先 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=
本ページではひかり電話接続モジュール「iGW-N01」をPCにセットアップする手順を示します。 
iGW-N01とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n01/

=制限事項=

==網輻輳制御==
網輻輳時、INVITE に対して、Reasonヘッダ（protocolにQ.850、protocol-causeに42）が設定された503 Service Unavailableレスポンスとなります。 
この場合、可視表示、あるいは可聴音等で、ユーザにその旨を通知してください。

==ひかり電話網工事後の自動更新==
ひかり電話網工事（網側アドレス変更等）時に、自動更新機能が利用できないため、変更内容反映まで最大で２時間程度かかることがあります。 
即時反映させるためには、接続モジュールの再起動を行う必要があります。（自動反映機能は、次バージョンでの対応を予定しています）

=典型的な利用方法=
Linux サーバに、本製品をインストールして、利用します。

<blockquote><pre>
[NGN]---[ONU]---[eth1:iGW-N01:eth0]---[Asterisk]---[電話機]
</pre></blockquote>

外部ルーターを利用する場合は、下記の構成となります。

<blockquote><pre>
[NGN]---[ONU]---[HUB]+---[eth1:iGW-N01:eth0]---+[HUB]---[Asterisk]---[電話機]
　　 +---[ROUTER]--------------+
</pre></blockquote>

=バイナリアーカイブ=
バイナリアーカイブは下記より取得できます。 
http://www2.iweave.jp/iGW-N01/iGW-N01-20150227-pc.tar.bz2

=対応するサーバ=

{| style="text-align:left"
|-
! CPU
| intel x86 系（32 ビット、64 ビット共）
|-
!
| 800[MHz] 以上（同時通話数により異なります）
|-
! メモリ
| 256[MB] 以上（同時通話数により異なります）
|-
! ストレージ
| 500[MB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（バージョン 2.6.18 以上）
|}
※ CPU は、i486 以上の x86 系、あるいは、x64 系に対応しています。 
※ OS は、32 ビット、64 ビットともに対応しています。

=設定方法=

==ライセンス発行について==
ソフトフォン適合検査への対応のため、ライセンス認証を行なっています。 
ライセンス発行には、以下の情報が必要となります。 
下記項目を本ページ末尾のお問い合わせ先からご連絡ください。

*メールアドレス
*eth0 の MAC アドレス

なお、MAC アドレスは下記コマンドにて確認できます。
<blockquote><pre>
# ifconfig eth0
</pre></blockquote>

1chライセンスは無償発行します。2ch以上のライセンスにつきましては本ページ末尾のお問い合わせ先までお問い合わせください。 

==事前準備==
Linux サーバでは、あらかじめ下記の設定を行なってください。

*eth0 側のネットワーク設定
*NTP の設定（必須ではありませんが、推奨します）

なお、eth1 側のネットワークは未設定で構いません。
ただし、eth1 側で PPPoE 等を利用することも可能です。

==バイナリアーカイブの展開==
展開先は任意の場所で構いませんが、これ以降では、/opt 以下に展開する例を示します。 
（バイナリアーカイブのファイル名は、ダウンロードしたものに置き換えてください）

<blockquote><pre>
# mkdir /opt
# tar jxfC iGW-N01-pc.tar.bz2 /opt
# ln -s iGW-N01-pc /opt/iGW-N01
</pre></blockquote>

==ライセンスの設定==
ライセンスキー取得後、/opt/iGW-N01/etc/iGW-N01/license.txt を修正してください。 
余計な空白（ = 前後、行末）を入れないようご注意ください。

<blockquote><pre>
　　 # emacs /opt/iGW-N01/etc/iGW-N01/license.txt
</pre></blockquote>

==設定変更==

===利用するインターフェイスの設定===
/opt/iGW-N01/etc/iGW-N01/if_conf.sh を修正する必要があります。 

以下のように設定する場合の例です。

*PBX との接続には、eth0 を利用する。
*ひかり電話網との接続には eth1 を利用する。

<blockquote><pre>
# pbx side interface
export pbx_if0=eth0 # physical
export pbx_if1=eth0 # logical
　　　　
# hikari side interface
export hikari_if0=eth1 # physical
export hikari_if1=eth1 # logical
</pre></blockquote>

==接続する Asterisk のアドレス等の設定==
/opt/iGW-N01/etc/iGW-N01/pbx_vars.xml を修正する必要があります。 
以下のように変更する場合の例

{| style="text-align:left"
|-
! Asterisk アドレス
| 192.168.171.2
|-
! 利用 SIP ポート
| Asterisk 側 UDP/5060
|-
! レジスト
| 不要
|-
! 接続認証
| IP アドレスによる認証
|-
! セッションタイマ
| なし
|-
! 100rel
| なし
|}

修正箇所（- の行を + の行のように修正ください）
なお、この例では Asterisk 側の SIP ポートを明示的に記載しています。
<blockquote><pre>
　　　　@@ -1,6 +1,6 @@
　　　　 <include>
　　　　 
　　　　- <X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.230.231"/>
　　　　+ <X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.171.2"/>
　　　　
　　　　 
　　　　 <X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
　　　　@@ -12,9 +12,9 @@
　　　　 <X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>
　　　　
　　　　 
　　　　- <X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
　　　　- <X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
　　　　- <X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>
　　　　+ <X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5060"/>
　　　　+ <X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5060"/>
　　　　+ <X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5060"/>
　　　　
　　　　 
　　　　 <X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
</pre></blockquote>

===接続元を制限する===
標準では、Asterisk が所属するネットワークの 24 ビットマスクのアドレスからの発信要求を許可する設定となっています。 
ゲートウェイの対象となる Asterisk からの発信要求のみ許可する場合、/opt/iGW-N01/etc/iGW-N01/pbx_acl.xml を修正する必要があります。 

修正箇所（- の行を + の行のように修正ください）
<blockquote><pre>
　　　　@@ -1,3 +1,3 @@
　　　　 <list name="pbx" default="deny">
　　　　- <node type="allow" cidr="$${pbx1_ip}/24"/>
　　　　+ <node type="allow" cidr="$${pbx1_ip}/32"/>
　　　　 </list>
</pre></blockquote>

==Asterisk の設定例==

===sip.conf の例===

<blockquote><pre>
　　　----- ここから -----
　　　[hikari-gw]
　　　type=peer
　　　host=192.168.171.137
　　　context=from_pstn
　　　disallow=all
　　　allow=ulaw
　　　directmedia=no
　　　dtmfmode=inband
　　　----- ここまで -----
</pre></blockquote>

　◆接続モジュール起動設定（ubuntu 以外）
　　/etc/rc.local に下記を追加ください。

<blockquote><pre>
　　　----- ここから -----
　　　mount --bind /dev /opt/iGW-N01/dev
　　　mount --bind /proc /opt/iGW-N01/proc
　　　mount --bind /sys /opt/iGW-N01/sys
　　　mount -t tmpfs tmpfs /opt/iGW-N01/tmp
　　　mount -t tmpfs tmpfs /opt/iGW-N01/dev/shm
　　 chroot /opt/iGW-N01 service iGW-N01 start
　　　----- ここまで -----
</pre></blockquote>

　◆ ubuntu で利用する場合の追加設定
　　ubuntu で利用する場合は、あらかじめ、
　　/opt/iGW-N01/run/shm ディレクトリを作成してください。
　　
　　 # mkdir -p /opt/iGW-N01/run/shm

　　また、/etc/rc.local は下記を追加ください。

<blockquote><pre>
　　　----- ここから -----
　　　mount --bind /dev /opt/iGW-N01/dev
　　　mount --bind /proc /opt/iGW-N01/proc
　　　mount --bind /sys /opt/iGW-N01/sys
　　　mount -t tmpfs tmpfs /opt/iGW-N01/tmp
　　　chroot /opt/iGW-N01 mount -t tmpfs tmpfs /dev/shm
　　 chroot /opt/iGW-N01 service iGW-N01 start
　　　----- ここまで -----
</pre></blockquote>

==再起動==
上記の設定が終わりましたら、Linux サーバーを再起動してください。 
再起動後に、接続モジュールが稼動します。

<blockquote><pre>
　　 # shutdown -r now
</pre></blockquote>

==接続モジュールの手動開始、停止方法==

===開始方法===

<blockquote><pre>
# chroot /opt/iGW-N01 service iGW-N01 start
</pre></blockquote>

===停止方法===
<blockquote><pre>
# chroot /opt/iGW-N01 service iGW-N01 stop
</pre></blockquote>

===再起動方法===
<blockquote><pre>
# chroot /opt/iGW-N01 service iGW-N01 restart
</pre></blockquote>

=設定に関する補足=

==Asterisk での番号計画について==
発信者番号の指定方法と、輻輳案内に関して、補足します。 
発信者番号に発信したい番号を設定してください。 
Asterisk 1.8 以降では、下記の方法で輻輳状態を判定できます。 
それ以前の Asterisk では、正確ではありませんが DIALSTATUS 変数で判断できます。

===Asterisk 設定例（extensions.conf）===
あらかじめ、輻輳案内用の音声ファイルをご用意ください。 
Asterisk 1.8 以降の例を示します。 
（sip.conf に use_q850_reason=true を追加する必要があります）

<blockquote><pre>
　　[from_phone]
　　exten => _[01].,1,Set(CALLERID(num)=0312345678)
　　exten => _[01].,n,Dial(SIP/hikari-gw/${EXTEN})
　　exten => _[01].,n,ExecIF($["${HANGUPCAUSE}"="42"]?PlayBack(輻輳案内))
</pre></blockquote>

Asterisk 1.8以前の例　　
<blockquote><pre>
　　----- ここから -----
　　[from_phone]
　　exten => _[01].,1,Set(CALLERID(num)=0312345678)
　　exten => _[01].,n,Dial(SIP/hikari-gw/${EXTEN})
　　exten => _[01].,n,ExecIF($["${DIALSTATUS}"="CONGESTION"]?PlayBack(輻輳案内))
　　----- ここまで -----
</pre></blockquote>

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 

なお、接続モジュールの設定として、660 秒が設定されていますが、/opt/iGW-N01/etc/iGW-N01/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

==ひかり電話網側のファイヤーウォール設定==
UDP/5060, UDP/20000〜39999 を通信を許可してください。

=接続モジュールの状態確認=

==ひかり電話の接続情報が取得できたかの確認==
下記のコマンドで、契約番号が表示されれば、情報取得は完了しています。
<blockquote><pre>
# grep new_ntt_hikarinum /opt/iGW-N01/var/tmp/dhcp-iGW_N01
</pre></blockquote>

==ひかり電話へのレジスト状態の確認==
<blockquote><pre>
# chroot /opt/iGW-N01 fs_cli -x "sofia status"
</pre></blockquote>

下記のように出力されますので、hikari::hikari gateway の行で、State が REGED となっていることをご確認ください。

<blockquote><pre>
　　 Name Type Data State
　　=================================================================================================
　　 pbx profile sip:mod_sofia@127.0.0.1:5060 RUNNING (0)
　　 pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
　　 hikari profile sip:mod_sofia@AAA.BBB.CC.DD:5060 RUNNING (0)
　　 hikari::hikari gateway sip:0300000000@ntt-east.ne.jp REGED
　　=================================================================================================
　　2 profiles 0 aliases
</pre></blockquote>

==接続モジュールの状態確認==
起動してからの稼働時間、セッション数（１通話で２セッション）などを確認することができます。

<blockquote><pre>
# chroot /opt/iGW-N01 fs_cli -x "status"
</pre></blockquote>

==ひかり電話を利用できない場合==

DHCPクライアントが起動しない場合は接続モジュールが機能しませんので、下記を実行して表示内容をご確認ください。

<blockquote><pre>
# grep dhcl /var/log/syslog | tail
# grep dhcl /var/log/messages | tail
</pre></blockquote>

出力内容とエラーの状況は以下の通りです。

:ERROR CODE 000
::チャネル数の設定が正しくありません。

:ERROR CODE 001
::ライセンスの設定がただしくありません。

:ERROR CODE 002
::修正できないファイルが修正されています。 
::（下記の「起動制限について」を確認ください）

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

==起動制限について==
ソフトフォン適合検査への対応のため、下記のファイル、ディレクトリを修正した場合は、起動制限を行なっています。
*/opt/iGW-N01/etc/freeswitch/freeswitch.serial
*/opt/iGW-N01/etc/freeswitch/freeswitch.xml
*/opt/iGW-N01/etc/freeswitch/mime.types
*/opt/iGW-N01/etc/freeswitch/vars.xml.tmpl
*/opt/iGW-N01/etc/freeswitch/autoload_configs
*/opt/iGW-N01/etc/freeswitch/dialplan
*/opt/iGW-N01/etc/freeswitch/sip_profiles
*/opt/iGW-N01/usr/bin/freeswitch
*/opt/iGW-N01/usr/lib/freeswitch/mod
*/opt/iGW-N01/usr/local/sbin/igw_n01_up.sh
*/opt/iGW-N01/sbin/dhclient-script
*/opt/iGW-N01/etc/dhcp/dhclient.conf.tmpl
*/opt/iGW-N01/etc/dhcp/dhclient-exit-hooks.d/iGW-N01
*/opt/iGW-N01/etc/dhcp/dhclient-exit-hooks.d/rfc3442-classless-routes

=お問い合わせ先=
2024年4月30日をもちまして、iGW-N01 のご提供を終了いたしました。同時に、iGW-N01に関するお問い合わせへの対応も終了しておりますので、予めご了承ください。

後継製品として '''iGW-N02''' を提供しております。本サイト内に iGW-N01 と同様のご案内を掲載しておりますのでご参照ください。【 [[ひかり電話ゲートウェイ iGW-N02]] 】

iGW-N02 につきましては、下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-05-02T01:56:30Z

アースワークス: /* サーバー側設定 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。



==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-05-02T01:32:19Z

アースワークス: /* はじめに */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N02 とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。

それ以外の OS でのセットアップ手順が必要でしたら、igw@ews.jpまでお問い合わせください。

==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-04-26T06:38:09Z

アースワークス: /* モジュール設定 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N01とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。

それ以外の OS でのセットアップ手順が必要でしたら、igw@ews.jpまでお問い合わせください。

==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==ネットワーク・NIC設定==

<blockquote><pre>
nano /etc/network/interfaces
</pre></blockquote>

インストール時、ファイル内容は以下のようになっています。

<blockquote><pre>
source /etc/network/interfaces.d/*

#### host0 は、 /etc/iGW-N02/if_conf.sh の pbx_if1 の設定値に合わせる。
auto host0

#### IPアドレスをDHCPで取得する場合:

#iface host0 inet dhcp

#### IPアドレスを固定で設定する場合:
#### * gateway は、必要ならば設定する。

#iface host0 inet static
# address 192.168.230.230/24
# gateway 192.168.230.1
</pre></blockquote>

ご利用の環境に合わせて、コメントを外すなど編集をお願いいたします。

編集後以下のコマンドにて反映をします。

<blockquote><pre>
systemctl restart networking
</pre></blockquote>

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-02-14T01:03:29Z

アースワークス: /* お問い合わせ先 */

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N01とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。

それ以外の OS でのセットアップ手順が必要でしたら、igw@ews.jpまでお問い合わせください。

==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-01-30T08:45:16Z

アースワークス:

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N01とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

* 会社名
* 連絡先担当者氏名
* 連絡先担当者メールアドレス
* 連絡先担当者住所
* 連絡先担当者電話番号
* iGW-N02の設置場所名称
* ひかり電話を収容するNICのインターフェース名・MACアドレス
* 用途（評価用または本運用）
* ch数（評価用の場合は1chのみ）

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。

それ以外の OS でのセットアップ手順が必要でしたら、igw@ews.jpまでお問い合わせください。

==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「Asterisk FreeSWITCH対応ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-01-29T04:15:28Z

アースワークス:

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N01とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を当社Webサイトの問合せフォーム (https://ews.jp/company/contact/) よりご連絡ください。 

*氏名（会社名）
*メールアドレス
*住所
*電話番号
*ひかり電話を収容するNICのインターフェース名・MACアドレス

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。

それ以外の OS でのセットアップ手順が必要でしたら、igw@ews.jpまでお問い合わせください。

==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「Asterisk FreeSWITCH対応ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/

ひかり電話ゲートウェイ iGW-N02

2024-01-29T02:22:37Z

アースワークス: ページの作成:「Category:Asterisk Category:ひかり電話 =はじめに= 本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセッ...」

[[Category:Asterisk]]
[[Category:ひかり電話]]

=はじめに=

本ページは、ひかり電話接続モジュール「iGW-N02」インストール手順やセットアップ方法、注意事項などを記載します。 
Linux OS に対する知識を一定以上所有している方を想定しています。 
iGW-N01とは何かについては以下のURLをご参照ください。 
https://ews.jp/works/voice-solution/igw-n02/

=PBX での対応事項=

iGW-N02 を使用してひかり電話（NGN）に接続する上で、配下PBXでの対応がいくつか必要となります。

==網ふくそう通知==

網ふくそう時、INVITE に対し iGW-N02 から、Reason ヘッダに Q.850 ;cause=42 が設定されている 503 をレスポンスします。 
配下PBX側にて、ユーザーにふくそう通知を行ってください。

==着信拒否==

着信拒否をする場合は 403 応答をしてください。

==RTP 送信==

アーリーメディア中、および通話中では常に一定間隔で RTP を送信してください。 
発話していない状態であっても RTP を送信するよう、VAD などの機能は解除してください。

==音声コーデックについて==

音声コーデックは g.711u-law のみ対応しています。 
g.711u-law の送受信を出来るようにしてください。

==呼び出し時間の制限について==
一部の 0120 番号などでは、呼び出し状態で通話が開始されることがあります。（アーリーメディアの状態で、IVR や通話が開始される） 
この場合、呼び出し時間の制限を行うと、IVR や通話の途中で切断されますので、自動切断時間を適切にご調整ください。 
なお、接続モジュールの設定として、660 秒が設定されていますが、/var/lib/machines/igw-n02/etc/iGW-N02/pbx_vars.xml ファイル中のpbx_call_timeout=660 の設定にて変更できます。

=システム要件=

{| style="text-align:left"
|-
! CPU
| Intel Celeron CPU N3350 1.10GHz以上（同時通話数により変動します）
|-
! メモリ
| 1[GB] 以上（同時通話数により変動します）
|-
! ストレージ
| 1[GB] 以上の空き容量
|-
! NIC
| ２ポート以上（必須）
|-
! OS
| Linux（systemd-nspawn が利用できること）
|}
※ OS は、64 ビットにのみ対応します。

=事前準備=

==ダウンロード==

以下のURLよりコンテナイメージのダウンロードをお願いします。 
ダウンロード後、インストール先のサーバーへ配置してください。

https://www2.ews.jp/iGW-N02/igw-n02-20240109.tar.gz

==ライセンス発行==

本製品は、ソフトウェア適合検査に対応するため、ライセンス認証を行います。 
ライセンス発行の為、以下の情報が必要となります。 
下記項目を、igw@ews.jpまでご連絡下さい。 

*氏名（会社名）
*メールアドレス
*住所
*電話番号
*ひかり電話を収容するNICのインターフェース名・MACアドレス

=サーバー側設定=

サーバー（iGW-N02 をインストールする Linux PC）側の設定手順です。
以下に Ubuntu22 と Rocky8 の場合の手順を示します。

それ以外の OS でのセットアップ手順が必要でしたら、igw@ews.jpまでお問い合わせください。

==Ubuntu22==

Ubuntu Server22 LTS のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
apt install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はnetplanのドキュメントを参照の上、設定してください。

* NIC "eno1" : 社内LANへ接続するNIC
* NIC "enp1s0" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

「/etc/netplan/99-igwn02-config.yaml」を設定します。

<blockquote><pre>
vi /etc/netplan/99-igwn02-config.yaml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
network:
ethernets:
eno1:
dhcp4: true
enp1s0:
dhcp4: false
version: 2

bridges:
br0:
interfaces:
- eno1
dhcp4: true
gateway4: 192.168.1.1
nameservers:
addresses:
- 192.168.1.2
</pre></blockquote>

設定後、下記コマンドにより設定反映をしてください。

<blockquote><pre>
netplan apply
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.1.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp1s0
</pre></blockquote>

5.1.3 項で設定した NIC・Bridge 名を指定してください。

==Rocky8==

Rocky Linux 8.8 のケースについて手順を記述します。

===systemd-nspawn インストール===

<blockquote><pre>
dnf install systemd-container
</pre></blockquote>

===アーカイブ展開・コンテナ配置===

<blockquote><pre>
tar -zxf igw-n02-v1.0.tar.gz -C /var/lib/machines
</pre></blockquote>

4.1 項にて配置したコンテナイメージファイルを指定してください。

===SELinux無効化===

SELinuxが有効だとコンテナが起動できないため無効化する。

<blockquote><pre>
vi /etc/selinux/config
</pre></blockquote>

以下の通り変更

<blockquote><pre>
SELINUX=enforcing
↓
SELINUX=disabled
</pre></blockquote>

設定が反映されるのは再起動後となります。
次項にて再起動をするため現段階では不要です。

===ネットワーク・NIC設定例===

前提・設定条件として以下があります。

* IPアドレスはDHCPにより取得
** 固定IPとする場合はNetworkManagerのドキュメントを参照の上設定してください。

* NIC "enp0s3" : 社内LANへ接続するNIC、DHCP有効設定
* NIC "enp0s8" : ひかり電話を収容するNIC
* ブリッジ "br0" : iGW-N02コンテナを社内LANに接続するためのブリッジ

上記設定はあくまで一例となるため、導入先の環境により適宜読み替えてください。

NetworkManager を使用した設定例を以下に示します。

====仮想ブリッジインタフェースの作成・設定====

ブリッジインターフェース br0 の作成。

<blockquote><pre>
nmcli con add type bridge ifname br0
</pre></blockquote>

NIC enp0s3 をブリッジ br0 に接続

<blockquote><pre>
nmcli con add type bridge-slave ifname enp0s3 master br0
</pre></blockquote>

自動接続設定をONに

<blockquote><pre>
nmcli con mod bridge-br0 connection.autoconnect yes
</pre></blockquote>

====物理ポート設定の削除、および再起動====

SSHで接続している場合、接続が切断されます。
そのため、設定後即座に再起動をして設定を反映させます。

<blockquote><pre>
nmcli con del enp0s3;reboot
</pre></blockquote>

===コンテナ設定===

「/etc/systemd/nspawn/igw-n02.nspawn」を設定します。

5.2.2 項で配置したコンテナディレクトリ名(例：/var/lib/machines/igw-n02/)と、nspawn 設定ファイル名は一致している必要があるため、もしディレクトリ名などを変更した場合はファイル名と揃えてください。

<blockquote><pre>
mkdir -p /etc/systemd/nspawn
vi /etc/systemd/nspawn/igw-n02.nspawn
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
[Network]
Bridge=br0
Interface=enp0s8
</pre></blockquote>

5.2.4 項で設定した NIC・Bridge 名を指定してください。

=モジュール設定=

==コンテナ起動設定==

<blockquote><pre>
machinectl enable igw-n02
machinectl start igw-n02
machinectl shell igw-n02 # root で実行することでコンテナ内のコンソールに遷移
</pre></blockquote>

上記コマンド実行後、母艦側立ち上げ時にコンテナも起動する設定となります。

以降、iGW-N02 コンテナ内での操作となります。

==インターフェース設定==

<blockquote><pre>
nano /etc/iGW-N02/if_conf.sh
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
# pbx side interface
export pbx_if0=host0 # physical
export pbx_if1=host0 # logical

# hikari side interface
export hikari_if0=enp0s8 # physical
export hikari_if1=enp0s8 # logical
</pre></blockquote>

pbx_if：PBXサーバーへアクセス可能なNICを指定してください。
hikari_if：ひかり電話を収容するNICを指定してください。

==PBX サーバー接続設定==

ご利用の環境に合わせ、設定してください。
設定方法が不明な場合はサポートまでお問い合わせください。

===設定例===

<blockquote><pre>
nano /etc/iGW-N02/pbx_vars.xml
</pre></blockquote>

以下はファイル内容例です。

<blockquote><pre>
<include>

<X-PRE-PROCESS cmd="set" data="pbx1_ip=192.168.1.1"/>


<X-PRE-PROCESS cmd="set" data="pbx1_register=false"/>
<X-PRE-PROCESS cmd="set" data="pbx1_username="/>
<X-PRE-PROCESS cmd="set" data="pbx1_password="/>


<X-PRE-PROCESS cmd="set" data="pbx1_realm=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_domain=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}"/>


<X-PRE-PROCESS cmd="set" data="pbx_100rel=false"/>
<X-PRE-PROCESS cmd="set" data="pbx_session_timer=false"/>


<X-PRE-PROCESS cmd="set" data="pbx_rtp_timeout_sec=120"/>
<X-PRE-PROCESS cmd="set" data="pbx_rtp_hold_timeout_sec=300"/>
<X-PRE-PROCESS cmd="set" data="pbx_call_timeout=660"/>
</include>
</pre></blockquote>

上記設定例は以下のような設定となります。

{| class="wikitable"
! 設定項目
! 設定値
|-
| PBX アドレス
| 192.168.1.1
|-
| 利用する SIP ポート
| PBX 側 UDP/5060
|-
| レジスター
| しない
|-
| 接続認証
| IP アドレスによる認証
|-
| セッションタイマ
| 無し
|-
| 100rel
| 無し
|}

===項目説明===
{| class="wikitable"
! 項目
! 意味
! 既定値
! 備考
|-
| pbx1_ip
| 接続先 PBX の IP アドレス
|
|
|-
| pbx1_register
| レジスターの有効・無効
| false
|
|-
| pbx1_username
| レジスターの認証情報
|
|
|-
| pbx1_password
| レジスターの認証情報
|
|
|-
| pbx1_proxy
| プロキシサーバーの IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_reg_proxy
| レジスターの送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx1_out_proxy
| INVITE の送信先 IP アドレス
| pbx1_ip と同値
| ※1
|-
| pbx_100rel
| 100rel の有効・無効
| false
|
|-
| pbx_session_timer
| セッションタイマの有効・無効
| false
|
|-
| pbx_rtp_timeout_sec
| RTP タイムアウト時間（秒）
| 120
|
|-
| pbx_rtp_hold_timeout_sec
| 保留中の RTP タイムアウト時間（秒）
| 300
|
|-
| pbx_call_timeout
| 呼出しタイムアウト時間（秒）
| 660
|
|}

※1 PBX サーバーの待ち受けポートが 5060 以外の場合、下記3つの設定値にポート番号を追加してください。

* pbx1_proxy
* pbx1_reg_proxy
* pbx1_proxy

例：5070ポートへ変更する場合、該当箇所を下記のように変更します。

<blockquote><pre>
<X-PRE-PROCESS cmd="set" data="pbx1_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_reg_proxy=$${pbx1_ip}:5070"/>
<X-PRE-PROCESS cmd="set" data="pbx1_out_proxy=$${pbx1_ip}:5070"/>
</pre></blockquote>

==接続元制限==

<blockquote><pre>
nano /etc/iGW-N02/pbx_acl.xml
</pre></blockquote>

以下はファイル内容です。

<blockquote><pre>
<list name="pbx" default="deny">
<node type="allow" cidr="$${pbx1_ip}/32"/>
</list>
</pre></blockquote>

発信要求を許可するアドレス帯の設定です。
標準では上記のように、ゲートウェイ対象となる PBX サーバーからの発信要求のみを許可する設定となります。
ご利用される環境に合わせ、アドレス帯の変更をしてください。

==ライセンス設定==

本ドキュメント3項の「ライセンス発行について」を参照の上、ライセンスを取得してください。

取得後、ライセンス内容を以下のファイルに書き込んでください。

注意：余計な空白（イコールの前後や、行末など）を入れないようご注意ください

<blockquote><pre>
nano /etc/iGW-N02/license.txt
</pre></blockquote>

==設定反映==

iGW-N02 モジュールを再起動し、設定反映を行ってください。
その際、話中の通話は切断され、起動完了まで通話が不可となる点にご留意ください。

<blockquote><pre>
systemctl restart igw-n02
</pre></blockquote>

==状態確認==

===動作状態===

iGW-N02 は systemd により起動管理を行っているため、下記コマンドにて動作状態を確認可能できます。

<blockquote><pre>
systemctl status igw-n02
</pre></blockquote>

===ひかり電話へのレジスター状態===

<blockquote><pre>
fs_cli -x "sofia status"
</pre></blockquote>

上記コマンドにより以下のように出力されます。
「hikari::hikari gateway」行の State が REGED となっていれば、ひかり電話にREGが通っている状態です。

<blockquote><pre>
Name Type Data State
=================================================================================================
hikari profile sip:mod_sofia@10.0.0.2:5060 RUNNING (0)
hikari::hikari gateway sip:0551111111@ntt-east.ne.jp REGED
pbx profile sip:mod_sofia@192.168.171.100:5060 RUNNING (0)
pbx::pbx1 gateway sip:FreeSWITCH@192.168.171.2 NOREG
=================================================================================================
</pre></blockquote>

===モジュール状態確認===

起動してからの稼働時間、セッション数、最大セッション数などを確認することができます。

<blockquote><pre>
fs_cli -x "status"
</pre></blockquote>

=その他=
==SIP 仕様==
{|
|-
|IP バージョン　　　||IPv4
|-
|SIP ポート　　　　　||5060
|-
|音声コーデック　　　||G.711(μlaw）
|-
|DTMF　　　　　　　 ||みなし音声方式（インバンド方式）
|-
|ISDN サブアドレス　||未対応
|-
|FAX 　　　　　　　　||みなし音声方式
|}

=お問い合わせ先=
下記URLのお問い合わせフォームからお問い合わせ内容について「Asterisk FreeSWITCH対応ひかり電話ゲートウェイiGW-N02」を選択し、必要事項を入力の上お問い合わせください。

https://ews.jp/company/contact/