Jabber for Windows のマルチラインのログの読み方 - 登録処理

Shuhei Mentani · ‎2018-05-01

はじめに
使用した環境
Unified CM へのレジスト
ライン切り替え時のログの紹介
その他ログの紹介
参考情報

はじめに

本ドキュメントでは、Jabber for Windows/Mac の 12.0 で機能追加された、マルチラインがどのように Unified CM にレジストされるかについて、Jabber のログを抜粋して説明します。なお、マルチラインの機能の概要については、Jabber for Windows のマルチライン機能の紹介を参照して下さい。

使用した環境

ファームウェアバージョン

本ドキュメントでは、以下のソフトウェアを用いた環境を使用しています。

製品名	ソフトウェアバージョン	IP Address
Jabber for Windows	12.0(0)	192.168.3.13
Unified CM	11.5(1)SU3 (*)	Primary 192.168.98.170, Secondary 192.168.98.171
IM and Presence	11.5(1)SU3	Primary 192.168.98.172, Secondary 192.168.98.173

(*) マルチラインサポートのための cop ファイル (cmterm-jabber-desktop-eight-Lines.k3.cop.sgn) を適用済み

Unifed CM 上の設定

CSFUSER1 というデバイスを作成し、ライン 1 〜 8 に Directory Number 5101 〜 5108 を設定しています。

ライン 1 の設定例（Directory Number 5101 を設定しています）

ライン 1 の Line Text Label の設定 (本例では、ライン 1 と 3 にのみ Line Text Label を設定しています)

Unified CM へのレジスト

ここでは、Jabber の問題レポートで取得できる jabber.log からの抜粋を用いて、マルチラインのレジスト処理を説明します。

1. Service Discovery による設定ファイルの取得先の特定

(*) Service Discovery では、多くの処理が実施されますが、詳細はここでは割愛します。

参考 URL

サービスディスカバリにより、設定ファイルの取得先が判明。

[DEVICE_XML]
    [URL]        https://192.168.98.170:6972/CSFUSER1.cnf.xml
    [URL]        https://192.168.98.171:6972/CSFUSER1.cnf.xml
    [Host]        192.168.98.170
    [Host]        192.168.98.171
    [Filename]    CSFUSER1.cnf.xml
    [XML]        <empty>

2. 設定ファイル (CSFUSER1.cnf.xml.sgn) の取得

2018-04-25 14:45:02,821 DEBUG [0x00000118] [s\telephonyservice\ECCHttpHelper.cpp(47)] [jcf.tel.ecc.http] [CSFUnified::ECCHttpHelper::doGet] - doGet() request [ https://192.168.98.170:6972/CSFUSER1.cnf.xml.sgn]
2018-04-25 14:45:02,821 INFO  [0x00000118] [etutils\src\http\CurlHttpUtils.cpp(1116)] [csf.httpclient] [csf::http::CurlHttpUtils::configureEasyRequest] - *-----* Configuring request #1205 GET https://192.168.98.170:6972/[...]
2018-04-25 14:45:02,884 DEBUG [0x00000118][ls\src\http\BasicHttpClientImpl.cpp(592)] [csf.httpclient] [csf::http::executeImpl] - For request #1205 the total size of the data received is: 17891, the size of the response body is: 17891

3. 取得した設定ファイル (CSFUSER1.cnf.xml.sgn) の内容表示

(非常に長いため、マルチラインに関連する部分のみ抜粋)

2018-04-25 14:45:02,884 DEBUG [0x00000118] [src\callcontrol\ServicesManager.cpp(795)]
 [csf.ecc] [csf::ecc::ServicesManager::fetchDeviceConfig] - Device Config: 
<device  xsi:type="axl:XIPPhone" ctiid="15" uuid="{6b430ad3-d19c-50ea-ecab-1258c3902c01}">
<fullConfig>true</fullConfig>
<portalDefaultServer>192.168.98.170</portalDefaultServer>
<deviceProtocol>SIP</deviceProtocol>
/** 省略 **/
<callManagerGroup>
<name>Default</name>
<tftpDefault>true</tftpDefault>
<members>
<member  priority="0">
<callManager>
/** 省略 **/
<processNodeName>192.168.98.170</processNodeName>   <<< Primary Unified CM
</callManager>
</member>
<member  priority="1">
<callManager>
/** 省略 **/
<processNodeName>192.168.98.171</processNodeName>   <<< Secondary Unified CM
</callManager>
</member>
</members>
</callManagerGroup>
/** 省略 **/
<sipLines>
<line  button="1" lineIndex="1">                    <<< ライン 1 の設定
<featureID>9</featureID>
<featureLabel>Label of Line1</featureLabel>         <<< Line Text Label
<proxy>USECALLMANAGER</proxy>
<port>5060</port>
<name>5101</name>                                   <<< Directory Number
/** 省略 **/
</line>
<line  button="2" lineIndex="2">                    <<< ライン 2 の設定
<featureID>9</featureID>
<featureLabel></featureLabel>
<proxy>USECALLMANAGER</proxy>
<port>5060</port>
<name>5102</name>                                   <<< Directory Number (Line Text Label は未設定)
/** 省略 **/
</line>
<line  button="3" lineIndex="3">                    <<< ライン 3 の設定
<featureID>9</featureID>
<featureLabel>Label of Line3</featureLabel>         <<< Line Text Label
<proxy>USECALLMANAGER</proxy>
<port>5060</port>
<name>5103</name>                                   <<< Directory Number
/** 省略 **/
</line>
<line  button="4" lineIndex="4">                    <<< ライン 4 の設定
<featureID>9</featureID>
<featureLabel></featureLabel>
<proxy>USECALLMANAGER</proxy>
<port>5060</port>
<name>5104</name>                                   <<< Directory Number
/** 以下 Line5 〜 8 は省略 **/

4. SIP による Unified CM へのレジスト

REFER と REGISTER により、Primary Unified CM へレジストし、Secondary に対しては、REGISTER (Expires: 0) によりキープアライブを送信します。

REGISTER の To/From ヘッダーはライン 1 (本例では 5101) が設定され、Contact ヘッダにデバイス名の CSFUSER1 が設定されています。これにより 1 つの REGISTER により全ラインのレジスト、および、キープアライブが行われます。

Jabber のログ (問題レポート内の jabber.log) を translatorX で解析した例

5. レジスト完了

レジストが完了した状態の Jabber の例

ライン切り替え時のログの紹介

マルチラインのドロップダウンメニューにて、ライン 1 から 7 への切り替えを行った際のログの抜粋を紹介します。

マルチラインのドロップダウンメニューを開く

2018-04-17 15:50:45,948 INFO  [0x000014a0] [actssearchplugin\MultilineButton.cpp(14)] [ContactsSearchPlugin] [MultilineRichButton::OnLButtonClicked] - [Jabber].[UI_ACTION].[LEFTCLICK].[4267].[Open multiline menu]
2018-04-17 15:50:45,979 INFO  [0x000014a0] [tssearchplugin\MultilineMenuView.cpp(62)] [ContactsSearchPlugin] [MultilineMenuView::Populate] - [Jabber].[UI_DISPLAY].[WINDOW_ON].[4207].[Multiline menu is populated]

ライン 7 (5107) を選択

2018-04-17 15:50:52,168 INFO  [0x000014a0] [earchplugin\JabberMultilineItem.cpp(129)] [ContactsSearchPlugin] [JabberMultilineItem::OnLButtonUp] - [Jabber].[UI_ACTION].[LEFTCLICK].[4219].[Selected a new line [7][5107] to be preferred line]

ドロップダウンメニューを閉じる

2018-04-17 15:50:52,183 INFO  [0x000014a0] [ssearchplugin\MultilineMenuView.cpp(286)] [ContactsSearchPlugin] [MultilineMenuView::ShowMenu] - [Jabber].[UI_DISPLAY].[WINDOW_OFF].[4207].[Multiline menu is closed]

ライン 7 (5107) がアクティブなラインとして動作を開始

2018-04-17 15:50:52,230 INFO  [0x000014a0] [rvices\impl\TelephonyDeviceImpl.cpp(851)] [jcf.tel.device] [CSFUnified::TelephonyDeviceImpl::OnPreferredLineChanged] - Updating activeLine to 5107

その他ログの紹介

マルチラインが正しく動作をする 3 つの条件（Unified CM で設定されていること、Softphone モードであること、MRA ではないこと）を Jabber のログから確認する方法を紹介します。

Unified CM から取得した設定ファイル内に、マルチラインが設定されていることを確認

2018-04-17 15:50:01,193 DEBUG [0x000014a0] [rvices\impl\TelephonyDeviceImpl.cpp(216)] [jcf.tel.device] [CSFUnified::TelephonyDeviceImpl::update] - MultilineConfigured change to 1

Softphon モードで動作をしていることを確認

2018-04-17 15:50:01,209 INFO  [0x000014a0] [ices\impl\TelephonyServiceImpl.cpp(2250)] [jcf.tel.service] [CSFUnified::TelephonyServiceImpl::onTelephonyPhoneModeUpdated] - TelephonyServiceImpl::onTelephonyPhoneModeUpdated(Softphone)

MRA 経由のレジストではないことを確認

2018-04-17 15:50:01,350 DEBUG [0x000019e0] [ntrol\TelephonyCallControlImpl.cpp(4144)] [jcf.tel.callcontrol] [CSFUnified::TelephonyCallControlImpl::isEdgeOnly] - edgeState = OnPrem